如何在Android Studio Kotlin中为RecyclerView实现快速滚动

你已经在XML里给RecyclerView加了app:fastScrollEnabled="true"，但没看到效果大概率是因为缺少样式配置，按下面步骤来就能搞定：

• 第一步：配置快速滚动样式
  在res/values/styles.xml里添加自定义样式：

<style name="RecyclerViewFastScroll" parent="Widget.MaterialComponents.RecyclerView.FastScroll">
    <!-- 滚动条轨道背景 -->
    <item name="fastScrollTrackDrawable">@drawable/fast_scroll_track</item>
    <!-- 滚动滑块 -->
    <item name="fastScrollThumbDrawable">@drawable/fast_scroll_thumb</item>
    <!-- 滑块最小点击尺寸，符合Material Design规范 -->
    <item name="fastScrollThumbMinimumSize">48dp</item>
</style>

• 第二步：关联样式到RecyclerView
  有两种方式：

  1. 全局生效：在你的App主题里添加这个配置，这样所有RecyclerView都能用：

  <style name="Theme.PhonePapers" parent="...">
      <!-- 其他主题配置 -->
      <item name="androidx.recyclerview.widget.RecyclerView">@style/RecyclerViewFastScroll</item>
  </style>
  

  2. 单独给这个RecyclerView生效：修改你的XML里的RecyclerView标签，加上样式属性：

  <androidx.recyclerview.widget.RecyclerView
      android:id="@+id/abstract_recyclerView"
      android:layout_width="match_parent"
      android:layout_height="match_parent"
      app:layout_constraintEnd_toEndOf="parent"
      app:layout_constraintStart_toStartOf="parent"
      app:layout_constraintTop_toTopOf="parent"
      app:fastScrollEnabled="true"
      app:fastScrollStyle="@style/RecyclerViewFastScroll"/>
  

• 第三步：创建滚动条和滑块的Drawable资源
  在res/drawable目录下创建两个文件：

  1. fast_scroll_track.xml（滚动条轨道）：

  <shape xmlns:android="http://schemas.android.com/apk/res/android"
      android:shape="rectangle">
      <solid android:color="#20000000"/> <!-- 半透明黑色，不遮挡内容 -->
      <corners android:radius="24dp"/> <!-- 圆角更美观 -->
  </shape>
  

  2. fast_scroll_thumb.xml（滚动滑块）：

  <shape xmlns:android="http://schemas.android.com/apk/res/android"
      android:shape="rectangle">
      <solid android:color="@color/orange"/> <!-- 和你的订阅按钮颜色统一 -->
      <corners android:radius="24dp"/>
  </shape>
  

• 第四步：检查依赖版本
  确保你的RecyclerView依赖是最新稳定版，在Module的build.gradle里：

implementation 'androidx.recyclerview:recyclerview:1.3.2'

做完这些，你的RecyclerView就能显示出正常的快速滚动滑块，用户拖动就能快速定位到列表不同位置了。另外注意，快速滚动只支持LinearLayoutManager和GridLayoutManager，如果你用的是其他布局管理器可能需要额外适配，壁纸应用一般用这两种足够。

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