Android selector state_checked XML复选框选中状态样式

state_checked仅对实现checkable接口的控件（如checkbox、radiobutton）生效；顺序上需将state_checked="true"置于state_checked="false"之前；改勾图标用android:button，改背景用android:background；vector drawable在selector中需适配api并显式设tint。

selector 里 state_checked 不生效？先看控件是否支持

Android 的 state_checked 只对实现了 Checkable 接口的控件有效，比如 CheckBox、RadioButton、CompoundButton 子类。直接用在 TextView 或 LinearLayout 上，XML 里写得再对也没反应。

常见错误现象：selector 放进 android:background，但点击后颜色/图片完全不变。

• 确认你用的是 CheckBox（不是 ImageView + 手动 setChecked）
• 别把 selector 设给 android:drawableLeft 这类属性——它不响应 state 变化
• 如果自定义 View，必须重写 setChecked() 和 onCreateDrawableState()，否则系统根本不会推送 state_checked

state_checked="true" 和 state_checked="false" 的顺序很重要

selector 是按从上到下匹配第一条「全满足」的项。如果 state_checked="false" 写在前面，它会拦截所有未选中状态，导致 state_checked="true" 永远没机会生效。

正确顺序必须是：更具体的 state 组合优先，通用兜底放最后。例如：

如此AI员工

国内首个全链路营销获客AI Agent

下载

<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:state_checked="true" android:drawable="@drawable/ic_check_on" />
    <item android:state_checked="false" android:drawable="@drawable/ic_check_off" />
</selector>

• 千万别把 android:state_checked="false" 放第一行
• 如果还要兼容按下态，写成 android:state_checked="true" android:state_pressed="true"，且这一行必须比单 state_checked 更靠前
• 没有显式声明 android:state_checked="false" 时，系统会 fallback 到默认项（即无任何 state 属性的 item），所以兜底项可以不写 state

用在 android:button 还是 android:background？区别很大

state_checked 对这两处的作用机制完全不同：android:button 控制的是复选框小图标的样式（就是那个勾/圆圈），而 android:background 控制的是整个控件的背景区域。

典型误用：想改勾的颜色，却把 selector 塞进 android:background，结果整个按钮背景跟着变，小勾还是系统默认灰。

• 改勾图标 → 用 android:button="@drawable/my_checkbox_selector"
• 改背景色/形状 → 用 android:background="@drawable/my_bg_selector"
• 两个 selector 可以独立存在，互不影响；但别混用，比如给 android:button 塞一个带 state_pressed 的 selector——按钮图标一般不响应 press
• Material 组件如 MaterialCheckBox 默认禁用 android:button，需先设 app:buttonTint="@null" 才能接管

API 21+ 的 vector drawable 作为 selector item 时容易崩

直接把 VectorDrawable XML 当作 android:drawable 值放进 selector，在 Android 5.0 以下会 crash，报 Resources$NotFoundException；5.0+ 虽不崩，但 tint 不生效或 state 切换卡顿。

根本原因是 vector drawable 在 selector 中无法自动适配 state 变化，尤其涉及 tint 或 alpha 动态调整时。

• 稳妥做法：用 AnimatedVectorDrawable 或拆成多个静态 PNG（虽然重）
• 如果坚持用 vector，确保 targetSdk ≥ 24，并在 selector item 中显式加 android:tint，而不是依赖 theme 的 colorControlNormal
• 测试时务必在真机 API 19 和 23 上各点几下，看是否偶现空指针或渲染异常