Utilizzando l'associazione di dati unidirezionale, puoi impostare un valore su un attributo e un listener che reagisce a una modifica di quell'attributo:
<CheckBox android:id="@+id/rememberMeCheckBox" android:checked="@{viewmodel.rememberMe}" android:onCheckedChanged="@{viewmodel.rememberMeChanged}" />
L'associazione di dati bidirezionale fornisce una scorciatoia per questo processo:
<CheckBox android:id="@+id/rememberMeCheckBox" android:checked="@={viewmodel.rememberMe}" />
La notazione @={}, che include l'importante segno "=", riceve le modifiche ai dati della proprietà e ascolta gli aggiornamenti dell'utente contemporaneamente.
Per reagire alle modifiche dei dati di supporto, puoi fare in modo che la variabile di layout sia un'implementazione di Observable, di solito BaseObservable, e utilizzare un'annotazione @Bindable, come mostrato nel seguente snippet di codice:
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);
}
}
}
Poiché il metodo getter della proprietà associabile è denominato getRememberMe(), il metodo setter corrispondente della proprietà utilizza automaticamente il nome setRememberMe().
Per saperne di più sull'utilizzo di BaseObservable e @Bindable, consulta Utilizza gli oggetti dati osservabili.
Associazione di dati bidirezionale utilizzando attributi personalizzati
La piattaforma fornisce implementazioni di associazione di dati bidirezionale per gli attributi bidirezionali più comuni e i listener di modifica, che puoi utilizzare nell'ambito della tua app. Se vuoi utilizzare l'associazione di dati bidirezionale con attributi personalizzati, devi utilizzare le annotazioni @InverseBindingAdapter e @InverseBindingMethod.
Ad esempio, se vuoi attivare l'associazione di dati bidirezionale su un attributo "time"
in una visualizzazione personalizzata denominata MyView, completa i seguenti passaggi:
Annota il metodo che imposta il valore iniziale e lo aggiorna quando cambia utilizzando
@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; } }Annota il metodo che legge il valore dalla visualizzazione utilizzando
@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(); }
A questo punto, l'associazione di dati sa cosa fare quando i dati cambiano (chiama il metodo annotato con @BindingAdapter) e cosa chiamare quando l'attributo della visualizzazione cambia (chiama InverseBindingListener). Tuttavia, non sa quando o come cambia l'attributo.
Per farlo, devi impostare un listener sulla visualizzazione. Può essere un listener personalizzato associato alla tua visualizzazione personalizzata o un evento generico, ad esempio una perdita di stato attivo o una modifica del testo. Aggiungi l'annotazione @BindingAdapter al metodo che imposta il listener per le modifiche alla proprietà:
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.
}
Il listener include un InverseBindingListener come parametro. Utilizza
InverseBindingListener per comunicare al sistema di associazione di dati che l'attributo è
cambiato. Il sistema può quindi iniziare a chiamare il metodo annotato utilizzando
@InverseBindingAdapter.
In pratica, questo listener include una logica non banale, inclusi i listener per l'associazione di dati unidirezionale. Per un esempio, consulta l'adattatore per la modifica dell'attributo di testo, TextViewBindingAdapter.
Utenti che hanno completato una conversione
Se la variabile associata a un oggetto View deve essere formattata, tradotta o modificata in qualche modo prima di essere visualizzata, è possibile utilizzare un oggetto Converter.
Ad esempio, prendi un oggetto EditText che mostra una data:
<EditText
android:id="@+id/birth_date"
android:text="@={Converter.dateToString(viewmodel.birthDate)}"
/>
L'attributo viewmodel.birthDate contiene un valore di tipo Long, pertanto deve essere formattato utilizzando un convertitore.
Poiché viene utilizzata un'espressione bidirezionale, è necessario anche un convertitore inverso per consentire alla libreria di sapere come convertire la stringa fornita dall'utente nel tipo di dati di supporto, in questo caso Long. Per farlo, aggiungi l'annotazione @InverseMethod a uno dei convertitori e fai in modo che questa annotazione faccia riferimento al convertitore inverso. Un esempio di questa configurazione
è mostrato nel seguente snippet di codice:
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 infiniti che utilizzano l'associazione di dati bidirezionale
Fai attenzione a non introdurre loop infiniti quando utilizzi l'associazione di dati bidirezionale. Quando l'utente modifica un attributo, viene chiamato il metodo annotato utilizzando @InverseBindingAdapter e il valore viene assegnato alla proprietà di supporto. A sua volta, questo chiamerebbe il metodo annotato utilizzando @BindingAdapter, che attiverebbe un'altra chiamata al metodo annotato utilizzando @InverseBindingAdapter, continuando il loop.
Per questo motivo, è importante interrompere i possibili loop infiniti confrontando i valori nuovi e quelli precedenti nei metodi annotati utilizzando @BindingAdapter.
Attributi bidirezionali
La piattaforma fornisce un supporto integrato per l'associazione di dati bidirezionale quando utilizzi gli attributi nella tabella seguente. Per informazioni dettagliate su come la piattaforma fornisce questo supporto, consulta le implementazioni per gli adattatori di associazione corrispondenti:
| Classe | Attributi | Adattatore di associazione |
|---|---|---|
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
|
Risorse aggiuntive
Per scoprire di più sull'associazione di dati, consulta le seguenti risorse aggiuntive.
Esempi
Blog post
Consigliati per te
- Nota: il testo del link viene visualizzato quando JavaScript è disattivato
- Utilizza oggetti dati osservabili
- Layout ed espressioni di associazione
- Associa le visualizzazioni di layout ai componenti dell'architettura