Jetpack Compose LazyList适配键盘滚动问题求助

问题现状 #

在处理应用的IME内边距适配时，遇到以下问题：

• 未添加imePadding()修饰符时，点击列表底部的BasicTextField，光标会被键盘遮挡，Card的部分内容也会被键盘覆盖；
• 给父Column或LazyColumn添加imePadding()后，输入框会上移，但键盘与输入框之间会出现和Footer等高的间隙，不符合预期。

期望效果 #

• 点击输入框时，列表自动滚动（若有需要），确保整个Card完整显示，保留编辑上下文；
• 键盘收起后，列表滚动回之前的位置。

已配置项 #

• AndroidManifest.xml中设置android:windowSoftInputMode="adjustResize"；
• Activity中setContent前调用了WindowCompat.setDecorFitsSystemWindows(window, false)。

解决方案 #

核心思路是利用LazyListState管理列表滚动状态，结合FocusRequester监听输入框焦点变化，再通过系统API监听键盘状态，实现自动滚动与位置恢复：

1. 保存列表初始滚动位置，键盘弹出时滚动到目标Card，确保其完整可见；
2. 键盘收起时，恢复到之前保存的滚动位置；
3. 移除不必要的imePadding()，避免出现额外间隙。

修改后的完整代码 #

@Composable
fun KeyboardExperiment2Screen() {
    val names =
        "Thorin,Balin,Dwalin,Fíli,Kíli,Dori,Nori,Ori,Óin,Glóin,Bifur,Bofur,Bombur".split(',')
    // 管理LazyColumn滚动状态
    val listState = rememberLazyListState()
    // 保存键盘弹出前的滚动位置
    val scrollPosition = remember { mutableStateOf<Int?>(null) }
    // 监听键盘可见性
    val isKeyboardVisible = WindowInsets.isImeVisible
    // 软件键盘控制器
    val keyboardController = LocalSoftwareKeyboardController.current

    Column(
        modifier = Modifier
            .systemBarsPadding()
            .fillMaxSize()
            .background(color = Color.White)
    ) {
        Text(
            text = "HEADER",
            modifier = Modifier
                .fillMaxWidth()
                .height(60.dp)
                .background(color = Color.Cyan),
            textAlign = TextAlign.Center
        )
        LazyColumn(
            modifier = Modifier
                .weight(1f)
                .fillMaxWidth(),
            state = listState
        ) {
            itemsIndexed(names) { index, name ->
                val focusRequester = remember { FocusRequester() }
                // 监听输入框焦点变化
                LaunchedEffect(focusRequester.isFocused) {
                    if (focusRequester.isFocused) {
                        // 保存当前滚动位置
                        scrollPosition.value = listState.firstVisibleItemIndex
                        // 滚动到当前item，确保完整可见，偏移量可根据实际调整
                        listState.animateScrollToItem(
                            index = index,
                            scrollOffset = -60.dp.roundToPx()
                        )
                    } else {
                        // 焦点丢失且键盘收起时，恢复滚动位置
                        if (!isKeyboardVisible && scrollPosition.value != null) {
                            scrollPosition.value?.let {
                                listState.animateScrollToItem(it)
                                scrollPosition.value = null
                            }
                        }
                    }
                }

                MyCard(
                    name = name,
                    age = Random.nextInt(50, 150),
                    favColor = Color.hsv(
                        Random.nextFloat() * 360,
                        Random.nextFloat() * 0.5f + 0.5f,
                        Random.nextFloat() * 0.5f + 0.5f
                    ),
                    height = Random.nextInt(80, 120),
                    weight = Random.nextDouble(50.0, 95.0),
                    background = Color.hsv(
                        ((index * 3) % names.size).toFloat() * 360 / names.size.toFloat(), 0.5f, 1f
                    ),
                    focusRequester = focusRequester
                )
            }
        }
        Text(
            text = "Footer",
            modifier = Modifier
                .fillMaxWidth()
                .height(60.dp)
                .background(color = Color.Gray),
            textAlign = TextAlign.Center
        )
    }
}

@Composable
private fun MyCard(
    name: String,
    age: Int,
    favColor: Color,
    height: Int,
    weight: Double,
    background: Color,
    focusRequester: FocusRequester
) {
    Card(
        modifier = Modifier
            .fillMaxWidth()
            .padding(12.dp),
        colors = CardDefaults.cardColors(containerColor = background)
    ) {
        Column(modifier = Modifier.padding(12.dp)) {
            Row(
                modifier = Modifier
                    .fillMaxWidth()
                    .background(color = Color.LightGray, shape = RoundedCornerShape(percent = 25))
                    .padding(vertical = 6.dp, horizontal = 6.dp),
                verticalAlignment = Alignment.CenterVertically

            ) {
                BasicTextField(
                    value = name,
                    modifier = Modifier
                        .weight(1f)
                        .focusRequester(focusRequester),
                    onValueChange = { update -> println(update) },
                    textStyle = MaterialTheme.typography.bodyLarge,
                    keyboardOptions = KeyboardOptions(imeAction = ImeAction.Done),
                    keyboardActions = KeyboardActions(
                        onDone = {
                            keyboardController?.hide()
                            focusRequester.freeFocus()
                        }
                    )
                )
                Spacer(modifier = Modifier.width(12.dp))
                Box(
                    modifier = Modifier
                        .size(28.dp)
                        .background(color = favColor, shape = RoundedCornerShape(6.dp))
                )
            }
            Spacer(modifier = Modifier.height(8.dp))
            Row(
                modifier = Modifier.fillMaxWidth(),
                verticalAlignment = Alignment.CenterVertically,
                horizontalArrangement = Arrangement.SpaceBetween
            ) {
                val style = MaterialTheme.typography.labelSmall
                Text(text = "Age: $age yr", style = style)
                Text(text = "Height: $height cm", style = style)
                Text(text = "Weight: ${String.format("%.1f", weight)} kg", style = style)
            }
        }
    }
}

关键修改点 #

• 添加rememberLazyListState控制列表滚动，保存键盘弹出前的滚动位置；
• 给每个BasicTextField绑定FocusRequester，监听焦点变化触发滚动逻辑；
• 利用WindowInsets.isImeVisible判断键盘状态，在键盘收起时恢复滚动位置；
• 移除了可能导致间隙的imePadding()，通过滚动偏移量确保Card完整显示；
• 给KeyboardActions添加onDone逻辑，点击完成按钮时收起键盘并释放焦点。

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