目录
- 简介
- 启用databinding
- 布局xml
- variable (变量标签)
- data (数据标签)
- @{}表达式
- 绑定普通数据
- 绑定可观察数据
- 对单个变量的绑定-fields
- 对集合的绑定-collections
- 绑定对象-objects
- 绑定LiveData
- 双向绑定
简介
DataBinding 是 Google 在 Jetpack 中推出的一款数据绑定的支持库,利用该库可以实现在页面组件中直接绑定应用程序的数据源。使其维护起来更加方便,架构更明确简介。
DataBinding 唯一的作用,也是他的使命,就是绑定数据,以及所有的支持库,本质上都是为了支持这个功能。绑定一词有两种解释,第一是将数据绑定在 UI 元素;第二是将 UI 上的数据绑定到对应的数据模型,还支持对数据及 UI 的变动观察,其中一个发生变动就需要同步到另一个上去。
启用databinding
首先设置使用 Databinding,在 app module 的 build.gradle 中添加如下代码即可:
android {
...
dataBinding {
enabled = true
}
}
布局xml
根结点必须为<layout>,只能存在一个<data>和一个直接子View结点。
variable (变量标签)
变量的属性名name不能包含_下划线,否则再kt文件里会找不到变量,有时可能需要指定自定义类型,可以使用 import 语法来导入类,以及使用 alias 设置别名
<data> <import type="com.example.databinding.Entity.User"/> <import type="com.example.databinding.Entity.user.User" alias="member"/> <variable name="user" type="User" /> <variable name="member" type="member" /> </data>
当需要使用两个同名但不同包名的类,可以使用alias别名属性
data (数据标签)
它有个属性class,可以自定义DataBinding生成的类名及路径
<data class="ObservableDataBinding"> </data>
@{}表达式
运算符
关键字
instanceof
字符、字符串、数字、null
类型转换
方法调用
字段访问
数组访问 []
绑定普通数据
DataBinding 可以绑定普通数据对象(非 Observable/LiveData)
<data> <import type="java.lang.String"/> <variable name="content" type="String" /> </data>
绑定可观察数据
绑定可观察数据意味着当数据变化时 UI 会跟着一起变化,绑定可观察数据有三种方式:objects
、fields
和 collections
.
对单个变量的绑定-fields
对于一些数据类只需要其中几个字段支持可观察,那么可以使用这种方式来创建可观察数据
data class User( val name: ObservableField<String>, val likes: ObservableInt )
基本数据类型直接使用对应的包装类
引用类型使用带有泛型参数的 ObservableField 类来创建
val name: ObservableField<String>
对集合的绑定-collections
<data> <import type="android.databinding.ObservableList"/> <variable name="user" type="ObservableList<Object>"/> </data> <TextView android:text="@{user[index]}" ... />
可以直接使用 [] 运算符( list[0] )获取对应位置的元素
绑定对象-objects
需要绑定的数据实体类继承 BaseObservable
class Person : BaseObservable() { @get:Bindable var country: String = "" set(value) { field = value notifyPropertyChanged(BR.country) } @get:Bindable var sex: String = "" set(value) { field = value notifyPropertyChanged(BR.sex) } }
需要支持可观察的数据上添加 @get:Bindable 注解,然后重写 set 方法,在其中调用 notifyPropertyChanged 方法表示更新该数据,BR 是自动生成的,包名跟当前包名一致,会根据 Bindable 注解的变量生成对应的值;也可以调用 notifyChange() 方法更新所有数据
绑定LiveData
LiveData也支持数据绑定
<?xml version="1.0" encoding="utf-8"?> <layout> <data> <variable name="desc" type="androidx.lifecycle.MutableLiveData<String>" /> </data> ... <TextView android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_gravity="center_vertical" android:text="@{desc}" /> </layout>
我们可以直接将 LiveData 赋值给 text,然后绑定数据
val desc = MutableLiveData<String>() binding.desc = desc
双向绑定
单向绑定是指数据变化后更新 UI,而双向绑定是指其中任意一个变化后都会同步更新到另一个。
双向绑定使用 @={} 表达式来实现:
<data> ... <variable name="input" type="androidx.databinding.ObservableField<String>" /> </data> ... <EditText android:layout_width="match_parent" android:layout_height="wrap_content" android:text="@={input}"/>
到此这篇关于Android JetPack组件的支持库Databinding详解的文章就介绍到这了,更多相关Android JetPack组件内容请搜索自由互联以前的文章或继续浏览下面的相关文章希望大家以后多多支持自由互联!