Android RecyclerView比较常用的使用方法总结

（点击上方目录可以跳转）

转载请注明出处：http://blog.csdn.net/htwhtw123/article/details/77917403

1.一般的RecyclerView（和一些注意事项）

2.下拉后从上端刷新

3.上拉从下端刷新

4.添加尾部首部分别添加footer和Head

项目Demo放在gihub上了，4个module是此博文的4个情况下的实例：点击跳转

1.一般的RecyclerView（和一些注意事项）

(在demo中是名为Normal的module)

1.首先需要导入RecyclerView,下面给两种方法，任选一种（方法一是导入包的共有方法，感觉导入官方包时更加常用）

（1）方法一：ctrl+shift+alt+s->左端点击需要导入RecyclerViewd的module->右上端点击Dependencies标签->点击最右端加号：“+”

->library dependency->搜索框输入recyclerView后回车->双击以“com.android.“开头的一项->OK

（2）方法二：在module的build.gradle中的dependencies {}中添加下面一句后点击Android Studio右上角出现的Sync Now。

compile 'com.android.support:recyclerview-v7:26.0.0-alpha1'

2.布局文件，没有什么特殊的

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

3.列表子项的布局，一定要注意，最外层的控件高度不是match_parent，而是子项需要有的高度，否则一个子项就会占据整个屏幕。这里就放了一个textView，其实想放什么控件都可以，在适配器里面，这些对象都是可以获取的，在那里怎么设置都可以。这里通过android:layout_marginTop=”4dp”，实现子项间有4dp的间隔，可以通过设置颜色，实现recyclerView的分隔线（当然还有更加正规的方法）。下面是item_layout的全部代码。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_marginTop="4dp"
android:background="@android:color/white"
android:layout_width="match_parent"
android:layout_height="wrap_content">

<TextView
android:id="@+id/textView"
android:textSize="30sp"
android:padding="5dp"
android:layout_gravity="center"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="TextView"/>
</LinearLayout>

4.RecyclerView的适配器需要重写，可以依照自己的需求修改，这里写一个常用的，并可以对recyclerView数据添加、删除、清空的适配器。下面直接放ItemAdapter里的代码：
12913

public class ItemAdapter extends RecyclerView.Adapter<ItemAdapter.MyViewHolder> {

List<String> list;//存放数据
Context context;

public ItemAdapter(List<String> list, Context context) {
this.list = list;
this.context = context;
}

@Override
public MyViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
MyViewHolder holder = new MyViewHolder(LayoutInflater.from(context).inflate(R.layout.item_layout, parent, false));
return holder;
}

//在这里可以获得每个子项里面的控件的实例，比如这里的TextView,子项本身的实例是itemView，
// 在这里对获取对象进行操作
//holder.itemView是子项视图的实例，holder.textView是子项内控件的实例
//position是点击位置
@Override
public void onBindViewHolder(MyViewHolder holder,final  int position) {
//设置textView显示内容为list里的对应项
holder.textView.setText(list.get(position));
//子项的点击事件监听
holder.itemView.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
Toast.makeText(context, "点击子项"+position, Toast.LENGTH_SHORT).show();
}
});
}

//要显示的子项数量
@Override
public int getItemCount() {
return list.size();
}

//这里定义的是子项的类，不要在这里直接对获取对象进行操作
public class MyViewHolder extends RecyclerView.ViewHolder {

TextView textView;

public MyViewHolder(View itemView) {
super(itemView);
textView = itemView.findViewById(R.id.textView);
}
}

/*之下的方法都是为了方便操作，并不是必须的*/

//在指定位置插入，原位置的向后移动一格
public boolean addItem(int position, String msg) {
if (position < list.size() && position >= 0) {
list.add(position, msg);
notifyItemInserted(position);
return true;
}
return false;
}

//去除指定位置的子项
public boolean removeItem(int position) {
if (position < list.size() && position >= 0) {
list.remove(position);
notifyItemRemoved(position);
return true;
}
return false;
}

//清空显示数据
public void clearAll() {
list.clear();
notifyDataSetChanged();
}

