منبع فهرست وضعیت رنگ

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" />
همچنین مراجعه کنید به: