إنشاء شريط تمرير لنطاق من القيم

تتيح العناصر القابلة للتجميع Slider للمستخدمين إجراء اختيارات من مجموعة من القيم. يمكنك استخدام شريط تمرير للسماح للمستخدم بإجراء ما يلي:

  • اضبط الإعدادات التي تستخدم نطاقًا من القيم، مثل مستوى الصوت والسطوع.
  • فلترة البيانات في رسم بياني، كما هو الحال عند ضبط نطاق أسعار
  • إدخال المستخدم، مثل ضبط تقييم في مراجعة

يحتوي شريط التمرير على مسار ومؤشر وعلامة قيمة وعلامات علامة:

  • المسار: المسار هو الشريط الأفقي الذي يمثّل نطاق القيم التي يمكن أن يأخذها شريط التمرير.
  • المؤشر: المؤشر هو عنصر تحكّم قابل للسحب على شريط التمرير الذي يسمح للمستخدم باختيار قيمة معيّنة ضمن النطاق الذي يحدّده المخطّط.
  • علامات الاختيار: علامات الاختيار هي علامات أو مؤشرات مرئية اختيارية تظهر على طول مسار شريط التمرير.

يعرض هذا الموضوع عمليات تنفيذ شريط التمرير التالية:

توافق الإصدار

يتطلّب هذا التنفيذ ضبط الحد الأدنى من إصدار حزمة تطوير البرامج (SDK) لمشروعك على المستوى 21 من واجهة برمجة التطبيقات أو مستوى أعلى.

التبعيات

إنشاء شريط تمرير أساسي

المثال التالي هو شريط تمرير بسيط. يتيح ذلك للمستخدم اختيار قيمة من 0.0 إلى 1.0. ولأنّه يمكن للمستخدم اختيار أي قيمة في هذا النطاق، يكون شريط التمرير متواصلًا.

النتائج

مكوّن شريط تمرير تم اختيار قيمة له تبلغ ثلاثة أرباع المسار تقريبًا
الشكل 1. تنفيذ أساسي لشريط التمرير

إنشاء شريط تمرير متقدّم

ينفِّذ المقتطف التالي شريط تمرير يتضمّن ثلاث خطوات، مع نطاق من 0.0 إلى 50.0. وبما أنّ إصبع الإبهام ينقر على كل خطوة، يكون شريط التمرير منفصلاً.

النتائج

اكتب النص البديل هنا.
الشكل 2. شريط تمرير يتضمّن خطوات ونطاقًا محدّدًا من القيم

شريط تمرير النطاق

يمكنك أيضًا استخدام العنصر القابل للتجميع المخصّص RangeSlider. يسمح هذا للمستخدم بتحديد قيمتَين. ويمكن أن يكون ذلك مفيدًا في حالات مثل عندما يريد المستخدم اختيار حدّ أدنى وأقصى للسعر.

يوضّح المثال التالي مثالاً بسيطًا نسبيًا على شريط التمرير المستمر للنطاق:

النتائج

مكوّن شريط تمرير النطاق مع اختيار قيمتَين يعرض التصنيف الحدّ الأقصى والحدّ الأدنى للاختيار.
الشكل 3. مثال على شريط تمرير النطاق

النقاط الرئيسية

اطّلِع على مرجع Slider للحصول على تعريف كامل لواجهة برمجة التطبيقات. في ما يلي بعض الparameters الرئيسية للعنصر القابل للتجميع Slider:

  • value: القيمة الحالية لأداة التمرير.
  • onValueChange: دالة lambda التي يتمّ استدعاؤها في كلّ مرّة يتمّ فيها تغيير القيمة.
  • enabled: قيمة منطقية تشير إلى ما إذا كان بإمكان المستخدم التفاعل مع شريط التمرير.

عند تنفيذ شريط تمرير أكثر تعقيدًا، يمكنك أيضًا الاستفادة من المَعلمات التالية.

  • colors: مثيل SliderColors يتيح لك التحكّم في ألوان شريط التمرير.
  • valueRange: نطاق القيم التي يمكن أن يأخذها شريط التمرير
  • steps: عدد الفتحات في شريط التمرير التي ينطبق عليها الإبهام

يمكنك أيضًا تمرير Slider عنصرَي thumb وtrack قابلَين للتجميع من أجل تخصيص شكل المكوّن بشكلٍ أكثر دقة.

المجموعات التي تتضمّن هذا الدليل

هذا الدليل هو جزء من مجموعات الأدلة السريعة المنظَّمة التي تتناول أهداف تطوير Android الأوسع نطاقًا:

تعرَّف على كيفية استخدام الدوال القابلة للتجميع لإنشاء مكونات جميلة لواجهة المستخدم بسهولة استنادًا إلى نظام التصميم المتعدّد الأبعاد.

إذا كانت لديك أسئلة أو ملاحظات

يمكنك الانتقال إلى صفحة الأسئلة الشائعة والاطّلاع على الأدلة السريعة أو التواصل معنا وإعلامنا برأيك.