RecyclerView教程

设置依赖

在module的build.gradle里添加如下代码

dependencies {
    ...
    compile 'com.android.support:appcompat-v7:26.0.2'
    compile  'com.android.support:design:26.0.2'
    ...
}

在布局文件中定义

 <android.support.v7.widget.RecyclerView
        android:id="@+id/recycler"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

建立Item的布局

我们还需要建立一个布局文件用于自定义RecyclerView中每个条目的布局，在这里我将这个布局命名为item_layout.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="horizontal" android:layout_width="match_parent"
    android:layout_height="wrap_content">
    <TextView
        android:id="@+id/tv_text"
        android:layout_width="match_parent"
        android:gravity="center"
        android:layout_height="40dp"
        android:layout_weight="1"/>
</LinearLayout>

建立一个Bean类

这个类主要用于对数据进行包装（一般会在Bean类里放多个数据，这里只是为了简便只放一种数据）


public class ItemBean {
    private String text;
    public void setText(String text) {
        this.text = text;
    }
    public String getText() {
        return text;
    }
}

自定义Adapter和ViewHolder

adapter 用于将数据绑定到每个Item的View上，而ViewHolder相当于item_layout的Activity类，用于获取item_layout.xml里的控件。

public class MyAdapter extends RecyclerView.Adapter {
    // 要在Item上显示的数据
    List<ItemBean> mDataSet = new ArrayList<>();
    Context mContext;
    public MyAdapter(Context context){
        mContext=context;
    }
    // 用于获取ViewHolder
    @Override
    public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        View itemView=LayoutInflater.from(mContext).inflate(R.layout.item_layout, parent, false);
        return new MyViewHolder(itemView);
    }
    // 将数据与ViewHolder绑定 
    @Override
    public void onBindViewHolder(RecyclerView.ViewHolder holder, int position) {
        MyViewHolder mHolder= (MyViewHolder) holder;
        ItemBean itemBean=mDataSet.get(position);
        mHolder.textView.setText(itemBean.getText());
    }
    // 获取Item的数量
    @Override
    public int getItemCount() {
        return mDataSet.size();
    }
    // 以下五个方法是我自定义的，用来对数据进行一系列操作
    public void refreshItems(List<ItemBean> items) {
        mDataSet.clear();
        mDataSet.addAll(items);
        notifyDataSetChanged();
    }

    public void addItems(List<ItemBean> items) {
        mDataSet.addAll(items);
    }
    public void addItem(ItemBean item){
        mDataSet.add(item);
    }
    public void deleteItem(int position) {
        mDataSet.remove(position);
        notifyItemRemoved(position);
        notifyItemRangeChanged(0, mDataSet.size() - 1);
    }
    // ViewHolder用于获取Item上的控件
    public class MyViewHolder extends RecyclerView.ViewHolder {
        TextView textView;
        public MyViewHolder(View itemView) {
            super(itemView);
            textView=(TextView) itemView.findViewById(R.id.tv_text);
            //添加点击事件
            itemView.setOnClickListener(new View.OnClickListener() {
                @Override
                public void onClick(View view) {
                    Toast.makeText(mContext,"第"+getLayoutPosition()+"项被选中",Toast.LENGTH_SHORT).show();
                }
            });
        }
    }
}

在adapter中对于数据的操作就是对mDataSet这个List进行操作。但是对mDataSet进行修改以后我们还需要通知RecyclerView数据发生了改变，这就需要RecyclerView提供的以下几种方法

adapter.notifyDataSetChanged();

adapter.notifyItemInserted();

adapter.notifyItemChanged();

adapter.notifyItemMoved();

adapter.notifyItemRemoved();

adapter.notifyItemRangeChanged();

adapter.notifyItemRangeInserted();

adapter.notifyItemRangeRemoved();

其中第一种方法不会显示动画效果，它会直接将所有的 item 重新绘制。而后面七种方法会有相应的动画效果

在MainActivity.java中设置

