Bootstrap

【Android】ListView和RecyclerView知识总结

文章目录

ListView

ListView 是 Android 中的一种视图组件，用于显示可滚动的垂直列表。每个列表项都是一个视图对象，ListView 会通过适配器（Adapter）将数据绑定到这些视图对象上。它通常用于显示一组相似的数据，比如联系人列表、消息列表等。

步骤

  1. 准备数据：这是数据源，通常是一个数组或一个List。
  2. 构建适配器：适配器用于将数据映射到ListView的每一项。你可以使用系统提供的适配器（如ArrayAdapter）或者自定义适配器。
  3. 绑定适配器到ListView：将适配器设置到ListView上。
  4. 处理ListView项的点击事件：添加点击事件监听器来处理每一项的点击事件。

适配器Adpter

作用：充当 ListView 和数据源之间的桥梁，将数据源转换为可以显示在 ListView 中的视图项。

image-20240723093657352

常用适配器类型

  1. ArrayAdapter：适用于简单的数据源，如数组或列表。它将每个数据项转换为一个 TextView 或其他简单视图。
  2. SimpleAdapter：用于将复杂的数据源（如 List<Map<String, Object>>）绑定到多个视图。
  3. Custom Adapter：通过继承 BaseAdapter 或其他适配器类，可以创建自定义适配器以实现复杂的需求。

ArrayAdapter

新建一个ArrayListActivity类及其布局文件

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

    <ListView
        android:id="@+id/lv"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

</LinearLayout>

添加入一个ListView控件

public class ArrayListActivity extends AppCompatActivity {
    private ListView mListView;
    private List<String> mStringList;
    private ArrayAdapter<String> mArrayAdapter;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_array_list);
       
        // 初始化 ListView。
        mListView = findViewById(R.id.lv);
        
        // 初始化字符串列表并填充数据。
        mStringList = new ArrayList<>();
        for (int i = 0; i < 50; i++) {
            mStringList.add("这是条目" + i);
        }
        
        // 使用 ArrayAdapter 绑定数据到 ListView。
        mArrayAdapter = new ArrayAdapter<>(this, android.R.layout.simple_list_item_1, mStringList);
        mListView.setAdapter(mArrayAdapter);
        
        // 设置 ListView 的点击事件。
        mListView.setOnItemClickListener((parent, view, position, id) -> {
            Toast.makeText(ArrayListActivity.this, "你点击了" + position, Toast.LENGTH_SHORT).show();
        });
        // 设置 ListView 的长按事件。
        mListView.setOnItemLongClickListener((parent, view, position, id) -> {
            Toast.makeText(ArrayListActivity.this, "你长按了" + position, Toast.LENGTH_SHORT).show();
            return true;
        });
    }
}

  • mListView = findViewById(R.id.lv);

    获得ListView组件

  • mStringList = new ArrayList<>();

    创建一个list储存信息

  • mArrayAdapter = new ArrayAdapter<>(this, android.R.layout.simple_list_item_1, mStringList);

    1. 创建了一个ArrayAdapter对象，命名为mArrayAdapter。
    2. 通过构造函数传入了三个参数：
      • this：表示当前的上下文对象，即这个ArrayAdapter将被用于当前的Activity或Fragment中。
      • android.R.layout.simple_list_item_1：表示列表项的布局文件，这里使用了Android系统提供的简单列表项布局，该布局只有一个文本视图。
      • mStringList：表示要显示的数据集合，即一个字符串列表。

    通过这个ArrayAdapter对象，可以将mStringList中的字符串显示在列表视图中。

  • mListView.setAdapter(mArrayAdapter);

    将mArrayAdapter对象设置为mListView的适配器

实现效果：

Screenshot_2024-07-23-10-28-26-233_com.example.la

SimpleAdapter

SimpleAdapter是Android中用于将数据模型转换成ListView或其他视图组件的适配器。它简化了数据绑定过程，通过映射数据集中的字段到布局文件中的视图

同样新建一个ArrayListActivity类及其布局文件

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/main"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <ListView
        android:id="@+id/lv"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

</LinearLayout>

xml和刚才一致

public class SimpleListActivity extends AppCompatActivity {
    
