Material M3禁用状态按钮颜色不符合无障碍对比度要求求助

我们的应用在Google Play发布报告中收到无障碍警告，所有问题均出现在默认Material M3禁用状态的按钮上（未手动设置颜色，仅使用Jetpack Compose的Material M3主题）。报错信息如下：

Recommendation
Consider increasing this item's text foreground to background contrast ratio.

The item's text contrast ratio is 2.27. This ratio is based on an estimated foreground color of <foreground-color-hex> and an estimated background color of <bg-color-hex>. Consider using colors that result in a contrast ratio greater than 4.50 for small text, or 3.00 for large text. This item may be obscured by other on-screen content. Consider manually testing this item's contrast.

我们希望通过全局适配方案修复（不想逐个修改按钮颜色），保证应用包容性；曾尝试手动修改部分按钮但难以适配所有场景，需要Material M3相关的指导方案。

全局修复方案 #

1. 自定义Material M3主题的ColorScheme #

Material M3默认禁用按钮的文本色为onSurfaceVariant，背景色为surfaceVariant，这两个颜色的对比度未达标。你可以直接修改主题的ColorScheme，全局调整这两个颜色：

// 自定义符合对比度要求的颜色方案
val AppColorScheme = lightColorScheme(
    // 保留其他默认颜色，仅调整禁用按钮相关色值
    surfaceVariant = Color(0xFFE5E5E5), // 浅色背景
    onSurfaceVariant = Color(0xFF2D2D2D) // 深色文本，确保对比度≥4.5
).copy(
    // 部分组件会直接使用disabled系列属性，同步配置
    disabled = Color(0xFFE5E5E5),
    onDisabled = Color(0xFF2D2D2D)
)

// 应用自定义主题
MaterialTheme(
    colorScheme = AppColorScheme,
    typography = MaterialTheme.typography,
    shapes = MaterialTheme.shapes
) {
    // 应用内容
}

2. 全局覆盖Button组件样式 #

如果需要更精准控制按钮的禁用状态，可以直接在主题中覆盖Button的默认样式：

val CustomButtonStyle = ButtonDefaults.buttonStyle(
    containerColor = MaterialTheme.colorScheme.primary,
    disabledContainerColor = Color(0xFFE5E5E5),
    contentColor = MaterialTheme.colorScheme.onPrimary,
    disabledContentColor = Color(0xFF2D2D2D)
)

// 全局应用按钮样式
MaterialTheme(
    colorScheme = lightColorScheme(),
    components = MaterialTheme.components.copy(
        button = CustomButtonStyle,
        // 同步配置OutlinedButton等其他按钮类型
        outlinedButton = ButtonDefaults.outlinedButtonStyle(
            disabledBorderColor = Color(0xFFCCCCCC),
            disabledContentColor = Color(0xFF2D2D2D)
        )
    )
) {
    // 应用内容
}

3. 验证对比度合规性 #

修改颜色后，需确认对比度：

• 小文本（≤18sp常规字重）需达到≥4.5的对比度
• 大文本（≥18sp或≥16sp加粗）需达到≥3.0的对比度

4. 全场景测试 #

确保修改在以下场景生效：

• 系统深色/浅色主题切换
• 不同屏幕亮度环境
• 所有按钮类型（Button、OutlinedButton、IconButton等）的禁用状态

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