如何通过Jetpack Compose内置API将所有Text组件文本设为完全不透明

现象原因 #

你观察到的文本自带透明度是Jetpack Compose Material库的默认行为：Material Design规范针对不同场景的文本定义了高、中、禁用三个层级的内容透明度，当Text未显式指定color参数时，会自动根据当前父容器Surface的颜色角色（比如示例中使用的primary），调用对应等级的透明度叠加到文本色上，所以出现了半透明效果。

内置统一配置方案 #

Jetpack Compose提供了两种原生方案可以全局实现所有文本完全不透明，无需自定义封装Text组件：

方案1：全局覆盖内容透明度（推荐，改动量最小）

通过CompositionLocalProvider覆盖LocalContentAlpha这个全局配置项，所有未显式指定颜色的组件（包括Text、Icon等）都会默认使用完全不透明的内容色，直接在你的自定义主题包裹层添加配置即可：

@Composable
fun ColorsTestTheme(
    darkTheme: Boolean = isSystemInDarkTheme(),
    content: @Composable () -> Unit
) {
    val colors = if (darkTheme) {
        DarkColorPalette
    } else {
        LightColorPalette
    }

    MaterialTheme(
        colors = colors,
        typography = Typography,
        shapes = Shapes
    ) {
        // 全局设置内容透明度为完全不透明
        CompositionLocalProvider(
            LocalContentAlpha provides 1f,
            content = content
        )
    }
}

方案2：修改Typography文本样式（仅作用于Text组件）

如果你只需要Text组件完全不透明，不想影响Icon等其他组件的默认透明度，可以在定义主题的Typography时，给所有文本样式统一指定alpha为1f：

val AppTypography = Typography(
    h1 = TextStyle(
        fontWeight = FontWeight.Light,
        fontSize = 96.sp,
        alpha = 1f
    ),
    h2 = TextStyle(
        fontWeight = FontWeight.Light,
        fontSize = 60.sp,
        alpha = 1f
    ),
    // 依次给h3、h4、h5、h6、subtitle1、subtitle2、body1、body2、button、caption、overline所有内置文本样式添加alpha=1f配置
)

配置完成后在MaterialTheme的typography参数传入该自定义Typography即可。

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