    private ListView mListView;
    private SimpleAdapter msimpleAdapter;
    private List<Map<String, Object>> mList;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_simple_list);
        
        // 初始化ListView
        mListView = findViewById(R.id.lv);
        // 初始化并填充列表数据
        mList = new ArrayList<>();
        for (int i = 0; i < 5; i++) {
            Map<String, Object> map1 = new HashMap<>();
            map1.put("image", R.drawable.apple);
            map1.put("text", "苹果");
            mList.add(map1);
            Map<String, Object> map2 = new HashMap<>();
            map2.put("image", R.drawable.banana);
            map2.put("text", "香蕉");
            mList.add(map2);
            Map<String, Object> map3 = new HashMap<>();
            map3.put("image", R.drawable.litchi);
            map3.put("text", "荔枝");
            mList.add(map3);
        }
        
        // 使用SimpleAdapter绑定数据到ListView
        msimpleAdapter = new SimpleAdapter(this, mList, R.layout.list_item_layout,
                new String[]{"image", "text"}, new int[]{R.id.image, R.id.tv});
        mListView.setAdapter(msimpleAdapter);
    } 
}

  • msimpleAdapter = new SimpleAdapter(this, mList, R.layout.list_item_layout,

    new String[]{"image", "text"}, new int[]{R.id.image, R.id.tv});

    1. 创建了一个SimpleAdapter对象，用于将数据绑定到ListView上。
    2. this：上下文对象，表示当前的Activity或Fragment。
    3. mList：数据源，通常是一个List集合，包含了要展示的数据。
    4. R.layout.list_item_layout：不同于刚才安卓自带的，这里我们使用自己创建的布局，下面的两个参数String[]是刚才map数组中的键，int[]是自定义布局中对应的视图id
    5. new String[]{"image", "text"}：数据源中要展示的字段名数组，这里表示要展示名为"image"和"text"的字段。
    6. new int[]{R.id.image, R.id.tv}：对应字段在布局文件中的控件ID数组，这里表示字段"image"对应ID为R.id.image的ImageView控件，字段"text"对应ID为R.id.tv的TextView控件

  • mListView.setAdapter(msimpleAdapter);

R.layout.list_item_layout：自定义的布局

<?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"
    android:orientation="horizontal">

    <ImageView
        android:id="@+id/image"
        android:layout_width="0dp"
        android:layout_height="100dp"
        android:layout_weight="1" />

    <TextView
        android:id="@+id/tv"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="3" />

</LinearLayout>

实际效果：
在这里插入图片描述

BaseAdpter

新建一个ItemBean类来存储数据

public class ItemBean {
    private String name;
    private int imageId;

    public ItemBean(String name, int imageId) {
        this.name = name;
        this.imageId = imageId;
    }

    public void setName(String name) {
        this.name = name;
    }

    public void setImageId(int imageId) {
        this.imageId = imageId;
    }

    public String getName() {
        return name;
    }

    public int getImageId() {
        return imageId;
    }
}

接下来为这个类构造适配器：

继承BaseAdapter类，自动生成四个重写方法

/**
 * 自定义适配器，用于在ListView中显示物品列表。
 * 该适配器负责将数据集中的每个项目绑定到相应的视图上。
 */
public class MyAdapter extends BaseAdapter {
    // 存储物品数据的列表
    private List<ItemBean> mlist;
    // LayoutInflater用于从XML文件中加载布局
    private LayoutInflater mLayoutInflater;
    // 上下文对象，用于获取资源和进行其他上下文相关的操作
    private Context mcontext;

    /**
     * 构造函数初始化适配器。
     * 
     * @param mlist 物品数据的列表
     * @param mcontext 上下文对象，用于初始化LayoutInflater
     */
    public MyAdapter(List<ItemBean> mlist, Context mcontext) {
        this.mlist = mlist;
        this.mcontext = mcontext;
        this.mLayoutInflater = LayoutInflater.from(mcontext);
    }

    //返回数据集的大小
    @Override
    public int getCount() {
        return mlist.size();
    }

    //根据位置获取数据集中的物品。
    @Override
    public Object getItem(int position) {
        return mlist.get(position);
    }

    // 获取物品在ListView中的唯一标识符
    @Override
    public long getItemId(int position) {
        return position;
    }

    /**
     * 为ListView的每个项目创建并返回一个视图。
     * 
     * @param position 物品的位置
     * @param convertView 当前被重用的视图
     * @param parent 视图的父容器
     * @return 绑定到数据集中的视图
     */
    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        // 使用LayoutInflater加载列表项的布局
        convertView = mLayoutInflater.inflate(R.layout.list_item_layout, parent, false);
        
