RecyclerView使用指南（一）—— 基本使用

声明：原创作品，转载请注明出处：https://www.jianshu.com/p/5525310c0e40

RecyclerView是用于列表展示的控件，对于小白来说，是比较难使用的，下面，我将对它的最基本使用方式进行讲解。

• 步骤：

1. 添加Recyclerview依赖。
2. 在xml文件中添加Recyclerview控件。
3. 创建Recyclerview的Adapter（适配器）。
4. 将适配器设置给Recyclerview。

一、添加Recyclerview依赖

• 在模块的build.gradle中的dependencies{}中添加如下代码：

implementation 'com.android.support:recyclerview-v7:28.0.0'

二、在xml文件中添加Recyclerview控件

三、创建Recyclerview的Adapter（适配器）

• 步骤：

1. 创建RecyclerView.Adapter类的子类，泛型传入RecyclerView.ViewHolder类。
2. 创建RecyclerView.ViewHolder类的子类。
3. 在RecyclerView.ViewHolder的子类中初始化item的控件。
4. 重写RecyclerView.Adapter类的相关方法。

package com.liuym.myapplication;

import android.support.annotation.NonNull;
import android.support.v7.widget.RecyclerView;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.ImageView;
import android.widget.TextView;

import java.util.List;

public class RvAdapter extends RecyclerView.Adapter {
    //数据源
    private List mList;

    public RvAdapter(List list) {
        mList = list;
    }

    /**
     * 创建ViewHolder
     *
     * @param viewGroup
     * @param i
     * @return
     */
    @NonNull
    @Override
    public RecyclerView.ViewHolder onCreateViewHolder(@NonNull ViewGroup viewGroup, int i) {
        View item = LayoutInflater.from(viewGroup.getContext()).inflate(R.layout.item_rv, viewGroup, false);
        RecyclerView.ViewHolder holder = new MyViewHolder(item);
        return holder;
    }

    /**
     * 通过ViewHolder对item中的控件进行控制（如：显示数据等等）
     *
     * @param viewHolder
     * @param i
     */
    @Override
    public void onBindViewHolder(@NonNull RecyclerView.ViewHolder viewHolder, int i) {
        MyViewHolder holder = (MyViewHolder) viewHolder;
        Data data = mList.get(i);
        holder.iv.setImageResource(R.drawable.ic_launcher_background);
        holder.tv.setText(data.getText());
    }

    /**
     * 返回列表长度
     *
     * @return
     */
    @Override
    public int getItemCount() {
        return mList == null ? 0 : mList.size();
    }

    /**
     * 创建ViewHolder类，用来缓存item中的子控件，避免不必要的findViewById
     */
    class MyViewHolder extends RecyclerView.ViewHolder {
        ImageView iv;
        TextView tv;

        public MyViewHolder(@NonNull View itemView) {
            super(itemView);
            iv = itemView.findViewById(R.id.iv);
            tv = itemView.findViewById(R.id.tv);
        }
    }
}

四、将适配器设置给Recyclerview

    private void initRv() {
        List list = new ArrayList<>();
        for (int i = 0; i < 10; i++) {
            String text = String.format("mockData: %1s", i);
            list.add(new Data(text));
        }
        RecyclerView recyclerView = findViewById(R.id.rv);
        RvAdapter adapter = new RvAdapter(list);
        recyclerView.setAdapter(adapter);
    }

总结

这一篇，我讲解了RecyclerView的基本使用方式，下一篇，我会讲解如何在RecyclerView中使用不同的布局。

系列文章

《RecyclerView使用指南（一）—— 基本使用》
《RecyclerView使用指南（二）—— 多种ItemLayout》
《RecyclerView使用指南（三）—— 添加分割线和点击事件》
《RecyclerView使用指南（四）—— 使用ItemDecoration》
《RecyclerView使用指南（五）—— 实现吸顶效果》