使用GridLayoutManager时如何让Paging3库的Header单独占一整行

问题原因 #

1. 你当前的SpanSizeLookup判断逻辑有误，且调用withLoadStateHeaderAndFooter后返回的是拼接了Header、业务Adapter、Footer的ConcatAdapter，直接用showAdapter.getItemViewType()传入全局position判断类型会出现位置偏移错误。
2. 业务Adapter中的getItemViewType边界逻辑错误，position的取值范围为[0, itemCount-1]，position == itemCount的条件永远无法触发，导致所有业务项类型被误判。

修复步骤 #

1. 先修正业务Adapter的getItemViewType逻辑，不需要在业务层定义加载项类型，LoadStateAdapter会自带独立的item类型：

companion object {
    const val SHOW_ITEM = 1
}

override fun getItemViewType(position: Int): Int {
    // 所有业务项统一返回自定义的业务类型
    return SHOW_ITEM
}

2. 调整SpanSizeLookup的判断逻辑，基于拼接后的ConcatAdapter的item类型做判断：

val header = LoadStateAdapter { showAdapter.retry() }
val footer = LoadStateAdapter { showAdapter.retry() }
// 先拿到拼接后的ConcatAdapter实例
val concatAdapter = showAdapter.withLoadStateHeaderAndFooter(
    header = header,
    footer = footer
)

binding.list.apply {
    val layoutManager = layoutManager as GridLayoutManager
    layoutManager.spanSizeLookup = object : SpanSizeLookup() {
        override fun getSpanSize(position: Int): Int {
            // 非业务类型的项（Header、Footer）返回总Span数占满整行，业务项占1格
            return if (concatAdapter.getItemViewType(position) == ShowAdapter.SHOW_ITEM) {
                1
            } else {
                layoutManager.spanCount
            }
        }
    }
    adapter = concatAdapter
}

实现原理 #

withLoadStateHeaderAndFooter会自动将Header、业务Adapter、Footer拼接为ConcatAdapter，Header和Footer的item类型由LoadStateAdapter内部独立定义，和业务项类型天然区分，只要判断为非业务类型就返回总Span数，即可实现Header、Footer都单独占满一整行的效果。

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