Jetpack Compose TextField 如何实现输入字符的可变映射前置处理

现有尝试方案的固有缺陷 #

开发者最初尝试通过基础TextField的回调逻辑实现需求，参考代码如下：

var value by remember { mutableStateOf("") }

TextField(
    value = value,
    onValueChange = {
        // 尝试在此处执行字符映射
        value = it
    }
)

该方案存在无法解决的问题：

• 映射逻辑会对整段全量文本生效，而非仅处理最新输入的单个字符
• 交互过程中手动调整光标位置时，会出现光标错位、文本异常跳转的问题
• 动态调整mapper函数时，已输入的存量文本会被二次映射，不符合预期

注：VisualTransformation无法适配该场景，其设计定位是对全量已输入文本统一应用变换规则，没有能力区分「历史存量文本」和「最新输入字符」的处理边界。

可落地的实现思路 #

核心逻辑是在输入回调中定位文本的实际增量修改段，仅对新增/替换的输入片段应用当前时刻的动态mapper，重组文本后自动校准光标位置，具体流程为：

• 不再仅用纯字符串存储输入状态，而是基于TextFieldValue维护完整的文本+光标位置信息，同时记录上一次处理完成的基准文本
• 每次onValueChange触发时，对比当前输入文本和基准文本的差异，定位实际发生修改的字符区间，提取本次的原始输入片段
• 仅对提取到的原始输入片段调用最新的动态mapper做映射处理，不触碰区间外的存量文本
• 用映射后的片段替换原修改区间内容，重组为完整的展示文本；同时根据映射前后的片段长度差，自动计算修正后的光标位置，避免错位
• 当mapper函数动态调整时，仅对调整完成后的新输入片段生效，不会回溯修改已经输入完成的存量内容，完全匹配需求

核心逻辑参考代码 #

// 维护完整的文本+光标状态
var displayValue by remember { mutableStateOf(TextFieldValue("")) }
// 动态可修改的映射函数，可根据业务逻辑随时更换引用
var dynamicMapper by remember { mutableStateOf { input: String -> input } }

TextField(
    value = displayValue,
    onValueChange = { newInput: TextFieldValue ->
        val oldText = displayValue.text
        val rawInputText = newInput.text

        // 计算新旧文本的实际变化区间（覆盖插入、删除、替换三类场景）
        val changeRange = locateTextChangeRange(oldText, rawInputText)
        val changedRawPart = rawInputText.substring(
            startIndex = changeRange.first,
            endIndex = changeRange.last
        )

        // 仅对本次变化的片段应用动态映射
        val mappedPart = dynamicMapper(changedRawPart)

        // 重组为最终展示文本
        val finalText = oldText.substring(0, changeRange.first) +
                mappedPart +
                rawInputText.substring(changeRange.last)

        // 计算校准后的光标位置，补偿映射带来的长度差
        val adjustedCursorPos = newInput.selection.start +
                (mappedPart.length - changedRawPart.length)

        // 更新状态，带上校准后的光标
        displayValue = TextFieldValue(
            text = finalText,
            selection = TextRange(adjustedCursorPos.coerceIn(0, finalText.length))
        )
    }
)

关键实现注意点 #

• 差异定位逻辑需要覆盖所有输入场景：包括单字符插入、批量粘贴、删除、选中文本替换，不能仅通过长度差简单判断修改位置
• 光标位置必须做长度差补偿，否则当映射后的片段长度和原输入片段不一致时，会出现光标跳转错位
• 动态切换mapper时，不需要额外触发存量文本重处理，自然就只会对后续的新输入片段生效，和需求的“随时间动态调整mapper”完全匹配

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