Two-way data binding (雙向數據綁定)

前言 使用單向數據綁定可以在屬性上設置數值，並可設定對該屬性的變化作出反應的監聽器。如下 <CheckBox android:id="@+id/rememberMeCheckBox" android:checked="@{viewmodel.rememberMe}" android:onCheckedChanged="@{viewmodel.rememberMeChanged}" /> 雙向數據綁定提供了此過程的捷徑。如下 <CheckBox android:id="@+id/rememberMeCheckBox" android:checked="@={viewmodel.rememberMe}" /> 注意在 @={} 表示法中的 = 符號表示了同時接受資料變化以及監聽更新。 為了對數據的變化做出反應，可以讓佈局變量成為 Observable 的實現，通常是 BaseObservable，並使用 @Bindable 註釋，如下 public class LoginViewModel extends BaseObservable { // private Model data = ... @Bindable public Boolean getRememberMe() { return data.rememberMe; } public void setRememberMe(Boolean value) { // Avoids infinite loops. if (data.rememberMe...

Read more »

Bind layout views to Architecture Components (綁定佈局到架構元件)

前言 AndroidX 函式庫包含架構元件(Architecture Components)，可以使用它來設計健壯，可測試和可維護的應用程序。 Data Binding Library 可與架構元件無縫協作，進一步簡化 UI 的開發。 應用程序中的 layout 可以綁定到架構元件中的數據，這些數據可以幫助管理 UI 控制器生命週期並通知數據中的更改。 以下介紹如何將架構元件合併到應用程序，以進一步使用 Data Binding Library 的好處。   Use LiveData to notify the UI about data changes 可以使用 LiveData 物件作為數據綁定來源，以自動通知UI有關數據更改的訊息。更多的資訊可以參考 LiveData Overview 與實現 Observable 的物件(例如 observable fields)不同，LiveData 物件了解訂閱對象的生命週期。相關的好處可以參考 The advantages of using LiveData 在 Android Studio 3.1 或之後的版本可以使用 LiveData 取代 observable fields。 要將 LiveData 與綁定類別一起使用，需要指定生命週期所有者(lifecycle owner)以定義 LiveData 對象的範圍。如下，在綁定類別初始化之後指定了 Activity 本身為生命週期所有者。 class ViewModelActivity extends AppCompatActivity { @Override protected void onCreate(Bundle...

Read more »

Binding adapters (綁定轉接器)

前言 Binding Adapter 主要用來呼叫適當方式來設定數值。一個例子為透過 setText 方法來設定屬性值，另一個例子為透過呼叫 setOnClickListener 方法來設定事件監聽器。 Data Binding Library 讓使用者指定調用方法來設定數值，客製化綁定邏輯，並使用適配器指定返回對象的類型。 Setting attribute values 每當綁定值發生更改時，綁定類別必須使用綁定表達式在視圖上調用 setter 方法。使用者可以允許 data binding library 自動決定哪個方法，顯式的聲明方法或提供自定義邏輯來選擇方法。   Automatic method selection 對於一個命名為 example 的屬性，data binding library 會嘗試尋找名稱為 setExample(arg) 的方法，其方法接受兼容的參數。 只有屬性的名稱和型別會被用於搜尋，屬性的名稱空間則不會被考慮。 例如，對於 android:text="@{user.name}" 表達式，data binding library 會尋找一個 setText(arg) 方法，該方法的參數(arg)的型別為 user.getName 方法所回傳的。例如，若 user.getName 方法回傳的型態為 String，則 data binding library 會尋找 setText 方法，其方法接受的參數型態為 String。若 user.getName 方法回傳的型態為 int，則 data binding library 會尋找 setText 方法，其方法接受的參數型態為 int。 表達式必須回傳正確的型態，如有必要可以進行轉型的動作。即使沒有屬性符合給定的名稱，數據綁定仍然工作。之後，可以使用數據綁定為任何...

Read more »