Compose中BasicTextField输入时如何自定义无障碍语义播报内容

问题本质 #

默认情况下，Compose的BasicTextField输入字符时，辅助功能只会播报单个输入字符，不会自动带上你自定义的附加信息（比如计数器文本）。你不需要对接TextInputService，核心是通过动态更新语义化配置来实现自定义播报内容。

具体实现方案 #

1. 动态生成语义描述 #

在BasicTextField的Modifier.semantics里，不要只写死初始的内容描述，而是基于当前输入文本和计数器值动态生成。每次输入变化时，语义树会自动更新，辅助功能就会播报完整内容。

示例代码：

var text by remember { mutableStateOf("") }
val counterText = "已输入${text.length}个字符"

BasicTextField(
    value = text,
    onValueChange = { text = it },
    modifier = Modifier
        .semantics {
            contentDescription = if (text.isNotEmpty()) "$text, $counterText" else "请输入内容"
        }
)

2. 主动触发播报（可选） #

如果需要输入后立即强制播报，而不是等辅助功能默认触发，可以在onValueChange里调用announceForAccessibility：

onValueChange = {
    text = it
    // 主动触发辅助功能播报
    LocalView.current.announceForAccessibility("$it, $counterText")
}

注意：快速输入时可能会重复播报，可自行添加防抖逻辑优化。

3. 关键注意点 #

• 必须用State变量（比如mutableStateOf）来管理输入文本和计数器，这样Compose才能感知变化并更新语义配置。
• 不要硬编码语义描述，一定要动态关联当前的输入状态。

为什么不用对接TextInputService #

TextInputService主要负责和输入法的交互（比如弹出软键盘、处理输入提交），和辅助功能的播报逻辑完全不相关。辅助功能的内容播报是由Compose的语义系统控制的，所以核心是维护动态的语义描述。

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