Khi sử dụng tính năng liên kết dữ liệu một chiều, bạn có thể đặt giá trị cho một thuộc tính và đặt trình nghe phản ứng với thay đổi trong thuộc tính đó:
<CheckBox android:id="@+id/rememberMeCheckBox" android:checked="@{viewmodel.rememberMe}" android:onCheckedChanged="@{viewmodel.rememberMeChanged}" />
Liên kết dữ liệu hai chiều cung cấp một lối tắt cho quy trình này:
<CheckBox android:id="@+id/rememberMeCheckBox" android:checked="@={viewmodel.rememberMe}" />
Ký hiệu @={} (quan trọng là có dấu "=") nhận các thay đổi về dữ liệu đối với thuộc tính và đồng thời theo dõi thông tin cập nhật của người dùng.
Để phản ứng với các thay đổi trong dữ liệu sao lưu, bạn có thể đặt biến bố cục thành một phương thức triển khai của Observable, thường là BaseObservable và sử dụng chú thích @Bindable, như minh hoạ trong đoạn mã sau:
Kotlin
class LoginViewModel : BaseObservable {
// val data = ...
@Bindable
fun getRememberMe(): Boolean {
return data.rememberMe
}
fun setRememberMe(value: Boolean) {
// Avoids infinite loops.
if (data.rememberMe != value) {
data.rememberMe = value
// React to the change.
saveData()
// Notify observers of a new value.
notifyPropertyChanged(BR.remember_me)
}
}
}
Java
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 != value) {
data.rememberMe = value;
// React to the change.
saveData();
// Notify observers of a new value.
notifyPropertyChanged(BR.remember_me);
}
}
}
Vì phương thức getter của thuộc tính có thể liên kết được gọi là getRememberMe(), nên phương thức setter tương ứng của thuộc tính sẽ tự động sử dụng tên setRememberMe().
Để biết thêm thông tin về cách sử dụng BaseObservable và @Bindable, hãy xem bài viết Làm việc với các đối tượng dữ liệu có thể ghi nhận được.
Liên kết dữ liệu hai chiều bằng thuộc tính tùy chỉnh
Nền tảng này cung cấp các phương thức triển khai liên kết dữ liệu hai chiều cho các thuộc tính hai chiều phổ biến nhất và trình nghe thay đổi mà bạn có thể sử dụng trong ứng dụng của mình. Nếu muốn sử dụng liên kết dữ liệu hai chiều với các thuộc tính tùy chỉnh, bạn cần làm việc với các chú thích @InverseBindingAdapter và @InverseBindingMethod.
Ví dụ: nếu bạn muốn bật tính năng liên kết dữ liệu hai chiều trên thuộc tính "time" trong một chế độ xem tuỳ chỉnh có tên là MyView, hãy hoàn tất các bước sau:
Chú thích phương thức đặt giá trị ban đầu và cập nhật khi giá trị thay đổi bằng
@BindingAdapter:Kotlin
@BindingAdapter("time") @JvmStatic fun setTime(view: MyView, newValue: Time) { // Important to break potential infinite loops. if (view.time != newValue) { view.time = newValue } }Java
@BindingAdapter("time") public static void setTime(MyView view, Time newValue) { // Important to break potential infinite loops. if (view.time != newValue) { view.time = newValue; } }Chú thích phương thức đọc giá trị từ khung hiển thị bằng
@InverseBindingAdapter:Kotlin
@InverseBindingAdapter("time") @JvmStatic fun getTime(view: MyView) : Time { return view.getTime() }Java
@InverseBindingAdapter("time") public static Time getTime(MyView view) { return view.getTime(); }
Tại thời điểm này, liên kết dữ liệu biết việc cần làm khi dữ liệu thay đổi (liên kết dữ liệu gọi phương thức được chú thích bằng @BindingAdapter) và biết nội dung cần gọi khi thuộc tính khung hiển thị thay đổi (liên kết dữ liệu gọi InverseBindingListener). Tuy nhiên, liên kết dữ liệu không biết thời điểm hoặc cách thức thuộc tính thay đổi.
Để làm được việc đó, bạn cần đặt trình nghe trên khung hiển thị. Đó có thể là trình nghe tuỳ chỉnh liên kết với thành phần hiển thị tuỳ chỉnh của bạn hoặc có thể là một sự kiện chung, chẳng hạn như mất tiêu điểm hoặc thay đổi văn bản. Thêm chú thích @BindingAdapter vào phương thức
thiết lập trình nghe cho các thay đổi đối với thuộc tính:
Kotlin
@BindingAdapter("app:timeAttrChanged")
@JvmStatic fun setListeners(
view: MyView,
attrChange: InverseBindingListener
) {
// Set a listener for click, focus, touch, etc.
}
Java
@BindingAdapter("app:timeAttrChanged")
public static void setListeners(
MyView view, final InverseBindingListener attrChange) {
// Set a listener for click, focus, touch, etc.
}
Trình nghe bao gồm InverseBindingListener làm tham số. Bạn sử dụng InverseBindingListener để thông báo cho hệ thống liên kết dữ liệu rằng thuộc tính đã thay đổi. Sau đó, hệ thống có thể bắt đầu gọi phương thức được chú thích bằng @InverseBindingAdapter.
Trong thực tế, trình nghe này bao gồm một số logic không đơn giản, bao gồm cả trình nghe
để liên kết dữ liệu một chiều. Để biết ví dụ, hãy xem trình chuyển đổi cho thay đổi thuộc tính văn bản, TextViewBindingAdapter.
Người chuyển đổi
Nếu biến liên kết với đối tượng View cần được định dạng, dịch hoặc thay đổi theo cách nào đó trước khi hiển thị, thì bạn có thể sử dụng đối tượng Converter.
Ví dụ: hãy lấy một đối tượng EditText cho thấy ngày:
<EditText
android:id="@+id/birth_date"
android:text="@={Converter.dateToString(viewmodel.birthDate)}"
/>
Thuộc tính viewmodel.birthDate chứa một giá trị thuộc loại Long, vì vậy, thuộc tính này cần được định dạng bằng cách sử dụng trình chuyển đổi.
Vì đang sử dụng biểu thức hai chiều, nên bạn cũng cần có một bộ chuyển đổi nghịch đảo để cho thư viện biết cách chuyển đổi chuỗi do người dùng cung cấp trở lại kiểu dữ liệu sao lưu, trong trường hợp này là Long. Để thực hiện việc này, hãy thêm chú thích @InverseMethod vào một trong các trình chuyển đổi và để chú thích này tham chiếu đến trình chuyển đổi nghịch đảo. Ví dụ về cấu hình này xuất hiện trong đoạn mã sau:
Kotlin
object Converter {
@InverseMethod("stringToDate")
@JvmStatic fun dateToString(
view: EditText, oldValue: Long,
value: Long
): String {
// Converts long to String.
}
@JvmStatic fun stringToDate(
view: EditText, oldValue: String,
value: String
): Long {
// Converts String to long.
}
}
Java
public class Converter {
@InverseMethod("stringToDate")
public static String dateToString(EditText view, long oldValue,
long value) {
// Converts long to String.
}
public static long stringToDate(EditText view, String oldValue,
String value) {
// Converts String to long.
}
}
Vòng lặp vô hạn khi sử dụng liên kết dữ liệu hai chiều
Hãy cẩn thận để không tạo ra vòng lặp vô hạn khi sử dụng liên kết dữ liệu hai chiều. Khi người dùng thay đổi một thuộc tính, phương thức được chú thích bằng @InverseBindingAdapter sẽ được gọi và giá trị được gán cho thuộc tính sao lưu. Sau đó, thao tác này sẽ gọi phương thức được chú thích bằng @BindingAdapter, từ đó kích hoạt một lệnh gọi khác đến phương thức được chú thích bằng @InverseBindingAdapter, tiếp tục vòng lặp.
Vì lý do này, bạn cần phải ngắt các vòng lặp vô hạn có thể xảy ra bằng cách so sánh
các giá trị mới và cũ trong các phương thức được chú thích bằng @BindingAdapter.
Thuộc tính hai chiều
Nền tảng này cung cấp tính năng hỗ trợ tích hợp sẵn cho liên kết dữ liệu hai chiều khi bạn sử dụng các thuộc tính trong bảng sau. Để biết thông tin chi tiết về cách nền tảng cung cấp dịch vụ hỗ trợ này, hãy xem cách triển khai cho các bộ chuyển đổi liên kết tương ứng:
| Lớp | (Các) thuộc tính | Bộ chuyển đổi liên kết |
|---|---|---|
AdapterView
|
android:selectedItemPositionandroid:selection |
AdapterViewBindingAdapter
|
CalendarView |
android:date |
CalendarViewBindingAdapter
|
CompoundButton |
android:checked
|
CompoundButtonBindingAdapter
|
DatePicker
|
android:yearandroid:monthandroid:day |
DatePickerBindingAdapter
|
NumberPicker |
android:value
|
NumberPickerBindingAdapter
|
RadioButton
|
android:checkedButton |
RadioGroupBindingAdapter
|
RatingBar
|
android:rating
|
RatingBarBindingAdapter
|
SeekBar
|
android:progress |
SeekBarBindingAdapter
|
TabHost
|
android:currentTab |
TabHostBindingAdapter
|
TextView
|
android:text
|
TextViewBindingAdapter
|
TimePicker
|
android:hourandroid:minute |
TimePickerBindingAdapter
|
Tài nguyên khác
Để tìm hiểu thêm về liên kết dữ liệu, hãy tham khảo thêm những tài nguyên sau đây.
Mẫu
Lớp học lập trình
Bài đăng trên blog
Đề xuất cho bạn
- Lưu ý: văn bản có đường liên kết sẽ hiện khi JavaScript tắt
- Làm việc với đối tượng dữ liệu có thể ghi nhận được
- Bố cục và biểu thức liên kết
- Liên kết chế độ xem bố cục với thành phần kiến trúc