5.Activity里的代码：RecyclerView的三部曲：获取recyclerView对象、添加布局管理器、添加适配器。适配器要重写，可以事先放入数据，也可以之后添加数据。注意，这里导入包是import android.support.v7.widget.RecyclerView; 不要导入另一个。

RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recyclerView);//获取对象
recyclerView.setLayoutManager(new LinearLayoutManager(this));//设置布局管理器，这里选择用竖直的列表
List<String> list = new ArrayList<>();
for (int i = 0; i < 15; i++) {
list.add("" + i);
}
ItemAdapter itemAdapter=new ItemAdapter(list, this);//添加适配器，这里适配器刚刚装入了数据
recyclerView.setAdapter(itemAdapter);
//itemAdapter.addItem(1,"123");
//itemAdapter.removeItem(15);
//itemAdapter.clearAll();

2.下拉后从上端刷新

(在demo中是名为PullDownRefresh的module)

下拉从上端刷新，这个比较简单。在布局文件里，用SwipeRefreshLayout把RecyclerView包在里面，然后再在java代码里面写下拉的响应事件就好了。下面直接写代码：

1.布局文件，把RecyclerView放在SwipeRefreshLayout里：

<android.support.v4.widget.SwipeRefreshLayout
android:id="@+id/srl"
android:layout_width="match_parent"
android:layout_height="match_parent">

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

2.java代码：

//列表
recyclerView= (RecyclerView) findViewById(R.id.rv);
recyclerView.setLayoutManager(new LinearLayoutManager(this));
//添加数据
list=new ArrayList<>();
for (int i = 0; i < 10; i++) {
list.add("第"+i+"项");
}
adapter=new ItemAdapter(list,this);
recyclerView.setAdapter(adapter);

//下拉加载控件
swipeRefreshLayout= (SwipeRefreshLayout) findViewById(R.id.srl);
swipeRefreshLayout.setColorSchemeColors(Color.BLUE);//设置旋转圈的颜色
//下拉监听
swipeRefreshLayout.setOnRefreshListener(new SwipeRefreshLayout.OnRefreshListener() {
@Override
public void onRefresh() {
list.add(0,"下拉加载出现的："+i++);
adapter.notifyDataSetChanged();
swipeRefreshLayout.setRefreshing(false);//设置成true的话，下拉过后就会一直在那里转
}
});

(在demo中是名为PullUpRefresh的module)

3.上拉从下端刷新

设置一个监听器，在上拉到开始显示最下面一项时，加载更多项。

监听器EndLessOnScrollListener代码：

public abstract class EndLessOnScrollListener extends RecyclerView.OnScrollListener {

private static final String TAG = "EndLessOnScrollListener";

LinearLayoutManager linearLayoutManager;

//当前所在页
private int currentPage=0;

//已经加载出来的item数
private int totalItemCount=0;

//用来存储上一个totalItemCount
private int previousTotal=0;

//屏幕可见的item数量
private int visibleItemCount;

//屏幕可见第一个Item的位置
private int firstVisibleItem;

//是否上拉数据
private boolean loading=true;

public EndLessOnScrollListener(LinearLayoutManager linearLayoutManager) {
this.linearLayoutManager = linearLayoutManager;
}

@Override
public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
super.onScrolled(recyclerView, dx, dy);

visibleItemCount=recyclerView.getChildCount();
totalItemCount=linearLayoutManager.getItemCount();
firstVisibleItem=linearLayoutManager.findFirstVisibleItemPosition();
//去掉loading也可以，但是性能会下降，在每次滑动时都会判断，所以的加上
if(loading){
Log.d(TAG, "firstVisibleItem: " + firstVisibleItem);
Log.d(TAG, "totalItemCount:" + totalItemCount);
Log.d(TAG, "visibleItemCount:" + visibleItemCount);
Log.d(TAG, "currentPage:" + currentPage);
if(totalItemCount>previousTotal){
//说明数据项已经加载结束
loading=false;
previousTotal=totalItemCount;
}
}
//实际效果是滑动到已加载页最后一项可见的瞬间，添加下一页
if(!loading&&totalItemCount-visibleItemCount<=firstVisibleItem){
currentPage++;
onLoadMore(currentPage);
loading=true;
}

}