        // 查找并初始化列表项中的ImageView和TextView
        ImageView img = convertView.findViewById(R.id.image);
        TextView tv = convertView.findViewById(R.id.tv);
        
        // 获取当前位置的物品数据,设置ImageView的图片资源
        ItemBean itemBean = mlist.get(position);
        img.setImageResource(itemBean.getImageId());
        tv.setText(itemBean.getName());
        
        return convertView;
    }
}

  • convertView = mLayoutInflater.inflate(R.layout.list_item_layout, parent, false);

    mLayoutInflater通过构造方法处的LayoutInflater.from(mcontext)赋值

    调用其inflate方法：

    1. convertView: 这个变量通常用来存储从布局文件转换而来的View对象。在ListView或RecyclerView的getView()方法中，它会被检查是否为空。如果非空，那么会直接使用这个View对象来展示数据，以避免频繁创建新的View，从而提高性能。
    2. mLayoutInflater: 这是一个LayoutInflater实例，它是Android框架提供的一个类，用于将XML布局文件转换为对应的View对象。
    3. R.layout.list_item_layout: 这是一个资源ID，指向了XML布局文件list_item_layout.xml。这个布局文件定义了一个ListView或RecyclerView中单个item的外观和结构，包括控件的类型、大小、位置以及样式等。
    4. parent: 这是一个ViewGroup类型的参数，代表了新创建的View最终将被添加到的父容器。在ListView或RecyclerView的情况下，parent就是ListView或RecyclerView本身。虽然在这个调用中，我们并没有立即把新创建的View添加到parent中（因为false参数），但这个参数还是需要的，因为它会影响LayoutInflater如何计算View的尺寸和位置。
    5. false: 这个布尔值参数告诉LayoutInflater不要将生成的View添加到parent中。这是因为ListView或RecyclerView有自己的逻辑来管理子View的添加和移除，它们会在适当的时候将View添加到自己内部的ViewGroup中。

    下面是BaseAdpterActivity类，和前两个步骤相似

    public class BaseAdpterActivity extends AppCompatActivity {
    
    private ListView mListView;
    private BaseAdapter mBaseAdapter;
    private List<ItemBean> mlist;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_base_adpter);

        // 初始化数据列表，这里使用了循环来添加多个数据项。
        mlist = new ArrayList<>();
        for (int i = 0; i < 20; i++) {
            ItemBean itemBean1 = new ItemBean("apple", R.drawable.apple);
            ItemBean itemBean2 = new ItemBean("banana", R.drawable.banana);
            ItemBean itemBean3 = new ItemBean("litchi", R.drawable.litchi);
            mlist.add(itemBean1);
            mlist.add(itemBean2);
            mlist.add(itemBean3);
        }

        // 初始化ListView和其适配器
        mListView = findViewById(R.id.lv);
        mBaseAdapter = new MyAdapter(mlist, this);
        mListView.setAdapter(mBaseAdapter);
    }
}

    效果：

    Screenshot_2024-07-23-12-24-11-021_com.example.la

效率问题

列表中信息的出现需要频繁调用getView方法，效率很低。

public class MyAdapter extends BaseAdapter {
    //省略这里代码.......
    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        
        ViewHolder viewHolder;
        
        if (convertView == null) {
            // 如果convertView为空，说明该视图是第一次被创建
            convertView = mLayoutInflater.inflate(R.layout.list_item_layout, parent, false);
            viewHolder = new ViewHolder();
            viewHolder.img = convertView.findViewById(R.id.image);
            viewHolder.tv = convertView.findViewById(R.id.tv);
            convertView.setTag(viewHolder);
        } else {
            // 如果convertView不为空，说明该视图可以被复用，直接从标签中获取ViewHolder对象
            viewHolder = (ViewHolder) convertView.getTag();
        }
        // 获取当前位置的物品数据
        ItemBean itemBean = mlist.get(position);
        // 绑定数据到视图
        viewHolder.img.setImageResource(itemBean.getImageId());
        viewHolder.tv.setText(itemBean.getName());

