إضافة مفتاح تبديل يمكن للمستخدمين تفعيله أو إيقافه

يتيح مكوّن Switch للمستخدمين التبديل بين حالتَين: "مفعّل" و"غير مفعّل". استخدِم مفتاح التبديل للسماح للمستخدم بتنفيذ أحد الإجراءات التالية:

• تفعيل إعداد أو إيقافه
• تفعيل ميزة أو إيقافها
• تحديد خيار

يتكوّن المكوّن من جزأين: زر التحكّم وشريط التمرير. زر التحكّم هو الجزء القابل للسحب من مفتاح التبديل، وشريط التمرير هو الخلفية. يمكن للمستخدم سحب زر التحكّم إلى اليسار أو اليمين لتغيير حالة مفتاح التبديل. يمكنه أيضًا النقر على مفتاح التبديل لتفعيله وإيقافه.

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

يتطلّب هذا التنفيذ ضبط `minSDK` لمشروعك على مستوى واجهة برمجة التطبيقات 21 أو أعلى.

الطلبات التابعة

تنفيذ مفتاح تبديل

المثال التالي هو تنفيذ بسيط للدالة المركّبة Switch:

النتائج

إنشاء زر تحكّم مخصّص

يمكنك تمرير أي دالة مركّبة لمعلَمة thumbContent لإنشاء زر تحكّم مخصّص. في ما يلي مثال على مفتاح تبديل يستخدم رمزًا مخصّصًا لزر التحكّم:

النتائج

يكون المظهر غير المفعّل هو نفسه في المثال الوارد في القسم السابق. ومع ذلك، عند تفعيل مفتاح التبديل، يظهر هذا التنفيذ على النحو التالي:

استخدام ألوان مخصّصة

استخدِم معلَمة colors لتغيير لون زر التحكّم وشريط التمرير لمفتاح التبديل، مع الأخذ في الاعتبار ما إذا كان مفتاح التبديل مفعّلاً.

النتائج

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

• المَعلمات الأساسية:

  • checked: الحالة الأولية لمفتاح التبديل
  • onCheckedChange: دالة معاودة الاتصال التي يتم استدعاؤها عند تغيُّر حالة مفتاح التبديل
  • enabled: ما إذا كان مفتاح التبديل مفعّلاً أو غير مفعّل
  • colors: الألوان المستخدَمة لمفتاح التبديل

• المَعلمات المتقدّمة

  • thumbContent: استخدِم هذه المَعلمة لتخصيص مظهر زر التحكّم عند تفعيله.
  • colors: استخدِم هذه المَعلمة لتخصيص لون شريط التمرير وزر التحكّم.

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

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

هل لديك أسئلة أو ملاحظات؟

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

الانتقال إلى الأسئلة الشائعة تقديم ملاحظات