布局覆盖RecyclerView而非将其向上顶起的问题排查

问题描述 #

Fragment布局包含RecyclerView和底部输入栏（EditText最小高度50dp、最大高度100dp），存在两个问题：

• 滚动RecyclerView到最后一项时，内容被EditText覆盖，未被向上顶起；
• 点击EditText时，RecyclerView无法显示最后一条消息。

解决方案 #

一、布局与配置调整 #

1. 设置Activity软键盘模式

在AndroidManifest.xml中给对应Activity添加软键盘调整模式，确保软键盘弹出时布局自动重计算：

<activity
    android:name=".ui.main.fragments.ChatMessageFragment所在的Activity"
    android:windowSoftInputMode="adjustResize" />

2. 修改Fragment布局

调整RecyclerView的内边距与约束，确保最后一项不会被输入栏遮挡，同时保证输入栏高度变化时能正确挤压RecyclerView：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout 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"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".ui.main.fragments.ChatMessageFragment">

    <!-- 聊天消息列表 -->
    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/rvChatMessage"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:clipToPadding="false"
        android:paddingBottom="66dp" <!-- 预留输入栏最小高度+上下padding的空间 -->
        app:layout_constraintBottom_toTopOf="@+id/constraintLayoutEditTextHolder"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

    <!-- 输入栏容器 -->
    <androidx.constraintlayout.widget.ConstraintLayout
        android:id="@+id/constraintLayoutEditTextHolder"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:paddingTop="8dp"
        android:paddingBottom="8dp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintStart_toStartOf="parent">

        <ImageView
            android:id="@+id/ivProfilePicSender"
            android:layout_width="30dp"
            android:layout_height="30dp"
            android:layout_marginStart="8dp"
            android:src="@drawable/profilepic"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintStart_toStartOf="parent" />

        <ImageView
            android:id="@+id/ivSendMessage"
            android:layout_width="30dp"
            android:layout_height="30dp"
            android:layout_marginEnd="8dp"
            android:src="@drawable/send_24px"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintEnd_toEndOf="parent" />

        <EditText
            android:id="@+id/editTextChatMessage"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_marginStart="8dp"
            android:layout_marginEnd="8dp"
            android:background="@drawable/et_box"
            android:ems="10"
            android:hint="Message @john_doe"
            android:inputType="textMultiLine"
            android:maxHeight="100dp"
            android:minHeight="50dp"
            android:paddingStart="4dp"
            android:paddingEnd="4dp"
            android:scrollbars="vertical"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintEnd_toStartOf="@+id/ivSendMessage"
            app:layout_constraintStart_toEndOf="@+id/ivProfilePicSender"
            app:layout_constraintTop_toTopOf="parent" />
    </androidx.constraintlayout.widget.ConstraintLayout>

</androidx.constraintlayout.widget.ConstraintLayout>

二、代码逻辑处理 #

在Fragment的onViewCreated方法中添加以下逻辑，确保EditText状态变化时RecyclerView自动滚动到底部：

1. 监听EditText高度变化

当EditText从最小高度扩展到最大高度时，触发RecyclerView滚动：

val editText = view.findViewById<EditText>(R.id.editTextChatMessage)
val recyclerView = view.findViewById<RecyclerView>(R.id.rvChatMessage)

// 监听EditText高度变化
editText.viewTreeObserver.addOnGlobalLayoutListener(object : ViewTreeObserver.OnGlobalLayoutListener {
    override fun onGlobalLayout() {
        editText.viewTreeObserver.removeOnGlobalLayoutListener(this)
        var lastHeight = editText.height
        editText.viewTreeObserver.addOnGlobalLayoutListener(object : ViewTreeObserver.OnGlobalLayoutListener {
            override fun onGlobalLayout() {
                val currentHeight = editText.height
                if (currentHeight != lastHeight) {
                    lastHeight = currentHeight
                    recyclerView.post {
                        recyclerView.scrollToPosition(recyclerView.adapter?.itemCount?.minus(1) ?: 0)
                    }
                }
            }
        })
    }
})

2. 监听EditText点击事件

点击EditText时自动滚动到最后一条消息：

editText.setOnClickListener {
    recyclerView.post {
        recyclerView.scrollToPosition(recyclerView.adapter?.itemCount?.minus(1) ?: 0)
    }
}

3. 可选：新消息自动滚动

如果需要新消息到来时自动滚动到底部，可添加以下方法：

fun scrollToBottom() {
    recyclerView.post {
        recyclerView.scrollToPosition(adapter.itemCount - 1)
    }
}

关键说明 #

• android:windowSoftInputMode="adjustResize"：保证软键盘弹出时布局向上调整，避免RecyclerView被遮挡；
• android:clipToPadding="false" + android:paddingBottom：让RecyclerView的最后一项可以滚动到内边距区域，不会被输入栏遮挡；
• 高度变化监听：解决EditText高度扩展时，RecyclerView未自动调整的问题。

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