1024程序节|Android框架之一 BRVAH【BaseRecyclerViewAdapterHelper】使用demo

BRVAH是一个强大的RecyclerAdapter框架(什么是RecyclerView?),它能节约开发者大量的开发时间,集成了大部分列表常用需求解决方案。为什么会有它?请查看「Android开源框架BRVAH由来篇」该框架于2016年4月10号发布的第1个版本到现在已经一年多了,经历了800多次代码提交,140多次版本打包,修复了1000多个问题,获得了9000多star,非常感谢大家的使用以及反馈。
本篇为BRVAH的使用指南以及包含常见问题会第一时间更新最新的使用方法。最新版本请查看releases,由于持续更新。

下面我们就来看看这个开源框架的使用吧
在这里插入图片描述

🍓🍓BRVAH 上部

🍄🍓动态图结果展示

在这里插入图片描述


🍄🍄myAdapter.java【第一个布局适配器】

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<Person, BaseViewHolder> {
    public myAdapter(int layoutResId, List<Person> data) {
        super(layoutResId,data);
    }

    @Override
    protected 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控件


🍄🍄youAdapter.java【第二个布局适配器】

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<Pictures, BaseViewHolder> {
    public youAdapter(int layoutResId, List<Pictures> pictureData) {
        super(layoutResId,pictureData);
    }


    @Override
    protected void convert(@NotNull BaseViewHolder baseViewHolder, Pictures pictures) {
        baseViewHolder
                .setText(R.id.tV,pictures.getName())
                .setBackgroundResource(R.id.img,pictures.getId());
    }
}


🍄🍄MainActivity.java【主活动】

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<Person> datas;
    //    private List<Pictures> pictures;
    private List<Pictures> pictureData;
    private myAdapter adapter;
    private youAdapter adapter2;
    private int[] PictureId;

    @Override
    protected 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() {
            @Override
            public 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() {
            @Override
            public 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() {
            @Override
            public 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() {
            @Override
            public 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();
    }

}

🍄🍄Person.java【Person对象类】

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;
    }


}



🍄🍄Pictures.java【Picture对象类】

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;
    }



}



🍓🍓BRVAH 下部


🍎🍎自定义动画

效果图》》》

// 第二个布局添加自定义动画
        adapter2.setAdapterAnimation(new BaseAnimation() {
            @NotNull
            @Override
            public 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主要属性、方法说明

JavaKotlin说明
获取ContextgetContext()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 idaddChildClickViewIds()同java添加以后,setOnItemChildClickListener才会响应
添加需要响应长按事件的子View idgetChildLongClickViewIds()同java
动画
是否打开动画setAnimationEnable()animationEnable默认:false
动画是否仅第一次执行setAnimationFirstOnly()isAnimationFirstOnly
设置自定义动画setAdapterAnimation()adapterAnimation
设置使用内置默认动画setAnimationWithDefault()setAnimationWithDefault()参数为枚举






觉得有用的可以给个三连,关注一波!!!带你了解更多的Android框架

评论 69
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

不良使

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值