Jetpack Compose过滤文本后光标不移动的问题解决

问题根源 #

你当前的LetterOnlyTransformation直接替换整个文本内容，但未同步调整光标位置。当输入非字母字符被过滤后，光标仍停留在原索引位置，而该索引可能已超出过滤后文本的有效范围，导致光标位置异常。

修复方案：调整光标位置 #

修改自定义InputTransformation，在过滤文本的同时计算并设置正确的光标位置：

class LetterOnlyTransformation : InputTransformation {
    override val keyboardOptions: KeyboardOptions?
        get() = KeyboardOptions(keyboardType = KeyboardType.Text)

    override fun TextFieldBuffer.transformInput() {
        val originalText = asCharSequence().toString()
        val filteredValue = originalText.filter { it.isLetter() }
        
        if (filteredValue != originalText) {
            // 记录原光标选中范围
            val originalStart = selectionStart
            val originalEnd = selectionEnd
            
            // 计算原光标范围内被过滤的字符数量，调整新光标位置
            val filteredBeforeStart = originalText.take(originalStart).count { !it.isLetter() }
            val newStart = originalStart - filteredBeforeStart
            val filteredBeforeEnd = originalText.take(originalEnd).count { !it.isLetter() }
            val newEnd = originalEnd - filteredBeforeEnd
            
            // 替换为过滤后的文本
            replace(0, length, filteredValue)
            
            // 设置合法的光标位置，避免超出文本长度
            setSelection(
                start = newStart.coerceIn(0, filteredValue.length),
                end = newEnd.coerceIn(0, filteredValue.length)
            )
        }
    }
}

代码说明 #

1. 记录原光标位置：先保存用户操作前的光标选中起始和结束索引。
2. 计算新光标位置：统计原光标位置前被过滤掉的非字母字符数量，用原索引减去该数量得到过滤后的正确光标位置。
3. 设置合法光标：使用coerceIn确保光标位置始终在过滤后文本的有效范围内，避免越界。

更优实践建议 #

• 组合Transform的顺序：当多个InputTransformation组合使用时（如你代码中的maxLength(6).then(LetterOnlyTransformation())），建议将长度限制类transform放在过滤类之后，避免先截断文本再过滤导致的额外计算，但此顺序不影响光标处理逻辑。
• 覆盖多场景测试：测试时需覆盖在文本中间输入非字母、选中批量文本替换、末尾输入无效字符等场景，确保光标在所有操作下都能正确定位。

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