如何让Jetpack Compose的ClickableText适配屏幕阅读器无障碍功能

解决方案 #

共有两种可行的实现方式，都可以解决TalkBack不识别可交互属性的问题：

方案1：保留ClickableText，新增无障碍语义配置

你不需要直接替换组件，只需要给ClickableText的Modifier添加semantics配置，显式声明组件的角色为按钮，无障碍服务就会自动识别可交互属性：

// 需要先导入相关依赖
// import androidx.compose.ui.semantics.semantics
// import androidx.compose.ui.semantics.Role

ClickableText(
  text = forgotPasswordAnnotatedString,
  onClick = {
    context.startActivity(intent)
  },
  modifier = Modifier
    .padding(top = mediumPadding)
    // 新增无障碍语义配置
    .semantics {
        // 声明当前组件是按钮类型，TalkBack会自动追加"按钮"提示音和朗读后缀
        role = Role.Button
        // 可选：自定义内容描述，不需要额外提示可以省略该行
        contentDescription = "点击跳转找回密码页面"
    }
)

配置完成后TalkBack聚焦该元素时，会朗读「忘记密码，按钮」，同时会提示用户可双击激活，符合无障碍交互要求。

方案2：改用Button组件（更推荐）

如果你的需求是整段文本全部可点击，直接改用TextButton组件开发成本更低，Button组件默认自带了完整的无障碍适配，不需要额外配置语义，只需要把样式调整为你需要的链接样式即可：

TextButton(
    onClick = { context.startActivity(intent) },
    modifier = Modifier.padding(top = mediumPadding),
    // 不需要默认点击水波纹可以添加以下两行配置：
    // interactionSource = remember { MutableInteractionSource() },
    // indication = null
    colors = ButtonDefaults.textButtonColors(
        contentColor = Color.White
    )
) {
    Text(
        text = stringResource(R.string.forgot_password),
        textDecoration = TextDecoration.Underline,
        fontSize = 16.sp,
        fontWeight = FontWeight.Medium
    )
}

方案选择建议 #

• 如果是一段文本中只有部分子串可点击，选择方案1的ClickableText+语义配置即可
• 如果是整段文本都作为点击入口，方案2的TextButton默认适配更完善，后续维护成本更低

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