Jetpack Compose：阻止键盘弹出时背景被拉伸

你遇到的问题是因为adjustResize会缩小Activity窗口的可用高度，而背景组件默认会填充整个窗口，导致被压缩拉伸。以下是几种针对Jetpack Compose的解决方案：

方案1：给背景图设置合适的缩放模式 #

如果背景是用Image组件实现的，通过contentScale属性控制缩放逻辑，避免拉伸：

Image(
    painter = painterResource(id = R.drawable.your_background),
    contentDescription = "页面背景",
    modifier = Modifier.fillMaxSize(),
    contentScale = ContentScale.Crop // 保持比例裁剪，不会拉伸
    // 或用ContentScale.Fit：保持比例适应窗口，可能留空白
)

方案2：分层布局，固定背景层 #

用Box将背景和内容分层，背景层固定尺寸不随窗口调整，仅内容层响应键盘：

Box(modifier = Modifier.fillMaxSize()) {
    // 底层背景，匹配父布局大小，不受窗口resize影响
    Image(
        painter = painterResource(id = R.drawable.your_background),
        contentDescription = "页面背景",
        modifier = Modifier.matchParentSize(),
        contentScale = ContentScale.Crop
    )
    // 上层内容，随键盘上移
    Column(
        modifier = Modifier
            .fillMaxSize()
            .verticalScroll(rememberScrollState()) // 内容过长时可滚动
    ) {
        // 你的文本框、按钮等交互控件
        TextField(value = "", onValueChange = {})
        Button(onClick = {}) { Text("提交") }
        // ...其他内容
    }
}

方案3：手动处理键盘Insets（更灵活） #

借助Compose的WindowInsets获取键盘高度，动态调整内容的底部内边距，同时保持背景固定：

val imeInsets = WindowInsets.ime.asPaddingValues()

Box(modifier = Modifier.fillMaxSize()) {
    Image(
        painter = painterResource(id = R.drawable.your_background),
        contentDescription = "页面背景",
        modifier = Modifier.matchParentSize(),
        contentScale = ContentScale.Crop
    )
    Column(
        modifier = Modifier
            .fillMaxSize()
            .padding(bottom = imeInsets.calculateBottomPadding()) // 适配键盘高度
            .verticalScroll(rememberScrollState())
    ) {
        // 你的交互内容
    }
}

备选：替换windowSoftInputMode为adjustPan #

如果页面内容高度不大，可以把android:windowSoftInputMode改成adjustPan：

android:windowSoftInputMode="adjustPan"

这种模式下窗口不会缩小，只是整体上移，背景不会拉伸，但顶部内容可能被移出屏幕，适合短页面场景。

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