الفرق بين المراجعتين ل"ReactNative/scrollview"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
سطر 259: سطر 259:
  
 
===<code>fadingEdgeLength</code>===
 
===<code>fadingEdgeLength</code>===
 +
تُستخدم لتلاشي (Fade) حواف المحتوى الممرر. فإذا كانت قيمتها أكبر من الصفر, فإن تلاشي الحواف سيكون وفقًا لاتجاه ومكان التمرير الحالي للدلالة فيما إذا كان هنالك مزيدًا من المحتوى لإظهاره.
 +
{| class="wikitable"
 +
!النوع
 +
!مطلوب
 +
!القيمة الافتراضية
 +
!المنصة
 +
|-
 +
|عدد (number)
 +
|لا
 +
|0 
 +
|Android
 +
|}
 +
 +
===<code>horizontal</code>===
 +
إذا كانت قيمتها <code>true</code> فإن المكونات الأبناء لعرض التمرير ستصطف أفقيًا في سطر بدل الاصطفاف عموديًا في عمود, وقيمتها الافتراضية <code>false</code>.
 +
{| class="wikitable"
 +
!النوع
 +
!مطلوب
 +
|-
 +
|قيمة منطقية (bool)
 +
|لا
 +
|}
 +
 +
=== <code>indicatorStyle</code> ===
 +
تُستخدم لتنسيق مؤشر التمرير, وقيمها:
 +
 +
* <code>default</code> (الافتراضية) - نفس <code>black</code>.
 +
* <code>black</code> - يكون المؤشر أسود ويُستخدم مع الخلفيات الفاتحة. 
 +
* <code>white</code> - يكون المؤشر أبيض ويُستخدم مع الخلفيات الداكنة.
 +
 +
{| class="wikitable"
 +
!النوع
 +
!مطلوب
 +
!المنصة
 +
|-
 +
|قيمة اسمية (enum('default', 'black', 'white'))
 +
|لا
 +
|iOS
 +
|}
 +
 +
===<code>invertStickyHeaders</code>===
 +
تجعل هذه الخاصيّة الترويسات الدبقة (sticky headers) تلتصق في أسفل عرض التمرير بدل الالتصاق في الأعلى, وعادة ما تُستخدم مع عرض التمرير المقلوب.
 +
{| class="wikitable"
 +
!النوع
 +
!مطلوب
 +
|-
 +
|قيمة منطقية (bool)
 +
|لا
 +
|}
 +
 +
=== <code>keyboardDismissMode</code> ===
 +
تُستخدم لإبطال لوحة المفاتيح أثناء السحب, وقيمها:
 +
 +
على المنصات المتعددة (''Cross platform''):
 +
 +
* <code>none</code> (الافتراضية) - لا يبطل السحب لوحة المفاتيح.
 +
* <code>on-drag</code> - تبطل لوحة المفاتيح عند بدء السحب.
 +
 +
على منصّة iOS:
 +
 +
* <code>interactive</code> - تبطل لوحة المفاتيح تفاعليًا مع السحب والحركات بالتزامن مع اللمس, وتفعّل بالسحب للأعلى. وهذه الخاصيّة غير مفعّلة على منصّة Android وتبقى كما لو أن قيمتها <code>none</code>.
 +
 +
{| class="wikitable"
 +
!النوع
 +
!مطلوب
 +
|-
 +
|قيمة اسمية (enum('none', 'on-drag', '<code>interactive</code>'))
 +
|لا
 +
|}
 +
 +
=== <code>keyboardShouldPersistTaps</code> ===
 +
تحدد فيما إذا كانت لوحة المفاتيح ستبقى ظاهرة بعد النقر (tap), وقيمها:
 +
 +
* <code>never</code> (الافتراضية) - إن النقر خارج إطار النص المركّز ولوحة المفاتيح مرفوعة, يؤدي إلى إبطالها. ولن تستقبل المكونات الأبناء لعرض التمرير النقر عند حدوث ذلك. 
 +
* <code>always</code> - لا تبطل لوحة المفاتيح تلقائيًا, ولن يستقبل عرض التمرير النقر لكن المكونات الأبناء تستطيع استقباله.
 +
 +
* <code>handled</code> - لا تبطل لوحة المفاتيح تلقائيًا عند معالجة النقر من قبل المكونات الأبناء لعرض التمرير (أو عند استقباله من قبل المكونات الأجداد).
 +
