Jetpack Compose中如何优化密码输入框的TalkBack播报，仅保留输入原字符的播报

我太懂你这个困扰了——每次输入密码字符，TalkBack非要把原字符和它转成的圆点都念一遍，重复又啰嗦，完全没必要！之前你尝试的hideFromAccessibility()确实能解决播报问题，但把输入框的其他无障碍特性也给丢了，得不偿失。咱们可以从自定义语义配置入手，既保留输入框的无障碍能力，又让TalkBack只播报你输入的原字符。

核心思路 #

TalkBack默认会读取输入框经过视觉转换后的文本内容，所以咱们要做的就是告诉它：“别读转换后的圆点，直接读用户实际输入的内容！”通过Modifier.semantics()可以覆盖输入框的无障碍播报内容，同时不影响其他功能。

修改后的代码示例 #

咱们基于你现有的代码调整，主要改动在TextInput组件里添加语义配置，同时确保视觉转换逻辑不干扰语义传递：

private var job: Job? = null

@Composable
internal fun PasswordTextInput(
    value: String,
    onValueChange: (String) -> Unit,
    hint: String,
    enabled: Boolean = true,
) {
    val mask = '\u2022'
    val visualTransformation: MutableState<VisualTransformation> = remember {
        mutableStateOf(PasswordVisualTransformation(mask))
    }

    TextInput(
        value,
        onValueChange = { string ->
            job?.cancel()
            if (string.length > value.length) {
                visualTransformation.value = MaskAllExceptLastChar(mask)
                job = CoroutineScope(Dispatchers.Default).launch {
                    delay(1000)
                    visualTransformation.value = PasswordVisualTransformation(mask)
                }
            } else {
                visualTransformation.value = PasswordVisualTransformation(mask)
            }
            onValueChange(string)
        },
        hint,
        enabled,
        visualTransformation = visualTransformation.value
    )
}

@Composable
internal fun TextInput(
    value: String,
    onValueChange: (String) -> Unit,
    hint: String,
    enabled: Boolean = true,
    visualTransformation: VisualTransformation = VisualTransformation.None,
) {
    val interactionSource = remember { MutableInteractionSource() }
    val isFocused = interactionSource.collectIsFocusedAsState()

    OutlinedTextField(
        value = value,
        onValueChange = onValueChange,
        placeholder = { Text(text = if(isFocused.value) "" else hint) },
        label = { Text(text = hint) },
        visualTransformation = visualTransformation,
        singleLine = true,
        keyboardOptions = KeyboardOptions(
            keyboardType = if(visualTransformation != VisualTransformation.None) 
                KeyboardType.Password else KeyboardType.Text
        ),
        enabled = enabled,
        interactionSource = interactionSource,
        modifier = Modifier
            .fillMaxWidth()
            .padding(top = Dimensions.TextInputPaddingVertical)
            // 关键：添加语义配置，让TalkBack读取原始输入值
            .semantics {
                contentDescription = value
                // 可选：保留输入框的"编辑框"语义提示
                role = Role.TextField
            }
    )
}

private class MaskAllExceptLastChar(val mask: Char) : VisualTransformation {
    override fun filter(text: AnnotatedString): TransformedText {
        return if (text.isEmpty()) {
            TransformedText(AnnotatedString(text.text), OffsetMapping.Identity)
        } else {
            val maskedText = mask.toString().repeat(text.length - 1) + text.last()
            // 保留原始文本的语义标注，避免丢失无障碍信息
            TransformedText(
                AnnotatedString(maskedText, text.spanStyles, text.paragraphStyles),
                OffsetMapping.Identity
            )
        }
    }

    override fun equals(other: Any?): Boolean {
        if (this === other) return true
        if (other !is MaskAllExceptLastChar) return false
        if (mask != other.mask) return false
        return true
    }

    override fun hashCode(): Int {
        return mask.hashCode()
    }
}

为什么这样改？ #

1. 语义覆盖：通过semantics里的contentDescription = value，直接告诉TalkBack要播报的是用户实际输入的字符串，而非转换后的圆点。这样输入“a”时，只会播报“a”。
2. 保留无障碍特性：没有用hideFromAccessibility()，所以输入框的焦点状态、标签提示、编辑框角色等无障碍信息都能正常被TalkBack识别。
3. 语义传递完整：在MaskAllExceptLastChar的filter方法中，保留了原始文本的spanStyles和paragraphStyles，确保任何附加的语义信息不会丢失。

额外提示 #

如果你担心输入密码时播报完整的密码内容不安全，可以针对输入场景调整：比如只播报最近输入的单个字符，而不是整个密码串。只需要把contentDescription改成value.takeLast(1)即可，这样输入时只会播报刚输入的那个字符，既解决重复播报问题，又兼顾安全性。

内容来源于stack exchange