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

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

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

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

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

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

التبعيات

تنفيذ عملية تبديل

في ما يلي مثال على تنفيذ بسيط للعنصر القابل للتجميع Switch:

النتائج

إنشاء صورة مصغّرة مخصّصة

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

النتائج

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

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

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

النتائج

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

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

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

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

  • ‫thumbContent: استخدِم هذا الخيار لتخصيص مظهر الإبهام عند وضع علامة عليه.
  • colors: استخدِم هذا الخيار لتخصيص لون المقطع الصوتي والصورة المصغّرة.

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

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

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

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

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