مورد قائمة حالة الألوان

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

يمكنك وصف قائمة الحالات في ملف XML. يتم تحديد كل لون في عنصر <item> داخل عنصر <selector> واحد. يستخدم كل <item> سمات مختلفة لوصف الحالة التي يتم استخدامه فيها.

أثناء كل تغيير في الحالة، يتم التنقّل في قائمة الحالات من الأعلى إلى الأسفل، ويتم استخدام العنصر الأول الذي يتطابق مع الحالة الحالية. لا يستند الاختيار إلى "أفضل" مطابقة، بل إلى أول عنصر يستوفي الحد الأدنى من معايير الحالة.

ملاحظة: إذا أردت تقديم مورد لون ثابت، استخدِم قيمة لون بسيطة.

مكان الملف:
res/color/filename.xml
يُستخدم اسم الملف كمعرّف المرجع.
نوع بيانات المورد المجمَّع:
مؤشر المورد إلى ColorStateList
مرجع المورد:
في Java: R.color.filename
في XML: @[package:]color/filename
البنية:
<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android" >
    <item
        android:color="hex_color"
        android:lStar="floating_point_value"
        android:state_pressed=["true" | "false"]
        android:state_focused=["true" | "false"]
        android:state_selected=["true" | "false"]
        android:state_checkable=["true" | "false"]
        android:state_checked=["true" | "false"]
        android:state_enabled=["true" | "false"]
        android:state_window_focused=["true" | "false"] />
</selector>
العناصر:
<selector>
مطلوب. هذا هو عنصر الجذر. يحتوي على عنصر واحد أو أكثر من عناصر <item>.

السمات:

xmlns:android
String. مطلوب تحدّد مساحة اسم XML، وهي "http://schemas.android.com/apk/res/android".
<item>
تحدّد هذه السمة لونًا لاستخدامه في حالات معيّنة، كما هو موضّح في سماتها. وهو عنصر فرعي من العنصر <selector>.

السمات:

android:color
اللون الست عشري: مطلوبة. يتم تحديد اللون باستخدام قيمة النموذج اللوني أحمر أخضر أزرق وقناة ألفا اختيارية.

تبدأ القيمة دائمًا بحرف الجنيه (#)، متبوعًا بمعلومات ألفا-أحمر-أخضر-أزرق بأحد التنسيقات التالية:

  • #RGB
  • #ARGB
  • #RRGGBB
  • #AARRGGBB
android:lStar
الفاصلة العائمة: اختياري: تعدّل هذه السمة مستوى الإضاءة المدرَك للون الأساسي. وتقبل إما قيمة نقطة عائمة بين 0 و100 أو سمة مظهر يتم حلّها على هذا النحو. يتم احتساب اللون العام للعنصر من خلال تحويل اللون الأساسي إلى فضاء لوني يسهل الوصول إليه وضبط قيمة L* ‎ على القيمة المحدّدة في السمة lStar.

مثال: android:lStar="50"

android:state_pressed
قيمة منطقية: ‫"true" إذا تم استخدام هذا العنصر عند النقر على الكائن، مثلاً عند لمس زر أو النقر عليه تكون القيمة "false" إذا تم استخدام هذا العنصر في الحالة التلقائية غير المنقورة.
android:state_focused
قيمة منطقية: ‫"true" إذا تم استخدام هذا العنصر عند التركيز على الكائن، مثلاً عند تمييز زر باستخدام كرة التعقّب أو لوحة التحكم وتكون القيمة "false" إذا تم استخدام هذا العنصر في الوضع التلقائي غير المركّز.
android:state_selected
قيمة منطقية: "true" إذا تم استخدام هذا العنصر عند اختيار الكائن، مثلاً عند فتح علامة تبويب وتكون القيمة "false" إذا تم استخدام هذا العنصر عندما لا يكون الكائن محدّدًا.
android:state_checkable
قيمة منطقية: ‫"true" إذا تم استخدام هذا العنصر عندما يكون العنصر قابلاً للاختيار وتكون القيمة "false" إذا تم استخدام هذا العنصر عندما لا يكون العنصر قابلاً للاختيار. يكون مفيدًا فقط إذا كان بإمكان العنصر الانتقال بين تطبيق مصغّر قابل للاختيار وآخر غير قابل للاختيار.
android:state_checked
قيمة منطقية: "true" إذا تم استخدام هذا العنصر عند وضع علامة على الكائن. وتكون قيمتها "false" إذا تم استخدامها عند إلغاء اختيار العنصر.
android:state_enabled
قيمة منطقية: ‫"true" إذا تم استخدام هذا العنصر عندما يكون الكائن مفعَّلاً وقادرًا على تلقّي أحداث اللمس أو النقر وتكون قيمتها "false" إذا تم استخدامها عندما يكون العنصر غير مفعَّل.
android:state_window_focused
قيمة منطقية: "true" إذا تم استخدام هذا العنصر عندما تكون نافذة التطبيق في المقدّمة، ما يعني أنّ التطبيق في المقدّمة. وتكون القيمة "false" إذا تم استخدام هذا العنصر عندما لا تكون نافذة التطبيق في المقدّمة، مثلاً في حال سحب مركز الإشعارات للأسفل أو ظهور مربّع حوار.

ملاحظة: يتم تطبيق العنصر الأول في قائمة الحالات الذي يتطابق مع الحالة الحالية للعنصر. لذلك، إذا كان العنصر الأول في القائمة لا يحتوي على أي من سمات الحالة السابقة، فسيتم تطبيقه في كل مرة. لهذا السبب، ضع القيمة الافتراضية في النهاية، كما هو موضح في المثال التالي.

مثلا:
تم حفظ ملف XML في res/color/button_text.xml:
<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:state_pressed="true"
          android:color="#ffff0000"/> <!-- pressed -->
    <item android:state_focused="true"
          android:color="#ff0000ff"/> <!-- focused -->
    <item android:color="#ff000000"/> <!-- default -->
</selector>

يطبّق ملف XML للتنسيق التالي قائمة الألوان على View:

<Button
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:text="@string/button_text"
    android:textColor="@color/button_text" />
يمكنك الاطّلاع أيضًا على: