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

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

本篇文章我们将用RecyclerView实现如下效果图(实现一个带分隔线有点击事件的列表,类似Listview ArrayAdapter的示例)

 Listview的实现传送门:Android Listview ArrayAdapter示例_左眼看成爱的博客-CSDN博客

前言:

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

两者差别:

相同点:
都可以实现垂直方向的滚动列表效果;
都需要使用适配器(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

或者:用一行代码在Android Studio给RecyclerView添加点击效果(水波纹/点击变色)_android recyclerview点击效果_学疯了的博客-CSDN博客 RecyclerView 实现item点击水波纹动画_小蜗牛在漫步的博客-CSDN博客

猜你喜欢

转载自blog.csdn.net/wh445306/article/details/129645139