Android Compose软键盘升降时LazyColumn自然滚动实现方法

要实现Telegram那种软键盘升降时保持浏览内容可见的自然滚动效果，核心是利用Compose的窗口Insets感知能力，结合LazyList的偏移调整，而非生硬调用scrollToItem。以下是具体实现方案：

1. 配置Activity窗口属性 #

在AndroidManifest.xml中给聊天页面的Activity添加软键盘模式配置：

<activity
    android:name=".ui.chat.ChatActivity"
    android:windowSoftInputMode="adjustResize" />

adjustResize会让系统在软键盘弹出时调整窗口大小，确保Compose能正确获取到输入法的Insets信息。

2. 利用WindowInsets处理布局偏移 #

在聊天界面的布局中，给输入框和消息列表添加Insets相关的padding，让布局自动适配软键盘位置：

@Composable
fun ChatScreen() {
    val listState = rememberLazyListState()
    val density = LocalDensity.current
    // 监听输入法Insets变化
    val imeBottom = remember {
        derivedStateOf {
            WindowInsets.ime.getBottom(density)
        }
    }
    val isImeVisible = imeBottom.value > 0

    // 软键盘弹出时自动调整列表位置
    LaunchedEffect(isImeVisible) {
        if (isImeVisible) {
            listState.layoutInfo.visibleItemsInfo.lastOrNull()?.let { lastVisibleItem ->
                // 计算需要滚动的偏移量，确保最后可见项保持在可视区域内
                val viewportEnd = listState.layoutInfo.viewportEndOffset
                val itemBottom = lastVisibleItem.offset + lastVisibleItem.size
                val offsetNeeded = viewportEnd - itemBottom
                if (offsetNeeded < 0) {
                    // 使用animateScrollBy实现平滑偏移，而非直接跳转
                    listState.animateScrollBy(offsetNeeded.toFloat())
                }
            }
        }
    }

    Scaffold(
        bottomBar = {
            // 输入框区域添加IME padding，自动避开软键盘
            TextField(
                value = "",
                onValueChange = {},
                modifier = Modifier
                    .fillMaxWidth()
                    .padding(horizontal = 16.dp, vertical = 8.dp)
                    .windowInsetsPadding(WindowInsets.ime)
            )
        }
    ) { scaffoldPadding ->
        LazyColumn(
            state = listState,
            modifier = Modifier
                .fillMaxSize()
                .padding(scaffoldPadding),
            // 如果聊天消息是从底部往顶部排列，开启reverseLayout
            reverseLayout = true,
            verticalArrangement = Arrangement.Bottom
        ) {
            items(100) { index ->
                ChatMessageItem(text = "消息 $index")
            }
        }
    }
}

@Composable
fun ChatMessageItem(text: String) {
    Text(
        text = text,
        modifier = Modifier
            .fillMaxWidth()
            .padding(horizontal = 16.dp, vertical = 8.dp)
            .background(Color.LightGray, RoundedCornerShape(8.dp))
            .padding(12.dp)
    )
}

关键逻辑说明 #

• 避免生硬滚动：使用animateScrollBy替代scrollToItem，它会基于当前列表位置做平滑偏移，而非直接跳转到指定项，更符合自然滚动的体验。
• 动态监听Insets：通过WindowInsets.ime实时获取软键盘的高度变化，判断软键盘是否显示，只在需要时触发滚动调整。
• 保持可见项位置：计算最后可见项与视口底部的偏移差，仅当项被软键盘遮挡时才调整滚动，确保用户之前浏览的内容始终在可视区域内。

内容的提问来源于stack exchange，提问作者H.JiMan