منبع فهرست حالت رنگ
با مجموعهها، منظم بمانید
ذخیره و دستهبندی محتوا براساس اولویتهای شما.
ColorStateList
شی ای است که می توانید آن را در XML تعریف کنید و به عنوان رنگی اعمال کنید که در واقع رنگ ها را بسته به وضعیت شی View
که روی آن اعمال می شود تغییر می دهد. برای مثال، یک ویجت Button
میتواند در یکی از چندین حالت وجود داشته باشد: فشرده، متمرکز، یا هیچکدام. با استفاده از فهرست حالت رنگ، می توانید برای هر حالت رنگ متفاوتی ارائه دهید.
شما لیست وضعیت را در یک فایل XML توصیف می کنید. هر رنگ در یک عنصر <item>
در داخل یک عنصر <selector>
تعریف میشود. هر <item>
از ویژگی های مختلفی برای توصیف وضعیتی که در آن استفاده می شود استفاده می کند.
در طول هر تغییر حالت، لیست حالت از بالا به پایین پیمایش می شود و اولین موردی که با وضعیت فعلی مطابقت دارد استفاده می شود. انتخاب بر اساس "بهترین" تطابق نیست ، بلکه اولین موردی است که حداقل معیارهای ایالت را برآورده می کند.
توجه: اگر می خواهید یک منبع رنگ ثابت ارائه کنید، از یک مقدار رنگ ساده استفاده کنید.
- محل فایل:
-
res/color/ filename .xml
نام فایل به عنوان شناسه منبع استفاده می شود. - نوع داده منبع کامپایل شده:
- اشاره گر منبع به
ColorStateList
- مرجع منبع:
- در جاوا:
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
- نقطه شناور . اختیاری این ویژگی درخشندگی ادراکی رنگ پایه را تغییر می دهد. یا یک مقدار ممیز شناور بین 0 تا 100 یا یک ویژگی تم می گیرد که به این ترتیب حل می شود. رنگ کلی مورد با تبدیل رنگ پایه به فضای رنگی مناسب برای دسترسی و تنظیم L* آن بر روی مقدار مشخص شده در ویژگی
lStar
محاسبه می شود. مثال: android:lStar="50"
-
android:state_pressed
- بولی .
"true"
اگر از این مورد در هنگام ضربه زدن به شی استفاده شود، مانند زمانی که دکمه ای لمس یا کلیک می شود. اگر این مورد در حالت پیشفرض و بدون ضربه استفاده شود، "false"
است. -
android:state_focused
- بولی .
"true"
اگر این مورد در هنگام فوکوس کردن شی مورد استفاده قرار گیرد، مانند زمانی که یک دکمه با استفاده از گوی یا پد D برجسته می شود. اگر این مورد در حالت پیشفرض و بدون تمرکز استفاده شود، "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 و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2024-09-09 بهوقت ساعت هماهنگ جهانی.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"اطلاعاتی که نیاز دارم وجود ندارد"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"بیشازحد پیچیده/ مراحل بسیار زیاد"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"قدیمی"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"مشکل ترجمه"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"مشکل کد / نمونهها"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"غیره"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"درک آسان"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"مشکلم را برطرف کرد"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"غیره"
}]
{"lastModified": "\u062a\u0627\u0631\u06cc\u062e \u0622\u062e\u0631\u06cc\u0646 \u0628\u0647\u200c\u0631\u0648\u0632\u0631\u0633\u0627\u0646\u06cc 2024-09-09 \u0628\u0647\u200c\u0648\u0642\u062a \u0633\u0627\u0639\u062a \u0647\u0645\u0627\u0647\u0646\u06af \u062c\u0647\u0627\u0646\u06cc."}
[[["درک آسان","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"]],["تاریخ آخرین بهروزرسانی 2024-09-09 بهوقت ساعت هماهنگ جهانی."]]