/**
* 提供一个抽闲方法，在Activity中监听到这个EndLessOnScrollListener
* 并且实现这个方法
* 这个方法在可见的页的最后一项，可见时调用
* currentPage是加载到的页面编号
*/
public abstract void onLoadMore(int currentPage);

给recyclerview添加上拉监听事件即可，这里我让它每次加5项：

recyclerView.addOnScrollListener(new EndLessOnScrollListener(linearLayoutManager) {
@Override
public void onLoadMore(int currentPage) {
for (int i = count; i < 5+count; i++) {
list.add("上拉加载"+i);
}
adapter.notifyDataSetChanged();
count+=5;
}
});

4.添加尾部首部分别添加footer和Head

(在demo中是名为HeaderAndFooter的module)

实现方法，主要是在适配器里实现。要在适配器必须写的方法里面和getItemViewType()方法里，考虑可能最前和最后一项分别是header和footer情况。

1.temAdapter里的代码

private static final int TYPE_HEADER = 0;
private static final int TYPE_FOOTER = 1;
private static final int TYPE_NORMAL = 2;

public ItemAdapter(List<String> list, Context context) {
this.list = list;
this.context = context;
}

@Override
public MyViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
if (headerView != null && viewType == TYPE_HEADER) {
return new MyViewHolder(headerView);
}
if (footerView != null && viewType == TYPE_FOOTER) {
return new MyViewHolder(footerView);
}

MyViewHolder holder = new MyViewHolder(LayoutInflater.from(context).
inflate(R.layout.item_layout, parent, false));
return holder;
}

@Override
public void onBindViewHolder(MyViewHolder holder, final int position) {
if (getItemViewType(position) == TYPE_NORMAL) {
holder.tv.setText(list.get(position - 1));
return;
} else if (getItemViewType(position) == TYPE_HEADER) {
return;
} else
return;
}

/**
* 重写这个方法，很重要，是加入Header和Footer的关键，我们通过判断item的类型，从而绑定不同的view
*/
@Override
public int getItemViewType(int position) {
if (headerView == null && footerView == null) {
return TYPE_NORMAL;
}
if (position == 0) {
//第一个item应该加载Header
return TYPE_HEADER;
}
if (position == getItemCount() - 1) {
//最后一个,应该加载Footer
return TYPE_FOOTER;
}
return TYPE_NORMAL;
}

@Override
public int getItemCount() {
if (headerView == null && footerView == null) {
return list.size();
} else if (headerView == null && footerView != null) {
return list.size() + 1;
} else if (headerView != null && footerView == null) {
return list.size() + 1;
} else {
return list.size() + 2;
}
}

public View getHeaderView() {
return headerView;
}

public void setHeaderView(View headerView) {
this.headerView=headerView;
notifyItemInserted(0);
}

public View getFooterView() {
return footerView;
}

public void setFooterView(View footerView) {
this.footerView=footerView;
notifyItemInserted(getItemCount()-1);
}

class MyViewHolder extends RecyclerView.ViewHolder {

TextView tv;

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

活动里面的代码：

RecyclerView recyclerView;
ItemAdapter adapter;
List<String>list;

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
initView();
}
private void initView() {
list= new ArrayList<>();
for (int i = 0; i < 10; i++) {
list.add("第"+i+"项");
}
adapter=new ItemAdapter(list,this);

recyclerView= (RecyclerView) findViewById(R.id.rv);
recyclerView.setAdapter(adapter);
recyclerView.setLayoutManager(new LinearLayoutManager(this));
//注意，以下两个方法必须在setAdapter()之后调用，否则长和宽会变成wrap_content
addHeader();
addFooter();

}

private void addHeader(){
View header= LayoutInflater.from(this).inflate(R.layout.header_layout,recyclerView,false);
adapter.setHeaderView(header);
}

private  void addFooter(){
View footer= LayoutInflater.from(this).inflate(R.layout.footer_layout,recyclerView,false);
adapter.setFooterView(footer);
}