Dengan menggunakan data binding satu arah, Anda dapat menetapkan nilai pada atribut dan menetapkan pemroses yang bereaksi terhadap perubahan pada atribut tersebut:
<CheckBox android:id="@+id/rememberMeCheckBox" android:checked="@{viewmodel.rememberMe}" android:onCheckedChanged="@{viewmodel.rememberMeChanged}" />
Data binding dua arah menyediakan pintasan ke proses ini:
<CheckBox android:id="@+id/rememberMeCheckBox" android:checked="@={viewmodel.rememberMe}" />
Notasi @={}
, yang mencakup tanda "=", menerima perubahan data pada properti dan secara bersamaan memproses pembaruan pengguna.
Untuk bereaksi terhadap perubahan pada data pendukung, Anda dapat menjadikan variabel tata letak sebagai implementasi Observable
, biasanya BaseObservable
, dan menggunakan anotasi @Bindable
, seperti yang ditunjukkan dalam cuplikan kode berikut:
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); } } }
Karena metode pengambil properti bindable ini disebut getRememberMe()
, metode penyetel yang sesuai untuk properti tersebut akan otomatis menggunakan nama setRememberMe()
.
Untuk informasi selengkapnya tentang penggunaan BaseObservable
dan @Bindable
, lihat Bekerja dengan
objek data yang dapat diamati.
Data binding dua arah menggunakan atribut khusus
Platform ini menyediakan implementasi data binding dua arah untuk atribut dua arah
yang paling umum dan mengubah pemroses, yang dapat digunakan
sebagai bagian dari aplikasi Anda. Jika ingin menggunakan data binding dua arah dengan atribut
kustom, Anda harus menggunakan anotasi
@InverseBindingAdapter
dan
@InverseBindingMethod
.
Misalnya, jika Anda ingin mengaktifkan data binding dua arah pada atribut "time"
dalam tampilan kustom yang disebut MyView
, selesaikan langkah-langkah berikut:
Anotasikan metode yang menetapkan nilai awal dan melakukan pembaruan saat nilai tersebut berubah menggunakan
@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; } }
Anotasikan metode yang membaca nilai ini dari tampilan menggunakan
@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(); }
Pada tahap ini, data binding mengetahui apa yang harus dilakukan saat data berubah (memanggil
metode yang dianotasikan dengan
@BindingAdapter
) dan apa yang harus
dipanggil saat atribut tampilan berubah (memanggil
InverseBindingListener
).
Namun, data binding tidak mengetahui kapan atau bagaimana atribut berubah.
Untuk itu, Anda perlu menetapkan pemroses pada tampilan. Hal ini dapat berupa pemroses kustom
yang terkait dengan tampilan kustom Anda, atau dapat berupa peristiwa umum, seperti hilangnya
fokus atau perubahan teks. Tambahkan anotasi @BindingAdapter
ke metode
yang menetapkan pemroses untuk perubahan pada properti:
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. }
Pemroses ini menyertakan InverseBindingListener
sebagai parameter. Anda menggunakan
InverseBindingListener
untuk memberi tahu sistem data binding bahwa atribut telah
berubah. Selanjutnya, sistem dapat mulai memanggil metode yang dianotasi menggunakan
@InverseBindingAdapter
, dan seterusnya.
Dalam praktiknya, pemroses ini menyertakan beberapa logika yang sulit, termasuk pemroses
untuk data binding satu arah. Sebagai contoh, lihat adaptor untuk perubahan
atribut teks,
TextViewBindingAdapter
.
Pelaku konversi
Jika variabel yang terikat ke objek View
perlu diformat, diterjemahkan, atau diubah sebelum ditampilkan,
objek Converter
dapat digunakan.
Misalnya, ambil objek EditText
yang menampilkan tanggal:
<EditText
android:id="@+id/birth_date"
android:text="@={Converter.dateToString(viewmodel.birthDate)}"
/>
Atribut viewmodel.birthDate
berisi nilai jenis Long
sehingga perlu
diformat menggunakan pengonversi.
Karena ekspresi dua arah sedang digunakan, perlu ada pengonversi
terbalik untuk memberi tahu library cara mengonversi kembali string yang disediakan pengguna
menjadi jenis data pendukung, dalam hal ini Long
. Proses ini dilakukan dengan menambahkan
anotasi @InverseMethod
ke salah satu pengonversi dan menyetel anotasi ini mereferensikan pengonversi
terbalik. Contoh konfigurasi ini terlihat dalam cuplikan
kode berikut:
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. } }
Loop tak terbatas menggunakan data binding dua arah
Berhati-hatilah agar tidak menimbulkan loop tak terbatas saat menggunakan data binding dua arah. Saat
pengguna mengubah atribut, metode yang dianotasi menggunakan
@InverseBindingAdapter
akan dipanggil, dan nilainya ditetapkan ke properti
pendukung. Hal ini nantinya akan memanggil metode yang dianotasi menggunakan
@BindingAdapter
, yang akan memicu panggilan lain ke metode yang dianotasi
menggunakan @InverseBindingAdapter
, dan seterusnya.
Oleh karena itu, penting untuk memutus kemungkinan loop tak terbatas dengan membandingkan nilai baru dan nilai lama dalam metode yang dianotasi menggunakan @BindingAdapter
.
Atribut dua arah
Platform ini menyediakan dukungan bawaan untuk data binding dua arah saat Anda menggunakan atribut dalam tabel berikut. Untuk detail tentang cara platform memberikan dukungan ini, lihat implementasi untuk adaptor binding yang terkait:
Class | Atribut | Adaptor binding |
---|---|---|
AdapterView
|
android:selectedItemPosition android:selection |
AdapterViewBindingAdapter
|
CalendarView |
android:date |
CalendarViewBindingAdapter
|
CompoundButton |
android:checked
|
CompoundButtonBindingAdapter
|
DatePicker
|
android:year android:month android: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:hour android:minute |
TimePickerBindingAdapter
|
Referensi lainnya
Untuk mempelajari data binding lebih lanjut, lihat referensi tambahan berikut.
Contoh
Codelab
Postingan blog
Direkomendasikan untuk Anda
- Catatan: teks link ditampilkan saat JavaScript nonaktif
- Bekerja dengan objek data yang dapat diamati
- Tata letak dan ekspresi binding
- Mengikat tampilan tata letak ke Komponen Arsitektur