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
- رشته. الزامی است. فضای نام XML را تعریف میکند که
"http://schemas.android.com/apk/res/android" است.
<item>
- رنگی را برای استفاده در حالتهای خاص، همانطور که در ویژگیهای آن شرح داده شده است، تعریف میکند. این عنصر فرزند عنصر
<selector> است.
مشخصه ها:
android:color
- رنگ شانزدهشانزدهی. الزامی. رنگ با مقدار RGB و کانال آلفای اختیاری مشخص میشود.
این مقدار همیشه با نویسه پوند (#) شروع میشود و بهدنبال آن
اطلاعات آلفا-قرمز-سبز-آبی در یکی از قالبهای زیر میآید:
- #RGB
- #ARGB
- #RRGGBB
- #AARRGGBB
android:lStar
- ممیز شناور. اختیاری. این مشخصه درخشندگی ادراکی رنگ پایه را اصلاح میکند. این ویژگی یا یک مقدار ممیز شناور بین ۰ و ۱۰۰ یا یک مشخصه زمینه که به این صورت حل میشود را میپذیرد. رنگ کلی مورد با تبدیل رنگ پایه به فضای رنگی مناسب برای دسترسپذیری و تنظیم 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" />
- همچنین مراجعه کنید به:
-
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2026-11-19 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2026-11-19 بهوقت ساعت هماهنگ جهانی."],[],[]]