如何为自定义Button子类中的自定义Drawable应用可设置样式的选择器颜色

我之前踩过一模一样的坑！你猜的没错——Drawable始终保持原有颜色，大概率是这几个核心原因在搞鬼，咱们一步步来解决：

一、先搞懂为什么ColorStateList不生效 #

最常见的两个原因：

• Drawable本身不可着色：比如你用的是带固有颜色的BitmapDrawable（像素里直接存了颜色），或者VectorDrawable没有设置可着色属性；
• 没有正确关联Drawable和Button的状态：要么没调用关键方法，要么Drawable是共享状态导致修改无效。

二、分步解决方案 #

1. 确保你的Drawable支持着色 #

优先推荐用VectorDrawable（天生支持tint，体积小还灵活），如果必须用Bitmap，得把它转换成「模板模式」——只保留Alpha通道，让tint完全控制颜色：

// 工具方法：将Bitmap转为可着色的Alpha通道版本
fun getTintableBitmap(context: Context, resId: Int): Drawable? {
    val originalBitmap = BitmapFactory.decodeResource(context.resources, resId)
    // 创建仅含Alpha通道的Bitmap
    val tintableBitmap = Bitmap.createBitmap(
        originalBitmap.width,
        originalBitmap.height,
        Bitmap.Config.ALPHA_8
    )
    // 将原Bitmap绘制到新的Alpha Bitmap上
    Canvas(tintableBitmap).drawBitmap(originalBitmap, 0f, 0f, Paint())
    return BitmapDrawable(context.resources, tintableBitmap)
}

2. 正确设置Drawable的Tint和状态关联 #

在自定义Button的构造函数或onAttachedToWindow()方法中，按这个流程来：

class CustomButton @JvmOverloads constructor(
    context: Context,
    attrs: AttributeSet? = null,
    defStyleAttr: Int = 0
) : AppCompatButton(context, attrs, defStyleAttr) {

    init {
        setupIcon()
    }

    private fun setupIcon() {
        // 获取Drawable（这里用VectorDrawable举例，Bitmap的话用上面的工具方法）
        val iconDrawable = ContextCompat.getDrawable(context, R.drawable.ic_custom_icon)
            ?.mutate() // 重点！必须mutate，避免修改影响其他地方的同名Drawable

        iconDrawable?.let {
            // 加载ColorStateList（放在res/color/目录下的xml文件）
            val tintList = ContextCompat.getColorStateList(context, R.color.button_icon_tint)
            // 设置Tint列表和混合模式（SRC_IN是最常用的，确保tint覆盖原有颜色）
            it.setTintList(tintList)
            it.setTintMode(PorterDuff.Mode.SRC_IN)
            // 将Drawable设置到Button上（这里设为左侧图标，根据需求调整）
            setCompoundDrawablesWithIntrinsicBounds(it, null, null, null)
        }
    }

    // 关键：确保Button状态变化时，通知Drawable更新状态
    override fun drawableStateChanged() {
        super.drawableStateChanged()
        // 遍历所有CompoundDrawable，同步Button的状态
        compoundDrawables.forEach { drawable ->
            drawable?.state = drawableState
        }
    }
}

3. 正确编写ColorStateList文件 #

在res/color/目录下创建button_icon_tint.xml，定义不同状态的颜色：

<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 按下状态 -->
    <item android:color="@color/icon_pressed_color" android:state_pressed="true"/>
    <!-- 焦点状态 -->
    <item android:color="@color/icon_focused_color" android:state_focused="true"/>
    <!-- 禁用状态 -->
    <item android:color="@color/icon_disabled_color" android:state_enabled="false"/>
    <!-- 默认状态 -->
    <item android:color="@color/icon_normal_color"/>
</selector>

三、避坑总结 #

• 永远记得给Drawable调用mutate()，不然所有使用该Drawable的控件都会共享同一个状态，导致 tint 混乱；
• 必须设置tintMode为SRC_IN（或适合的模式），不然原有颜色可能会和tint叠加显示；
• 重写drawableStateChanged()时一定要调用super.drawableStateChanged()，否则Drawable收不到状态更新的通知；
• 带颜色的Bitmap一定要转成Alpha通道版本，不然tint无法覆盖原有像素颜色。

内容的提问来源于stack exchange，提问作者Andrei Herford