美文网首页Android技术知识Android开发Android
解放双手的列表[单选]、[多选]库——CheckHelper v

解放双手的列表[单选]、[多选]库——CheckHelper v

作者: 鸡汤程序员 | 来源:发表于2019-03-13 09:54 被阅读12次

一 瞎扯淡

你还在为列表[单选]、[多选]写重复的逻辑吗

项目中经常性会碰到列表的单选、多选,实现起来好像也不难,但是最近项目有好多个需要单选/多选的页面,看到设计稿的一瞬间,脑子灵光一闪,为啥不把这些简单而又繁琐的逻辑给封装起来呢(懒癌发作)?

于是就有了下面的小东西(开源库)...

二 功能

1.功能

  • 普通单选
  • 普通多选
  • 预选中
  • 拦截器
  • ...

3.优点

  • 简单易用
  • 低耦合
  • 不用为Bean添加额外字段
  • 没有调用 Adapter.notifyItemChange方法,所以不会有闪屏Bug

三 使用

1.配置

[图片上传失败...(image-c19eda-1552441902508)]
Step 1. 在你项目的 Project (根目录)的 build.gradle 文件添加下面配置:

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

Step 2. 在需要使用的模块下添加以下依赖

    dependencies {
            //Tag更换成最新的版本号,比如 1.1
            implementation 'com.github.gminibird:CheckHelper:Tag'
    }

依赖包中依赖了RecyclerView,如果项目中已经使用了不同版本,可以使用以下配置:

    dependencies {
            //Tag更换成最新的版本号,比如 1.1
            implementation 'com.github.gminibird:CheckHelper:Tag',{
                exclude group: 'com.android.support'
            }
    }

最后那个1.0是版本号,可以上 GitHub 上看最新的,然后就可以愉快的玩耍啦。

2.使用

  • 创建CheckHelper实例
    SingleCheckHelper mCheckHelper = new SingleCheckHelper();
    //or
    MultiCheckHelper mCheckHelper = new MultiCheckHelper();
    
  • 注册选择器
    mCheckHelper.register(String.class, new CheckHelper.Checker<String, LwViewHolder>() 
    @Override
    public void check(String s, LwViewHolder holder) {
        //选中状态
        holder.itemView.setBackgroundColor(0xFF73E0E4); //蓝色
        holder.setChecked(R.id.checkbox, true);
    }
    @Override
    public void unCheck(String s, LwViewHolder holder) {
        //非选中状态
        holder.itemView.setBackgroundColor(0xFFFFFFFF);  //白色
        holder.setChecked(R.id.checkbox, false);
    }
    });
    
  • 绑定到Adapter中
    @Override
    protected void onBind(@NonNull LwViewHolder holder, @NonNull String item) {
        //这里用了自己封装的Adapter,相当于onBindViewHolder方法
        mCheckHelper.bind(item, holder, holder.itemView);
    }
    

然后,然后就完成了。。。运行就可以看到想要的效果,选中的数据可以调用相应CheckHelper实例的getXXX()获取。

四 效果

废话少说,先上图:

1.左到右分别为 单选->多选->拦截器

<center>
<img src="https://user-gold-cdn.xitu.io/2019/1/27/1688e64e15aa79dc?w=374&h=607&f=gif&s=1047346" width ="240">
<img src="https://user-gold-cdn.xitu.io/2019/1/27/1688e65eea8cb4ed?w=374&h=607&f=gif&s=1119303"
width ="240">
<img src="https://user-gold-cdn.xitu.io/2019/2/25/169235cacfe71475?w=368&h=598&f=gif&s=1349327"
width ="240">
</center>

五 Api

1. CheckHelper (基类)

返回值 方法 说明
void register(Class, Checker) 注册Checker,提供选中以及非选中状态
void bind(Object, ViewHolder) 绑定,没有指定点击View,需要额外设置点击事件,并主动调用select()方法
void bind(Object,ViewHolder, @IdRes int) 绑定,并指定触发事件的 View id
void bind(Object,ViewHolder, View) 绑定,并指定触发事件的 View
void bind(Object, ViewHolder, boolean) 手动绑定
void select(Object, ViewHolder) 手动选择(状态值非当前状态的相反值)
void select(Object, ViewHolder, boolean) 手动选择(可设置状态)
void addOnCheckListener(Class,OnCheckListene) 添加check监听(触发条件为bind监听与select监听的并集)
void addOnSelectListener(Class,OnSelectListener) 添加select监听(点击时调用)
void addOnBindListener(Class,onBindListener) 添加bind监听(onBindViewHolder调用时调用)
void addInterceptor(Interceptor interceptor) 添加拦截器
boolean isChecked(Object,ViewHolder) 判断当前实例是否选中
boolean hasChecked() 判断是否至少选中一个
void add(Object) 添加默认选中
void remove(Object) 删除选中
T getChecked() 获取所有选中

2. SingleCheckHelper(单选)

返回值 方法 说明
void setCanCancel(booleanl) 设置是否可以取消

3. MultiCheckHelper(多选)

返回值 方法 说明
Set<T> getChecked(Class<T>) 获取指定类型的所有选中
boolean isAllChecked(List<?>) 指定列表是否全部选中
boolean isAllChecked(List<?>, Class<T>) 指定列表里面的指定类型是否全部选中
void checkAll(Map<?,ViewHolder>) 选择全部(指定数据)
void checkAll(List<?>, Adapter) 选择全部(指定数据)
void unCheckAll(Adapter adapter) 取消全部选中
void unCheckAll(Adapter adapter, Class<T>, List<T>) 取消全部选中(指定数据)
void unCheckAll(Adapter, Class) 取消全部选中(指定数据,指定类型)



written by gminibird

源码戳上面 ^^^

相关文章

  • 解放双手的列表[单选]、[多选]库——CheckHelper v

    一 瞎扯淡 你还在为列表[单选]、[多选]写重复的逻辑吗 项目中经常性会碰到列表的单选、多选,实现起来好像也不难,...

  • Spring MVC 表单标签库

    文本框 密码处理 文本域 复选框 复选框(多选) 单选按钮 多项单选按钮 下拉选项 列表多选框 隐藏字段域 错误处...

  • flutter 布局

    From 表单组件允许用户输入内容,下拉列表,单选、多选。表单元素:TextFromField ListView ...

  • 更换单选与多选样式

    HTML: JQ: CSS: 单选与多选img: 单选: 多选:

  • v-model select

    1.单选 v-model绑定的是一个值 2.多选 v-model绑定的是一个数组 选择时要按住ctrl再多选

  • input的代码类

    账号框 密码框 下拉列表 选项1 选项2 选项3 单选 男: 女: 多选 A B C 按钮...

  • HTML 表单应用

    账号框 密码框 下拉列表 选项1 选项2 选项3 单选 男: 女: 多选 A B C...

  • RecyclerView的通用快速适配封装

    这次的主题是封装RecyclerView的单选多选,现在大家应该都是用的RecyclerView开发列表数据吧。网...

  • 表单应用

    账号框 密码框 下拉列表 选项1 选项2 选项3 单选 男: 女: 多选 A B C 按钮 或

  • Android Dialog

    对话框:确认,单选,多选,列表,自定义activity_main.xml dialog_layout.xml Ma...

网友评论

    本文标题:解放双手的列表[单选]、[多选]库——CheckHelper v

    本文链接:https://www.haomeiwen.com/subject/epaapqtx.html