JKeyboardPanelSwitch项目非全屏主题集成指南

JKeyboardPanelSwitch项目非全屏主题集成指南

JKeyboardPanelSwitch For resolve the layout conflict when keybord & panel are switching (Android键盘面板冲突 布局闪动处理方案) 项目地址: https://gitcode.com/gh_mirrors/jk/JKeyboardPanelSwitch

前言

在Android应用开发中，处理软键盘与自定义面板的切换冲突是一个常见难题。JKeyboardPanelSwitch项目提供了一套优雅的解决方案，本文将重点介绍在非全屏主题或状态栏半透明(fitsSystemWindows=true)场景下的集成方法。

适用场景

本教程适用于以下两种典型场景：

1. 应用使用非全屏主题（未设置FLAG_FULLSCREEN标志）
2. 状态栏为半透明（设置了FLAG_TRANSLUCENT_STATUS标志）且根布局设置了fitsSystemWindows=true属性

集成步骤详解

第一步：AndroidManifest配置

在目标Activity的manifest声明中，必须设置windowSoftInputMode为adjustResize：

<activity
    android:name=".activity.ChattingActivity"
    android:windowSoftInputMode="adjustResize"/>

这个配置确保当软键盘弹出时，系统会调整窗口大小而不是直接覆盖内容。

第二步：布局文件设计

布局设计需要遵循两个核心原则：

1. 根布局必须使用项目提供的专用容器：

   • KPSwitchRootFrameLayout
   • KPSwitchRootLinearLayout
   • KPSwitchRootRelativeLayout

2. 面板布局必须使用对应的面板容器：

   • KPSwitchPanelFrameLayout
   • KPSwitchPanelLinearLayout
   • KPSwitchPanelRelativeLayout

示例代码：

<KPSwitchRootLinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <!-- 主内容区域 -->
    ...

    <KPSwitchPanelLinearLayout
        android:id="@+id/panel_root"
        android:layout_width="match_parent"
        android:layout_height="@dimen/panel_height"
        android:visibility="gone">
        <!-- 面板内容 -->
        ...
    </KPSwitchPanelLinearLayout>

</KPSwitchRootLinearLayout>

第三步：Activity代码实现

在Activity中需要完成两个关键操作：

1. 键盘状态监听

使用KeyboardUtil.attach()方法监听键盘状态：

KeyboardUtil.attach(this, mPanelLayout);

这个方法会：

• 监测键盘的显示/隐藏状态
• 获取键盘的实际高度
• 提供回调接口监听键盘状态变化

2. 冲突处理工具初始化

使用KPSwitchConflictUtil处理键盘与面板的切换冲突：

KPSwitchConflictUtil.attach(mPanelLayout, mPlusIv, mSendEdt);

参数说明：

• mPanelLayout: 面板布局实例
• mPlusIv: 触发切换的按钮（如"+"图标）
• mSendEdt: 接收输入的EditText

3. 返回键处理（可选）

如需在面板显示时按返回键隐藏面板：

@Override
public boolean dispatchKeyEvent(KeyEvent event) {
    if (event.getAction() == KeyEvent.ACTION_UP &&
            event.getKeyCode() == KeyEvent.KEYCODE_BACK) {
        if (mPanelLayout.getVisibility() == View.VISIBLE) {
            KPSwitchConflictUtil.hidePanelAndKeyboard(mPanelLayout);
            return true;
        }
    }
    return super.dispatchKeyEvent(event);
}

实现原理简析

JKeyboardPanelSwitch的核心思想是通过专用容器和工具类实现：

1. 根布局容器：负责正确处理系统窗口插入行为，确保布局不会被软键盘遮挡
2. 面板布局容器：管理与软键盘的高度同步和切换动画
3. 工具类：封装了键盘状态检测和切换逻辑，简化开发者工作

常见问题

1. 为什么必须使用专用容器？ 普通布局无法正确处理系统窗口插入和高度计算，专用容器内部实现了这些特殊逻辑。

2. 如何处理多个面板的情况？ 可以使用KPSwitchConflictUtil.attach()的重载方法，传入多个面板和对应的触发器。

3. 面板高度如何确定？ 建议设置为与键盘高度相近的值，可以通过KeyboardUtil获取实际键盘高度作为参考。

通过遵循本指南的步骤，开发者可以轻松实现平滑的键盘与面板切换效果，避免常见的布局错乱问题。

JKeyboardPanelSwitch For resolve the layout conflict when keybord & panel are switching (Android键盘面板冲突 布局闪动处理方案) 项目地址: https://gitcode.com/gh_mirrors/jk/JKeyboardPanelSwitch