如何为Android应用的RecyclerView添加可正常交互的滚动条

解决方案 #

1. 修改XML布局中的RecyclerView配置 #

直接在你现有的RecyclerView标签中新增滚动条相关属性，修改后的完整配置如下：

<androidx.recyclerview.widget.RecyclerView
    android:id="@+id/word_list"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:layoutManager="LinearLayoutManager"
    <!-- 滚动条核心配置 -->
    android:scrollbars="vertical"
    android:scrollbarSize="8dp"
    android:scrollbarStyle="outsideInset"
    android:fadeScrollbars="false"
    android:fastScrollEnabled="true"
    android:fastScrollAlwaysVisible="true"
    android:scrollbarThumbVertical="@drawable/scrollbar_thumb"
    android:scrollbarTrackVertical="@drawable/scrollbar_track"
    android:hasFixedSize="true"/>

如果不需要滚动条常驻，可将android:fadeScrollbars改为true、android:fastScrollAlwaysVisible改为false

2. 新增滚动条自定义样式文件 #

在res/drawable目录下新建两个文件，用于固定滚动条样式、扩大触摸响应范围：

scrollbar_thumb.xml（滚动条滑块样式）

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="rectangle">
    <solid android:color="?attr/colorPrimary" />
    <corners android:radius="4dp" />
</shape>

scrollbar_track.xml（滚动条轨道样式）

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="rectangle">
    <solid android:color="@android:color/transparent" />
    <padding android:right="2dp"/>
</shape>

3. 补充Java初始化配置 #

在你初始化RecyclerView的代码段中添加如下配置，修复滚动计算异常问题：

LinearLayoutManager layoutManager = (LinearLayoutManager) word_list.getLayoutManager();
// 优化回收逻辑，避免滚动条计算错误
layoutManager.setRecycleChildrenOnDetach(true);
// 若你的列表item高度固定，开启后滚动条尺寸计算会更准确
word_list.setHasFixedSize(true);
// 开启嵌套滚动，修复滚动条触摸无响应问题
ViewCompat.setNestedScrollingEnabled(word_list, true);

异常原因说明 #

你之前遇到的滚动条变小、无法触摸操作的问题，根源是两个：

• 系统默认滚动条尺寸会随滚动占比动态调整，没有固定尺寸限制
• 默认滚动条的触摸热区极小，手指很难命中
  上述配置固定了滚动条尺寸、扩大了触摸响应范围，同时优化了滚动条的尺寸计算逻辑，可完全解决你遇到的问题。

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