เมื่อใช้การเชื่อมโยงข้อมูลแบบทางเดียว คุณจะตั้งค่าในแอตทริบิวต์และตั้งค่า Listener ที่ตอบสนองต่อการเปลี่ยนแปลงในแอตทริบิวต์นั้นได้ ดังนี้
<CheckBox android:id="@+id/rememberMeCheckBox" android:checked="@{viewmodel.rememberMe}" android:onCheckedChanged="@{viewmodel.rememberMeChanged}" />
การเชื่อมโยงข้อมูลแบบ 2 ทางเป็นทางลัดสำหรับกระบวนการนี้ ดังนี้
<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 ของพร็อพเพอร์ตี้ที่เชื่อมโยงได้มีชื่อว่า getRememberMe() เมธอด Setter ที่เกี่ยวข้องของพร็อพเพอร์ตี้จึงใช้ชื่อ setRememberMe() โดยอัตโนมัติ
ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ BaseObservable และ @Bindable ได้ที่หัวข้อทำงานกับ
ออบเจ็กต์ข้อมูลที่สังเกตได้
การเชื่อมโยงข้อมูลแบบ 2 ทางโดยใช้แอตทริบิวต์ที่กำหนดเอง
แพลตฟอร์มนี้มีการติดตั้งใช้งานการเชื่อมโยงข้อมูลแบบ 2 ทางสำหรับแอตทริบิวต์แบบ 2 ทางที่พบบ่อยที่สุดและ Listener การเปลี่ยนแปลง ซึ่งคุณสามารถใช้เป็นส่วนหนึ่งของแอปได้ หากต้องการใช้การเชื่อมโยงข้อมูลแบบ 2 ทางกับแอตทริบิวต์ที่กำหนดเอง คุณต้องใช้คำอธิบายประกอบ @InverseBindingAdapter และ @InverseBindingMethod
ตัวอย่างเช่น หากต้องการเปิดใช้การเชื่อมโยงข้อมูลแบบ 2 ทางในแอตทริบิวต์ "time" ในมุมมองที่กำหนดเองชื่อ MyView ให้ทำตามขั้นตอนต่อไปนี้
ใส่คำอธิบายประกอบเมธอดที่ตั้งค่าเริ่มต้นและอัปเดตเมื่อค่าเปลี่ยนแปลงโดยใช้
@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; } }ใส่คำอธิบายประกอบเมธอดที่อ่านค่าจากมุมมองโดยใช้
@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(); }
ณ จุดนี้ การเชื่อมโยงข้อมูลจะทราบสิ่งที่ต้องทำเมื่อข้อมูลมีการเปลี่ยนแปลง (โดยจะเรียกใช้เมธอดที่มีคำอธิบายประกอบเป็น @BindingAdapter) และสิ่งที่ต้องเรียกใช้เมื่อแอตทริบิวต์มุมมองมีการเปลี่ยนแปลง (โดยจะเรียกใช้ InverseBindingListener) อย่างไรก็ตาม การเชื่อมโยงข้อมูลจะไม่ทราบว่าแอตทริบิวต์มีการเปลี่ยนแปลงเมื่อใดหรืออย่างไร
ซึ่งคุณต้องตั้งค่า Listener ในมุมมอง ซึ่งอาจเป็น Listener ที่กำหนดเองซึ่งเชื่อมโยงกับมุมมองที่กำหนดเอง หรืออาจเป็นเหตุการณ์ทั่วไป เช่น การสูญเสียโฟกัสหรือการเปลี่ยนแปลงข้อความ เพิ่มคำอธิบายประกอบ @BindingAdapter ลงในเมธอดที่ตั้งค่า Listener สำหรับการเปลี่ยนแปลงในพร็อพเพอร์ตี้
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.
}
Listener จะมี InverseBindingListener เป็นพารามิเตอร์ คุณใช้ InverseBindingListener เพื่อบอกระบบการเชื่อมโยงข้อมูลว่าแอตทริบิวต์มีการเปลี่ยนแปลง จากนั้นระบบจะเริ่มเรียกใช้เมธอดที่มีคำอธิบายประกอบโดยใช้ @InverseBindingAdapter
ในทางปฏิบัติ Listener นี้มีตรรกะที่สำคัญบางอย่าง รวมถึง Listener สำหรับการเชื่อมโยงข้อมูลแบบทางเดียว ตัวอย่างเช่น ดูอะแดปเตอร์สำหรับการเปลี่ยนแปลงแอตทริบิวต์ข้อความ TextViewBindingAdapter
ผู้ทำ Conversion
หากตัวแปรที่เชื่อมโยงกับออบเจ็กต์ View ต้องได้รับการจัดรูปแบบ แปล หรือเปลี่ยนแปลงก่อนที่จะแสดง คุณสามารถใช้ออบเจ็กต์ Converter ได้
ตัวอย่างเช่น ลองดูออบเจ็กต์ EditText ที่แสดงวันที่ต่อไปนี้
<EditText
android:id="@+id/birth_date"
android:text="@={Converter.dateToString(viewmodel.birthDate)}"
/>
แอตทริบิวต์ viewmodel.birthDate มีค่าประเภท Long จึงต้องจัดรูปแบบโดยใช้ตัวแปลง
เนื่องจากมีการใช้นิพจน์แบบ 2 ทาง จึงต้องมีตัวแปลงผกผันเพื่อให้ไลบรารีทราบวิธีแปลงสตริงที่ผู้ใช้ระบุกลับเป็นประเภทข้อมูลสำรอง ซึ่งในกรณีนี้คือ 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.
}
}
ลูปไม่สิ้นสุดที่ใช้การเชื่อมโยงข้อมูลแบบ 2 ทาง
โปรดระวังอย่าให้เกิดลูปไม่สิ้นสุดเมื่อใช้การเชื่อมโยงข้อมูลแบบ 2 ทาง เมื่อผู้ใช้เปลี่ยนแอตทริบิวต์ ระบบจะเรียกใช้เมธอดที่มีคำอธิบายประกอบโดยใช้ @InverseBindingAdapter และกำหนดค่าให้กับพร็อพเพอร์ตี้สำรอง ซึ่งจะเรียกใช้เมธอดที่มีคำอธิบายประกอบโดยใช้ @BindingAdapter ซึ่งจะทริกเกอร์การเรียกใช้เมธอดที่มีคำอธิบายประกอบโดยใช้ @InverseBindingAdapter อีกครั้ง และวนซ้ำไปเรื่อยๆ
ด้วยเหตุนี้ คุณจึงต้องหยุดการวนซ้ำที่อาจเกิดขึ้นไม่สิ้นสุดโดยการเปรียบเทียบค่าใหม่และค่าเก่าในเมธอดที่มีคำอธิบายประกอบโดยใช้ @BindingAdapter
แอตทริบิวต์แบบ 2 ทาง
แพลตฟอร์มนี้รองรับการเชื่อมโยงข้อมูลแบบ 2 ทางในตัวเมื่อคุณใช้แอตทริบิวต์ในตารางต่อไปนี้ ดูรายละเอียดเกี่ยวกับวิธีที่แพลตฟอร์มให้การสนับสนุนนี้ได้ที่การติดตั้งใช้งานสำหรับอะแดปเตอร์การเชื่อมโยงที่เกี่ยวข้อง ดังนี้
| ชั้น | แอตทริบิวต์ | อะแดปเตอร์การเชื่อมโยง |
|---|---|---|
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
|
แหล่งข้อมูลเพิ่มเติม
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเชื่อมโยงข้อมูลได้ที่แหล่งข้อมูลเพิ่มเติมต่อไปนี้
ตัวอย่าง
Codelab
บล็อกโพสต์
แนะนำสำหรับคุณ
- หมายเหตุ: ข้อความลิงก์จะแสดงเมื่อ JavaScript ปิดอยู่
- ทำงานกับออบเจ็กต์ข้อมูลที่ได้รับอนุญาตให้สังเกตพฤติกรรมผู้ใช้ได้
- เลย์เอาต์และนิพจน์การเชื่อมโยง
- เชื่อมโยงมุมมองเลย์เอาต์กับคอมโพเนนต์สถาปัตยกรรม