Android开发基础——RecyclerView

最新推荐文章于 2025-11-10 09:11:09 发布

原创最新推荐文章于 2025-11-10 09:11:09 发布 · 4.2k 阅读

17 ·

CC 4.0 BY-SA版权

文章标签：

#android #RecyclerView #UI #ListView

Android开发基础专栏收录该内容

20 篇文章

订阅专栏

RecyclerView是比LitView更为强大的控件，其优化了ListView的不足。Android官方也更推荐使用RecyclerView。

基本用法

RecyclerView属于新增控件，Google将RecyclerView控件定义在AndroidX当中，用户只需要在项目的build.gradle中添加RecyclerView库的依赖，就能够保证在所有Android系统版本上都可以使用RecyclerView控件。

在app/build.gradle文件中的dependencis中添加如下内容：

dependencies {

    implementation 'androidx.core:core-ktx:1.3.2'
    implementation 'androidx.appcompat:appcompat:1.2.0'
    implementation 'com.google.android.material:material:1.3.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.0.4'
    implementation 'androidx.recyclerview:recyclerview:1.2.0'
    testImplementation 'junit:junit:4.+'
    androidTestImplementation 'androidx.test.ext:junit:1.1.2'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.3.0'
}

然后修改布局中的代码：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/recyclerView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

</LinearLayout>

由于RecyclerView并不是内置在系统SDK中的，因此需要完整的包路径。

这里构造和之前同样的Fruit类和fruit_item.xml布局文件。

然后构建新的FruitAdapter适配器，使该适配器继承自RecyclerView.Adapter，并将泛型指定为FruitAdapter.ViewHolder。

class FruitAdapter(val fruitList:List<Fruit>):
    RecyclerView.Adapter<FruitAdapter.ViewHolder>(){

    inner class ViewHolder(view:View):RecyclerView.ViewHolder(view) {
        val fruitImage: ImageView = view.findViewById(R.id.fruitImage)
        val fruitName: TextView = view.findViewById(R.id.fruitName)
    }

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

    override fun onBindViewHolder(holder: ViewHolder, position: Int) {
        val fruit = fruitList[position]
        holder.fruitImage.setImageResource(fruit.imageId)
        holder.fruitName.text = fruit.name
    }

    override fun getItemCount() = fruitList.size
}

上面是RecyclerView适配器的标准写法，首先定义一个内部类ViewHolder，其继承自RecyclerView.ViewHolder，然后ViewHolder的主构造函数要传入一个View参数，该参数通常就是RecyclerView子项的最外层布局，然后用户就可以通过findViewById获取布局中ImageView和TextView的实例了。

而FruitAdapter继承自RecyclerView.Adapter，就必须要重写onCreateViewHolder/onBindViewHolder/getItemCount三个方法：

onCreateViewHolder：用于创建ViewHolder实例，在该方法中加载fruit_item布局，然后创建一个ViewHolder实例，并将加载出来的布局传入构造函数中，最后将ViewHolder的实例返回
onBindViewHolder：用于对RecyclerView子项的数据进行复制，会在每个子项被滚动到屏幕内的时候执行，这里通过position参数得到当前项的Fruit实例，然后将之设置到ViewHolder
getItemCount：返回数据源的长度

class MainActivity : AppCompatActivity() {

    private val fruitList = ArrayList<Fruit>()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        initFruits()
        val layoutManager = LinearLayoutManager(this)
        recyclerView.layoutManager = layoutManager
        val adapter = FruitAdapter(fruitList)
        recyclerView.adapter = adapter
    }

    private fun initFruits() {
        repeat(2) {
            fruitList.add(Fruit("Apple", R.drawable.apple_pic))
            fruitList.add(Fruit("Banana", R.drawable.banana_pic))
            fruitList.add(Fruit("Orange", R.drawable.orange_pic))
            fruitList.add(Fruit("Watermelon", R.drawable.watermelon_pic))
            fruitList.add(Fruit("Pear", R.drawable.pear_pic))
            fruitList.add(Fruit("Grape", R.drawable.grape_pic))
            fruitList.add(Fruit("Pineapple", R.drawable.pineapple_pic))
            fruitList.add(Fruit("Strawberry", R.drawable.strawberry_pic))
            fruitList.add(Fruit("Cherry", R.drawable.cherry_pic))
            fruitList.add(Fruit("Mango", R.drawable.mango_pic))
        }
    }
}

可以看到，这里设置了同样的initFruits方法，用于初始化所有的数据，然后在onCreate方法中先创建LinearLayoutManager对象，并将之设置到RecyclerView中。LayoutManager用于指定RecyclerView的布局方式，这里使用的是LinearLayoutManager是线性布局的意思，可以实现和ListView类似的效果。之后创建了FruitAdapter实例，并将数据传入FruitAdapter的构造函数中，最后调用RecyclerView的setAdapter方法来完成适配器设置。程序运行后的结果为：

实现横向滚动和瀑布流布局

ListView扩展性并不好，其只能实现纵向滚动的效果，而RecyclerView却还能够实现横向流动的效果。

