前言
在用到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:
* <p>
* Created by pei
* Date: 2017/12/29
*/
public abstract class ComAdapter<T> extends BaseQuickAdapter<T, BaseViewHolder> {
protected Context mContext;
protected List<T>mData;
protected int mItemViewId;//item布局id
protected View mHeaderView;
protected View mFooterView;
public ComAdapter(int itemViewId,List<T>data,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:
* <p>
* Created by pei
* Date: 2017/12/29
*/
public class NameAdapter<T>extends ComAdapter {
private TextView mTvName;
public NameAdapter(List<T> 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布局代码很简单,如下:
<?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="60dp"
android:orientation="vertical"
android:gravity="center_vertical"
android:background="#ff0000">
<TextView
android:id="@+id/tv_name"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="2dp"
android:layout_marginBottom="2dp"
android:background="#0000ff"/>
</LinearLayout>
四.在MainActivity中的简单使用
4.1先给出MainActivity的布局activity_main.xml,代码很简单,只做展示
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context="com.brvahdemo.MainActivity"
android:orientation="vertical">
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Hello World!"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintLeft_toLeftOf="parent"
app:layout_constraintRight_toRightOf="parent"
app:layout_constraintTop_toTopOf="parent" />
<android.support.v7.widget.RecyclerView
android:id="@+id/recycler_view"
android:layout_width="match_parent"
android:layout_height="wrap_content"/>
</LinearLayout>
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 List<String>mNameList;
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库的简单介绍就到这里了,谢谢诶。
网友评论