資料繫結程式庫 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 開發作業。
- 雙向資料繫結
- 資料繫結程式庫支援雙向資料繫結。這類繫結使用的標記法可接收屬性的資料變更,同時監聽使用者對該屬性的更新。
其他資源
如要進一步瞭解資料繫結,請參閱下列其他資源。
範例
網誌文章
為您推薦
- 注意:系統會在 JavaScript 關閉時顯示連結文字
- 繫結轉接器
- 版面配置與繫結的運算式
- 產生的繫結類別