Android 爬坑之旅：软键盘挡住输入框的终极解决方案

Android

2023-11-18 00:13:49

在 Android 中解决软键盘挡住输入框的问题

在移动应用程序开发中，沉浸式状态栏为用户提供了身临其境般的体验。然而，它也带来了一个独特的挑战：软键盘有时会覆盖输入框，妨碍用户输入。这种问题尤其令人沮丧，特别是当你依赖即时消息或文本输入时。

问题剖析

要解决这个问题，我们需要了解其背后的原因。在 Android 4.4 之前的版本中，系统会自动调整窗口大小以容纳弹出键盘。然而，在 Android 4.4 及更高版本中，这种行为已被弃用。因此，应用程序必须自行处理键盘的显示和隐藏。

解决方案

要解决此问题，我们需要采用一种双管齐下的方法：

调整窗口大小： 当键盘显示时，我们需要调整窗口的大小以腾出键盘的空间。
滚动窗口： 如果输入框被键盘部分遮挡，我们需要滚动窗口以使其可见。

分步指南

1. 监听键盘显示事件

要监听键盘显示事件，我们需要注册一个 ViewTreeObserver，如下所示：

ViewTreeObserver vto = myLayout.getViewTreeObserver();
vto.addOnGlobalLayoutListener(new ViewTreeObserver.OnGlobalLayoutListener() {
    @Override
    public void onGlobalLayout() {
        // 键盘显示时执行的操作
    }
});

2. 调整窗口大小

在键盘显示时，我们需要使用 getWindow().setSoftInputMode() 方法调整窗口大小。具体来说，我们需要使用 ADJUST_RESIZE 标志，如下所示：

getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE);

3. 滚动窗口

如果输入框被键盘部分遮挡，我们需要使用 scrollTo() 方法滚动窗口以使其可见。具体来说，我们需要计算输入框和键盘的相对位置，然后将窗口滚动到适当的位置。

示例代码

以下是一个示例代码，演示如何实现此解决方案：

private void adjustKeyboard() {
    ViewTreeObserver vto = myLayout.getViewTreeObserver();
    vto.addOnGlobalLayoutListener(new ViewTreeObserver.OnGlobalLayoutListener() {
        @Override
        public void onGlobalLayout() {
            Rect r = new Rect();
            myLayout.getWindowVisibleDisplayFrame(r);
            int screenHeight = myLayout.getRootView().getHeight();

            // 键盘显示高度
            int keyboardHeight = screenHeight - r.bottom;

            // 如果键盘显示高度大于 0，则调整窗口大小
            if (keyboardHeight > 0) {
                getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE);

                // 获取输入框的位置
                int[] location = new int[2];
                myInputBox.getLocationOnScreen(location);

                // 计算输入框相对键盘的位置
                int y = location[1] + myInputBox.getHeight();

                // 如果输入框被键盘遮挡，则滚动窗口
                if (y > r.bottom) {
                    myLayout.scrollTo(0, y - r.bottom);
                }
            } else {
                // 键盘隐藏，重置窗口大小
                getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_PAN);
            }
        }
    });
}