DataBinding使用(一):布局和binding表达式
DataBinding使用(二):可观察的数据对象
DataBinding使用(三):DataBinding高级使用
一、动态变量
有时候我们可能不知道Binding类的名称,比如RecyclerView.Adapter
中item布局可能有很多,并不会对应特定的Binding类,但任然需要通过onBindViewHolder(VH, int )
去绑定数据
public void onBindViewHolder(BindingHolder holder, int position) {
final T item = mItems.get(position);
holder.getBinding().setVariable(BR.item, item);
holder.getBinding().executePendingBindings();
}
- Immediate Binding
当一个被绑定的变量或绑定的对象发生变化时,DataBinding 会让这些改变排队去在下一帧出现之前改变,有些时候binding效果要立即执行,这时候就用到executePendingBindings()
- Background Thread
只要绑定数据不是一个collection,我们可以在非ui主线程去改变数据,不会有任何线程切换问题,DataBinding会自动处理。
二、Attribute Setters
当一个被绑定的数据的值发生改变时,Binding类会自动寻找该view上的绑定表达式上的方法去改变view,通过数据绑定框架还可以自定义这些方法。
对于一个xml的attribute,DataBinding去寻找setAttribute方法,xml属性的命名空间是没有关系的。比如TextView上的一个属性android:text,会去寻找setText(String)。如果表达式返回的是int则会去寻找setText(int),所以必须确保xml中表达式返回正确的数据类型,必要时需要数据转换。我们可以比较容易地为任何属性创造出setter去使用dataBinding。比如support包下的DrawerLayout没有任何属性,但是确有很多setter,下面利用这些已有的setter中的一个:
<android.support.v4.widget.DrawerLayout
android:layout_width="wrap_content"
android:layout_height="wrap_content"
app:scrimColor="@{@color/scrim}"
app:drawerListener="@{fragment.drawerListener}"/>
- 自定义setters
有些xml属性需要自己去定义并实现逻辑,比如android:paddingLeft。但是setPadding(left,top,right,bottom)是存在的,那么可以用BindingAdapter
注解去自定义setter:
@BindingAdapter("android:paddingLeft")
fun setPaddingLeft(view: View, padding:Int ) {
view.setPadding(padding,
view.getPaddingTop(),
view.getPaddingRight(),
view.getPaddingBottom());
}
自定义的BindingAdapter和android自带的发生冲突时,DataBinding优先采用开发者自定义的。
- 多参数的BindingAdapter
@BindingAdapter("imageUrl", "error")
fun loadImage(view: ImageView, url:String, error: Drawable) {
Picasso.with(view.getContext()).load(url).error(error).into(view)
}
布局中使用
<ImageView
app:imageUrl="@{data.imageUrl}"
app:error="@{@drawable/venueError}" />
- BindingAdpater方法可以对属性的旧值和新值进行处理
@BindingAdapter("android:paddingLeft")
fun setPaddingLeft(view: View, oldPadding: Int, newPadding: Int) {
if (oldPadding != newPadding) {
view.setPadding(
newPadding,
view.paddingTop,
view.paddingRight,
view.paddingBottom
)
}
}
使用这个方法首先要声明属性的所有旧值,然后再声明新值
- 事件处理
@BindingAdapter("android:onLayoutChange")
fun setOnLayoutChangeListener(
view: View, oldValue: View.OnLayoutChangeListener?,
newValue: View.OnLayoutChangeListener?
) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
if (oldValue != null) {
view.removeOnLayoutChangeListener(oldValue)
}
if (newValue != null) {
view.addOnLayoutChangeListener(newValue)
}
}
}
布局中使用
<View android:onLayoutChange="@{() -> events.layoutChanged()}"/>
三、双向绑定
在xml属性上使用语法"@={}"
...
<TextView android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@={user.name}"/>
四、转换器(Converters)
在 xml 中为属性赋值时,如果变量的类型与属性不一致,通过 DataBinding 可以进行转换。
<Button
android:onClick="toggleIsError"
android:text="@{isError.get() ? @color/red : @color/white}"
android:layout_width="match_parent"
android:layout_height="wrap_content" />
只需要定义一个标记了 @BindingConversion 的方法即可:
@BindingConversion
fun convertColorToString(color: Int): Int {
when (color) {
Color.RED -> return R.string.red
Color.WHITE -> return R.string.white
}
return R.string.app_name
}
五、自定义binding类名
通过调整data元素的class属性,将 binding 类进行重命名或放置在不同的包中。例如,以下布局会生成ContactItem binding类,位于当前模块的databinding包中:
<data class="ContactItem">
…
</data>
可以通过在类名前添加一个句点来在不同的包中生成binding类。以下示例在模块包中生成binding类:
<data class=". ContactItem">
…
</data>
也可以在要生成binding类的位置使用完整的包名称。以下示例在com.example包中创建ContactItem 绑定类 :
<data class="com.example.ContactItem">
…
</data>