如何让横向RecyclerView单元格内的Header在滚动时保持固定

针对你提出的横向RecyclerView中单元格Header固定的需求，我整理了两种可行的实现思路，对应你提到的两个方向：

方案一：让Header独立于RecyclerView，固定显示 #

这种思路是把原本放在单元格内的Header抽离出来，放到RecyclerView的外层布局中，通过监听RecyclerView的滚动状态，动态同步当前可见单元格的Header内容，让它看起来和单元格绑定但不随滚动移动。

具体步骤： #

1. 调整布局结构：在外层用FrameLayout或RelativeLayout，将固定Header和RecyclerView叠放，Header放在上层。

   <FrameLayout
       android:layout_width="match_parent"
       android:layout_height="wrap_content">
       
       <!-- 固定显示的Header -->
       <TextView
           android:id="@+id/fixed_header"
           android:layout_width="wrap_content"
           android:layout_height="wrap_content"
           android:background="#f0f0f0"
           android:padding="16dp"/>
       
       <!-- 横向RecyclerView -->
       <androidx.recyclerview.widget.RecyclerView
           android:id="@+id/horizontal_recycler"
           android:layout_width="match_parent"
           android:layout_height="wrap_content"
           android:orientation="horizontal"/>
   </FrameLayout>
   

2. 监听滚动同步Header内容：给RecyclerView添加滚动监听，实时获取当前第一个可见单元格的Header内容，同步到外层的固定Header上。

   val recyclerView = findViewById<RecyclerView>(R.id.horizontal_recycler)
   val fixedHeader = findViewById<TextView>(R.id.fixed_header)
   val layoutManager = LinearLayoutManager(this, LinearLayoutManager.HORIZONTAL, false)
   recyclerView.layoutManager = layoutManager
   recyclerView.adapter = YourAdapter(dataList)
   
   recyclerView.addOnScrollListener(object : RecyclerView.OnScrollListener() {
       override fun onScrolled(recyclerView: RecyclerView, dx: Int, dy: Int) {
           super.onScrolled(recyclerView, dx, dy)
           // 获取第一个可见的单元格位置
           val firstVisiblePos = layoutManager.findFirstVisibleItemPosition()
           // 获取对应ViewHolder，同步Header内容
           recyclerView.findViewHolderForAdapterPosition(firstVisiblePos)?.let { holder ->
               val cellHeader = holder.itemView.findViewById<TextView>(R.id.cell_header)
               fixedHeader.text = cellHeader.text
               // 可选：如果需要让Header和单元格的Header位置对齐，可计算偏移调整
           }
       }
   })
   

3. 隐藏单元格内的Header：因为外层已经显示固定Header了，单元格内的Header可以设置android:visibility="gone"，避免重复显示。

方案二：让单元格正常滚动，反向偏移Header实现固定 #

这种思路保留单元格内的Header结构，通过动态调整Header的位移，抵消RecyclerView的滚动效果，让Header看起来固定不动。

具体步骤： #

1. 保持原有布局结构：不需要修改整体布局，每个单元格依旧包含Header和Content。

2. 监听滚动调整Header位移：给RecyclerView添加滚动监听，对每个可见单元格的Header设置反向的translationX，抵消滚动带来的位置变化。

   recyclerView.addOnScrollListener(object : RecyclerView.OnScrollListener() {
       override fun onScrolled(recyclerView: RecyclerView, dx: Int, dy: Int) {
           super.onScrolled(recyclerView, dx, dy)
           // 获取所有可见的ViewHolder
           val visibleHolders = recyclerView.childViewHolderList
           visibleHolders.forEach { holder ->
               val header = holder.itemView.findViewById<View>(R.id.cell_header)
               // 反向设置偏移量，让Header保持原位
               header.translationX = -recyclerView.computeHorizontalScrollOffset().toFloat()
           }
       }
   
       override fun onScrollStateChanged(recyclerView: RecyclerView, newState: Int) {
           super.onScrollStateChanged(recyclerView, newState)
           // 滚动停止时可以做一些位置校准，避免偏移误差
           if (newState == RecyclerView.SCROLL_STATE_IDLE) {
               val firstVisiblePos = layoutManager.findFirstVisibleItemPosition()
               recyclerView.findViewHolderForAdapterPosition(firstVisiblePos)?.let { holder ->
                   val header = holder.itemView.findViewById<View>(R.id.cell_header)
                   header.translationX = -recyclerView.computeHorizontalScrollOffset().toFloat()
               }
           }
       }
   })
   

3. 处理ViewHolder复用：在Adapter的onViewRecycled方法中重置Header的translationX，避免复用旧的偏移值：

   override fun onViewRecycled(holder: YourViewHolder) {
       super.onViewRecycled(holder)
       holder.cellHeader.translationX = 0f
   }
   

两种方案的对比： #

• 方案一更适合Header内容随单元格切换的场景，性能开销较小，逻辑更简单。
• 方案二更适合每个单元格Header需要独立样式或交互的场景，但要注意处理复用和偏移精度问题。

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