是什么?
在布局xml中将控件和数据进行绑定,使数据变化可以驱动控件改变,控件改变可以驱动数据改变。
减少了Activity中对控件的初始化、设置监听、显示数据等操作
使用databinding你就不需要使用findviewbyid()、setText()等
怎么用
使用入门
配置开关在app\build\android 下开启databinding开关
android {
compileSdkVersion 30
buildToolsVersion "30.0.2"
dataBinding {
enabled = true
}
}
布局xml 利用快捷键alt+enter 将布局转换成layout格式的,使用格式是 @{}
<layout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<data>
<variable
name="user"
type="com.example.hellojetpack.databinding.UserBean" />
</data>
<androidx.constraintlayout.widget.ConstraintLayout
android:layout_width="match_parent"
android:layout_height="match_parent">
<TextView
android:layout_width="match_parent"
android:layout_height="match_parent"
app:layout_constraintLeft_toLeftOf="parent"
app:layout_constraintRight_toRightOf="parent"
app:layout_constraintTop_toTopOf="parent"
app:layout_constraintBottom_toBottomOf="parent"
android:textSize="28sp"
android:text="@{user.name}"
/>
</androidx.constraintlayout.widget.ConstraintLayout>
</layout>
//Activity中设置 setContentView 并给布局中变量user 赋值
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
val binding = DataBindingUtil.setContentView<ActivityDatabindingBinding>(
this,
R.layout.activity_databinding
)
//给xml中的对象赋值
binding.user = UserBean("DataBinding",2)
}
布局和绑定表达式
数据对象
data class User(val firstName: String, val lastName: String)
绑定数据
系统会为每个布局文件生成一个绑定类。例如布局文件名为 activity_main.xml,因此生成的对应类为 ActivityMainBinding。
绑定数据方式一
val binding: ActivityMainBinding = DataBindingUtil.setContentView(
this, R.layout.activity_main)
binding.user = User("Test", "User")
绑定数据方式二
val binding: ActivityMainBinding = ActivityMainBinding.inflate(getLayoutInflater())
//注意需要设置setContentview
setContentView(binding.root)
绑定数据方式三
如果您要在Fragment、ListView 或 RecyclerView 适配器中使用数据绑定项
val listItemBinding = ListItemBinding.inflate(layoutInflater, viewGroup, false)
// or
val listItemBinding = DataBindingUtil.inflate(layoutInflater, R.layout.list_item, viewGroup, false)
//or
val view = inflater.inflate(getSubLayoutId(), container, false)
binding = DataBindingUtil.bind<T>(view)
常用功能
表达式语言与托管代码中的表达式非常相似。您可以在表达式语言中使用以下运算符和关键字:
- 算术运算符+ - / * %
- 字符串连接运算符+
- 逻辑运算符&& ||
- instanceof
- 三元运算符?:
例子
android:text='@{user.age>13 ? user.name:user.name+"-s"}'
Null快捷表达式
如果左边运算数不是 null,则 Null 合并运算符 (??) 选择左边运算数,如果左边运算数为 null,则选择右边运算数
android:text="@{user.displayName ?? user.lastName}"
功能等效于
android:text="@{user.displayName != null ? user.displayName : user.lastName}"
避免出现null问题
生成的数据绑定代码会自动检查有没有 null 值并避免出现 Null 指针异常。例如,在表达式 @{user.name} 中,如果 user 为 Null,则为 user.name 分配默认值 null。如果您引用 user.age,其中 age 的类型为 int,则数据绑定使用默认值 0。
属性引用
android:text="@{user.lastName}"
视图引用
<EditText
android:id="@+id/example_text"
android:layout_height="wrap_content"
android:layout_width="match_parent"
/>
<TextView
android:id="@+id/example_output"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@{exampleText.text}"
/>
注意:绑定类将 ID 转换为驼峰式大小写。
集合
<data>
<import type="android.util.SparseArray"/>
<import type="java.util.Map"/>
<import type="java.util.List"/>
<variable name="list" type="List<String>"/>
<variable name="sparse" type="SparseArray<String>"/>
<variable name="map" type="Map<String, String>"/>
<variable name="index" type="int"/>
<variable name="key" type="String"/>
</data>
…
android:text="@{list[index]}"
…
android:text="@{sparse[index]}"
…
android:text="@{map[key]}"
注意
- 引入 <import type="java.util.List"/>
- 泛型 <variable name="list" type="List<String>"/> “<” 符号用< 代替
- 调用 list[ ] "@{list[index]}"
字符串使用
您可以使用单引号括住特性值,这样就可以在表达式中使用双引号,如以下示例所示:
android:text='@{map["firstName"]}'
也可以使用双引号括住特性值。如果这样做,则还应使用反单引号 将字符串字面量括起来:
android:text="@{map[`firstName`]}"
资源引用
资源引用再xml中不能自动适配,可能需要自己手动赋值粘贴
android:padding="@{large? @dimen/largePadding : @dimen/smallPadding}"
//根据条件选择
<variable
name="large"
type="boolean" />
android:padding="@{large? (int)@dimen/largePadding : (int)@dimen/smallPadding}"
<variable
name="firstName"
type="String" />
<variable
name="lastName"
type="String" />
<string name="nameFormat">Full Name: %1$s:%2$s</string>
android:text="@{@string/nameFormat(firstName,lastName)}"