تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.
مورد قائمة حالة الألوان
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
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" />
- يمكنك الاطّلاع أيضًا على:
-
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2026-11-19 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2026-11-19 (حسب التوقيت العالمي المتفَّق عليه)"],[],[]]