android recyclerview header 吸顶-摩杜云开发者社区

Android RecyclerView Header 吸顶

在开发 Android 应用程序时，经常会遇到需要在 RecyclerView 中添加一个吸顶的 Header 的需求。这样的效果可以提升用户体验，使页面更加美观和易用。本文将介绍如何实现这个功能，并提供代码示例。

引言

RecyclerView 是一个强大的布局容器，用于显示大量数据列表。然而，它并不直接支持吸顶的 Header 功能。因此，我们需要自己实现这个功能。我们可以通过以下步骤来实现：

创建一个自定义的 RecyclerView.Adapter；
在 Adapter 中添加一个 Header View；
处理滚动事件，根据滚动位置显示或隐藏 Header View。

在下面的代码示例中，我们将使用 Kotlin 和 AndroidX 来实现这个功能。

实现步骤

引入依赖

首先，我们需要在项目的 build.gradle 文件中添加 RecyclerView 和 Kotlin 相关的依赖。

implementation 'androidx.recyclerview:recyclerview:1.2.1'
implementation 'org.jetbrains.kotlin:kotlin-stdlib:1.5.20'

创建自定义 Adapter

创建一个自定义的 RecyclerView.Adapter，并继承自 RecyclerView.Adapter<RecyclerView.ViewHolder>。

class MyAdapter(private val data: List<String>) :
    RecyclerView.Adapter<RecyclerView.ViewHolder>() {

    private val HEADER_VIEW_TYPE = 0
    private val ITEM_VIEW_TYPE = 1

    private var headerVisible = false

    // 创建 Header View 的 ViewHolder
    class HeaderViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView)

    // 创建普通 Item 的 ViewHolder
    class ItemViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView)

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): RecyclerView.ViewHolder {
        return when (viewType) {
            HEADER_VIEW_TYPE -> {
                val view = LayoutInflater.from(parent.context)
                    .inflate(R.layout.header_view, parent, false)
                HeaderViewHolder(view)
            }
            ITEM_VIEW_TYPE -> {
                val view = LayoutInflater.from(parent.context)
                    .inflate(R.layout.item_view, parent, false)
                ItemViewHolder(view)
            }
            else -> throw IllegalArgumentException("Invalid view type")
        }
    }

    override fun getItemCount(): Int {
        // 如果 Header 可见，则 Item 数量加一
        return if (headerVisible) data.size + 1 else data.size
    }

    override fun getItemViewType(position: Int): Int {
        // 根据位置决定当前 ViewHolder 的类型
        return if (position == 0 && headerVisible) HEADER_VIEW_TYPE else ITEM_VIEW_TYPE
    }

    override fun onBindViewHolder(holder: RecyclerView.ViewHolder, position: Int) {
        when (holder.itemViewType) {
            HEADER_VIEW_TYPE -> {
                // 处理 Header View 的数据绑定
            }
            ITEM_VIEW_TYPE -> {
                // 处理 Item View 的数据绑定
            }
        }
    }

    // 显示或隐藏 Header
    fun showHeader(visible: Boolean) {
        headerVisible = visible
        notifyDataSetChanged()
    }
}

添加 Header View

在上面的代码中，我们定义了两个 ViewHolder 类：HeaderViewHolder 和 ItemViewHolder。在 onCreateViewHolder 方法中，我们根据 viewType 创建不同的 ViewHolder。在 getItemViewType 方法中，我们根据位置决定当前 ViewHolder 的类型。

在 onBindViewHolder 方法中，我们可以处理 Header View 和 Item View 的数据绑定。

处理滚动事件

为了实现吸顶的效果，我们需要监听 RecyclerView 的滚动事件，并根据滚动位置来显示或隐藏 Header View。

class MainActivity : AppCompatActivity() {

    private lateinit var recyclerView: RecyclerView
    private lateinit var adapter: MyAdapter
    private lateinit var headerView: View

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        recyclerView = findViewById(R.id.recyclerView)
        headerView = findViewById(R.id.headerView)

        // 初始化 RecyclerView
        adapter = MyAdapter(getData())
        recyclerView.adapter = adapter
        recyclerView.layoutManager = LinearLayoutManager(this)

        // 监听 RecyclerView 的滚动事件
        recyclerView.addOnScrollListener(object : RecyclerView.OnScrollListener() {
            override fun onScrolled(recyclerView: RecyclerView, dx: Int, dy: Int) {
                super.onScrolled(recyclerView, dx, dy)
                val layoutManager = recyclerView.layoutManager as LinearLayoutManager
                val firstVisibleItemPosition = layoutManager.findFirstVisibleItemPosition()

                // 如果第一个可见的 Item 是 Header View，则显示 Header View，否则隐藏 Header View
                adapter.showHeader(firstVisibleItemPosition == 0)
            }
        })
    }

    private fun getData(): List<String> {
        // 返回示例数据
        return listOf("Item 1", "Item 2", "Item