前言
在用到RecycleView的时候，通常会写一个adapter，然后是一堆的垃圾代码，为了让adapter用起来更简便，代码更少，今天介绍一个强大的adapter库------BRVAH
本文参考以下链接：
BRVAH官网
BRVAH官方使用指南(持续更新)
BRVAH版本更新说明
在此对作者表示感谢
今天只是对此adapter对一般的点击事件及展示做一个介绍，更多使用方法，请参考上面链接
今天涉及知识：
- BRVAH 框架配置
- 对界面展示及基本点击事件做简单"封装"
- 在activity中使用
一.BRVAH 框架配置
BRVAH的配置比一般的库配置要多出一步，就是配置maven。
1.1在project的build.gradle中配置maven
在project的build.gradle的allprojects下的repositories中配置,代码如下：
maven { url "https://jitpack.io" }
具体代码如下：
//在这里引入config.gradle
apply from:"config.gradle"
buildscript {
repositories {
google()
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:3.0.0'
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
}
allprojects {
repositories {
google()
jcenter()
maven { url "https://jitpack.io" }
}
}
task clean(type: Delete) {
delete rootProject.buildDir
}
这里需要注意的有两点：
- 配置的是project的build.gradle,而不是app module的build.gradle
- maven写在allprojects-->repositories 下，而不是buildscript -->repositories 下，切记！
1.2在app module的build.gradle中引入库依赖：
//我使用时，最新版本为 2.9.34
compile 'com.github.CymChad:BaseRecyclerViewAdapterHelper:2.9.34'
自此，BRVAH库配置完毕
二.写一个父类Adapter以供一般的adapter使用，adapter名称问为ComAdapter
注：此adapter只专注于一般的展示及点击事件，和简单header和footer的添加，若有比较复杂的用途，需要自己重新写一个adapter，此ComAdapter并不适用于复杂情况
ComAdapter代码如下：
package com.adapter;
import android.content.Context;
import android.support.v7.widget.LinearLayoutManager;
import android.support.v7.widget.RecyclerView;
import android.view.LayoutInflater;
import android.view.View;
import com.chad.library.adapter.base.BaseQuickAdapter;
import com.chad.library.adapter.base.BaseViewHolder;
import com.chad.library.adapter.base.animation.BaseAnimation;
import java.util.List;
/**
* Title:RecyclerView适配器基类
* Description:
*
* Created by pei
* Date: 2017/12/29
*/
public abstract class ComAdapter extends BaseQuickAdapter {
protected Context mContext;
protected ListmData;
protected int mItemViewId;//item布局id
protected View mHeaderView;
protected View mFooterView;
public ComAdapter(int itemViewId,Listdata,Context context) {
super(itemViewId, data);
this.mItemViewId=itemViewId;
this.mContext=context;
this.mData=data;
}
@Override
protected void convert(BaseViewHolder viewHolder, T t) {
initView(viewHolder,t);
initData(viewHolder,t);
setListener(viewHolder,t);
}
protected abstract void initView(BaseViewHolder viewHolder, T t);
protected abstract void initData(BaseViewHolder viewHolder, T t);
protected abstract void setListener(BaseViewHolder viewHolder, T t);
/**获取position，当添加有header或footer要注意改变**/
public int getPosition(BaseViewHolder viewHolder){
return viewHolder.getLayoutPosition();
}
/**获取headerView**/
protected View getHeaderView(int headerViewId) {
if(mContext!=null){
mHeaderView=LayoutInflater.from(mContext).inflate(headerViewId, null);
}
return mHeaderView;
}
/**获取footerView**/
protected View getFooterView(int footerViewId) {
if (mContext != null&&mFooterView==null) {
mFooterView = LayoutInflater.from(mContext).inflate(footerViewId, null);
}
return mFooterView;
}
/**添加headerView**/
public void addHeaderView(int headerViewId){
addHeaderView(getHeaderView(headerViewId));
};
/**添加footerView**/
public void addFooterView(int footerViewId){
addFooterView(getFooterView(footerViewId));
}
/**设置RecyclerView**/
public void setRecyclerManager(RecyclerView recyclerView){
LinearLayoutManager layoutManager=new LinearLayoutManager(mContext);
layoutManager.setSmoothScrollbarEnabled(true);
layoutManager.setAutoMeasureEnabled(true);
recyclerView.setNestedScrollingEnabled(false);
recyclerView.setHasFixedSize(true);
recyclerView.setLayoutManager(layoutManager);
recyclerView.setAdapter(this);
openLoadAnimation();//默认adapter渐现效果
}
/**adapter渐现动画**/
public void openAlphaAnimation(){
openLoadAnimation(BaseQuickAdapter.ALPHAIN);
}
/**adapter缩放动画**/
public void openScaleAnimation(){
openLoadAnimation(BaseQuickAdapter.SCALEIN );
}
/**adapter从下到上动画**/
public void openBottomAnimation(){
openLoadAnimation(BaseQuickAdapter.SLIDEIN_BOTTOM );
}
/**adapter从左到右动画**/
public void openLeftAnimation(){
openLoadAnimation(BaseQuickAdapter.SLIDEIN_LEFT );
}
/**adapter从右到左动画**/
public void openRightAnimation(){
openLoadAnimation(BaseQuickAdapter.SLIDEIN_RIGHT );
}
/**自定义动画**/
public void openLoadAnimation(BaseAnimation animation){
}
}
三.写自己的适配器NameAdapter，继承于ComAdapter
package com.adapter;
import android.content.Context;
import android.widget.TextView;
import com.brvahdemo.R;
import com.chad.library.adapter.base.BaseViewHolder;
import java.util.List;
/**
* Title:
* Description:
*
* Created by pei
* Date: 2017/12/29
*/
public class NameAdapterextends ComAdapter {
private TextView mTvName;
public NameAdapter(List data, Context context){
super(R.layout.item_layout,data,context);
}
@Override
protected void initView(BaseViewHolder viewHolder, Object o) {
mTvName=viewHolder.getView(R.id.tv_name);
}
@Override
protected void initData(BaseViewHolder viewHolder, Object o) {
mTvName.setText(o.toString());
}
@Override
protected void setListener(BaseViewHolder viewHolder, Object o) {
//mTvName点击事件
viewHolder.addOnClickListener(mTvName.getId());
}
}
涉及到的item_layout.xml布局代码很简单，如下：
四.在MainActivity中的简单使用
4.1先给出MainActivity的布局activity_main.xml,代码很简单，只做展示
4.2 MainActivity中使用代码
废话不多说，直接上代码是王道
package com.brvahdemo;
import android.support.v7.widget.RecyclerView;
import android.view.View;
import android.widget.Toast;
import com.adapter.NameAdapter;
import com.base.AppActivity;
import com.chad.library.adapter.base.BaseQuickAdapter;
import java.util.Arrays;
import java.util.List;
import butterknife.BindView;
public class MainActivity extends AppActivity {
@BindView(R.id.recycler_view)
RecyclerView mRecyclerView;
private ListmNameList;
private NameAdapter mNameAdapter;
@Override
public int getContentViewId() {
return R.layout.activity_main;
}
@Override
protected void initData() {
mNameList= Arrays.asList("小明","小红","小芳","小花","小海","小林","小叶","小虎","小柔");
mNameAdapter=new NameAdapter(mNameList,mContext);//初始化NameAdapter
mNameAdapter.setRecyclerManager(mRecyclerView);//设置RecyclerView特性
mNameAdapter.addHeaderView(R.layout.item_header);//添加header
mNameAdapter.addFooterView(R.layout.item_footer);//添加footer
mNameAdapter.openLeftAnimation();//设置加载动画
}
@Override
protected void setListener() {
//item點擊事件
mNameAdapter.setOnItemClickListener(new BaseQuickAdapter.OnItemClickListener() {
@Override
public void onItemClick(BaseQuickAdapter adapter, View view, int position) {
Toast.makeText(MainActivity.this, "onItemLongClick" + position, Toast.LENGTH_SHORT).show();
}
});
//子空控件点击事件
mNameAdapter.setOnItemChildClickListener(new BaseQuickAdapter.OnItemChildClickListener() {
@Override
public void onItemChildClick(BaseQuickAdapter adapter, View view, int position) {
Toast.makeText(MainActivity.this, "onItemLongClick" + mNameList.get(position), Toast.LENGTH_SHORT).show();
}
});
}
}
其中addHeaderView时的R.layout.item_header.xml和addFooterView时的R.layout.item_footer.xml是随便写的布局，仅供测试之用，这里就不展示出来了。
ok，今天对BRVAH库的简单介绍就到这里了，谢谢诶。