如何处理Accompanist WebView的键盘行为与焦点问题？

核心思路 #

WebView属于Android原生View，并非Compose原生组件，LocalFocusManager无法直接管控它的焦点状态。需要结合Android原生输入法管理器（InputMethodManager）和WebView自身API，才能实现「点击输入框正常弹键盘、点击外部隐藏键盘并清焦点」的需求。

具体实现步骤 #

1. 存储WebView实例并获取输入法管理器 #

在Compose中使用AndroidView包裹WebView时，用remember存储WebView实例，同时获取系统输入法管理器：

val context = LocalContext.current
val inputMethodManager = context.getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager
val webView = remember { mutableStateOf<WebView?>(null) }

2. 为父布局添加外部点击事件 #

给承载WebView的父容器添加点击监听，触发时执行两个核心操作：隐藏软键盘、清除WebView焦点：

Box(
    modifier = Modifier
        .fillMaxSize()
        .pointerInput(Unit) {
            detectTapGestures(onTap = {
                webView.value?.run {
                    // 针对WebView的输入框隐藏键盘
                    inputMethodManager.hideSoftInputFromWindow(windowToken, 0)
                    // 清除WebView的焦点
                    clearFocus()
                }
            })
        }
) {
    // 放置WebView的AndroidView代码
}

3. 配置WebView并确保键盘正常显示 #

在AndroidView的factory中初始化WebView，并通过Manifest配置解决键盘遮挡问题：

WebView初始化代码

AndroidView(
    factory = { ctx ->
        WebView(ctx).apply {
            webView.value = this
            // 基础配置：启用JS、DOM存储等（根据你的网页需求调整）
            settings.javaScriptEnabled = true
            settings.domStorageEnabled = true
            // 加载目标网页
            loadUrl("你的网页地址")
        }
    }
)

Manifest配置（解决键盘遮挡）

在对应Activity的Manifest条目里添加windowSoftInputMode：

<activity
    android:name=".YourComposeActivity"
    android:windowSoftInputMode="adjustResize|stateHidden">
    <!-- 其他Activity配置 -->
</activity>

adjustResize会让Activity布局随键盘弹出自动调整大小，保证输入框不被遮挡；stateHidden确保初始状态键盘不自动弹出。

完整示例代码 #

@Composable
fun WebViewWithKeyboardControl() {
    val context = LocalContext.current
    val inputMethodManager = context.getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager
    val webView = remember { mutableStateOf<WebView?>(null) }

    Box(
        modifier = Modifier
            .fillMaxSize()
            .pointerInput(Unit) {
                detectTapGestures(onTap = {
                    webView.value?.run {
                        inputMethodManager.hideSoftInputFromWindow(windowToken, 0)
                        clearFocus()
                    }
                })
            }
    ) {
        AndroidView(
            factory = { ctx ->
                WebView(ctx).apply {
                    webView.value = this
                    settings.javaScriptEnabled = true
                    settings.domStorageEnabled = true
                    loadUrl("https://example.com") // 替换为你的目标网页
                }
            }
        )
    }
}

关键说明 #

• LocalFocusManager仅对Compose原生可聚焦组件（如TextField）生效，WebView需用Android原生API处理焦点和键盘。
• hideSoftInputFromWindow必须传入WebView的windowToken，才能精准针对WebView的输入框隐藏键盘。
• adjustResize是解决键盘遮挡输入框的核心配置，确保WebView所在布局能自适应键盘高度。

内容的提问来源于stack exchange，提问作者c-an