res/drawable/checkbox_selector.xml
<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="https://schemas.android.com/apk/res/android">
<!-- 選中狀態 -->
<item android:state_checked="true" android:drawable="@drawable/checkbox_checked" />
<!-- 未選中狀態 -->
<item android:state_checked="false" android:drawable="@drawable/checkbox_unchecked" />
<!-- 可選:按下、不可用等狀態 -->
<item android:state_pressed="true" android:state_checked="true" android:drawable="@drawable/checkbox_checked_pressed" />
<item android:state_pressed="true" android:state_checked="false" android:drawable="@drawable/checkbox_unchecked_pressed" />
<item android:state_enabled="false" android:state_checked="true" android:drawable="@drawable/checkbox_checked_disabled" />
<item android:state_enabled="false" android:state_checked="false" android:drawable="@drawable/checkbox_unchecked_disabled" />
</selector>
res/values/styles.xml
<style name="CustomCheckBox" parent="Widget.AppCompat.CompoundButton.CheckBox">
<item name="android:button">@drawable/checkbox_selector</item>
<item name="android:buttonTint">@null</item> <!-- 禁用 Material 色調覆蓋 -->
<item name="android:layout_width">24dp</item>
<item name="android:layout_height">24dp</item>
<item name="android:minWidth">24dp</item>
<item name="android:minHeight">24dp</item>
<item name="android:paddingLeft">8dp</item> <!-- 文字間距 -->
<item name="android:scaleType">centerInside</item>
</style>
<CheckBox
android:id="@+id/cb_agree"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="同意條款"
style="@style/CustomCheckBox" />
若需更精細控制 (如動畫、不規則形狀),可自建 CustomCheckBox extends AppCompatCheckBox 並覆寫 onDraw()。
<com.google.android.material.checkbox.MaterialCheckBox
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Material 風格"
app:buttonIcon="@drawable/checkbox_selector"
app:useMaterialThemeColors="false" />
| 現象 | 原因 | 解決 |
|---|---|---|
| 圖片不顯示/被拉伸 | 未設 `scaleType` 或 `buttonTint` 干擾 | 加 `android:scaleType="centerInside"`、`buttonTint="@null"` |
| 點擊區域過小 | 圖片本身太小 | 增大 `minWidth/minHeight` 或給父佈局 `padding` |
| 狀態不切換 | Selector 缺少狀態項 | 補齊 `state_checked=true/false` 至少兩項 |