基于DataBinding的基础View绑定库

Table of Contents

• 1. 写在前面
• 2. 缩略图
• 3. 如何引入
  • 3.1. step1
  • 3.2. step2
• 4. 如何使用
  • 4.1. 一般控件
    • 4.1.1. 涉及到的类
    • 4.1.2. 属性
  • 4.2. RecycleView
    • 4.2.1. 属性
    • 4.2.2. 代码说明
• 5. 参考
• 6. License

同步个人博客：

基于DataBinding的基础View绑定库
github地址：https://github.com/itlwy/DBindingView

写在前面

一个对databinding的常用封装库,包含基础控件及recycleview等。不了解databinding的可以先阅读相关网上的资料,这里推荐
Android DataBinding介绍

缩略图

如何引入

step1

Add the JitPack repository to your build file

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

step2

Add the dependency

dependencies {
                compile 'com.github.itlwy:DBindingView:v1.1.14'
        }

如何使用

一般控件

如上面的动态图,目前展示了基本控件的进行一些初始化的封装,目的是将一些繁琐的初始化操作自动化掉。注意,这里用到的属性均是自定义属性,前缀请用app:

涉及到的类

类名	包名	说明
KeyValue	com.lwy.dbindingview.data	存储key(Integer)-value(String),主要用于spinner、checkbox、radiogroup等,实现数据源的key-label模式
BindingSpinner	com.lwy.dbindingview.bindingadapter.spinner	封装的双向绑定自定义Spinner
DataBindingRadioGroup	com.lwy.dbindingview.bindingadapter.radiogroup	封装的双向绑定自定义RadioGroup
DataBindingRadioButton	com.lwy.dbindingview.bindingadapter.radiogroup	封装的双向绑定自定义RadioButton
BindingCheckGroup	com.lwy.dbindingview.bindingadapter.checkbox	封装的双向绑定自定义LinearLayout,用作BindingCheckBox容器
BindingCheckBox	com.lwy.dbindingview.bindingadapter.checkbox	封装的双向绑定自定义CheckBox
BindingEditText	com.lwy.dbindingview.bindingadapter.edittext.BindingEditText	让EditText支持绑定数值类型,eg:Integer、Double…

属性

控件	自定义属性	值类型	值	说明
BindingSpinner	selectedValue	KeyValue		绑定选中的值
	spinneritems	List		spinner的适配器数据源
DataBindingRadioGroup	selectedValue	KeyValue		绑定RadioGroup选中的值
	items	List		设置该属性可动态渲染子view
	childViewFactory	DBCustomViewFactory		当设置了items属性时,可通过此属性传入继承自DataBindingRadioButton的自定义view,不设则用默认类
DataBindingRadioButton	value	KeyValue		初始化RadioButton的值
BindingCheckGroup	selectedValues	List		存储checkbox选中的值,默认用,分割
	items	List		设置该属性可动态渲染子view
	childViewFactory	DBCustomViewFactory		当设置了items属性时,可通过此属性传入继承自BindingCheckBox的自定义view,不设则用默认类
BindingCheckBox	value	KeyValue		设置值
ImageView	uri	String or ObservableField		图片的url,用的加载框架是glide
	placeholderImageRes	int	eg:R.mipmap.ic_launcher	占位图
	request_width、request_width	int		设置图片的大小,不设置默认用view的大小,2个属性必修同时设置才有效
View	clickCommand	ReplyCommand		点击事件触发的命令
	display	boolean		控制view的Visibility
BindingEdittext	textDouble、textInt、textFloat、textLong	Double、Float、Integer、Long		绑定数值类型
	regularExpression			正则表达式校验输入值

具体使用很简单,直接看demo–>com.lwy.dbindingview.base_widget.WidgeActivity

这里说明下DataBindingRadioGroup和BindingCheckGroup,

这里的app:items属性,让其根据sexList动态渲染子view(DataBindingRadioButton),也可以选择在布局里直接写子View，如：

---

BindingCheckGroup同理

RecycleView

属性

属性	值类型	值	说明
itemBinding	ItemBinding		必填,item的布局和变量的绑定关系包装类
items	List		必填,数据源
adapter	BindingRecyclerViewAdapter		选填,可继承BindingRecyclerViewAdapter自定义适配器
itemIds	BindingRecyclerViewAdapter.ItemIds		选填,不设置则默认使用position
viewHolder	BindingRecyclerViewAdapter.ViewHolderFactory		选填,可继承以实现自定义ViewHolder
onItemClick	BindingRecyclerViewAdapter.OnItemClickListener		item点击事件
layoutManager	LayoutManagers.LayoutManagerFactory		必填,布局方式,如线性:LayoutManagers.linear()

代码说明

1. 单个布局的简单列表代码片段

   1、定义viewmodel

   public class ItemVM extends BaseObservable {
       public final boolean checkable; // for now,it's useless
       @Bindable
       private int index;
       @Bindable
       private boolean checked;
   
       public ItemVM(int index, boolean checkable) {
           this.index = index;
           this.checkable = checkable;
       }
   
       public int getIndex() {
           return index;
       }
   
       public boolean isChecked() {
           return checked;
       }
   
       public boolean onToggleChecked(View v) {
           if (!checkable) {
               return false;
           }
           checked = !checked;
   //        notifyPropertyChanged(com.lwy.dbindingview.BR.checked);
           return true;
       }
   }
   

   2、定义Item布局文件R.layout.item

   3、创建layout和viewmodel变量的绑定关系包装类

   public final ItemBinding singleItem = ItemBinding.of(com.lwy.dbindingview.BR.item, R.layout.item);
   

   4、创建数据源

   public final ObservableList items = new ObservableArrayList<>();
   

   5、设置RecycleView的属性

   ...
    
    ...
   

2. 复杂布局代码片段

   1、定义viewmodel(同上)

   2、定义Item布局文件R.layout.item(同上)

   3、创建footer的viewmodel

   public class FooterVM extends RcVFooterVM {
   
       public final ReplyCommand clickCommand = new ReplyCommand(new Action0() {
           @Override
           public void call() {
               if (!getIsFooterLoading().get()) {
                   switchLoading(true);
                   callback.execute();
               }
   
           }
       });
   
       private ReplyCommand callback;
   
   
       public final ObservableField noMoreTip = new ObservableField<>();
       /*
           state : 0 loading
           state : 1 idle
        */
       public final ObservableField state = new ObservableField<>();
   
   
       public FooterVM(ReplyCommand callback) {
           super();
           this.callback = callback;
           switchLoading(false);
           noMoreTip.set("暂无更多");
       }
   
       @Override
       protected ReplyCommand geneOnLoadMoreCommand() {
           return new ReplyCommand<>(new Action1() {
               @Override
               public void call(Integer integer) {
                   FooterVM.this.callback.execute();
   //                switchLoading(true);
               }
           });
       }
   
       @Override
       public void switchLoading(boolean flag) {
           if (flag) {
               state.set(0);
           } else {
               state.set(1);
           }
           super.switchLoading(flag);
       }
   }
   

   4、创建footer的布局文件R.layout.default_loading

   5、创建layout和viewmodel变量的绑定关系包装类

   // 这里根据class类型来控制不同的item
   public final ItemBinding