首先对fruit_item布局进行修改：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="80dp"
    android:layout_height="match_content">

    <ImageView
        android:id="@+id/fruitImage"
        android:layout_width="40dp"
        android:layout_height="40dp"
        android:layout_gravity="center_vertical"
        android:layout_marginTop="10dp"/>

    <TextView
        android:id="@+id/fruitName"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center_vertical"
        android:layout_marginTop="10dp"/>

</LinearLayout>

之前布局元素是水平排列的，这里将之修改为垂直排列。然后修改Activity中的代码：

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        initFruits()
        val layoutManager = LinearLayoutManager(this)
        layoutManager.orientation = LinearLayoutManager.HORIZONTAL
        recyclerView.layoutManager = layoutManager
        val adapter = FruitAdapter(fruitList)
        recyclerView.adapter = adapter
    }

这里只是将layoutManager的排列方向设为了水平方向。程序运行后的结果为：

RecyclerView之所以能够实现ListView无法实现的效果是因为RecyclerView的布局管理由LayoutManager完成。除了LinearLayoutManager之外，RecyclerView还提供了GridLayoutManager和StaggeredGridLayoutManager这两种内置的布局排列方式。前者可以实现网格布局，后者则可以实现瀑布流布局。

这里看一下瀑布流布局，首先是修改fruit_item布局：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:margin="5dp">

    <ImageView
        android:id="@+id/fruitImage"
        android:layout_width="40dp"
        android:layout_height="40dp"
        android:layout_gravity="center_vertical"
        android:layout_marginTop="10dp"/>

    <TextView
        android:id="@+id/fruitName"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="left"
        android:layout_marginTop="10dp"/>

</LinearLayout>

这里将LinearLayout的宽度改为了match_parent，这是因为瀑布流布局的宽度应该是根据布局的列数自动适配的，而不是固定值。然后修改Activity中的代码：

class MainActivity : AppCompatActivity() {

    private val fruitList = ArrayList<Fruit>()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        initFruits()
        val layoutManager = StaggeredGridLayoutManager(3,StaggeredGridLayoutManager.VERTICAL)
        recyclerView.layoutManager = layoutManager
        val adapter = FruitAdapter(fruitList)
        recyclerView.adapter = adapter
    }

    private fun initFruits() {
        repeat(2) {
            fruitList.add(Fruit(getRandomLengthString("Apple"), R.drawable.apple_pic))
            fruitList.add(Fruit(getRandomLengthString("Banana"), R.drawable.banana_pic))
            fruitList.add(Fruit(getRandomLengthString("Orange"), R.drawable.orange_pic))
            fruitList.add(Fruit(getRandomLengthString("Watermelon"), R.drawable.watermelon_pic))
            fruitList.add(Fruit(getRandomLengthString("Pear"), R.drawable.pear_pic))
            fruitList.add(Fruit(getRandomLengthString("Grape"), R.drawable.grape_pic))
            fruitList.add(Fruit(getRandomLengthString("Pineapple"), R.drawable.pineapple_pic))
            fruitList.add(Fruit(getRandomLengthString("Strawberry"), R.drawable.strawberry_pic))
            fruitList.add(Fruit(getRandomLengthString("Cherry"), R.drawable.cherry_pic))
            fruitList.add(Fruit(getRandomLengthString("Mango"), R.drawable.mango_pic))
        }
    }

    private fun getRandomLengthString(str:String):String {
        val n = (1..20).random()
        val builder = StringBuilder()
        repeat(n) {
            builder.append(str)
        }
        return builder.toString()
    }
}

其实上面的代码并没有修改多少，只是将原有的LinearLayoutManager修改为StaggeredGridLayoutManager。StaggeredGridLayoutManager的构造函数接收两个参数，第一个参数用于指定布局的列数，3表示3列，第二个参数用于指定布局的排列方向，这里为纵向排列。同时这里使用getRandomLengthString生成不同长度的字符串来显示瀑布流的效果。程序运行结果为：

RecyclerView的点击事件

和ListView不同，RecyclerView需要用户自己给子项具体的View注册点击事件。

修改FruitAdapter中的代码：

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder {
        val view = LayoutInflater.from(parent.context).inflate(R.layout.fruit_item, parent, false)
        val viewHolder = ViewHolder(view)

        viewHolder.itemView.setOnClickListener {
            val position = viewHolder.bindingAdapterPosition
            val fruit = fruitList[position]
            Toast.makeText(parent.context, "You clicked view ${fruit.name}", Toast.LENGTH_SHORT).show()
        }

        viewHolder.fruitImage.setOnClickListener {
            val position = viewHolder.bindingAdapterPosition
            val fruit = fruitList[position]
            Toast.makeText(parent.context, "You clicked image ${fruit.name}", Toast.LENGTH_SHORT).show()
        }

        return viewHolder
    }

在上面的代码中，仍然是在onCreateViewHolder中注册点击事件，并同时为最外层布局和ImageView都注册了点击事件，itemView表示最外层布局，fruitImage表示图片，这就是RecyclerView的特别之处。程序运行结果为：