RecyclerView
可以说是 Android 开发最常用到的控件之一了,每一次用到都 new 一个专门的 Adapter
不仅效率低,而且也没有必要,因为大部分的 Adapter
功能都是类似的。那么就来封装一个通用的、易用的、高扩展性 Adapter
吧。
先看效果图:
以上就是最常见的显示单独 viewType
种类和任意多个 viewType
种类列表项的列表。并且最常用的列表项的点击事件也已经方便的提供复写方法,具体的使用方法如下:
引入
compile 'com.yinzihao:YinAdapter:{latest-version}'
使用指南
BaseAdapter<T>
适用于只有一种 ItemViewType 的列表。其中泛型 T 表示数据源的类型。
BaseAdapter<PersonBean> baseAdapter = new BaseAdapter<PersonBean>(this, personBeanList, R.layout.item_male){
@Override
public void onDataBind(CommonViewHolder viewHolder, PersonBean data, int position) {
//绑定数据
viewHolder.getTextView(R.id.tv_name).setText(data.getName());
}
@Override
public void onItemClick(CommonViewHolder commonViewHolder, View view, int position) {
//整个列表项的点击事件
Toast.makeText(context, "onItemClick position = " + position, Toast.LENGTH_SHORT).show();
}
@Override
public boolean onItemLongClick(CommonViewHolder commonViewHolder, View view, int position) {
//整个列表项的长按事件
Toast.makeText(context, "onItemLongClick position = " + position, Toast.LENGTH_SHORT).show();
return false;
}
}
在构造函数中传入数据源和列表项的布局文件,在onDataBind
中绑定数据源内容到布局中既可完成显示。
CommonAdapter<T>
适用于有超过一种 ItemViewType 的列表(例如聊天列表分我的和对方的)。
CommonAdapter<PersonBean> commonAdapter = new CommonAdapter<PersonBean>(context, personBeanList) {
@Override
public List<DataType<PersonBean>> getDataTypes() {
DataType<PersonBean> maleDateType = new DataType<PersonBean>() {
@Override
public int getLayoutId() {
return R.layout.item_male;
}
@Override
public boolean isMatching(PersonBean data, int position) {
return data.getSex() == 1;
}
@Override
public void dataBind(CommonViewHolder viewHolder, PersonBean data, int position) {
viewHolder.getTextView(R.id.tv_name).setText(data.getName());
viewHolder.<TextView>getView(R.id.tv_sex).setText("男");
}
@Override
public void onItemClick(CommonViewHolder commonViewHolder, View view, int position) {
Toast.makeText(context, "onItemClick position = " + position, Toast.LENGTH_SHORT).show();
}
@Override
public boolean onItemLongClick(CommonViewHolder commonViewHolder, View view, int position) {
Toast.makeText(context, "onItemLongClick position = " + position, Toast.LENGTH_SHORT).show();
return false;
}
};
DataType<PersonBean> femaleDateType = new DataType<PersonBean>() {
@Override
public int getLayoutId() {
return R.layout.item_female;
}
@Override
public boolean isMatching(PersonBean data, int position) {
return data.getSex() == 0;
}
@Override
public void dataBind(CommonViewHolder viewHolder, PersonBean data, int position) {
viewHolder.getTextView(R.id.tv_name).setText(data.getName());
viewHolder.<TextView>getView(R.id.tv_sex).setText("女");
}
@Override
public void onItemClick(CommonViewHolder commonViewHolder, View view, int position) {
Toast.makeText(context, "onItemClick position = " + position, Toast.LENGTH_SHORT).show();
}
@Override
public boolean onItemLongClick(CommonViewHolder commonViewHolder, View view, int position) {
Toast.makeText(context, "onItemLongClick position = " + position, Toast.LENGTH_SHORT).show();
return false;
}
};
List<DataType<PersonBean>> list = new ArrayList<>();
list.add(maleDateType);
list.add(femaleDateType);
return list;
}
@Nullable
@Override
public DataTypeForTheRest<PersonBean> getDefaultDataTypesForRest() {
return new DataTypeForTheRest<PersonBean>() {
@Override
public int getLayoutRes() {
return R.layout.item_the_rest;
}
@Override
public void dataBind(CommonViewHolder viewHolder, PersonBean data, int position) {
viewHolder.getTextView(R.id.tv_name).setText(data.getName());
viewHolder.<TextView>getView(R.id.tv_sex).setText("特别");
}
@Override
public void onItemClick(CommonViewHolder commonViewHolder, View view, PersonBean data, int position) {
}
@Override
public boolean onItemLongClick(CommonViewHolder commonViewHolder, View view, PersonBean data, int position) {
return false;
}
};
}
};
CommonAdapter
需要你自己在 getDataTypes()
抽象方法中列出你需要区分显示和处理的 DataType
,然后拼装成列表返回。
注意每个 DataType
中的 isMatching()
方法需要判断数据源是否应该属于当前的 DataType
,并且注意唯一性,如果一个数据即匹配一种 DataType
又匹配了另一种 DataType
,则会抛出异常。
getDefaultDataTypesForRest()
方法中可以返回一个 DataTypeForTheRest
对象,当数据源不匹配 getDataTypes()
中的任何类型时,会匹配上此对象,你可以统一处理它们的显示。
LoadMoreWrapperAdapter<PersonBean><T>
当需要上拉列表加载更多功能时,只需要使用装饰者模式在原来的 adapter
上装饰 LoadMoreWrapperAdapter
作为新的 adapter
既可。
LoadMoreWrapperAdapter<PersonBean> loadMoreWrapperAdapter = new LoadMoreWrapperAdapter<>(adapter);
如果需要自定义加载更多栏的布局样式,则使用:
LoadMoreWrapperAdapter<PersonBean> loadMoreWrapperAdapter = new LoadMoreWrapperAdapter<>(adapter, R.layout.load_more_layout);
在 recyclerView
的 addOnScrollListener()
中设置 LoadMoreWrapperAdapter.OnLoadMoreListener
实现加载更多事件的回调
recyclerView.addOnScrollListener(new LoadMoreWrapperAdapter.OnLoadMoreListener() {
@Override
public void onRefresh() {
if (personBeanList.size() > 22 * 10) {
loadMoreWrapperAdapter.noMoreToLoad();
return;
}
List<PersonBean> init = PersonBean.init();
personBeanList.addAll(init);
loadMoreWrapperAdapter.loadFinish();
loadMoreWrapperAdapter.notifyDataSetChanged();
}
});
注意,当本次加载结束时需要手动调用 loadMoreWrapperAdapter
的 loadFinish()
方法。当没有更多数据时需要手动调用 loadMoreWrapperAdapter
的 noMoreToLoad()
方法。