本頁面由 Cloud Translation API 翻譯而成。

顏色狀態清單資源

ColorStateList 是可以在 XML 中定義的物件，並會套用為實際隨需變更顏色的顏色得知物件的 View 物件狀態套用。例如 Button 小工具可能存在以下其中一種狀態：已按下、已聚焦或兩者皆非。使用顏色狀態清單即可為每個州提供不同顏色

您可以在 XML 檔案中說明狀態清單。每個顏色都會在單一 <selector> 元素內的 <item> 元素中定義。每<item> 會使用各種屬性，描述要在何種狀態下使用。

每次狀態變更時，狀態清單都會從上到下掃遍，而第一個才會符合目前狀態此選擇不是以「最佳」為依據而是符合狀態最低條件的第一個項目

注意：如要提供靜態顏色資源，請使用簡單的顏色值。

檔案位置：

res/color/filename.xml
系統會把檔案名稱當做資源 ID。

編譯資源資料類型：

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 值和選用的 Alpha 管道。

這個值一律會以井字符號 (#) 字元開頭，後面接 Alpha-Red-Green-Blue 資訊，格式如下：

#RGB
#ARGB
#RRGGBB
#AARRGGBB

android:lStar

浮點值。選用。此屬性會修改基本顏色的感知亮度。這需要介於 0 到 100 之間的浮點值，或是會解析為這類值的主題屬性。項目的整體色彩的計算方式，是將基本顏色轉換為適合無障礙功能的顏色空間並將 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" />

另請參閱：

動畫

可繪項目