資料繫結程式庫   Android Jetpack 的一部分。

資料繫結程式庫是支援程式庫,可讓您使用宣告式格式 (而非程式輔助方式),將版面配置中的 UI 元件繫結至應用程式中的資料來源。

版面配置通常是在活動中定義,並使用呼叫 UI 架構方法的程式碼。舉例來說,下列程式碼會呼叫 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}" />

在版面配置檔案中繫結元件,可讓您移除活動中的許多 UI 架構呼叫,使其更加簡單且易於維護。這還可改善應用程式效能,避免發生記憶體流失及空值指標例外狀況。

使用資料繫結程式庫

請參閱下列頁面,瞭解如何在 Android 應用程式中使用資料繫結程式庫。

開始使用
瞭解如何準備開發環境,以便使用資料繫結程式庫,包括在 Android Studio 中支援資料繫結程式碼。

版面配置與繫結的運算式

運算式語言可讓您編寫運算式,將變數連結至版面配置中的檢視畫面。資料繫結程式庫會自動產生必要的類別,將版面配置中的檢視畫面與資料物件繫結。這個程式庫提供匯入、變數和包含等功能,您可以在版面配置中使用。

程式庫的這些功能可與現有版面配置完美並存。舉例來說,可在運算式中使用的繫結變數,是在 data 元素中定義,該元素是 UI 版面配置根元素的同層元素。這兩個元素都包裝在 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>

使用可觀測的資料物件
資料繫結程式庫提供類別和方法,用於觀察資料變化。您不必擔心基礎資料來源變更時,是否需要重新整理 UI。您可以將變數或其屬性設為可觀測。這個程式庫可讓您觀察物件、欄位或集合。
產生的繫結類別
資料繫結程式庫會產生繫結類別,用於存取版面配置的變數和檢視畫面。本頁說明如何使用及自訂產生的繫結類別。
繫結轉接器

每個版面配置運算式都有一個繫結轉接器,可進行必要的架構呼叫,設定對應的屬性或事件監聽器。舉例來說,繫結轉接器可以負責呼叫 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 支援資料庫包含架構元件,可用於設計功能完善、可測試及維護的應用程式。您可以搭配使用架構元件和資料繫結程式庫,進一步簡化 UI 開發作業。
雙向資料繫結
資料繫結程式庫支援雙向資料繫結。這類繫結使用的標記法可接收屬性的資料變更,同時監聽使用者對該屬性的更新。

其他資源

如要進一步瞭解資料繫結,請參閱下列其他資源。

範例

網誌文章