* <code>false</code> (مهملة) - استخدم <code>never</code> بدلًا منها.
 +
* <code>true</code> (مهملة) - استخدم <code>always</code> بدلًا منها.
 +
 +
{| class="wikitable"
 +
!النوع
 +
!مطلوب
 +
|-
 +
|قيمة اسمية (enum('always', 'never', 'handled', false, true))
 +
|لا
 +
|}
 +
 +
=== <code>maintainVisibleContentPosition</code> ===
 +
عند استخدام هذه الخاصيّة, فإن عرض التمرير يضبط موقع التمرير بحيث لا يتغير موقع المكوّن الابن الأول والظاهر حاليًا (عند القيمة <code>minIndexForVisible</code> أو ما بعدها). وهذا مفيد مع القوائم التي تحمّل المحتوى من كلا الاتجاهين كما هو الحال في الدردشة, حيث تمنع هذه الخاصيّة الرسائل الجديدة الواردة من إزاحة موقع التمرير. القيمة الاعتيادية لهذه الخاصيّة هي <code>0</code>, غير أنه يمكن استخدام قيم أخرى مثل <code>1</code> من أجل تجاهل تحميل المحتوى الذي قد يغيّر موقع التمرير.
 +
 +
يمكن استخدام القيمة الاختيارية <code>autoscrollToTopThreshold</code> لتمرير المحتوى تلقائيا للأعلى بعد ضبط موقع التمرير في حال كان المستخدم ضِمن العتبة العليا قبل الضبط. وهذا مفيد في تطبيقات الدردشة من أجل رؤية الرسائل الجديدة الواردة بشكل تلقائي دون الحاجة للتمرير في حال قام المستخدم بالتمرير بعيدًا عنها.
 +
 +
'''تنبيه 1:''' قد يؤدي إعادة ترتيب عناصر scrollview مع تمكين هذه الخاصيّة إلى حدوث تقفّز (jumpiness). ولا يوجد نيّة حاليًا لإصلاح هذا الخلل, لذا يجب حاليًا تجنّب إعادة ترتيب محتوى أي مكوّن scrollview أو Lists يستخدم هذه الخاصيّة.
 +
 +
'''تنبيه 2:''' تَستخدم هذه الخاصيّة الخاصيتين <code>contentOffset</code> و <code>frame.origin</code> في الشفرة الأصيلة لحساب قدرة الإظهار (visibility). كما أنه لم يؤخذ في الاعتبار التحويلات وتعقيدات الإظهار الأخرى.
 +
{| class="wikitable"
 +
!النوع
 +
!مطلوب
 +
!المنصة
 +
|-
 +
|كائن (object: { minIndexForVisible: number, autoscrollToTopThreshold: number })
 +
|لا
 +
|iOS
 +
|}
 +
 +
===<code>maximumZoomScale</code>===
 +
تحدد مقياس الرسم (scale) الأعظمي للتكبير. قيمتها الافتراضية <code>1.0</code>.
 +
{| class="wikitable"
 +
!النوع
 +
!مطلوب
 +
!المنصة
 +
|-
 +
|عدد (number)
 +
|لا
 +
|iOS
 +
|}
 +
 +
===<code>minimumZoomScale</code>===
 +
تحدد مقياس الرسم (scale) الأصغري للتكبير. قيمتها الافتراضية <code>1.0</code>.
 +
{| class="wikitable"
 +
!النوع
 +
!مطلوب
 +
!المنصة
 +
|-
 +
|عدد (number)
 +
|لا
 +
|iOS
 +
|}
 +
 +
===<code>nestedScrollEnabled</code>===
 +
تمكّن من التمرير المتداخل (nested), ومدعومة على واجهات منصة Android البرمجية من المستوى 21+. كما أنها مدعومة افتراضيًا على منصّة iOS.
 +
{| class="wikitable"
 +
!النوع
 +
!مطلوب
 +
!المنصة
 +
|-
 +
|قيمة منطقية (bool)
 +
|لا
 +
|Android
 +
|}
 +
 +
===<code>onContentSizeChange</code>===
 +
تُستدعى هذه الدالة عند تغيّر المحتوى الممرر في ScrollView, حيث يمرر لهذه الدالة عرض وارتفاع المحتوى على شكل معاملين: <code>contentWidth</code> و <code>contentHeight</code>.
 +
 +
