Android RecyclerView之最基本使用教程完整示例（列表/分隔线/点击事件响应/水波纹特效等实现）

悠悠 2023-10-08 20:48 12阅读 0赞

前面几篇文章我们学了Listview的一些基本使用和面向实用优化性的一些进阶自定义用法。这篇文章开始学习RecyclerView，还是先从一个最简单的示例开始。

本篇文章我们将用RecyclerView实现如下效果图（实现一个带分隔线有点击事件的列表，类似Listview ArrayAdapter的示例）![64b30efe11df4625813977e56fb79e4d.png][]

Listview的实现传送门：[Android Listview ArrayAdapter示例\_左眼看成爱的博客-CSDN博客][Android Listview ArrayAdapter_-CSDN]

**前言：**

从IDE中我们可以看到，Listview控件已经被谷歌边缘化了。存放在Legacy分类下，legacy在英语中就是过期，遗产的意思。意思是这个控件即将退出历史舞台。

![b88772c7c233493c83c93ff385d53035.png][]

**两者差别：**

相同点：
    都可以实现垂直方向的滚动列表效果；
    都需要使用适配器（Adapter）
    都能自定义适配器实现复杂场景需求
    
    不同点：
    ListView只能实现垂直滚动列表，
    RecyclerView不但能实现垂直滚动列表还可以实现水平、多列、跨列等复杂的滚动列表；
    RecyclerView还可以实现网格、瀑布流等复杂的应用场景布局，且默认强制使用ViewHolder，性能更强；
    RecyclerView不但需要自定义Adapter，还必须有LayoutManager，用法更复杂一些。
    RecyclerView实现的列表默认没有水波纹变色等点击特效，而Listview则无需任何设置直接就有
    ListView有setOnItemClickListener 鼠标点击事件监听接口，而RecyclerView没有。需自己去实现.
    RecyclerView可实现复杂的自定义功能，比如动画特效，边框线等。这些都是Listview没有的
    
    总结：
    ListView能做到的，RecyclerView都能做到，反之则不行。
    RecyclerView用法比ListView更复杂。
    一些简单的列表场景没有特殊性能要求。建议使用Listview更简单方便
    一些数据量不大的垂直滚动列表也建议使用Listview来实现更方便简单.

**示例实现步骤：**

1，使用RecylerView需要先导依赖包

implementation 'androidx.recyclerview:recyclerview:1.1.0'

MainActivity代码如下:

package com.example.RecyclerView_BaseTest;
    
    import android.util.Log;
    import android.view.View;
    import android.widget.AdapterView;
    import android.widget.Button;
    import android.widget.Toast;
    import androidx.appcompat.app.AppCompatActivity;
    import android.os.Bundle;
    import androidx.recyclerview.widget.DefaultItemAnimator;
    import androidx.recyclerview.widget.DividerItemDecoration;
    import androidx.recyclerview.widget.LinearLayoutManager;
    import androidx.recyclerview.widget.RecyclerView;
    
    import java.util.ArrayList;
    import java.util.List;
    
    public class MainActivity extends AppCompatActivity {
    
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_main);
    
            final String[] citys = {"上海","北京","天津","江苏","河南","西藏","新疆","湖南","湖北"};
    
            RecyclerView recyclerView =findViewById(R.id.recyview);
    
            //设置线性布局LinearLayoutManager,也可以是GridLayoutManager(网格布局),StaggeredGridLayoutManager(瀑布流)
            LinearLayoutManager layoutManager= new LinearLayoutManager(MainActivity.this,LinearLayoutManager.VERTICAL,false);
            recyclerView.setLayoutManager(layoutManager);
            //recyclerView.setLayoutManager(new LinearLayoutManager(this));
    
            //设置适配器
            MyAdapter adapter =new MyAdapter(this,citys);
            recyclerView.setAdapter(adapter);
    
        }
    }

item布局：

<?xml version="1.0" encoding="UTF-8"?>
    <TextView xmlns:android="http://schemas.android.com/apk/res/android"
              android:id="@+id/txtcity"
              android:layout_width="match_parent"
              android:layout_height="wrap_content"
              android:textColor="#FF00FF"
              android:padding="15dp"
              android:textSize="16sp">
    </TextView>

主布局文件：

<?xml version="1.0" encoding="utf-8"?>
    <LinearLayout
            xmlns:android="http://schemas.android.com/apk/res/android"
            xmlns:tools="http://schemas.android.com/tools"
            xmlns:app="http://schemas.android.com/apk/res-auto"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:orientation="vertical"
            tools:context=".MainActivity">
    
    
        <androidx.recyclerview.widget.RecyclerView
                android:id="@+id/recyview"
                android:layout_width="match_parent"
                android:layout_height="match_parent"/>
    </LinearLayout>

