Android 爬坑日记：打造丝滑顺畅的输入 DialogFragment

监听 Android 软键盘：打造无缝的输入体验

在移动应用中，DialogFragment 是实现弹出窗口和对话框的常用元素。然而，实现流畅顺滑的输入体验却是一项棘手的任务，需要仔细处理软键盘的监听。本文将深入探讨监听 Android 软键盘的陷阱和解决方案，助力开发者构建用户友好的输入界面。

为什么需要监听软键盘？

软键盘的弹出和隐藏会对 DialogFragment 的布局和定位产生重大影响。如果不进行监听，会出现输入框被软键盘遮挡或 DialogFragment 被软键盘顶出屏幕的情况，严重影响用户输入体验。

监听 Android 软键盘的陷阱

1. 全局监听导致内存泄漏

传统上，使用 ViewTreeObserver 的 addOnGlobalLayoutListener() 方法来监听所有 View 的布局变化，从而检测软键盘状态。然而，这种全局监听方式会占用大量内存，并可能造成内存泄漏。

2. 不同机型适配困难

Android 设备上的软键盘实现千差万别。全局监听方法需要根据不同机型进行调整，适配成本较高。

合理的监听方案

1. 使用局部布局变化监听

针对特定的 DialogFragment，监听其自身的布局变化，而不是全局布局变化。这可以有效减少内存占用，避免内存泄漏。

ViewTreeObserver viewTreeObserver = dialogFragment.getView().getViewTreeObserver();
viewTreeObserver.addOnGlobalLayoutListener(new ViewTreeObserver.OnGlobalLayoutListener() {
    @Override
    public void onGlobalLayout() {
        // 处理软键盘变化
    }
});

2. 区分软键盘显示与隐藏

软键盘的显示和隐藏会导致不同的布局变化。需要通过判断高度变化的方式区分软键盘的状态，以做出不同的处理。

int heightDiff = oldHeight - currentHeight;
if (heightDiff > 100) {
    // 软键盘显示
} else {
    // 软键盘隐藏
}

3. 使用软键盘弹出和隐藏监听

Android 11 引入了新的 API，允许监听软键盘的弹出和隐藏事件。这是一种更为简洁高效的监听方式。

WindowInsetsController controller = dialogFragment.getDialog().getWindow().getInsetsController();
controller.addOnShowListener(new WindowInsetsController.OnShowListener() {
    @Override
    public void onShow(WindowInsetsController controller, WindowInsets insets) {
        // 软键盘显示
    }
});
controller.addOnHideListener(new WindowInsetsController.OnHideListener() {
    @Override
    public void onHide(WindowInsetsController controller) {
        // 软键盘隐藏
    }
});

实现丝滑的输入体验

1. 调整 DialogFragment 位置

当软键盘显示时，需要调整 DialogFragment 的位置，使其不被软键盘遮挡。可以通过设置 DialogFragment 的 Bottom Margin，或者使用 WindowManager 来动态调整位置。

WindowManager.LayoutParams params = dialogFragment.getDialog().getWindow().getAttributes();
params.verticalMargin = 100;

2. 滚动布局以露出输入框

当软键盘显示时，输入框可能会被 DialogFragment 顶出屏幕。需要通过滚动布局的方式，将输入框移动到屏幕可见区域。

scrollView.smoothScrollTo(0, inputBox.getTop());

注意事项

• 监听软键盘的代码应放在 onResume() 方法中，并在 onPause() 方法中解除监听，以避免内存泄漏。
• 注意 Android 不同版本的差异性，及时适配新的 API。
• 确保输入框获取焦点后，不会因为其他 View 的点击事件而失去焦点。

常见问题解答

1. 为什么使用局部布局变化监听而不是全局布局变化监听？

局部布局变化监听可以减少内存占用，避免内存泄漏。全局布局变化监听会监听所有 View 的变化，而局部布局变化监听只监听特定 DialogFragment 的变化，节省了大量资源。

2. 如何区分软键盘显示和隐藏？

可以通过判断 ViewTreeObserver 中高度变化的方式来区分软键盘显示和隐藏。软键盘显示时，高度变化较大（例如超过 100 像素），而软键盘隐藏时，高度变化较小。

3. 如何避免输入框被软键盘遮挡？

可以通过调整 DialogFragment 的位置或滚动布局的方式，避免输入框被软键盘遮挡。调整 DialogFragment 的位置时，可以设置 Bottom Margin 或使用 WindowManager 来动态调整位置。滚动布局时，可以使用 smoothScrollTo() 方法将输入框移动到屏幕可见区域。

4. 如何在 Android 11 上监听软键盘弹出和隐藏？

可以使用 WindowInsetsController 的 addOnShowListener() 和 addOnHideListener() 方法来监听 Android 11 上软键盘的弹出和隐藏事件。

5. 监听软键盘时需要注意什么？

需要确保监听软键盘的代码只在 onResume() 方法中启用，并在 onPause() 方法中解除监听，以避免内存泄漏。同时，还需要注意 Android 不同版本的差异性，及时适配新的 API。