BRVAH是一个强大的RecyclerAdapter框架(什么是RecyclerView?),它能节约开发者大量的开发时间,集成了大部分列表常用需求解决方案。为什么会有它?请查看「Android开源框架BRVAH由来篇」该框架于2016年4月10号发布的第1个版本到现在已经一年多了,经历了800多次代码提交,140多次版本打包,修复了1000多个问题,获得了9000多star,非常感谢大家的使用以及反馈。
本篇为BRVAH的使用指南以及包含常见问题会第一时间更新最新的使用方法。最新版本请查看releases,由于持续更新。
下面我们就来看看这个开源框架的使用吧
package com.example.Adapter;import com.chad.library.adapter.base.BaseQuickAdapter;
import com.chad.library.adapter.base.viewholder.BaseViewHolder;
import com.example.brvhrecycleviewadapter.R;
import com.example.domain.Person;
import com.example.domain.Pictures;import org.jetbrains.annotations.NotNull;import java.util.List;public class myAdapter extends BaseQuickAdapter {public myAdapter(int layoutResId, List data) {super(layoutResId,data);}@Overrideprotected void convert(@NotNull BaseViewHolder baseViewHolder, Person person) {// 链式//可链式调用赋值baseViewHolder.setText(R.id.textView, "第"+ person.getId() + "条数据").setText(R.id.name2, person.getName())
// .addOnClickListener(R.id.button)//给按钮添加点击事件.setImageResource(R.id.imageView,R.drawable.cm);}
}
注意
这是错误写法,对于布局中的的那个item对象的子控件监听这种方法已经被干掉了,新的方法需要在主活动MainActivity.class中注册。
例如:
adapter2.addChildClickViewIds(R.id.img,R.id.tV);
注册布局中item对象里面的img控件和tV控件
package com.example.Adapter;import com.chad.library.adapter.base.BaseQuickAdapter;
import com.chad.library.adapter.base.viewholder.BaseViewHolder;
import com.example.brvhrecycleviewadapter.R;
import com.example.domain.Pictures;import org.jetbrains.annotations.NotNull;import java.util.List;public class youAdapter extends BaseQuickAdapter {public youAdapter(int layoutResId, List pictureData) {super(layoutResId,pictureData);}@Overrideprotected void convert(@NotNull BaseViewHolder baseViewHolder, Pictures pictures) {baseViewHolder.setText(R.id.tV,pictures.getName()).setBackgroundResource(R.id.img,pictures.getId());}
}
package com.example.brvhrecycleviewadapter;import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.recyclerview.widget.GridLayoutManager;
import androidx.recyclerview.widget.LinearLayoutManager;
import androidx.recyclerview.widget.RecyclerView;import android.animation.Animator;
import android.os.Bundle;
import android.view.View;
import android.widget.Toast;import com.chad.library.adapter.base.BaseQuickAdapter;
import com.chad.library.adapter.base.animation.AlphaInAnimation;
import com.chad.library.adapter.base.animation.BaseAnimation;
import com.chad.library.adapter.base.listener.OnItemChildClickListener;
import com.chad.library.adapter.base.listener.OnItemClickListener;
import com.chad.library.adapter.base.listener.OnItemLongClickListener;
import com.example.Adapter.myAdapter;
import com.example.Adapter.youAdapter;
import com.example.domain.Person;
import com.example.domain.Pictures;import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.TestOnly;import java.lang.reflect.Array;
import java.util.ArrayList;
import java.util.List;public class MainActivity extends AppCompatActivity {private RecyclerView recyclerView,recyclerView2;private List datas;// private List pictures;private List pictureData;private myAdapter adapter;private youAdapter adapter2;private int[] PictureId;@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);recyclerView = findViewById(R.id.RecyclerView);//实例化recyclerView2=findViewById(R.id.Recycle2);PictureId = new int[]{R.drawable.cm, R.drawable.cz, R.drawable.mht, R.drawable.nyg,R.drawable.pg, R.drawable.pt, R.drawable.sl, R.drawable.yt,R.drawable.cm,R.drawable.cz, R.drawable.mht, R.drawable.nyg,R.drawable.pg, R.drawable.pt,R.drawable.sl, R.drawable.yt};pictureData = new ArrayList<>();Pictures pictures;for (int i = 0; i < 16; i++) {pictures=new Pictures();pictures.setId(PictureId[i]);pictures.setName("第"+i+"个");pictureData.add(pictures);}//模拟数据datas = new ArrayList<>();Person person;for (int i = 0; i < 8; i++) {person = new Person();person.setId(i);person.setName("第" + i + "条内容");datas.add(person);}//todo 创建布局管理【必有】LinearLayoutManager layoutManager = new LinearLayoutManager(this);layoutManager.setOrientation(LinearLayoutManager.VERTICAL);recyclerView.setLayoutManager(layoutManager);GridLayoutManager gridLayoutManager=new GridLayoutManager(this,4);recyclerView2.setLayoutManager(gridLayoutManager);// GridLayoutManager gridLayoutManager=new GridLayoutManager(this,4);
// recyclerView.setLayoutManager(gridLayoutManager);//创建适配器adapter = new myAdapter(R.layout.item, datas);adapter2=new youAdapter(R.layout.grid_item,pictureData);
// adapter2.setAdapterAnimation(new BaseAnimation() {
// @NotNull
// @Override
// public Animator[] animators(@NotNull View view) {
// return new Animator[0];
// }
// });// 注册子控件点击事件的 button控件按钮adapter.addChildClickViewIds(R.id.button);adapter2.addChildClickViewIds(R.id.img,R.id.tV);// item 点击监听adapter.setOnItemClickListener(new OnItemClickListener() {@Overridepublic void onItemClick(@NonNull @NotNull BaseQuickAdapter, ?> adapter, @NonNull @NotNull View view, int position) {Toast.makeText(MainActivity.this, "你点击了第" + (position + 1) + "条信息", Toast.LENGTH_SHORT).show();}});// item长按监听adapter.setOnItemLongClickListener(new OnItemLongClickListener() {@Overridepublic boolean onItemLongClick(@NonNull @NotNull BaseQuickAdapter adapter, @NonNull @NotNull View view, int position) {Toast.makeText(MainActivity.this, "你长按了第" + (position + 1) + "条信息", Toast.LENGTH_SHORT).show();return false;}});// Listview 中item的点击事件监听adapter.setOnItemChildClickListener(new OnItemChildClickListener() {@Overridepublic void onItemChildClick(@NonNull @NotNull BaseQuickAdapter adapter, @NonNull @NotNull View view, int position) {Toast.makeText(MainActivity.this, "你点击了" + (position + 1) + "button按钮", Toast.LENGTH_SHORT).show();}});// 两个 adapter2 事件adapter2.setOnItemChildClickListener(new OnItemChildClickListener() {@Overridepublic void onItemChildClick(@NonNull @NotNull BaseQuickAdapter adapter, @NonNull @NotNull View view, int position) {switch (view.getId()){case R.id.img:Toast.makeText(MainActivity.this,"你点击了"+(position+1)+"图片",Toast.LENGTH_SHORT).show();break;case R.id.tV:Toast.makeText(MainActivity.this,"你点击了"+(position+1)+"文字",Toast.LENGTH_SHORT).show();break;}}});//给RecyclerView设置适配器recyclerView.setAdapter(adapter);recyclerView2.setAdapter(adapter2);adapter.notifyDataSetChanged();}}
package com.example.domain;public class Person {public int id;public String name;public int getId() {return id;}public void setId(int id) {this.id = id;}public String getName() {return name;}public void setName(String name) {this.name = name;}}
package com.example.domain;public class Pictures {int id;String name;public int getId() {return id;}public void setId(int id) {this.id = id;}public String getName() {return name;}public void setName(String name) {this.name = name;}}
效果图》》》
// 第二个布局添加自定义动画adapter2.setAdapterAnimation(new BaseAnimation() {@NotNull@Overridepublic Animator[] animators(@NotNull View view) {return new Animator[]{ObjectAnimator.ofFloat(view, "scaleY", 1, 0.1f, 1),ObjectAnimator.ofFloat(view, "scaleX", 1, 0.1f, 1)};}});
默认执行一次,想要反复执行可以自行设置。记得这段要添加在MainActivity.java的adapter2 new出来之后,setAdapter之前
空余时间别忘记了看看源码
~~~
说明:当adapter中数据不为空时,空布局不会生效
通过设置View为空布局
代码如下:
View view = ...
adapter.setEmptyView(view);
通过设置LayoutResId为空布局
代码如下:
adapter.setEmptyView(R.layout.loading_view);
设置是否使用空布局(默认为true)
代码如下:
// java
adapter.setUseEmpty(false);// kotlin
adapter.isUseEmpty = false
说明:此头部并不是item的头部,而是整个Adapter的头部
代码如下:
View view = ...;
adapter.addHeaderView(view);// 指定添加位置
adapter.addHeaderView(view, 1);// 替换头部
adapter.setHeaderView(view);
//替换指定位置头部
adapter.setHeaderView(view, 0);// 移除头部
adapter.removeHeaderView(view);
// 移除全部头部
adapter.removeAllHeaderView();
说明:此脚部不是item的脚部,而是整个Adapter的
代码如下:
View view = ...;
adapter.addFooterView(view);// 指定添加位置
adapter.addFooterView(view, 1);// 替换脚部
adapter.setFooterView(view);
//替换指定位置脚部
adapter.setFooterView(view, 0);// 移除脚部
adapter.removeFooterView(view);
// 移除全部脚部
adapter.removeAllFooterView();
是不是还是不太尽兴,那就来看看Github的详细解释吧。
BaseRecyclerViewAdapterHelper 使用详情页
BaseQuickAdapter主要属性、方法说明
空 | Java | Kotlin | 说明 |
---|---|---|---|
获取Context | getContext() | context | |
数据相关 | |||
获取Adapter中数据 | getData() | data | 只能get |
设置新的数据实例 | setNewData() | setNewData() | 将会替换List指针引用 |
添加数据 | addData() | addData() | |
移除数据 | remove() | remove() | |
改变某一位置的数据 | setData() | setData() | |
替换整个数据 | replaceData() | replaceData() | 不会更改原数据的引用 |
设置Diff数据(异步,推荐) | setDiffCallback() | setDiffCallback() | 配置数据差异化比较的Callback |
~ | setDiffConfig() | setDiffConfig() | 更高程度的自定义化配置 |
~ | setDiffNewData(List) | setDiffNewData(List?) | 必须先设置setDiffCallback() 或者 setDiffConfig(),否则不生效 |
设置Diff数据 | setDiffNewData(DiffResult, List) | setDiffNewData(DiffResult, List?) | 通过DiffResult设置数据,Adapter内部不关心Diff过程,只要结果。 |
空布局 | |||
设置空布局视图 | setEmptyView() | setEmptyView() | 仅当 data 为空时,才会显示 |
是否有空视图 | hasEmptyView() | hasEmptyView() | |
获取空视图 | getEmptyLayout() | getEmptyLayout() | |
是否使用空布局 | setUseEmpty() | isUseEmpty | |
头布局 | |||
添加头布局 | addHeaderView() | addHeaderView() | |
设置头布局 | setHeaderView() | setHeaderView() | |
是否有头布局 | hasHeaderLayout() | hasHeaderLayout() | |
移除头布局 | removeHeaderView() | removeHeaderView() | |
移除所有头布局 | removeAllHeaderView() | removeAllHeaderView() | |
脚布局 | |||
添加脚布局 | addFooterView() | addFooterView() | |
设置脚布局 | setFooterView() | setFooterView() | |
是否有脚布局 | hasFooterLayout() | hasFooterLayout() | |
移除脚布局 | removeFooterView() | removeFooterView() | |
移除所有脚布局 | removeAllFooterView() | removeAllFooterView() | |
布局其他属性 | |||
当显示空布局时,是否显示 头布局 | setHeaderWithEmptyEnable() | headerWithEmptyEnable | |
当显示空布局时,是否显示 脚布局 | setFooterWithEmptyEnable() | footerWithEmptyEnable | |
点击事件 | |||
item点击事件 | setOnItemClickListener() | 同java | |
item长按事件 | setOnItemLongClickListener | 同java | |
item子view的点击事件 | setOnItemChildClickListener | 同java | |
item子view的长按事件 | setOnItemChildLongClickListener | 同java | |
添加需要响应点击事件的子View id | addChildClickViewIds() | 同java | 添加以后,setOnItemChildClickListener才会响应 |
添加需要响应长按事件的子View id | getChildLongClickViewIds() | 同java | |
动画 | |||
是否打开动画 | setAnimationEnable() | animationEnable | 默认:false |
动画是否仅第一次执行 | setAnimationFirstOnly() | isAnimationFirstOnly | |
设置自定义动画 | setAdapterAnimation() | adapterAnimation | |
设置使用内置默认动画 | setAnimationWithDefault() | setAnimationWithDefault() | 参数为枚举 |
觉得有用的可以给个三连,关注一波!!!带你了解更多的Android框架