如何修改基于Material3主题的App所有视图的聚焦高亮颜色？

为什么修改android:colorFocusedHighlight无效？ #

• android:colorFocusedHighlight是Android原生视图组件（如原生Button、TextView）的聚焦高亮颜色配置，仅对非Material设计的组件生效。
• 你的App基于Theme.Material3.Light.NoActionBar主题，大部分使用的是Material3组件（如MaterialButton、MaterialCardView），这类组件的聚焦高亮效果是通过**波纹（Ripple）**实现的，和原生组件的focused highlight机制完全不同，因此修改android:colorFocusedHighlight不会对Material组件产生效果。

正确的修改方式 #

1. 全局修改所有Material组件的聚焦波纹颜色 #

在你的主题样式中添加或修改以下属性：

<style name="YourAppTheme" parent="Theme.Material3.Light.NoActionBar">
    <!-- 快速调整：Material3默认使用此颜色作为聚焦波纹色 -->
    <item name="colorOnSurfaceVariant">@color/your_target_focus_color</item>
    
    <!-- 自定义波纹颜色：支持单一颜色或状态列表颜色 -->
    <item name="rippleColor">@color/your_custom_ripple_color</item>
</style>

• colorOnSurfaceVariant是Material3主题预设的聚焦波纹关联颜色，修改后会全局影响所有Material组件的聚焦高亮效果。
• 若需要区分不同交互状态（如聚焦、按压）的波纹颜色，可以创建一个状态列表颜色资源（res/color/ripple_state_list.xml），再赋值给rippleColor。

2. 单独修改特定Material组件的聚焦波纹颜色 #

如果只需要调整某个组件的效果，直接在布局文件中给该组件设置app:rippleColor属性：

<com.google.android.material.button.MaterialButton
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="测试按钮"
    app:rippleColor="@color/your_target_focus_color" />

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