المكون Slider في ReactNative
مهمل: اسخدم هذه الحزم من المجتمع بدلًا منه.
يُستخدم مكوّن شريط التمرير (Slider) لاختيار قيمةٍ من مجال قيم.
الخاصيات
موروثة من خاصيات المكوّن View
.
style
تُستخدم لتنسيق وتخطيط المكون Slider
. ويمكن الاطلاع على StyleSheet.js
وViewStylePropTypes.js
لمزيدٍ من المعلومات.
النوع | مطلوب |
---|---|
تنسيق (View.style) | لا |
disabled
لن يستطيع المستخدم تحريك شريط التّمرير عندما تكون قيمتها true
، وقيمتها الافتراضيّة هي false
.
النوع | مطلوب |
---|---|
(bool) | لا |
maximumValue
تحدد أكبر قيمةٍ ابتدائيّةٍ لشريط التمرير، وقيمتها الافتراضية هي 1
.
النوع | مطلوب |
---|---|
عدد (number) | لا |
minimumTrackTintColor
تحدد اللون المستخدم للمسار الموجود على يسار الزّرّ، وتتجاوز التدرج الأزرق الافتراضيّ على منصة iOS.
النوع | مطلوب |
---|---|
لون (color )
|
لا |
minimumValue
تحدد أصغر قيمةٍ ابتدائيّةٍ لشريط التمرير، وقيمتها الافتراضية هي 0
.
النوع | مطلوب |
---|---|
عدد (number) | لا |
onSlidingComplete
تٌستدعى عندما يفلت المستخدم شريط التمرير حتى لو لم تتغير قيمته، وتمرَّر القيمة الحالية لشريط التمرير كمعاملٍ للمعالج.
النوع | مطلوب |
---|---|
دالة (function) | لا |
onValueChange
تٌستدعى هذه الدالة باستمرار عند سحب المستخدم للشريط.
النوع | مطلوب |
---|---|
دالة (function) | لا |
step
قيمة خطوة شريط التمرير، وتتراوح بين 0 و(maximumValue - minimumValue)، وقيمتها الافتراضيّة هي 0
.
النوع | مطلوب |
---|---|
عدد (number) | لا |
maximumTrackTintColor
تحدد اللون المستخدم للمسار الموجود على يمين الزّرّ، وتتجاوز التدرج الرماديّ الافتراضيّ على منصة iOS.
النوع | مطلوب |
---|---|
لون (color )
|
لا |
testID
تستخدم لوضع هذا العرض في اختبارات أتمتة واجهة المستخدم (UI automation tests).
النوع | مطلوب |
---|---|
سلسلة نصية (string) | لا |
value
تحدد القيمة الابتدائية لشريط التمرير، وتتراوح بين minimumValue وmaximumValue -اللتان كانت قيمهما الافتراضيّة 0
و1
على التوالي- وقيمتها الافتراضيّة هي 0
.
ملاحظة: هذا المكون غير متحكّم به لذا لا حاجة لتحديث القيمة أثناء السحب.
النوع | مطلوب |
---|---|
عدد (number) | لا |
thumbTintColor
اللون المستخدم لتلوين قبضة شريط التمرير -التي سيتحرك بواسطتها- على منصّة iOS، أو لون مفتاح التبديل الأمامي على منصّة Android.
النوع | مطلوب |
---|---|
لون (color )
|
لا |
maximumTrackImage
تحدد أكبر صورة مسارٍ، وتدعم الصّور الثابتة فقط، حيث يتمدد البكسل في أقصى يسار الصورة ليملأ المسار.
النوع | مطلوب | المنصة |
---|---|---|
مصدر الصورة (Image.propTypes.source) | لا | iOS |
minimumTrackImage
تحدد أصغر صورة مسارٍ، وتدعم الصور الثابتة فقط، حيث يتمدد البكسل في أقصى يمين الصورة ليملأ المسار.
النوع | مطلوب | المنصة |
---|---|---|
مصدر الصورة (Image.propTypes.source) | لا | iOS |
thumbImage
تحدّد صورةً لقبضة شريط التّمرير، وتدعم الصّور الثّابتة فقط.
النوع | مطلوب | المنصة |
---|---|---|
مصدر الصورة (Image.propTypes.source) | لا | iOS |
trackImage
تحدّد صورةً وحيدةً للمسار، وتدعم الصور الثابتة فقط، حيث تتمدد البكسلات في منتصف الصورة لتملأ المسار.
النوع | مطلوب | المنصة |
---|---|---|
مصدر الصورة (Image.propTypes.source) | لا | iOS |