صُممت هذه الدالة باستخدام المعالج <code>onLayout</code> والمرتبط بحاوية المحتوى الذي يظهره ScrollView.
 +
{| class="wikitable"
 +
!النوع
 +
!مطلوب
 +
|-
 +
|دالة (function)
 +
|لا
 +
|}
 +
 +
=== <code>onMomentumScrollBegin</code> ===
 +
تُستدعى هذه الدالة عند بدء زخم (momentum) التمرير (حين يبدأ ScrollView بالانزلاق).
 +
{| class="wikitable"
 +
!النوع
 +
!مطلوب
 +
|-
 +
|دالة (function)
 +
|لا
 +
|}
 +
 +
=== <code>onMomentumScrollEnd</code> ===
 +
تُستدعى هذه الدالة عند انتهاء زخم التمرير(حين يتوقف ScrollView عن الانزلاق).
 +
{| class="wikitable"
 +
!النوع
 +
!مطلوب
 +
|-
 +
|دالة (function)
 +
|لا
 +
|}
 +
 +
=== <code>onScroll</code> ===
 +
تُطلق مرة واحدة على الأكثر لكل إطار (frame) أثناء التمرير. ويمكن التحكم بتردد الأحداث عن طريق الخاصيّة <code>scrollEventThrottle</code>, ولهذه الأحداث الشكل التالي (جميع القيم أعداد):<syntaxhighlight lang="javascript">
 +
{
 +
  nativeEvent: {
 +
    contentInset: {bottom, left, right, top},
 +
    contentOffset: {x, y},
 +
    contentSize: {height, width},
 +
    layoutMeasurement: {height, width},
 +
    zoomScale
 +
  }
 +
}
 +
</syntaxhighlight>
 +
{| class="wikitable"
 +
!النوع
 +
!مطلوب
 +
|-
 +
|دالة (function)
 +
|لا
 +
|}
 +
 +
=== <code>onScrollBeginDrag</code> ===
 +
تُستدعى هذه الدالة عند بدء المستخدم بسحب عرض التمرير.
 +
{| class="wikitable"
 +
!النوع
 +
!مطلوب
 +
|-
 +
|دالة (function)
 +
|لا
 +
|}
 +
 +
=== <code>onScrollEndDrag</code> ===
 +
تُستدعى هذه الدالة عند توقف المستخدم عن سحب عرض التمرير, وكذلك عندما يتوقف عرض التمرير أو يبدأ بالانزلاق.
 +
{| class="wikitable"
 +
!النوع
 +
!مطلوب
 +
|-
 +
|دالة (function)
 +
|لا
 +
|}
 +
 +
=== <code>onScrollToTop</code> ===
 +
تُطلق عند تمرير عرض التمرير للأعلى بعد أن نُقر شريط الحالة.
 +
{| class="wikitable"
 +
!النوع
 +
!مطلوب
 +
!المنصة
 +
|-
 +
|دالة (function)
 +
|لا
 +
|iOS
 +
|}
 +
 +
===<code>overScrollMode</code>===
 +
تُستخدم لتعديل القيمة الافتراضية لوضع التمرير الإضافي (overScroll), وقيمها:
 +
 +
* <code>auto</code> (الافتراضية) - تسمح للمستخدم بالتمرير الإضافي لهذا العرض فقط في حال كان حجم المحتوى كبير بشكل كافي لهذا النوع من التمرير.
 +
* <code>always</code> - تسمح دائمًا للمستخدم بالتمرير الإضافي لهذا العرض. .
 +
 +
* <code>never</code> - لا تسمح للمستخدم بالتمرير الإضافي لهذا العرض.
 +
 +
{| class="wikitable"
 +
!النوع
 +
!مطلوب
 +
!المنصة
 +
|-
 +
|قيمة اسمية (enum('auto', 'always', 'never'))
 +
|لا
 +
|Android
 +
|}
 +
 +
=== <code>pagingEnabled</code> ===

مراجعة 22:06، 11 ديسمبر 2020

ScrollView

هو عبارة عن مكوّن يغلّف المنصة ScrollView لتأمين التكامل مع منظومة مستجيب "responder" تعليق اللمس (touch locking).

يجب أن يكون ارتفاع المكوّن ScrollView محددًا (bounded) لكي يعمل, كونه سيضم مكونات أبناء غير محددة الارتفاع إلى حاوية محددة الارتفاع أثناء التمرير (scroll). وذلك بضبط ارتفاع العرض مباشرة بالخيار discouraged أو بالتأكد من أنه لجميع العروض الآباء ارتفاع محدد. يؤدي نسيان ضبط الالتفاف أسفل العرض على القيمة {flex: 1} إلى حدوث خطأ, يسارع مراقب (inspector) العناصر إلى تصحيحه (debug).

