如何为RecyclerView Paging 3的PagingDataAdapter添加自定义头部视图？

嗨，我之前也碰到过一模一样的问题！直接在PagingDataAdapter里用多类型ViewHolder确实容易踩坑，因为Paging 3的分页逻辑是和数据状态强绑定的，混进非分页的头部会打乱它的位置计算，就会出现你说的跳转到列表中间、数据插错位置这些奇怪情况。

其实Paging 3官方更推荐用ConcatAdapter来组合头部和分页适配器，把头部的逻辑和分页数据完全分开，这样就能避免那些异常行为了，具体步骤如下：

1. 先单独创建头部的Adapter #

把头部的布局、数据绑定逻辑单独封装成一个普通的RecyclerView.Adapter，比如：

class HeaderAdapter(private val headerContent: String) : RecyclerView.Adapter<HeaderAdapter.HeaderViewHolder>() {

    inner class HeaderViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
        fun bind(content: String) {
            // 这里绑定头部的UI数据，比如TextView的文字
            itemView.tv_header_title.text = content
        }
    }

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): HeaderViewHolder {
        val view = LayoutInflater.from(parent.context)
            .inflate(R.layout.item_custom_header, parent, false)
        return HeaderViewHolder(view)
    }

    override fun onBindViewHolder(holder: HeaderViewHolder, position: Int) {
        holder.bind(headerContent)
    }

    override fun getItemCount() = 1 // 头部只显示一个
}

2. 组合头部Adapter和PagingDataAdapter #

在你的Activity或Fragment里，把头部适配器和原本的PagingDataAdapter用ConcatAdapter组合起来，再设置给RecyclerView：

// 初始化你的分页适配器
val myPagingAdapter = MyPagingDataAdapter()

// 初始化自定义头部适配器
val customHeaderAdapter = HeaderAdapter("我的自定义头部")

// 组合两个适配器，顺序就是头部在前，分页内容在后
val concatAdapter = ConcatAdapter(customHeaderAdapter, myPagingAdapter)

// 设置给RecyclerView
binding.recyclerView.adapter = concatAdapter

// 正常提交分页数据到PagingDataAdapter就行
viewModel.pagingData.observe(this) { pagingData ->
    myPagingAdapter.submitData(lifecycle, pagingData)
}

3. 如果需要加载状态头部/尾部 #

如果你还要保留加载状态的头部或尾部，可以先给PagingDataAdapter加上withLoadStateHeaderAndFooter，再和自定义头部组合：

// 先创建加载状态的适配器
val loadStateAdapter = MyLoadStateAdapter { myPagingAdapter.retry() }

// 给分页适配器添加加载状态的头和尾
val pagingWithLoadState = myPagingAdapter.withLoadStateHeaderAndFooter(
    header = loadStateAdapter,
    footer = loadStateAdapter
)

// 再组合自定义头部和带加载状态的分页适配器
val concatAdapter = ConcatAdapter(customHeaderAdapter, pagingWithLoadState)

这种方式的好处是把头部和分页数据的职责完全分离，PagingDataAdapter只专注处理分页内容的加载和更新，头部由单独的适配器管理，不会干扰分页逻辑的位置计算，自然就不会出现那些奇怪的跳转和数据插入问题了。

备注：内容来源于stack exchange，提问作者mianlaoshu