Android中为禁用滚动的RecyclerView实现可编程控制的自定义滚动条

完全可以实现独立于RecyclerView自身滚动功能的自定义滚动条，并通过编程控制其滚动行为，具体实现步骤如下：

1. 布局中添加独立滚动条控件 #

在布局文件里将滚动条与RecyclerView并列摆放，可选择用SeekBar快速实现，或自定义View绘制更个性化的滚动条：

示例布局（SeekBar作为滚动条） #

<RelativeLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/recyclerView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:scrollbars="none"
        android:enabled="false"/> <!-- 禁用RecyclerView滚动 -->

    <!-- 垂直滚动条，通过旋转270度实现竖向显示 -->
    <SeekBar
        android:id="@+id/customScrollbar"
        android:layout_width="wrap_content"
        android:layout_height="match_parent"
        android:layout_alignParentEnd="true"
        android:rotation="270"
        android:progressDrawable="@drawable/scrollbar_bg"
        android:thumb="@drawable/scrollbar_thumb"/>
</RelativeLayout>

2. 计算滚动条与内容的映射关系 #

如果需要让滚动条位置与RecyclerView内容对应，需先计算内容总高度，再建立偏移量与滚动条位置的比例关系：

// 计算RecyclerView内容总高度（适用于LinearLayoutManager）
fun calculateTotalContentHeight(recyclerView: RecyclerView): Int {
    val layoutManager = recyclerView.layoutManager as LinearLayoutManager
    var totalHeight = 0
    for (i in 0 until layoutManager.itemCount) {
        layoutManager.findViewByPosition(i)?.let {
            totalHeight += it.height
        }
    }
    return totalHeight
}

3. 编程控制滚动条行为 #

控制SeekBar类型滚动条 #

通过设置progress直接控制滑块位置，若需关联内容，同步调整RecyclerView显示位置：

val scrollbar = findViewById<SeekBar>(R.id.customScrollbar)
val recyclerView = findViewById<RecyclerView>(R.id.recyclerView)

// 初始化滚动条最大进度（滑块可移动的总范围）
scrollbar.max = scrollbar.height - scrollbar.thumb.height

// 示例：编程将滚动条定位到50%位置
val targetProgress = (scrollbar.max * 0.5).toInt()
scrollbar.progress = targetProgress

// 可选：滚动条位置变化时，同步RecyclerView内容显示
scrollbar.setOnSeekBarChangeListener(object : SeekBar.OnSeekBarChangeListener {
    override fun onProgressChanged(seekBar: SeekBar?, progress: Int, fromUser: Boolean) {
        val totalContentHeight = calculateTotalContentHeight(recyclerView)
        val scrollRatio = progress.toFloat() / seekBar!!.max
        val targetOffset = (totalContentHeight * scrollRatio).toInt()
        
        // 强制RecyclerView滚动到对应偏移位置（不受禁用滚动影响）
        val layoutManager = recyclerView.layoutManager as LinearLayoutManager
        var accumulatedHeight = 0
        var targetPosition = 0
        while (targetPosition < layoutManager.itemCount) {
            layoutManager.findViewByPosition(targetPosition)?.let {
                accumulatedHeight += it.height
                if (accumulatedHeight >= targetOffset) {
                    val offset = accumulatedHeight - targetOffset
                    layoutManager.scrollToPositionWithOffset(targetPosition, offset)
                    return@onProgressChanged
                }
            }
            targetPosition++
        }
    }

    override fun onStartTrackingTouch(seekBar: SeekBar?) {}
    override fun onStopTrackingTouch(seekBar: SeekBar?) {}
})

自定义View类型滚动条 #

若需要更灵活的样式，可自定义View绘制滚动条，通过外部方法控制位置：

class CustomScrollbar @JvmOverloads constructor(
    context: Context, attrs: AttributeSet? = null, defStyleAttr: Int = 0
) : View(context, attrs, defStyleAttr) {

    private val bgPaint = Paint().apply {
        color = Color.parseColor("#E0E0E0")
    }

    private val thumbPaint = Paint().apply {
        color = Color.parseColor("#666666")
    }

    private var thumbY = 0f
    private val thumbHeight = 80f
    private var maxScrollRange = 0f

    // 外部调用此方法设置滚动比例（0~1）
    fun setScrollRatio(ratio: Float) {
        val clampedRatio = ratio.coerceIn(0f, 1f)
        thumbY = clampedRatio * maxScrollRange
        invalidate()
    }

    override fun onSizeChanged(w: Int, h: Int, oldw: Int, oldh: Int) {
        super.onSizeChanged(w, h, oldw, oldh)
        maxScrollRange = h - thumbHeight
    }

    override fun onDraw(canvas: Canvas?) {
        super.onDraw(canvas)
        canvas ?: return
        // 绘制滚动条背景
        canvas.drawRect(0f, 0f, width.toFloat(), height.toFloat(), bgPaint)
        // 绘制滑块
        canvas.drawRect(0f, thumbY, width.toFloat(), thumbY + thumbHeight, thumbPaint)
    }
}

使用时直接调用方法控制：

val customScrollbar = findViewById<CustomScrollbar>(R.id.customScrollbar)
// 滚动到30%位置
customScrollbar.setScrollRatio(0.3f)

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