如何为RecyclerView实现随滚动联动的局部半透明锁定遮罩层？

不要在ViewHolder内部添加遮罩，直接在RecyclerView的同层级父容器上叠加自定义遮罩View，通过监听RecyclerView滚动动态计算遮罩的覆盖范围，遮罩自身负责绘制半透明背景和居中的锁定文本，天然满足文本在可见遮罩区居中、随滚动动态移动的需求，性能和可维护性远高于Item内部实现方案。

• 1. 调整布局层级 #

  用FrameLayout/ConstraintLayout作为RecyclerView的父容器，先放置RecyclerView，再放置自定义的LockScrimView，让遮罩层默认叠在RecyclerView上方，初始状态设为GONE。

  核心优势：遮罩是独立于Item的整块View，不会被RecyclerView的回收复用逻辑影响，也不需要遍历多个ViewHolder同步状态。

• 2. 实现自定义遮罩View #

  自定义View只需要做两件事：绘制半透明遮罩背景、在自身区域的正中心绘制“Locked（已锁定）”文本。因为View本身的布局范围会和当前遮罩可见区域完全对齐，文本直接画在View中心就永远符合居中要求，不需要额外计算位置。
  核心代码参考：

  class LockScrimView(context: Context, attrs: AttributeSet?) : View(context, attrs) {
      private val scrimPaint = Paint().apply {
          color = 0x80000000.toInt() // 50%透明度黑色，可按需调整颜色和透明度
      }
      private val textPaint = Paint().apply {
          color = Color.WHITE
          textSize = 48f // 按设计稿调整文字大小
          textAlign = Paint.Align.CENTER
          isAntiAlias = true
      }
      private val lockText = "Locked（已锁定）"
  
      override fun onDraw(canvas: Canvas) {
          // 绘制半透明遮罩
          canvas.drawRect(0f, 0f, width.toFloat(), height.toFloat(), scrimPaint)
          // 计算文字垂直居中位置，绘制居中文字
          val textCenterY = height / 2f - (textPaint.descent() + textPaint.ascent()) / 2f
          canvas.drawText(lockText, width / 2f, textCenterY, textPaint)
      }
  }
  

• 3. 动态计算遮罩范围 #

  给RecyclerView添加滚动监听，每次滚动、布局完成、数据刷新时，计算前20个Item（索引0-19）的当前可见区域，更新遮罩View的布局位置：

  1. 先判断索引19的Item（第20个列表项）是否可见：
     • 如果索引19的Item完全滑出屏幕顶部（当前第一个可见Item位置>19），直接隐藏遮罩
     • 如果索引19的Item还在屏幕下方未显示，说明当前可见的所有列表项都属于前20个锁定范围，遮罩直接覆盖RecyclerView的整个内容区域
     • 如果索引19的Item在屏幕可见范围内，遮罩顶部对齐RecyclerView内容区顶部，底部对齐19号Item的底部边缘，同时不超出RecyclerView的内容区边界
  2. 计算完边界后调用layout()方法更新遮罩View的位置，触发重绘即可。
     核心计算逻辑参考（基于垂直方向LinearLayoutManager）：

  // 初始化时、adapter数据刷新后、view布局完成后都需要调用一次
  private fun updateLockScrim() {
      val layoutManager = recyclerView.layoutManager as LinearLayoutManager
      val parentContainer = recyclerView.parent as ViewGroup
      val holderForPosition19 = recyclerView.findViewHolderForAdapterPosition(19)
  
      val rvContentLeft = recyclerView.left + recyclerView.paddingLeft
      val rvContentRight = recyclerView.right - recyclerView.paddingRight
      val rvContentTop = recyclerView.top + recyclerView.paddingTop
      val rvContentBottom = recyclerView.bottom - recyclerView.paddingBottom
  
      when {
          holderForPosition19 == null -> {
              val firstVisiblePos = layoutManager.findFirstVisibleItemPosition()
              if (firstVisiblePos > 19) {
                  scrimView.visibility = View.GONE
                  return
              }
              // 19号Item在屏幕下方，遮罩盖满整个列表可见区
              scrimView.layout(
                  rvContentLeft, rvContentTop,
                  rvContentRight, rvContentBottom
              )
          }
          else -> {
              // 19号Item在可见区域，获取其相对于父容器的位置
              val itemRect = Rect()
              holderForPosition19.itemView.getDrawingRect(itemRect)
              parentContainer.offsetDescendantRectToMyCoords(holderForPosition19.itemView, itemRect)
              val scrimBottom = min(itemRect.bottom, rvContentBottom).coerceAtLeast(rvContentTop)
              if (scrimBottom <= rvContentTop) {
                  scrimView.visibility = View.GONE
                  return
              }
              scrimView.layout(
                  rvContentLeft, rvContentTop,
                  rvContentRight, scrimBottom
              )
          }
      }
      scrimView.visibility = View.VISIBLE
      scrimView.invalidate()
  }
  
  // 绑定滚动监听
  recyclerView.addOnScrollListener(object : RecyclerView.OnScrollListener() {
      override fun onScrolled(rv: RecyclerView, dx: Int, dy: Int) {
          updateLockScrim()
      }
  })
  

• 如果使用GridLayoutManager、StaggeredGridLayoutManager，只需要修改边界判断逻辑，找到前20个Item中最靠下的可见Item的bottom值作为遮罩底部即可，核心思路不变
• 如果给RecyclerView设置了clipToPadding=false、添加了ItemDecoration，计算边界时需要对应扣除装饰项的偏移量，避免遮罩出现缝隙
• 如果需要禁止用户点击遮罩下方的锁定Item，给scrimView设置isClickable = true即可拦截触摸事件
• 调用Adapter的刷新方法（如notifyDataSetChanged）后，需要手动触发一次updateLockScrim()，避免遮罩位置错位

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