Android软键盘遮挡元素时如何实现布局滚动 避免按钮悬浮在键盘上方

问题根因 #

你当前的滚动失效和配置无效主要是3个核心错误导致的：

1. 布局存在循环约束：NestedScrollView 约束底部在footer上方，但footer又约束底部在NestedScrollView底部，导致布局测量逻辑混乱，软键盘弹出时无法正确计算滚动区域高度
2. NestedScrollView 子布局高度配置错误：内部的ConstraintLayout用了match_parent，不会随内容高度撑开触发滚动
3. 部分场景下adjustResize失效是因为开启了沉浸式状态栏/导航栏，系统不会自动调整布局可用高度

解决步骤 #

1. 修改AndroidManifest配置

确认对应Activity的windowSoftInputMode设置为以下值，不要用adjustPan（adjustPan会直接平移整个布局，不会触发滚动逻辑）：

android:windowSoftInputMode="stateHidden|adjustResize"

如果你的Activity开启了沉浸式/全屏模式，给根布局ConstraintLayout添加android:fitsSystemWindows="true"属性。

2. 修正布局约束和属性

修改后的核心布局代码如下：

<layout xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:app="http://schemas.android.com/apk/res-auto"
        xmlns:tools="http://schemas.android.com/tools">

    <androidx.constraintlayout.widget.ConstraintLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:fitsSystemWindows="true"
        tools:context=".auth.AuthFragment">

        <!-- 添加fillViewport属性，内容不足时撑满滚动区域 -->
        <androidx.core.widget.NestedScrollView
            android:id="@+id/scroll"
            android:layout_width="match_parent"
            android:layout_height="0dp"
            android:fillViewport="true"
            app:layout_constraintTop_toTopOf="parent"
            app:layout_constraintBottom_toTopOf="@id/footer"
            app:layout_constraintStart_toStartOf="parent"
            app:layout_constraintEnd_toEndOf="parent">

            <!-- 子布局高度改为wrap_content，随内容撑开 -->
            <androidx.constraintlayout.widget.ConstraintLayout
                android:id="@+id/authConstraint"
                android:layout_width="match_parent"
                android:layout_height="wrap_content">

                <com.google.android.material.textfield.TextInputLayout
                    android:id="@+id/usernameInputLayout"
                    android:layout_width="384dp"
                    android:layout_height="75dp"
                    app:layout_constraintTop_toTopOf="parent"
                    app:layout_constraintStart_toStartOf="parent"
                    app:layout_constraintEnd_toEndOf="parent">

                    <com.google.android.material.textfield.TextInputEditText
                        android:id="@+id/usernameInputEditText"
                        android:layout_width="match_parent"
                        android:layout_height="wrap_content"/>
                </com.google.android.material.textfield.TextInputLayout>

                <com.google.android.material.button.MaterialButton
                    android:id="@+id/uSubmit"
                    android:layout_width="match_parent"
                    android:layout_height="wrap_content"
                    app:layout_constraintTop_toBottomOf="@+id/usernameInputLayout"
                    app:layout_constraintStart_toStartOf="parent"
                    app:layout_constraintEnd_toEndOf="parent" />

                <com.google.android.material.button.MaterialButton
                    android:id="@+id/uRegistration"
                    android:layout_width="match_parent"
                    android:layout_height="70dp"
                    android:backgroundTint="#2C2C2E"
                    android:text="SIGNIN"
                    android:textSize="30sp"
                    app:layout_constraintTop_toBottomOf="@+id/uSubmit"
                    app:layout_constraintStart_toStartOf="parent"
                    app:layout_constraintEnd_toEndOf="parent"
                    app:layout_constraintBottom_toBottomOf="parent"
                    android:layout_marginTop="24dp"/>
            </androidx.constraintlayout.widget.ConstraintLayout>
        </androidx.core.widget.NestedScrollView>

        <!-- footer约束改为固定在父布局底部，移除和scroll的绑定 -->
        <FrameLayout
            android:id="@+id/footer"
            android:layout_width="match_parent"
            android:layout_height="70dp"
            android:background="@color/black"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintEnd_toEndOf="parent"
            app:layout_constraintStart_toStartOf="parent">

            <androidx.constraintlayout.widget.ConstraintLayout
                android:layout_width="match_parent"
                android:layout_height="match_parent">
                <TextView
                    android:layout_width="wrap_content"
                    android:layout_height="wrap_content"
                    android:text="底部文本"
                    android:textColor="@color/white"
                    app:layout_constraintCenterInParent="true"/>
            </androidx.constraintlayout.widget.ConstraintLayout>
        </FrameLayout>

    </androidx.constraintlayout.widget.ConstraintLayout>
</layout>

3. 特殊场景适配（可选）

如果以上修改后还是无法滚动，大概率是你用了边缘到边缘的沉浸式适配，需要手动监听软键盘高度动态修改滚动区域的底部padding，代码如下：

// 只需要在Fragment onViewCreated中添加即可
ViewCompat.setOnApplyWindowInsetsListener(binding.scroll) { view, insets ->
    val imeHeight = insets.getInsets(WindowInsetsCompat.Type.ime()).bottom
    val navHeight = insets.getInsets(WindowInsetsCompat.Type.navigationBars()).bottom
    view.setPadding(0, 0, 0, imeHeight.coerceAtLeast(navHeight))
    insets
}

这个方案可以保证按钮不会悬浮在软键盘上方，所有表单内容都在滚动区域内，底部文本固定在屏幕最底部不会跟随滚动。

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