造轮子系列,自己动手封装RecycylerView
关于RecyclewView,相信大家都比较熟悉了。在日常开发中很常见的一个控件。如果对RecyclerView还不是很熟悉的话,推荐你去参考鸿洋大神的博客。今天我们的目的不仅仅只是使用recyclerView,更重要的是,为recyclerView添加一些比较常见的功能,也简单化我们的recyclerView的使用。
首先,贴一张效果图放这里。
gif4.gif要实现上面的效果,如果只是使用RecyclerView的话,实现比较比较麻烦。所以,我就上面的效果封装起来,以便使用起来更加方便。下面是使用说明。
首先第一步,添加引用:在Projectbuilde.gradle
添加如下依赖:
compile 'reoger.hut.com.strrecyclerview:Rrecyclerview:1.0.0'
为RecyclerView添加适配器Adapter
在同一般的adapter不同的是,这里我们需要继承RBaseAdapter<MyAdapter.ViewHolderPer>
其中的MyAdapter.ViewHolderPer
是我们为适配器绑定的布局类,主要代码如下:
class ViewHolderPer extends RBaseViewHolder {
public ImageView imageView;
public TextView mName;
public ViewHolderPer(View itemView) {
super(itemView);
imageView = (ImageView) itemView.findViewById(R.id.image);
mName = (TextView) itemView.findViewById(R.id.name);
}
@Override
public void onBindViewHolder(int position) {
imageView.setImageResource(datas.get(position).getIds());
mName.setText(datas.get(position).getName());
}
//点击事件可以在这里进行实现
@Override
public void OnItemClick(View view, int position) {
Toast.makeText(mContext,"点击了"+position,Toast.LENGTH_SHORT).show();
}
}
可以看到MyAdapter.ViewHolderPer
继承了RBaseViewHolder
,并且在ViewHolderPer
中实现findViewById
逻辑,然后在onBindViewHolder
绑定布局,设置要显示的数据。最后,然后需要添加点击事件,可以在OnItemClick
实现点击逻辑。
接下来,在adapter中的示例代码如下:
private List<Per> datas;
private LayoutInflater mInflater;
private Context mContext;
public MyAdapter(List<Per> datas, Context context) {
this.datas = datas;
mInflater = LayoutInflater.from(context);
mContext = context;
}
public void loadMoreData(List<Per> datas){
this.datas = datas;
notifyDataSetChanged();
}
@Override
public void addHeaderView(View headerView) {
mHeaderView = headerView;
notifyItemInserted(0);
}
@Override
public void addFooterView(View footerView) {
mFooterView = footerView;
if(isLoadMoreFooterShown)
notifyItemInserted(Item_Count-2);
else
notifyItemInserted(Item_Count-1);
}
@Override
protected RBaseViewHolder onCreateNormalViewHolder(ViewGroup parent, int viewType) {
View v = mInflater.inflate(R.layout.item_list,parent,false);
ViewHolderPer per = new ViewHolderPer(v);
return per;
}
@Override
protected int getDataCount()
{
return datas.size();
}
/**
* 如果需要实现删除效果,在这里进行实现
* @param position 要删除对象的索引号
*/
@Override
public void onSwiped(int position) {
if(datas !=null&&datas.size()>=position){
if(HeaderView)//如果添加了header的话,需要将header的位置也算在里面
datas.remove(position-1);
else
datas.remove(position);
notifyItemRemoved(position);
}
}
/**
* 如果需要实现拖拽的效果,在这里实现数据交换
* @param srcPosition 选中的viewHolder
* @param targerPostion 目标对象
* @return true 表示消耗此次的点击事件
*/
@Override
public boolean onMove(int srcPosition, int targerPostion) {
if(datas != null){
if(HeaderView){
Collections.swap(datas,srcPosition-1,targerPostion-1);
}else
Collections.swap(datas,srcPosition,targerPostion);
notifyItemMoved(srcPosition,targerPostion);
}
return true;
}
相信理解上面的代码没有什么难度,特殊的地方已经添加了注释。注意:如果需要添加Header或者Footer的话,在adapter中直接copy上面的代码就好了。至于为什么要这么写,可以参考后面的博客。至于里面的Per,是我们定义的一个数据对象类,主要代码如下:
public class Per {
private int ids;
private String name;
public int getIds() {
return ids;
}
public void setIds(int ids) {
this.ids = ids;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
内容简单,不做解释了,如果想看adapter中完整的内容,可以点击这里.
对了,这里在贴一下item_list的代码:这里实现的是item的布局
<?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="wrap_content"
android:background="#cfb"
android:orientation="horizontal">
<ImageView
android:id="@+id/image"
android:layout_width="80dp"
android:layout_height="80dp"
android:padding="10dp" />
<TextView
android:id="@+id/name"
android:layout_width="90dp"
android:layout_height="80dp"
android:gravity="center"
android:padding="10dp"
android:text="name" />
<TextView
android:id="@+id/content"
android:layout_width="100dp"
android:layout_height="80dp"
android:gravity="center"
android:padding="10dp"
android:text="content" />
</LinearLayout>
最后,在MainActivity中进行引用
在布局中引用我们的布局:
<?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"
>
<reoger.hut.com.strrecyclerview.RPullRecycler
android:layout_width="match_parent"
android:layout_height="match_parent"
android:id="@+id/pullclerView"/>
</LinearLayout>
然后,先直接将MainActivity中的代码完全贴出来,里面的代码也是比较简单的。
package reoger.hut.com.testuser;
import android.os.Bundle;
import android.os.Handler;
import android.support.v7.app.AppCompatActivity;
import android.support.v7.widget.LinearLayoutManager;
import android.support.v7.widget.RecyclerView;
import android.view.LayoutInflater;
import android.view.View;
import java.util.ArrayList;
import java.util.List;
import reoger.hut.com.strrecyclerview.RPullRecycler;
import reoger.hut.com.strrecyclerview.houchHelper.MyItemTouchHelper;
import reoger.hut.com.strrecyclerview.myDecoraltion.RDividerItemDecoration;
import reoger.hut.com.testuser.adapter.MyAdapter;
import reoger.hut.com.testuser.bean.Per;
import static reoger.hut.com.strrecyclerview.utils.Utils.CanTouchCurrentItem;
import static reoger.hut.com.testuser.R.layout.footer_view;
import static reoger.hut.com.testuser.R.layout.header_view;
public class MainActivity extends AppCompatActivity implements RPullRecycler.OnRecyclerRefreshListener, RPullRecycler.OnRecyclerLongPressClick {
private RPullRecycler mpullRecycler;
private MyAdapter myAdapter;
private List<Per> datas;
private LinearLayoutManager manager;
private MyItemTouchHelper itemTouchHelper;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
manager = new LinearLayoutManager(this,LinearLayoutManager.VERTICAL,false);
// manager = new GridLayoutManager(this,2);
initData();
}
private void initData() {
mpullRecycler = (RPullRecycler) findViewById(R.id.pullclerView);
mpullRecycler.setLayoutManager(manager);//设置这个必须放在setAdapter之前
myAdapter = new MyAdapter(getData(),this);
mpullRecycler.setOnRefreshListener(this);//添加滑动监听,主要用于下拉刷新和上拉加载的监听
mpullRecycler.setRecyclerLongPressClick(this);//添加移动item的监听事件
mpullRecycler.setAdapter(myAdapter);
mpullRecycler.enableLoadMore(true);//设置可以上拉加载,默认不拉不可以加载
mpullRecycler.enablePullToRefresh(true);//设置可以下拉刷新,默认下拉刷新
itemTouchHelper = new MyItemTouchHelper(myAdapter);//添加移动Item的监听器
itemTouchHelper.attachToRecyclerView(mpullRecycler);
itemTouchHelper.setSwipeEnable(true);//设置可以删除
View v = LayoutInflater.from(this).inflate(header_view,mpullRecycler,false);
myAdapter.addHeaderView(v);//添加headView
View v2 = LayoutInflater.from(this).inflate(footer_view,mpullRecycler,false);
myAdapter.addFooterView(v2);//添加footerView
//添加分割线,默认系统效果。如果需要实现自己的效果,可以在
mpullRecycler.addItemDecoration(new RDividerItemDecoration(this, RDividerItemDecoration.VERTICAL));//添加间隔
}
private List<Per> getData(){
datas = new ArrayList<>();
int []ids ={R.mipmap.img1,R.mipmap.img2,R.mipmap.img3,R.mipmap.img4};
String []names ={"占山","历史","王五","斩六"};
for(int j=0;j<2;j++)
for(int i=0;i<4;i++){
Per item = new Per();
item.setIds(ids[i]);
item.setName(names[i]);
datas.add(item);
}
return datas;
}
/**
* 下拉与上拉刷新的回调
* @param action ACTION_PULL_TO_REFRESH 上拉
* ACTION_LOAD_MORE_REFRESH 下拉
*/
@Override
public void onRefresh(int action) {
if(action == RPullRecycler.ACTION_PULL_TO_REFRESH){
new Handler().postDelayed(new Runnable() {
@Override
public void run() {
myAdapter.loadMoreData(loadData());
mpullRecycler.onRefreshCompleted();
}
},3000);
}
if(action == RPullRecycler.ACTION_LOAD_MORE_REFRESH){//模拟延时加载
new Handler().postDelayed(new Runnable() {
@Override
public void run() {
mpullRecycler.onRefreshCompleted();
}
},3000);
}
}
private List<Per> loadData(){
for(int i=0;i<4;i++){
Per item = new Per();
item.setName("新增的"+i);
datas.add(0,item);
}
return datas;
}
/**
* 移动Item的实现
* @param vh 参照示例写即可
*/
@Override
public void onSwipAndDrag(RecyclerView.ViewHolder vh) {
if(CanTouchCurrentItem(vh))
itemTouchHelper.startDrag(vh);
}
}
具体实现以及说明代码和注释已经比较明显了,就不多做说明了。不过要记得继承两个接口RPullRecycler.OnRecyclerRefreshListener, RPullRecycler.OnRecyclerLongPressClick
.
OnRecyclerRefreshListener
实现对上拉、下拉的监听。
OnRecyclerLongPressClick
实现对item长按移动的监听。
到此,我们完成了上面效果图的全部代码。是不是很简单。
赶快去试试把。
总结
通过我自己简单封装的RrecycylerView可以比较简易的实现下面的功能效果‘
- 简单实现上拉下拉刷新
- 简单实现点击事件
- 简单实现右滑删除
- 简单添加head和footer
- 简单实现添加item之间的间隔。
如果你对里面的具体实现过程感兴趣,可以参考我的下一篇博客。也可以直接访问我的github查看源代码。
end