משאב רשימת מצבי צבעים

ColorStateList הוא אובייקט שאפשר להגדיר ב-XML ולהחיל כצבע שמשתנה בהתאם למצב של האובייקט View שעליו הוא מוחל. לדוגמה, ווידג'ט של Button יכול להיות באחד מהמצבים הבאים: לחוץ, ממוקד או אף אחד מהם. באמצעות רשימת מצבי צבע, אתם יכולים לספק צבע שונה לכל מצב.

אתם מתארים את רשימת המצבים בקובץ XML. כל צבע מוגדר באלמנט <item> בתוך אלמנט <selector> יחיד. כל <item> משתמש במאפיינים שונים כדי לתאר את המצב שבו הוא נמצא בשימוש.

בכל שינוי מצב, המערכת עוברת על רשימת המצבים מלמעלה למטה, ומשתמשת בפריט הראשון שתואם למצב הנוכחי. הבחירה לא מבוססת על ההתאמה "הטובה ביותר", אלא על הפריט הראשון שעומד בקריטריונים המינימליים של המצב.

הערה: אם רוצים לספק משאב צבע סטטי, משתמשים בערך color פשוט.

מיקום הקובץ:
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>
elements:
<selector>
חובה. זהו רכיב הבסיס. מכיל רכיב <item> אחד או יותר.

מאפיינים:

xmlns:android
String. חובה. מגדיר את מרחב השמות של ה-XML, שהוא "http://schemas.android.com/apk/res/android".
<item>
מגדיר צבע לשימוש במצבים מסוימים, כפי שמתואר במאפיינים שלו. הוא צאצא של רכיב <selector>.

מאפיינים:

android:color
צבע הקסדצימלי. חובה. הצבע מצוין באמצעות ערך RGB וערוץ אלפא אופציונלי.

הערך תמיד מתחיל בתו סולמית (#), ואחריו מופיע המידע על Alpha-Red-Green-Blue באחד מהפורמטים הבאים:

  • #RGB
  • #ARGB
  • #RRGGBB
  • #AARRGGBB
android:lStar
נקודה צפה. אופציונלי. המאפיין הזה משנה את הבהירות הנתפסת של צבע הבסיס. הוא מקבל ערך של נקודה צפה (floating-point) בין 0 ל-100 או מאפיין עיצוב שמתפרש ככזה. הצבע הכולל של הפריט מחושב על ידי המרת צבע הבסיס למרחב צבעים שמותאם לנגישות, והגדרת הערך של L* ‎ לערך שצוין במאפיין lStar.

דוגמה: android:lStar="50"

android:state_pressed
בוליאני. "true" אם הפריט הזה משמש כשלוחצים על האובייקט, למשל כשנוגעים בלחצן או לוחצים עליו. הערך הוא "false" אם הפריט הזה משמש במצב ברירת המחדל, ללא הקשה.
android:state_focused
בוליאני. ‫"true" אם הפריט הזה משמש כשהאובייקט נמצא במיקוד, למשל כשכפתור מודגש באמצעות כדור העקיבה או כפתורי החיצים (D-pad). הערך הוא "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" />
מידע נוסף: