Jetpack Compose TextField如何保持光标在可视区域？

直接可行的解决方案 #

要让光标始终处于屏幕可视范围，给你的Column添加滚动支持并配置窗口软输入模式即可，这比临时方案更稳定：

1. 给Column添加滚动与键盘适配修饰符
   在你的AddEditNote.kt中，把原有Column改成可滚动容器，同时加上imePadding()确保键盘弹出时内容有足够的底部留白：

   val scrollState = rememberScrollState()
   
   Column(
       modifier = Modifier
           .fillMaxSize()
           .verticalScroll(scrollState) // 开启垂直滚动
           .imePadding() // 自动适配键盘高度
           .padding(16.dp)
   ) {
       // 原标题TextField
       TextField(
           value = noteTitle,
           onValueChange = { /* 你的更新逻辑 */ },
           label = { Text(stringResource(R.string.title)) },
           modifier = Modifier.fillMaxWidth()
       )
   
       Spacer(modifier = Modifier.height(16.dp))
   
       // 原内容TextField
       TextField(
           value = noteContent,
           onValueChange = { /* 你的更新逻辑 */ },
           label = { Text(stringResource(R.string.content)) },
           modifier = Modifier
               .fillMaxWidth()
               .weight(1f),
           maxLines = Int.MAX_VALUE
       )
   }
   

2. 配置Activity的窗口软输入模式
   确保对应Activity设置adjustResize模式，让系统自动调整窗口大小适配键盘：

   • 代码方式（在Activity的onCreate中）：

     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         window.setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE)
         setContent {
             ZenoteTheme {
                 AddEditNoteScreen(/* 你的参数 */)
             }
         }
     }
     

   • 清单文件方式：

     <activity
         android:name=".ui.screen.add_edit.AddEditNoteActivity"
         android:windowSoftInputMode="adjustResize">
     </activity>
     

进阶优化：自动滚动到聚焦的TextField #

如果希望切换TextField焦点时，自动滚动到对应光标位置，可以用FocusRequester配合LaunchedEffect实现：

val titleFocus = FocusRequester()
val contentFocus = FocusRequester()
val scrollState = rememberScrollState()

// 给标题TextField添加焦点请求器
TextField(
    // ... 其他参数
    modifier = Modifier
        .fillMaxWidth()
        .focusRequester(titleFocus)
)

// 给内容TextField添加焦点请求器
TextField(
    // ... 其他参数
    modifier = Modifier
        .fillMaxWidth()
        .weight(1f)
        .focusRequester(contentFocus)
)

// 监听标题焦点，滚动到顶部
LaunchedEffect(titleFocus) {
    snapshotFlow { titleFocus.isFocused }
        .filter { it }
        .collect {
            scrollState.animateScrollTo(0)
        }
}

// 监听内容焦点，滚动到底部
LaunchedEffect(contentFocus) {
    snapshotFlow { contentFocus.isFocused }
        .filter { it }
        .collect {
            scrollState.animateScrollTo(scrollState.maxValue)
        }
}

关于官方示例的临时方案 #

早期Jetpack Compose版本中，滚动与键盘适配的API不够完善，所以官方会采用临时调整方案。但在Compose 1.2及以上的稳定版本中，上述方案已经可以稳定解决光标遮挡问题，无需再用临时手段。

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