באמצעות קישור נתונים חד-כיווני, אפשר להגדיר ערך במאפיין ולהגדיר מאזין שמגיב לשינוי במאפיין הזה:
<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, כמו שמוצג בקטע הקוד הבא:
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);
}
}
}
מכיוון שה-getter method של המאפיין שניתן לקישור נקראת getRememberMe(), ה-setter method התואמת של המאפיין משתמשת באופן אוטומטי בשם setRememberMe().
מידע נוסף על השימוש ב-BaseObservable וב-@Bindable זמין במאמר עבודה עם אובייקטים של נתונים גלויים.
קישור נתונים דו-כיווני באמצעות מאפיינים מותאמים אישית
הפלטפורמה מספקת הטמעות של קישור נתונים דו-כיווני למאפיינים הדו-כיווניים הנפוצים ביותר ולמאזינים לשינויים, שבהם אתם יכולים להשתמש כחלק מהאפליקציה. אם אתם רוצים להשתמש בקישור נתונים דו-כיווני עם מאפיינים מותאמים אישית, אתם צריכים לעבוד עם ההערות @InverseBindingAdapter ו-@InverseBindingMethod.
לדוגמה, כדי להפעיל קישור נתונים דו-כיווני במאפיין "time" בתצוגה מותאמת אישית בשם MyView, מבצעים את השלבים הבאים:
מוסיפים הערה ל-method שמגדירה את הערך הראשוני ומעדכנת כשהערך משתנה באמצעות
@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; } }מוסיפים הערה ל-method שקורא את הערך מהתצוגה באמצעות
@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(); }
בשלב הזה, קישור הנתונים יודע מה לעשות כשהנתונים משתנים (הוא קורא ל-method שמסומן ב-@BindingAdapter) ולמה לקרוא כשמאפיין התצוגה משתנה (הוא קורא ל-InverseBindingListener). עם זאת, הוא לא יודע מתי או איך המאפיין משתנה.
כדי לעשות את זה, צריך להגדיר מאזין בתצוגה. הוא יכול להיות מאזין בהתאמה אישית שמשויך לתצוגה בהתאמה אישית, או אירוע כללי, כמו אובדן מיקוד או שינוי טקסט. מוסיפים את ההערה @BindingAdapter לשיטה שמגדירה את המאזין לשינויים במאפיין:
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.
}
המאזין כולל InverseBindingListener כפרמטר. משתמשים ב-InverseBindingListener כדי להודיע למערכת של קישור הנתונים שהמאפיין השתנה. לאחר מכן, המערכת יכולה להתחיל לקרוא לשיטה שסומנה באמצעות @InverseBindingAdapter.
בפועל, המאזין הזה כולל לוגיקה לא טריוויאלית, כולל מאזינים לכריכת נתונים חד-כיוונית. לדוגמה, אפשר לעיין במתאם לשינוי מאפיין הטקסט, TextViewBindingAdapter.
משתמשים שהשלימו המרות
אם צריך לעצב, לתרגם או לשנות את המשתנה שקשור לאובייקט View לפני שהוא מוצג, אפשר להשתמש באובייקט Converter.
לדוגמה, נניח שיש אובייקט EditText שמציג תאריך:
<EditText
android:id="@+id/birth_date"
android:text="@={Converter.dateToString(viewmodel.birthDate)}"
/>
המאפיין viewmodel.birthDate מכיל ערך מסוג Long, ולכן צריך להשתמש בממיר כדי לשנות את הפורמט שלו.
בגלל שמשתמשים בביטוי דו-כיווני, צריך גם ממיר הפוך כדי שהספרייה תדע איך להמיר את המחרוזת שהמשתמש סיפק בחזרה לסוג הנתונים התומך, במקרה הזה Long. כדי לעשות את זה, מוסיפים את ההערה @InverseMethod לאחד מהממירים, וגורמים להערה הזו להפנות לממיר ההפוך. דוגמה להגדרה הזו מופיעה בקטע הקוד הבא:
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.
}
}
לולאות אינסופיות באמצעות קישור נתונים דו-כיווני
חשוב להיזהר לא ליצור לולאות אינסופיות כשמשתמשים בקישור נתונים דו-כיווני. כשהמשתמש משנה מאפיין, מתבצעת קריאה ל-method שמסומן באמצעות @InverseBindingAdapter, והערך מוקצה למאפיין הגיבוי. הפעולה הזו תפעיל את ה-method עם ההערה @BindingAdapter, שתפעיל קריאה נוספת ל-method עם ההערה @InverseBindingAdapter, וכך הלולאה תימשך.
לכן, חשוב להשוות בין הערכים החדשים והישנים בשיטות שמסומנות באמצעות @BindingAdapter כדי למנוע לולאות אינסופיות.
מאפיינים דו-כיווניים
הפלטפורמה מספקת תמיכה מובנית בקישור נתונים דו-כיווני כשמשתמשים במאפיינים שבטבלה הבאה. כדי להבין איך הפלטפורמה מספקת את התמיכה הזו, אפשר לעיין בהטמעות של מתאמי הקישור המתאימים:
| דרגה | מאפיינים | מתאם קישור |
|---|---|---|
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
|
מקורות מידע נוספים
כדי לקבל מידע נוסף על קישור נתונים, אפשר לעיין במקורות המידע הבאים.
דוגמאות
פוסטים בבלוגים
מומלץ בשבילכם
- הערה: טקסט הקישור מוצג כש-JavaScript מושבת
- עבודה עם אובייקטים של נתונים גלויים
- פריסות וביטויי קישור
- קישור תצוגות פריסה לרכיבי ארכיטקטורה