注册

recycleview适配器,不看后悔到35岁



在我最近开发的一个Android项目当中,用到列表的地方非常多。用RecyclerView+BaseRecyclerViewAdapterHelper(开源框架)可以帮我们节省大量的代码(约节省三分之二),RecyclerView不用多说大家非常熟悉,谷歌推荐的列表控件,代替了传统的ListView,更加强大和灵活。BaseRecyclerViewAdapterHelper是一个非常强大的开源框架,它基本上可以解决我们开发中的列表布局。在这里记录一下这个框架。


框架引入


先在项目的 build.gradle中的 repositories 添加


allprojects {
repositories {
maven { url 'https://jitpack.io' }
}
}

然后在Module的 build.gradle中的 dependencies 添加


	dependencies {
implementation 'com.github.CymChad:BaseRecyclerViewAdapterHelper:2.9.47'
}

基本使用


首先我们在Activity中有一个RecyclerView


<?xml version="1.0" encoding="utf-8"?>
android:layout_width="match_parent"
android:layout_height="match_parent">

android:id="@+id/recycler"
android:layout_width="match_parent"
android:layout_height="match_parent"/>



再新建一个item布局,item布局是一个简单的头像和名字


<?xml version="1.0" encoding="utf-8"?>
android:orientation="horizontal"
android:layout_width="match_parent"
android:layout_height="60dp"
android:layout_marginVertical="5dp">

android:id="@+id/iv_head"
android:layout_width="50dp"
android:layout_height="50dp"
android:layout_marginStart="10dp"
android:layout_gravity="center_vertical"
android:src="@mipmap/ic_launcher"/>

android:id="@+id/tv_name"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginStart="10dp"
android:layout_gravity="center_vertical"
android:text="张三"
android:textSize="18sp"
android:textColor="#000000"/>



再根据item所需数据,编写数据实体类型


public class User {
private String headUrl;
private String name;

public User(String headUrl, String name) {
this.headUrl = headUrl;
this.name = name;
}

public String getHeadUrl() {
return headUrl;
}

public void setHeadUrl(String headUrl) {
this.headUrl = headUrl;
}

public String getName() {
return name;
}

public void setName(String name) {
this.name = name;
}
}

接下来就要用到我们的BaseRecyclerViewAdapterHelper框架来编写适配器


public class UserAdapter extends BaseQuickAdapter {
public UserAdapter(int layoutResId, @Nullable List data) {
super(layoutResId, data);
}

@Override
protected void convert(BaseViewHolder helper, User item) {
Glide.with(mContext).load(item.getHeadUrl()).into((ImageView)helper.getView(R.id.iv_head));
helper.setText(R.id.tv_name, item.getName());
}
}

在这里我们用到图片加载框架,非常的好用,一行代码就可以加载url图片等,这里就不详细多说,GitHub地址:https://github.com/bumptech/glide


最后一步就是在我们的Activity使用该适配器


public class MainActivity extends AppCompatActivity {
private RecyclerView recycler;

private List userList;

private UserAdapter adapter;

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);

recycler = findViewById(R.id.recycler);

//模拟数据,实际开发中一般是从后台获取数据
userList = new ArrayList<>();
for (int i = 0; i < 20; i++) {
userList.add(new User("http://img2.imgtn.bdimg.com/it/u=3749323882,846155126&fm=26&gp=0.jpg",
"第" + i + "条"));
}

//设置布局管理
recycler.setLayoutManager(new LinearLayoutManager(this));
//创建适配器
adapter = new UserAdapter(R.layout.item_recycler, userList);
//给RecyclerView设置适配器
recycler.setAdapter(adapter);
}
}

这样就是RecyclerView+BaseRecyclerViewAdapterHelper的基本使用,效果如下
在这里插入图片描述


点击事件


使用列表那当然也少不了点击事件,不论是整个item的点击事件还是item中的子控件都可以实现。


item的点击事件


		adapter.setOnItemClickListener(new BaseQuickAdapter.OnItemClickListener() {
@Override
public void onItemClick(BaseQuickAdapter adapter, View view, int position) {
Toast.makeText(MainActivity.this, "点击了第" + position + "条", Toast.LENGTH_SHORT).show();
}
});

item的长按事件


		adapter.setOnItemLongClickListener(new BaseQuickAdapter.OnItemLongClickListener() {
@Override
public boolean onItemLongClick(BaseQuickAdapter adapter, View view, int position) {
Toast.makeText(MainActivity.this, "长按了第" + position + "条", Toast.LENGTH_SHORT).show();
return false;
}
});

item中子控件的点击事件
首先在适配器中绑定子控件


public class UserAdapter extends BaseQuickAdapter {
public UserAdapter(int layoutResId, @Nullable List data) {
super(layoutResId, data);
}

@Override
protected void convert(BaseViewHolder helper, User item) {
Glide.with(mContext).load(item.getHeadUrl()).into((ImageView)helper.getView(R.id.iv_head));
helper.setText(R.id.tv_name, item.getName());
//绑定点击事件
helper.addOnClickListener(R.id.iv_head);
helper.addOnClickListener(R.id.tv_name);
}
}

接着在activity中就可以监听到子控件的点击事件,根据view.getId()来区分点击了哪一个子控件


		adapter.setOnItemChildClickListener(new BaseQuickAdapter.OnItemChildClickListener() {
@Override
public void onItemChildClick(BaseQuickAdapter adapter, View view, int position) {
switch (view.getId()) {
case R.id.iv_head:
Toast.makeText(MainActivity.this, "点击了第" + position + "的头像",
Toast.LENGTH_SHORT).show();
break;
case R.id.tv_name:
Toast.makeText(MainActivity.this, "点击了第" + position + "的名字",
Toast.LENGTH_SHORT).show();
break;
default:
break;
}
}
});

子控件的长按事件也是如此。


常用方法


上面介绍了基本的使用方法,还有很多常用的方法这里列举一下:


方法名说明
getData()获取适配器中的数据
addData(data)向列表中添加数据(可一条,可多条)
setData(position, data)修改指定位置的数据
setNewData(List)设置适配器新的数据
notifyDataSetChanged()刷新适配器
remove(position)删除指定数据

BaseRecyclerViewAdapterHelper还有很多其他功能,例如列表加载动画、下拉刷新、上拉加载、添加分组、自定义不同的item、拖拽item等,这里就不一一列举出来,有兴趣的可以去官方GitHub了解更多,地址如下:https://github.com/CymChad/BaseRecyclerViewAdapterHelper


资源下载:BaseRecyclerViewAdapterHelper-master (1).zip

0 个评论

要回复文章请先登录注册