لا يدعم هذا المكوّن حتى الآن المستجيبات المضمّنة الأخرى لتعلّق عرض التمرير الحالي.

متى يُستخدم المكوّن FlatList بدل المكوّن <ScrollView>:

يعرض المكوّن ScrollView جميع مكونات react الأبناء دفعة واحدة, مما يؤثر سلبًا على الأداء عند عرض القوائم الطويلة التي تتطلب إنشاء الكثير من مكونات JS والعروض الأصيلة (native) ليتم إظهارها دفعة واحدة, وهذا بدوره يبطئ عملية الإظهار ويستهلك الكثير من الذاكرة.

في هذه الحالة يفضَّل استخدام المكون FlatList الذي لا يعرض المكونات المراد إظهارها إلا عند الوصول إليها, كما يقوم بإزالتها عند الانتهاء منها مما يوفر من قدرة المعالجة والذاكرة المستخدمة. كما يُستخدم هذا المكوّن عند الحاجة لإظهار فاصل بين العناصر أو بين الأعمدة المتعددة, أو لتمرير القوائم متناهية الطول وغيرها من الميزات الغير متوفرة في ScrollView.  

مثال

import React from 'react';
import { StyleSheet, Text, SafeAreaView, ScrollView } from 'react-native';
import Constants from 'expo-constants';

const App = () => {
  return (
    <SafeAreaView style={styles.container}>
      <ScrollView style={styles.scrollView}>
        <Text style={styles.text}>
          Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do
          eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad
          minim veniam, quis nostrud exercitation ullamco laboris nisi ut
          aliquip ex ea commodo consequat. Duis aute irure dolor in
          reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla
          pariatur. Excepteur sint occaecat cupidatat non proident, sunt in
          culpa qui officia deserunt mollit anim id est laborum.
        </Text>
      </ScrollView>
    </SafeAreaView>
  );
}

const styles = StyleSheet.create({
  container: {
    flex: 1,
    marginTop: Constants.statusBarHeight,
  },
  scrollView: {
    backgroundColor: 'pink',
    marginHorizontal: 20,
  },
  text: {
    fontSize: 42,
  },
});

export default App;

الخاصيّات (Props)

موروثة من الخاصيّات View Props.

alwaysBounceHorizontal

قيمتها الافتراضية horizontal={true} حيث تجعل عرض التمرير يرتد (bounce) أفقيًا عند وصوله للنهاية حتى ولو كان المحتوى أصغر من عرض التمرير نفسه.

النوع مطلوب المنصة
قيمة منطقية (bool) لا iOS

alwaysBounceVertical

قيمتها الافتراضية vertical={true} حيث تجعل عرض التمرير يرتد (bounce) عموديًا عند وصوله للنهاية حتى ولو كان المحتوى أصغر من عرض التمرير نفسه.

النوع مطلوب المنصة
قيمة منطقية (bool) لا iOS

automaticallyAdjustContentInset

تجعل منصّة iOS تتحكم آليًا بإدخال (inset) المحتوى من أجل عروض التمرير المتواجدة خلف شريط التنقل أو شريط الأدوات. وقيمتها الافتراضية true.

النوع مطلوب المنصة
قيمة منطقية (bool) لا iOS

bounces

قيمتها الافتراضية true حيث تجعل عرض التمرير يرتد عند وصوله لنهاية  المحتوى إن كان أكبر من عرض التمرير وفق محور التمرير. أما في حال كانت قيمتها false فإنها تلغي جميع أنواع الارتداد حتى لو كانت الخاصيات *alwaysBounce مفعّلة.

النوع مطلوب المنصة
قيمة منطقية (bool) لا iOS

bouncesZoom

قيمتها الافتراضية true حيث تتيح استخدام الإيماءات (gestures) لتجاوز الحد الأدنى والأقصى للتكبير, ويعود التكبير إلى حدوده الافتراضية بعد انتهاء الإيماءة.

النوع مطلوب المنصة
قيمة منطقية (bool) لا iOS

canCancelContentTouches

إذا كانت قيمتها false فإنها تمنع اللمسة المتحركة من السحب (drag). وقيمتها الافتراضية true.

