Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.
משאב רשימת מצבי צבעים
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
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" />
- מידע נוסף:
-
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2026-11-19 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2026-11-19 (שעון UTC)."],[],[]]