萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 背景選擇器 Selector 完整指南:狀態列表與按鈕樣式自訂

什麼是 StateListDrawable (Selector)?

在 Android 開發中,Selector(狀態列表繪圖)是一種 XML 定義的可繪製資源,能根據 View 的不同狀態(如按下、聚焦、選中、啟用/停用等)自動切換顯示的圖片或顏色。它廣泛用於 ListView 項目背景、Button 背景、文字顏色變化等場景,是打造優質交互體驗的基礎組件。

核心狀態屬性詳解

在 <selector> 根元素下的每個 <item> 可通過以下屬性組合匹配特定狀態:

  • android:state_pressed:是否被按下(true/false)
  • android:state_focused:是否獲得焦點
  • android:state_selected:是否處於選中狀態
  • android:state_checked:CheckBox/RadioButton 是否勾選
  • android:state_checkable:元件是否可勾選
  • android:state_enabled:元件是否啟用(可響應事件)
  • android:state_window_focused:所在 Activity 是否在前台聚焦

注意:系統按 XML 順序從上至下匹配,第一個符合條件的 item 生效。因此默認狀態(無任何屬性)必須放在最後。

實戰範例:ListView 項目背景選擇器

在 res/drawable/list_item_selector.xml 中定義:

<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="https://schemas.android.com/apk/res/android">
    <!-- 按下狀態 -->
    <item android:state_pressed="true" android:drawable="@drawable/item_pressed" />
    <!-- 聚焦且按下(非觸摸模式,如方向鍵操作) -->
    <item android:state_focused="true" android:state_pressed="true" android:drawable="@drawable/item_focused_pressed" />
    <!-- 僅聚焦 -->
    <item android:state_focused="true" android:drawable="@drawable/item_focused" />
    <!-- 選中狀態 -->
    <item android:state_selected="true" android:drawable="@drawable/item_selected" />
    <!-- 窗口失去焦點 -->
    <item android:state_window_focused="false" android:drawable="@drawable/item_default" />
    <!-- 默認狀態(放最後) -->
    <item android:drawable="@drawable/item_default" />
</selector>

套用方式

方法一:XML 佈局直接引用

<ListView
    android:id="@+id/listView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:listSelector="@drawable/list_item_selector" />
<!-- 或在 item 佈局根元素 -->
<LinearLayout ...
    android:background="@drawable/list_item_selector">

方法二:代碼動態設置(需解決黑色背景問題)

Drawable selector = getResources().getDrawable(R.drawable.list_item_selector);
listView.setSelector(selector);
// 關鍵:防止滑動時出現黑色背景
listView.setCacheColorHint(Color.TRANSPARENT); 
// 或在 XML 中:android:cacheColorHint="@android:color/transparent"

進階應用:Button 文字顏色隨狀態變化

建立 res/color/button_text_color.xml(注意放在 color 目錄):

<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="https://schemas.android.com/apk/res/android">
    <item android:state_pressed="true" android:color="#FFFFFF" />
    <item android:state_focused="true" android:color="#FFFFFF" />
    <item android:state_selected="true" android:color="#FFFFFF" />
    <item android:color="#000000" /> <!-- 默認 -->
</selector>

在 Button 中使用:android:textColor="@color/button_text_color"

進階應用:Button 背景漸變與形狀結合

建立 res/drawable/button_bg_selector.xml:

<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="https://schemas.android.com/apk/res/android">
    <item android:state_pressed="true">
        <shape>
            <gradient android:startColor="#8600FF" android:endColor="#4C00B4" android:angle="270" />
            <stroke android:width="2dp" android:color="#000000" />
            <corners android:radius="5dp" />
            <padding android:left="10dp" android:top="10dp" android:right="10dp" android:bottom="10dp" />
        </shape>
    </item>
    <item android:state_focused="true">
        <shape>
            <gradient android:startColor="#EAC100" android:endColor="#D4A800" android:angle="270" />
            <stroke android:width="2dp" android:color="#333333" />
            <corners android:radius="8dp" />
            <padding android:left="10dp" android:top="10dp" android:right="10dp" android:bottom="10dp" />
        </shape>
    </item>
    <item> <!-- 默認 -->
        <shape>
            <solid android:color="#CCCCCC" />
            <corners android:radius="5dp" />
            <padding android:left="10dp" android:top="10dp" android:right="10dp" android:bottom="10dp" />
        </shape>
    </item>
</selector>

佈局中啟用:

<Button
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="提交"
    android:focusable="true"
    android:background="@drawable/button_bg_selector"
    android:textColor="@color/button_text_color" />

常見坑與最佳實踐

  1. 順序至關重要:具體狀態在前,默認狀態在後。
  2. 圖片資源命名:建議用 state_action 後綴(如 btn_pressed.9.png),並提供 .9.png 九宮格圖以適應不同尺寸。
  3. ListView 黑背景:務必設置 android:cacheColorHint="@android:color/transparent"。
  4. 文字顏色 Selector 必須放在 res/color/,放在 drawable 會報錯。
  5. API 21+ 建議使用 RippleDrawable:Material Design 波紋效果更現代,可配合 android:background="?attr/selectableItemBackground" 快速實現。

總結

Selector 是 Android 視覺反饋的核心機制。掌握狀態屬性優先級、XML 順序規則、以及結合 Shape、Gradient、Color State List 等進階技巧,能讓你輕松打造專業級的交互體驗。從簡單的列表項點擊高亮,到複雜的按鈕漸變動畫,靈活運用 Selector 將大幅提升 App 的質感。

copyright © 萬盛學電腦網 all rights reserved