النوع مطلوب المنصة
قيمة منطقية (bool) لا iOS

centerContent

إذا كانت قيمتها true فإنها تضع المحتوى آليًا في منتصف عرض التمرير إن كان المحتوى أصغر من حدود عرض التمرير, أما إن كان المحتوى أكبر من عرض التمرير فلا تأثير لهذه الخاصيّة. وقيمتها الافتراضية false.

النوع مطلوب المنصة
قيمة منطقية (bool) لا iOS

contentContainerStyle

وهي مجموعة من التنسيقات المطبّقة على محتوى عرض التمرير, والتي تغلّف جميع عروض المكونات الأبناء.

مثال:

return (
  <ScrollView contentContainerStyle={styles.contentContainer}>
  </ScrollView>
);
...
const styles = StyleSheet.create({
  contentContainer: {
    paddingVertical: 20
  }
});
النوع مطلوب
تنسيقات StyleSheetPropType(View Style props) لا

contentInset

تحدد مقدار دخول المحتوى من حواف عرض التمرير, وقيمتها الافتراضية {top: 0, left: 0, bottom: 0, right: 0}.

النوع مطلوب المنصة
كائن (object: {top: number, left: number, bottom: number, right: number}) لا iOS

contentInsetAdjustmentBehavior

تحدد هذه الخاصيّة طريقة استخدام منطقة الإدخال لتعديل منطقة المحتوى في عرض التمرير. والقيمة الافتراضية لها never, ومتوفرة فقط على منصة iOS إصدار 11 وما فوق.

النوع مطلوب المنصة
قيمة اسمية (enum('automatic', 'scrollableAxes', 'never', 'always')) لا iOS

contentOffset

تُستخدم لتحديد إزاحة بداية التمرير يدويًا, والقيمة الافتراضية لها {x: 0, y: 0}.

النوع مطلوب المنصة
PointPropType لا iOS

decelerationRate

عبارة عن عدد عشري يحدد معدل تباطؤ التمرير بعد رفع الإصبع عن عرض التمرير, كما يمكن استخدام اختصارات السلاسل النصية normal و fast والتي تقابل الإعدادات UIScrollViewDecelerationRateNormal و UIScrollViewDecelerationRateFast على منصة iOS.

  • normal (الافتراضية) - وتوافق القيمة 0.998 على منصّة iOS والقيمة 0.985 على منصّة Android.
  • fast - وتوافق القيمة 0.99 على منصّة iOS والقيمة 0.9 على منصّة Android.
النوع مطلوب
قيمة اسمية, عدد (enum('fast', 'normal'),number) لا

directionalLockEnabled

إذا كانت قيمتها true فإنها تسمح بالتمرير وفق الاتجاه العمودي أو الأفقي فقط أثناء السحب. وقيمتها الافتراضية false.

النوع مطلوب المنصة
قيمة منطقية (bool) لا iOS

disableIntervalMomentum

إذا كانت قيمتها true فإنها توقف عرض التمرير على الدليل (index) التالي (المتعلّق بموقع التمرير عند التحرير) بغض النظر عن سرعة الإيماءة. ويمكن أن تُستخدم للتصفّح الأفقي عندما يكون عرض الصفحة أصغر من عرض ScrollView. وقيمتها الافتراضية false.

النوع مطلوب
قيمة منطقية (bool) لا

disableScrollViewPanResponder

إذا كانت قيمتها true فإنها تلغي عمل المكوّن PanResponder الافتراضي لعرض التمرير, ويُترك التحكم الكامل للّمسات داخل عرض التمرير للمكونات الأبناء. وهذا مفيد عمليًا عندما تكون الخاصيّة snapToInterval مفعّلة كونها لا تتبع أنمط اللمسات النموذجية. يجب تجنب هذه الخاصيّة في الاستخدامات الاعتيادية لعرض التمرير من دون الخاصيّة snapToInterval, لأنها قد تسبب حدوث لمسات غير متوقعة أثناء التمرير. وقيمتها الافتراضية false.

النوع مطلوب
قيمة منطقية (bool) لا

endFillColor

تُستخدم هذه الخاصيّة لملء الفراغ المتبقي في عرض التمرير والذي يحدث أحيانًا نتيجة أخذ عرض التمرير لحيز أكبر من الذي يشغله المحتوى, حيث تسمح هذه الخاصيّة بتجنب إعداد الخلفية. وتعد هذه الخاصيّة من التحسينات المتقدمة والتي لا تُستخدم في الحالات الاعتيادية. 