public class MainActivity extends AppCompatActivity {
    RecyclerView recyclerView;
    RecyclerView.LayoutManager layoutManager;
    MyAdapter adapter;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        adapter=new MyAdapter(this);
        recyclerView=(RecyclerView) findViewById(R.id.recycler);
        //设置LayoutManager为LinearLayoutManager
        layoutManager= new LinearLayoutManager(this);
        for(int i=0;i<100;i++){
            ItemBean itemBean=new ItemBean();
            itemBean.setText("第"+i+"项");
            adapter.addItem(itemBean);
        }
        //设置LayoutManager和Adapter
        recyclerView.setLayoutManager(layoutManager);
        recyclerView.setAdapter(adapter);
    }
}

从代码上可以看出RecyclerView必须设置LayoutManager和Adapter。Adapter前文已经讲过了，下面主要谈一下LayoutManager。

LayoutManager

LayoutManager主要用于定义RecyclerView的形式，系统提供了三种LayoutManager

LinearLayoutManager 线性管理器，支持横向、纵向。

GridLayoutManager 网格布局管理器

StaggeredGridLayoutManager 瀑布流式布局管理器

上面的代码中我使用的就是 LinearLayoutManager

下拉刷新

利用SwipeRefreshLayout实现
在SwipeRefreshLayout.setOnRefreshListener里刷新数据
用SwipeRefreshLayout.setRefreshing(false)关闭刷新状态

refreshLayout=(SwipeRefreshLayout) findViewById(R.id.refresh);
refreshLayout.setOnRefreshListener(new SwipeRefreshLayout.OnRefreshListener() {
            @Override
            public void onRefresh() {
                refreshData();
                refreshLayout.setRefreshing(false);
            }
        });
  private void refreshData(){
        List<String> textList=new ArrayList<>();
        for (int i = 1; i <= 20; i++) {
            num++;
            String s="第" + num + "项";
            textList.add(s);
        }
        adapter.refreshItems(textList);
    }

上拉加载

利用RecyclerView.addOnScrollListener实现
获取第一个可见的item的位置(firstVisibleItem)
获取可见的item的数量和总的item的数量(visibleItemCount和totalItemCount）
通过(totalItemCount - visibleItemCount) <= firstVisibleItem判断是否已经拉到了最后一页

 recyclerView.addOnScrollListener(new RecyclerView.OnScrollListener() {
            private int totalItemCount;
            private int firstVisibleItem;
            private int visibleItemCount;
            @Override
            public void onScrollStateChanged(RecyclerView recyclerView, int newState) {
                super.onScrollStateChanged(recyclerView, newState);
            }
            @Override
            public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
                super.onScrolled(recyclerView, dx, dy);
                LinearLayoutManager layoutManager = (LinearLayoutManager) recyclerView.getLayoutManager();
                totalItemCount = layoutManager.getItemCount();
                firstVisibleItem = layoutManager.findFirstVisibleItemPosition();
                visibleItemCount = recyclerView.getChildCount();
                if ( ((totalItemCount - visibleItemCount) <= firstVisibleItem)) {
                    onLoadMore();

                }
            }
            private void onLoadMore() {
                    getData();
            }
        });

添加不同类型的Item

建立相应的布局文件

<!--item_header.xml-->
<android.support.v7.widget.CardView xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:clickable="true"
    android:foreground="?android:attr/selectableItemBackground"
    android:orientation="horizontal">
    <ImageView
        android:id="@+id/iv_image"
        android:layout_width="match_parent"
        android:layout_height="60dp"
        android:gravity="center" />
</android.support.v7.widget.CardView>

接下来我们来改造以下刚才自定义的Adapter

给不同类型的Item建立相应的常量标识

    public final static int ITEM_TYPE_HEADER = 0;
    public final static int ITEM_TYPE_TEXT = 1;

重写getItemViewType方法

    @Override
    public int getItemViewType(int position) {
        return position == 0 ? ITEM_TYPE_HEADER : ITEM_TYPE_TEXT;
    }

建立相应的ViewHolder

    public class TextViewHolder extends RecyclerView.ViewHolder {
        TextView textView;

        public TextViewHolder(View itemView) {
            super(itemView);
            textView = (TextView) itemView.findViewById(R.id.tv_text);
            itemView.setOnClickListener(new View.OnClickListener() {
                @Override
                public void onClick(View view) {
                    Toast.makeText(mContext, "第" + (getLayoutPosition() + 1) + "项被选中", Toast.LENGTH_SHORT).show();
                }
            });
        }
    }
    public class HeaderViewHolder extends RecyclerView.ViewHolder{
        ImageView imageView;
        public HeaderViewHolder(View itemView) {
            super(itemView);
            imageView=(ImageView) itemView.findViewById(R.id.iv_image);
        }
    }

