如何修改Material 3 Switch的轮廓颜色？含XML、代码实现及文档指引

一、XML布局方式 #

在布局中通过app:strokeColor属性直接指定轮廓颜色，支持用颜色选择器区分选中/未选中状态：

1. 确保布局文件引入Material命名空间：

xmlns:app="http://schemas.android.com/apk/res-auto"

2. 修改你的MaterialSwitch代码，添加轮廓颜色属性：

<com.google.android.material.materialswitch.MaterialSwitch
    android:layout_width="wrap_content"
    android:layout_height="match_parent"
    android:checked="true"
    android:text="Material 3"
    app:strokeColor="@color/switch_stroke_selector"/>

3. 在res/color目录下创建颜色选择器switch_stroke_selector.xml，定义不同状态的轮廓颜色：

<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 选中状态的轮廓颜色 -->
    <item android:color="@color/your_checked_stroke_color" android:state_checked="true"/>
    <!-- 未选中状态的轮廓颜色 -->
    <item android:color="@color/your_unchecked_stroke_color" android:state_checked="false"/>
    <!-- 默认状态 -->
    <item android:color="@color/your_default_stroke_color"/>
</selector>

若无需区分状态，可直接指定单一颜色：

app:strokeColor="@color/your_single_stroke_color"

二、后端代码方式 #

通过MaterialSwitch的setStrokeColor()方法动态设置轮廓颜色，需构建ColorStateList处理多状态：

val materialSwitch = findViewById<MaterialSwitch>(R.id.your_switch_id)

// 构建颜色状态列表
val strokeColorStateList = ColorStateList(
    arrayOf(
        intArrayOf(android.R.attr.state_checked), // 选中状态
        intArrayOf(-android.R.attr.state_checked), // 未选中状态
        intArrayOf() // 默认状态
    ),
    intArrayOf(
        ContextCompat.getColor(this, R.color.your_checked_stroke_color),
        ContextCompat.getColor(this, R.color.your_unchecked_stroke_color),
        ContextCompat.getColor(this, R.color.your_default_stroke_color)
    )
)

// 设置轮廓颜色
materialSwitch.strokeColor = strokeColorStateList

仅需单一颜色时可简化：

materialSwitch.strokeColor = ColorStateList.valueOf(ContextCompat.getColor(this, R.color.your_single_stroke_color))

三、Material 3 Switch官方文档指引 #

官方文档明确了MaterialSwitch的自定义规则：

• strokeColor是控制轮廓颜色的核心属性，支持颜色值或颜色选择器
• 可在主题中配置switchStrokeColor属性，全局统一所有MaterialSwitch的轮廓样式
• 组件支持state_checked、state_enabled等状态属性，通过颜色选择器可实现多状态适配

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