النوع مطلوب المنصة
لون (color) لا iOS

fadingEdgeLength

تُستخدم لتلاشي (Fade) حواف المحتوى الممرر. فإذا كانت قيمتها أكبر من الصفر, فإن تلاشي الحواف سيكون وفقًا لاتجاه ومكان التمرير الحالي للدلالة فيما إذا كان هنالك مزيدًا من المحتوى لإظهاره.

النوع مطلوب القيمة الافتراضية المنصة
عدد (number) لا 0 Android

horizontal

إذا كانت قيمتها true فإن المكونات الأبناء لعرض التمرير ستصطف أفقيًا في سطر بدل الاصطفاف عموديًا في عمود, وقيمتها الافتراضية false.

النوع مطلوب
قيمة منطقية (bool) لا

indicatorStyle

تُستخدم لتنسيق مؤشر التمرير, وقيمها:

  • default (الافتراضية) - نفس black.
  • black - يكون المؤشر أسود ويُستخدم مع الخلفيات الفاتحة.
  • white - يكون المؤشر أبيض ويُستخدم مع الخلفيات الداكنة.
النوع مطلوب المنصة
قيمة اسمية (enum('default', 'black', 'white')) لا iOS

invertStickyHeaders

تجعل هذه الخاصيّة الترويسات الدبقة (sticky headers) تلتصق في أسفل عرض التمرير بدل الالتصاق في الأعلى, وعادة ما تُستخدم مع عرض التمرير المقلوب.

النوع مطلوب
قيمة منطقية (bool) لا

keyboardDismissMode

تُستخدم لإبطال لوحة المفاتيح أثناء السحب, وقيمها:

على المنصات المتعددة (Cross platform):

  • none (الافتراضية) - لا يبطل السحب لوحة المفاتيح.
  • on-drag - تبطل لوحة المفاتيح عند بدء السحب.

على منصّة iOS:

  • interactive - تبطل لوحة المفاتيح تفاعليًا مع السحب والحركات بالتزامن مع اللمس, وتفعّل بالسحب للأعلى. وهذه الخاصيّة غير مفعّلة على منصّة Android وتبقى كما لو أن قيمتها none.
النوع مطلوب
قيمة اسمية (enum('none', 'on-drag', 'interactive')) لا

keyboardShouldPersistTaps

تحدد فيما إذا كانت لوحة المفاتيح ستبقى ظاهرة بعد النقر (tap), وقيمها:

  • never (الافتراضية) - إن النقر خارج إطار النص المركّز ولوحة المفاتيح مرفوعة, يؤدي إلى إبطالها. ولن تستقبل المكونات الأبناء لعرض التمرير النقر عند حدوث ذلك.
  • always - لا تبطل لوحة المفاتيح تلقائيًا, ولن يستقبل عرض التمرير النقر لكن المكونات الأبناء تستطيع استقباله.
  • handled - لا تبطل لوحة المفاتيح تلقائيًا عند معالجة النقر من قبل المكونات الأبناء لعرض التمرير (أو عند استقباله من قبل المكونات الأجداد).
  • false (مهملة) - استخدم never بدلًا منها.
  • true (مهملة) - استخدم always بدلًا منها.
النوع مطلوب
قيمة اسمية (enum('always', 'never', 'handled', false, true)) لا

maintainVisibleContentPosition

عند استخدام هذه الخاصيّة, فإن عرض التمرير يضبط موقع التمرير بحيث لا يتغير موقع المكوّن الابن الأول والظاهر حاليًا (عند القيمة minIndexForVisible أو ما بعدها). وهذا مفيد مع القوائم التي تحمّل المحتوى من كلا الاتجاهين كما هو الحال في الدردشة, حيث تمنع هذه الخاصيّة الرسائل الجديدة الواردة من إزاحة موقع التمرير. القيمة الاعتيادية لهذه الخاصيّة هي 0, غير أنه يمكن استخدام قيم أخرى مثل 1 من أجل تجاهل تحميل المحتوى الذي قد يغيّر موقع التمرير.

يمكن استخدام القيمة الاختيارية autoscrollToTopThreshold لتمرير المحتوى تلقائيا للأعلى بعد ضبط موقع التمرير في حال كان المستخدم ضِمن العتبة العليا قبل الضبط. وهذا مفيد في تطبيقات الدردشة من أجل رؤية الرسائل الجديدة الواردة بشكل تلقائي دون الحاجة للتمرير في حال قام المستخدم بالتمرير بعيدًا عنها.

