数据绑定库 Android Jetpack 的一部分。
数据绑定库是一个支持库,可让您以声明性格式(而非通过编程方式)将布局中的界面组件绑定到应用中的数据源。
布局通常在 Activity 中定义,其中包含调用界面框架方法的代码。例如,以下代码会调用 findViewById()
来查找 TextView
微件,并将其绑定到 viewModel
变量的 userName
属性
Kotlin
findViewById<TextView>(R.id.sample_text).apply { text = viewModel.userName }
Java
TextView textView = findViewById(R.id.sample_text); textView.setText(viewModel.getUserName());
以下示例展示了如何使用数据绑定库直接在布局文件中为微件分配文本。这消除了调用上述任何 Java 代码的需要。请注意赋值表达式中 @{}
语法的用法
<TextView
android:text="@{viewmodel.userName}" />
在布局文件中绑定组件可让您从 Activity 中移除许多界面框架调用,从而使它们更简单且更易于维护。这还可以提高应用的性能,并有助于防止内存泄漏和空指针异常。
使用数据绑定库
使用以下页面了解如何在 Android 应用中使用数据绑定库。
- 开始使用
- 了解如何为使用数据绑定库准备开发环境,包括 Android Studio 中对数据绑定代码的支持。
表达式语言允许您编写将变量连接到布局中视图的表达式。数据绑定库会自动生成将布局中的视图与数据对象绑定的所需类。该库提供导入、变量和包含等功能,您可以在布局中使用它们。
该库的这些功能与您现有布局无缝共存。例如,可在表达式中使用的绑定变量定义在 data
元素内部,该元素是界面布局根元素的同级元素。这两个元素都封装在 layout
标记中,如以下示例所示
<layout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<data>
<variable
name="viewmodel"
type="com.myapp.data.ViewModel" />
</data>
<ConstraintLayout... /> <!-- UI layout's root element -->
</layout>
- 使用可观察数据对象
- 数据绑定库提供类和方法,可轻松观察数据变化。当底层数据源发生变化时,您无需担心刷新界面。您可以将变量或其属性设为可观察。该库允许您将对象、字段或集合设为可观察。
- 生成的绑定类
- 数据绑定库会生成绑定类,用于访问布局的变量和视图。本页面介绍了如何使用和自定义生成的绑定类。
- 绑定适配器
- 对于每个布局表达式,都有一个绑定适配器,用于进行设置相应属性或监听器所需的框架调用。例如,绑定适配器可以负责调用
setText()
方法来设置文本属性,或调用setOnClickListener()
方法为点击事件添加监听器。最常见的绑定适配器,例如本页面示例中使用的android:text
属性的适配器,您可以在android.databinding.adapters
软件包中使用。有关常见绑定适配器的列表,请参阅 适配器。您还可以创建自定义适配器,如以下示例所示
Kotlin
@BindingAdapter("app:goneUnless") fun goneUnless(view: View, visible: Boolean) { view.visibility = if (visible) View.VISIBLE else View.GONE }
Java
@BindingAdapter("app:goneUnless") public static void goneUnless(View view, Boolean visible) { view.visibility = visible ? View.VISIBLE : View.GONE; }
- 将布局视图绑定到架构组件
- Android 支持库包含 架构组件,您可以使用它们来设计健壮、可测试且易于维护的应用。您可以将架构组件与数据绑定库结合使用,以进一步简化界面开发。
- 双向数据绑定
- 数据绑定库支持双向数据绑定。此类绑定所使用的符号支持同时接收属性的数据更改和监听用户对该属性的更新。
其他资源
要了解有关数据绑定的更多信息,请查阅以下其他资源。
示例
Codelab
博文
为您推荐
- 注意:当 JavaScript 关闭时,会显示链接文本
- 绑定适配器 {:#binding-adapters}
- 布局和绑定表达式
- 生成的绑定类 {: #binding-classes}