在onCreateViewHolder方法里根据viewType返回对应的ViewHolder

    @Override
    public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        View itemView;
        if (viewType == ITEM_TYPE_HEADER) {
            itemView = LayoutInflater.from(mContext).inflate(R.layout.item_header, parent, false);
            return new HeaderViewHolder(itemView);
        } else {
            itemView = LayoutInflater.from(mContext).inflate(R.layout.item_layout, parent, false);
            return new TextViewHolder(itemView);
        }
    }

在onBindViewHolder方法里根据ViewHolder的类型执行相应操作

    @Override
    public void onBindViewHolder(RecyclerView.ViewHolder holder, int position) {
        if (holder instanceof HeaderViewHolder)
            ((HeaderViewHolder) holder).imageView.setImageResource(R.drawable.logo);
        else
            ((TextViewHolder) holder).textView.setText(mDataSet.get(position-1));
    }

改造后的Adapter完整代码如下

public class MyAdapter extends RecyclerView.Adapter {
    public final static int ITEM_TYPE_HEADER = 0;
    public final static int ITEM_TYPE_TEXT = 1;
    private List<String> mDataSet = new ArrayList<>();
    private Context mContext;

    public MyAdapter(Context context) {
        mContext = context;
    }

    @Override
    public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        View itemView;
        if (viewType == ITEM_TYPE_HEADER) {
            itemView = LayoutInflater.from(mContext).inflate(R.layout.item_header, parent, false);
            return new HeaderViewHolder(itemView);
        } else {
            itemView = LayoutInflater.from(mContext).inflate(R.layout.item_layout, parent, false);
            return new TextViewHolder(itemView);
        }
    }

    @Override
    public void onBindViewHolder(RecyclerView.ViewHolder holder, int position) {
        if (holder instanceof HeaderViewHolder)
            ((HeaderViewHolder) holder).imageView.setImageResource(R.drawable.logo);
        else
            ((TextViewHolder) holder).textView.setText(mDataSet.get(position-1));
    }

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


    public void refreshItems(List<String> items) {
        mDataSet.clear();
        mDataSet.addAll(items);
        notifyDataSetChanged();
    }


    public void addItem(String item) {
        mDataSet.add(item);
        notifyDataSetChanged();
    }

    @Override
    public int getItemViewType(int position) {
        return position == 0 ? ITEM_TYPE_HEADER : ITEM_TYPE_TEXT;
    }

    public class TextViewHolder extends RecyclerView.ViewHolder {
        TextView textView;

        public TextViewHolder(View itemView) {
            super(itemView);
            textView = (TextView) itemView.findViewById(R.id.tv_text);
            itemView.setOnClickListener(new View.OnClickListener() {
                @Override
                public void onClick(View view) {
                    Toast.makeText(mContext, "第" + (getLayoutPosition() + 1) + "项被选中", Toast.LENGTH_SHORT).show();
                }
            });
        }
    }
    public class HeaderViewHolder extends RecyclerView.ViewHolder{
        ImageView imageView;
        public HeaderViewHolder(View itemView) {
            super(itemView);
            imageView=(ImageView) itemView.findViewById(R.id.iv_image);
        }
    }
}

总结

通过上边的步骤，我们可以写出一个简单的RecyclerVIew。
上面demo的代码放在了github上：https://github.com/CodeChild/RecyclerViewDemo
如果有错误还请各位看官指正

最后编辑于：2018.11.06 22:40:57

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 204,732评论 6赞 478
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 87,496评论 2赞 381
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 151,264评论 0赞 338
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 54,807评论 1赞 277
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 63,806评论 5赞 368
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 48,675评论 1赞 281
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 38,029评论 3赞 399
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 36,683评论 0赞 258
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 41,704评论 1赞 299
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 35,666评论 2赞 321
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 37,773评论 1赞 332
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 33,413评论 4赞 321
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 39,016评论 3赞 307
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 29,978评论 0赞 19
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 31,204评论 1赞 260
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 45,083评论 2赞 350
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 42,503评论 2赞 343