MyAdapter适配器

package com.example.RecyclerView_BaseTest;
    
    import android.content.Context;
    import android.view.LayoutInflater;
    import android.view.View;
    import android.view.ViewGroup;
    import android.widget.TextView;
    import android.widget.Toast;
    import androidx.annotation.NonNull;
    import androidx.recyclerview.widget.RecyclerView;
    
    /**
     * @author wh445306
     * @version 1.0
     * @Description MyAdapter for RecyclerView
     * @Date 2023-03-18 15:07
     */
    
    public class MyAdapter extends RecyclerView.Adapter<MyAdapter.MyViewHolder>{
    
        LayoutInflater mInflater; //声明布局填充器
        String[] list;
        Context context; //声明上下文
    
    
        //构造方法
        public MyAdapter(Context context, String[] list) {
            mInflater = LayoutInflater.from(context); //获取布局服务
            this.list=list;
            this.context=context;
        }
    
        //用于创建ViewHolder实例，并加载Item布局
        @NonNull
        @Override
        public MyViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
            View view = mInflater.inflate( R.layout.list_item, parent, false);
            //View view = LayoutInflater.from(parent.getContext()).inflate( R.layout.list_item, parent, false);
            MyViewHolder myViewHolder = new MyViewHolder(view);
            return myViewHolder;
        }
    
        //用于将获取的数据绑定到对应的控件上
        @Override
        public void onBindViewHolder(@NonNull MyAdapter.MyViewHolder holder, final int position) {
            holder.txt.setText(list[position]);
    
            //添加点击事件监听
            holder.itemView.setOnClickListener(new View.OnClickListener() {
                @Override
                public void onClick(View v) {
                    Toast.makeText(context, list[position], Toast.LENGTH_SHORT).show();
                }
            });
        }
    
    
        //获取列表条目的总数
        @Override
        public int getItemCount() {
            return list.length;
        }
    
    
        //自定义内部类 ViewHolder
        public static class MyViewHolder extends RecyclerView.ViewHolder{
            TextView txt;
    
            public MyViewHolder(@NonNull View itemView) {
                super(itemView);
                txt=itemView.findViewById(R.id.txtcity);
            }
    
    
        }
    }

代码中全部都有注释，且很多地方都有多种实现方法。其中一种注释后保留做为参考。相信一看就明白了。没有过多的内容。只是实现一个简单的垂直列表。如果您想实现其它的效果，可以从MainActivity中修改布局管理器即可实现布局切换：

设置线性布局LinearLayoutManager,
    也可以是GridLayoutManager(网格布局),
    StaggeredGridLayoutManager(瀑布流)

**如何实现示例效果图中的类似Listview的官方默认的框线?：**

//设置divider框线
    DividerItemDecoration divider=new DividerItemDecoration(this,layoutManager.getOrientation());
    recyclerView.addItemDecoration(divider);
    
    参考：
    https://blog.csdn.net/minwenping/article/details/76148422

**如何实现Listview默认自带的Item点击水波纹变色点击效果呢?，参考这里：**

[android - RecyclerView facing small Issues - Stack Overflow][]

![9ff52d1ea214402c9d0ee8f8952f04aa.png][]

或者：[用一行代码在Android Studio给RecyclerView添加点击效果（水波纹/点击变色）\_android recyclerview点击效果\_学疯了的博客-CSDN博客][Android Studio_RecyclerView_android recyclerview_-CSDN] [RecyclerView 实现item点击水波纹动画\_小蜗牛在漫步的博客-CSDN博客][RecyclerView _item_-CSDN]

[64b30efe11df4625813977e56fb79e4d.png]: https://img-blog.csdnimg.cn/64b30efe11df4625813977e56fb79e4d.png
[Android Listview ArrayAdapter_-CSDN]: https://blog.csdn.net/wh445306/article/details/129558216
[b88772c7c233493c83c93ff385d53035.png]: https://img-blog.csdnimg.cn/b88772c7c233493c83c93ff385d53035.png
[android - RecyclerView facing small Issues - Stack Overflow]: https://stackoverflow.com/questions/28935631/recyclerview-facing-small-issues
[9ff52d1ea214402c9d0ee8f8952f04aa.png]: https://img-blog.csdnimg.cn/9ff52d1ea214402c9d0ee8f8952f04aa.png
[Android Studio_RecyclerView_android recyclerview_-CSDN]: https://blog.csdn.net/qq_41888672/article/details/125716769
[RecyclerView _item_-CSDN]: https://blog.csdn.net/chenli_001/article/details/80207719