        return convertView;
    }

    /**
     * ViewHolder类用于缓存ListView项的视图引用，
     * 以减少在getView方法中每次都需要通过findViewById查找视图的开销。
     */
    class ViewHolder {
        ImageView img;
        TextView tv;
    }
}
  1. convertView为空：创建一个新的视图并初始化它，然后使用 setTag() 方法将一个包含子控件引用的对象与 convertView 关联起来。
  2. convertView不为null，则调用 getTag() 方法来获取之前存储的 ViewHolder 对象，这样就可以直接访问子控件而不需要再次查找它们。
  3. 使用setTag()和getTag()方法来缓存这些子控件的引用
  4. ViewHolder：每次getView()方法被调用时，如果直接在视图中使用findViewById()方法来获取子视图，这会导致性能下降，因为findViewById()是一个耗时的操作。ViewHolder模式通过在视图首次创建时保存对所有子视图的引用，避免了后续滚动时的多次查找

RecyclerView

RecyclerView 是 Android 提供的一个更高级和灵活的列表视图控件，相对于 ListView，RecyclerView 提供了更多的功能和更好的性能。它引入了一些新的概念，如 ViewHolder 模式，更高效的滚动和动画支持，以及更灵活的布局管理器（LayoutManager）。

具体实现

可以实现和ListView一致的效果

Screenshot_2024-07-23-12-24-11-021_com.example.la

示例目录：

image-20240723154019488

  1. 主布局文件 activity_main.xml

加入RecyclerView控件，宽高设置match_parent占满布局。

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

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

</LinearLayout>
  1. 数据模型 FruitBean.java，和刚刚的一致
public class FruitBean implements Serializable {
    private String name;
    private int imageId;

    public FruitBean() {
    }
    public FruitBean(String name, int imageId) {
        this.name = name;
        this.imageId = imageId;
    }

    public void setName(String name) {
        this.name = name;
    }

    public void setImageId(int imageId) {
        this.imageId = imageId;
    }

    public String getName() {
        return name;
    }

    public int getImageId() {
        return imageId;
    }
}
  1. 自定义适配器MyAdapter
// RecyclerView的适配器类，用于将数据集中的数据绑定到RecyclerView的各个Item上。
//继承RecyclerView.Adapter，这里的泛型是下面的内部类
public class MyAdapter extends RecyclerView.Adapter<MyAdapter.MyViewHolder> {

    
    // 数据源列表
    private List<FruitBean> mList;
    // 布局填充器，用于将XML布局文件转换为View对象
    private LayoutInflater mLayoutInflater;
    // 上下文对象
    private Context mContext;

    //构造函数，初始化适配器。
    public MyAdapter(List<FruitBean> mList, Context mContext) {
        this.mList = mList;
        this.mContext = mContext;
        this.mLayoutInflater = LayoutInflater.from(mContext);
    }

    @NonNull
    @Override
    public MyViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        // 将布局文件转换为View对象
        View view = mLayoutInflater.inflate(R.layout.list_item_layout, parent, false);
        // 创建并返回ViewHolder实例
        MyViewHolder myViewHolder = new MyViewHolder(view);
        return myViewHolder;
    }

     // 将数据绑定到ViewHolder，在RecyclerView滚动时会不断调用
    @Override
    public void onBindViewHolder(@NonNull MyViewHolder holder, int position) {
       // 获取当前项的数据
        FruitBean fruitBean = mList.get(position);

        // 将数据绑定到ViewHolder中的TextView和ImageView
        holder.tv.setText(fruitBean.getName());
        holder.img.setImageResource(fruitBean.getImageId());
    }

    @Override
    public int getItemCount() {
        return mList.size();
    }

     // ViewHolder类，用于持有每个列表项的视图
    class MyViewHolder extends RecyclerView.ViewHolder {
		// 列表项中的ImageView和TextView
        private ImageView img;
        private TextView tv;

        public MyViewHolder(View view) {
            super(view);

            // 通过itemView获取布局中的控件，并设置参数
            this.img = view.findViewById(R.id.image);
            this.tv = view.findViewById(R.id.tv);
        }
    }
}
  1. MainActivity中
public class MainActivity extends AppCompatActivity {
    // 声明RecyclerView、数据列表和适配器
    private RecyclerView mrecyclerView;
    private List<FruitBean> mlist;
    private MyAdapter myAdapter;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 初始化数据
        initData();

