Jetpack Compose Material3中BasicTextField的API变更及参数适配咨询

嗨，我太懂你这种找不到对应示例的抓狂感了！Material3 版本的 BasicTextField 确实做了不少核心API调整，尤其是把之前大家习惯的value和onValueChange给整合了，这也是最容易让人摸不着头脑的点。

先给你拆解下最核心的变化：原来的value参数被完全整合到了state参数里，现在你需要用TextFieldState的实现类（比如MutableTextFieldState()）来管理输入文本的状态。你可以通过state.text直接读取当前输入的内容，修改的话也不用再传单独的回调，直接给state.text赋值就可以了——这相当于把状态和状态更新的逻辑打包到了一起，比之前的写法更简洁。

再给你逐个对应下你列出的新参数和旧版功能的关联，帮你快速适配：

• inputTransformation：就是原来的visualTransformation，用来处理输入内容的可视化转换，比如密码输入时的圆点隐藏、手机号的格式分隔
• outputTransformation：Material3新增的参数，用来处理文本输出时的转换，比如用户复制输入框内容到剪贴板时，自动调整格式
• decorator：这个是用来自定义输入框的装饰区域，比如在输入内容前后加图标、提示文本、计数器之类的，替代了原来需要自己嵌套布局来实现装饰的方式
• lineLimits：比原来的singleLine参数更灵活，支持限制单行、多行最大行数，比如LineLimits.SingleLine()或者LineLimits.MultiLine(max = 5)
• onKeyboardAction：对应原来的onImeActionPerformed，用来处理键盘上的动作按钮（比如完成、发送、下一步）的点击事件
• scrollState：针对多行输入场景，直接传入这个参数就能控制输入框的滚动状态，不用自己额外创建和管理ScrollState了

给你写个简单的实用示例，帮你快速上手：

// 记住输入状态
val textState = remember { MutableTextFieldState() }

BasicTextField(
    state = textState,
    modifier = Modifier.fillMaxWidth().padding(16.dp),
    textStyle = TextStyle(fontSize = 16.sp, color = Color.Black),
    // 限制最多3行输入
    lineLimits = LineLimits.MultiLine(max = 3),
    // 设置键盘为完成按钮
    keyboardOptions = KeyboardOptions.Default.copy(imeAction = ImeAction.Done),
    // 处理键盘完成动作
    onKeyboardAction = { action ->
        if (action == ImeAction.Done) {
            // 这里可以写完成输入后的逻辑，比如收起键盘、提交内容
            println("输入完成，内容是：${textState.text}")
        }
    },
    // 自定义装饰，比如加前缀图标
    decorator = { innerTextField ->
        Row(
            verticalAlignment = Alignment.CenterVertically,
            modifier = Modifier.fillMaxWidth()
        ) {
            Icon(Icons.Default.Edit, contentDescription = "编辑图标", tint = Color.Gray)
            Spacer(modifier = Modifier.width(8.dp))
            // 调用innerTextField渲染核心输入区域
            innerTextField()
        }
    }
)

另外你提到的BasicTextField2，其实它是Material3早期预览阶段的过渡API，现在已经被正式版的BasicTextField替代了，所以不用再纠结它的差异，直接用当前的正式API就行。

备注：内容来源于stack exchange，提问作者JoeHz