تنبيه 1: قد يؤدي إعادة ترتيب عناصر scrollview مع تمكين هذه الخاصيّة إلى حدوث تقفّز (jumpiness). ولا يوجد نيّة حاليًا لإصلاح هذا الخلل, لذا يجب حاليًا تجنّب إعادة ترتيب محتوى أي مكوّن scrollview أو Lists يستخدم هذه الخاصيّة.

تنبيه 2: تَستخدم هذه الخاصيّة الخاصيتين contentOffset و frame.origin في الشفرة الأصيلة لحساب قدرة الإظهار (visibility). كما أنه لم يؤخذ في الاعتبار التحويلات وتعقيدات الإظهار الأخرى.

النوع مطلوب المنصة
كائن (object: { minIndexForVisible: number, autoscrollToTopThreshold: number }) لا iOS

maximumZoomScale

تحدد مقياس الرسم (scale) الأعظمي للتكبير. قيمتها الافتراضية 1.0.

النوع مطلوب المنصة
عدد (number) لا iOS

minimumZoomScale

تحدد مقياس الرسم (scale) الأصغري للتكبير. قيمتها الافتراضية 1.0.

النوع مطلوب المنصة
عدد (number) لا iOS

nestedScrollEnabled

تمكّن من التمرير المتداخل (nested), ومدعومة على واجهات منصة Android البرمجية من المستوى 21+. كما أنها مدعومة افتراضيًا على منصّة iOS.

النوع مطلوب المنصة
قيمة منطقية (bool) لا Android

onContentSizeChange

تُستدعى هذه الدالة عند تغيّر المحتوى الممرر في ScrollView, حيث يمرر لهذه الدالة عرض وارتفاع المحتوى على شكل معاملين: contentWidth و contentHeight.

صُممت هذه الدالة باستخدام المعالج onLayout والمرتبط بحاوية المحتوى الذي يظهره ScrollView.

النوع مطلوب
دالة (function) لا

onMomentumScrollBegin

تُستدعى هذه الدالة عند بدء زخم (momentum) التمرير (حين يبدأ ScrollView بالانزلاق).

النوع مطلوب
دالة (function) لا

onMomentumScrollEnd

تُستدعى هذه الدالة عند انتهاء زخم التمرير(حين يتوقف ScrollView عن الانزلاق).

النوع مطلوب
دالة (function) لا

onScroll

تُطلق مرة واحدة على الأكثر لكل إطار (frame) أثناء التمرير. ويمكن التحكم بتردد الأحداث عن طريق الخاصيّة scrollEventThrottle, ولهذه الأحداث الشكل التالي (جميع القيم أعداد):

{
  nativeEvent: {
    contentInset: {bottom, left, right, top},
    contentOffset: {x, y},
    contentSize: {height, width},
    layoutMeasurement: {height, width},
    zoomScale
  }
}
النوع مطلوب
دالة (function) لا

onScrollBeginDrag

تُستدعى هذه الدالة عند بدء المستخدم بسحب عرض التمرير.

النوع مطلوب
دالة (function) لا

onScrollEndDrag

تُستدعى هذه الدالة عند توقف المستخدم عن سحب عرض التمرير, وكذلك عندما يتوقف عرض التمرير أو يبدأ بالانزلاق.

النوع مطلوب
دالة (function) لا

onScrollToTop

تُطلق عند تمرير عرض التمرير للأعلى بعد أن نُقر شريط الحالة.

النوع مطلوب المنصة
دالة (function) لا iOS

overScrollMode

تُستخدم لتعديل القيمة الافتراضية لوضع التمرير الإضافي (overScroll), وقيمها:

  • auto (الافتراضية) - تسمح للمستخدم بالتمرير الإضافي لهذا العرض فقط في حال كان حجم المحتوى كبير بشكل كافي لهذا النوع من التمرير.
  • always - تسمح دائمًا للمستخدم بالتمرير الإضافي لهذا العرض. .
  • never - لا تسمح للمستخدم بالتمرير الإضافي لهذا العرض.
النوع مطلوب المنصة
قيمة اسمية (enum('auto', 'always', 'never')) لا Android

pagingEnabled

مجلوبة من "https://wiki.hsoub.com/index.php?title=ReactNative/scrollview&oldid=29973"