        // 绑定RecyclerView，设置适配器
        mrecyclerView = findViewById(R.id.rlv);
        myAdapter = new MyAdapter(mlist, this);
        mrecyclerView.setAdapter(myAdapter);
        // 设置布局管理器，这里是竖向滚动
        RecyclerView.LayoutManager layoutManager = new LinearLayoutManager(this);
        mrecyclerView.setLayoutManager(layoutManager);
    }

    // 初始化数据列表，添加多个水果项
    private void initData() {
        mlist = new ArrayList<>();
        for (int i = 0; i < 20; i++) {
            FruitBean itemBean1 = new FruitBean("apple", R.drawable.apple);
            FruitBean itemBean2 = new FruitBean("banana", R.drawable.banana);
            FruitBean itemBean3 = new FruitBean("litchi", R.drawable.litchi);
            mlist.add(itemBean1);
            mlist.add(itemBean2);
            mlist.add(itemBean3);
        }
    }
}

不同布局形式的设置

横向滚动

只用改一行代码

 RecyclerView.LayoutManager layoutManager = new LinearLayoutManager(this,LinearLayoutManager.HORIZONTAL,false);
        mrecyclerView.setLayoutManager(layoutManager);

new LinearLayoutManager(this, LinearLayoutManager.HORIZONTAL, false)：

  • 这里创建了一个LinearLayoutManager实例
  • this：传入的是当前Activity的上下文（Context）。
  • LinearLayoutManager.HORIZONTAL：表示RecyclerView的布局方向为水平（HORIZONTAL），即列表项将水平排列。
  • false：表示不反转布局。false意味着列表项从起点到终点正常排列，如果设置为true，列表项将从终点到起点反向排列。

瀑布流

RecyclerView.LayoutManager layoutManager = new StaggeredGridLayoutManager(2,StaggeredGridLayoutManager.VERTICAL);

new StaggeredGridLayoutManager(2, StaggeredGridLayoutManager.HORIZONTAL)：

  • 2：表示布局中有2个跨度（列或行，取决于方向）。在水平布局中，这表示有2行。
  • StaggeredGridLayoutManager.HORIZONTAL：表示RecyclerView的布局方向为垂直，即列表项将垂直排列，并且每一列包含多个项目。

网格

RecyclerView.LayoutManager layoutManager = new GridLayoutManager(this,2);

new GridLayoutManager(this, 2)：

  • this：传入的是当前Activity的上下文（Context）。
  • 2：表示布局中有2个跨度（列）。这意味着RecyclerView的每一行将包含2个项目。

点击事件

在ViewHolder中添加rlContainer变量来保存最外层布局的实例，再在onBindViewHolder方法中为他注册点击事件

public class MyAdapter extends RecyclerView.Adapter<MyAdapter.MyViewHolder> {
//省略
    @Override
    public void onBindViewHolder(@NonNull MyViewHolder holder, int position) {
        FruitBean fruitBean = mList.get(position);

        holder.tv.setText(fruitBean.getName());
        holder.img.setImageResource(fruitBean.getImageId());

        // 设置容器布局的点击事件
        holder.rlContainer.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Toast.makeText(mContext, "你点击了" + position, Toast.LENGTH_SHORT).show();
            }
        });
    }


    class MyViewHolder extends RecyclerView.ViewHolder {

        private ImageView img;
        private TextView tv;
        //添加最外层的布局属性
        RelativeLayout rlContainer;

        public MyViewHolder(View view) {
            super(view);

            this.img = view.findViewById(R.id.image);
            this.tv = view.findViewById(R.id.tv);
            this.rlContainer = view.findViewById(R.id.rl_item_container);
        }
    }
}

感谢您的阅读
如有错误烦请指正

参考：

  1. 26-Android中的列表-RecyclerView_哔哩哔哩_bilibili
  2. 【Android】Fragment的静态动态创建以及两种创建方式的生命周期-CSDN博客
  3. 《第一行代码》

悦读

道可道，非常道；名可名，非常名。 无名，天地之始，有名，万物之母。 故常无欲，以观其妙，常有欲，以观其徼。 此两者，同出而异名，同谓之玄，玄之又玄，众妙之门。

最新收录
Standard EVB硬件开发指南（1）——LCD接口电路
以太网帧、IP包及TCP与UDP的报文格式
前端数据结构一级变三级
博图导出变量给Wincc7.5离线使用
KVM虚拟化（web控制）
Flask框架总结
matlab 参数数目不足,输入参数数目不足，怎么解决
C++ float类型如何判读是否为0
CSS学习笔记
Python 闭包小记
;