Libreria di associazione di dati Parte di Android Jetpack.
La libreria di associazione di dati è una libreria di supporto che ti consente di associare i componenti UI dei tuoi layout alle origini dati della tua app utilizzando un formato dichiarativo anziché in modo programmatico.
I layout vengono spesso definiti nelle attività con codice che chiama i metodi del framework UI. Ad esempio, il seguente codice chiama findViewById() per trovare un widget TextView e associarlo alla proprietà userName della variabile viewModel:
Kotlin
findViewById<TextView>(R.id.sample_text).apply {
text = viewModel.userName
}
Java
TextView textView = findViewById(R.id.sample_text);
textView.setText(viewModel.getUserName());
L'esempio seguente mostra come utilizzare la libreria di associazione di dati per assegnare il testo al widget direttamente nel file di layout. In questo modo non è necessario chiamare il codice Java mostrato sopra. Tieni presente l'utilizzo della sintassi @{} nell'espressione di assegnazione:
<TextView
android:text="@{viewmodel.userName}" />
L'associazione dei componenti nel file di layout consente di rimuovere molte chiamate al framework UI nelle tue attività, rendendole più semplici e facili da gestire. In questo modo, puoi anche migliorare le prestazioni dell'app ed evitare perdite di memoria ed eccezioni di puntatore nullo.
Utilizzo della libreria di associazione di dati
Utilizza le seguenti pagine per scoprire come utilizzare la libreria di associazione di dati nelle tue app per Android.
- Inizia
- Scopri come preparare l'ambiente di sviluppo per l'utilizzo della libreria di associazione di dati, incluso il supporto per il codice di associazione di dati in Android Studio.
Layout ed espressioni di associazione
Il linguaggio delle espressioni ti consente di scrivere espressioni che collegano le variabili alle visualizzazioni nel layout. La libreria di associazione di dati genera automaticamente le classi necessarie per associare le visualizzazioni nel layout agli oggetti di dati. La libreria fornisce funzionalità come importazioni, variabili e inclusioni che puoi utilizzare nei tuoi layout.
Queste funzionalità della libreria coesistono perfettamente con i layout esistenti.
Ad esempio, le variabili di associazione che possono essere utilizzate nelle espressioni sono definite all'interno di un elemento data che è un elemento di pari livello dell'elemento root del layout dell'interfaccia utente.
Entrambi gli elementi sono racchiusi in un tag layout, come mostrato nell'esempio seguente:
<layout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<data>
<variable
name="viewmodel"
type="com.myapp.data.ViewModel" />
</data>
<ConstraintLayout... /> <!-- UI layout's root element -->
</layout>
- Utilizza oggetti dati osservabili
- La libreria di associazione di dati fornisce classi e metodi per osservare le modifiche ai dati. Non devi preoccuparti di aggiornare la UI quando l'origine dati sottostante cambia. Puoi rendere osservabili le variabili o le relative proprietà. La libreria ti consente di rendere osservabili oggetti, campi o raccolte.
- Classi di associazione generate
- La libreria di associazione di dati genera classi di associazione utilizzate per accedere alle variabili e alle visualizzazioni del layout. Questa pagina mostra come utilizzare e personalizzare le classi di associazione generate.
- Adattatori di associazione
Per ogni espressione di layout, esiste un adattatore di associazione che effettua le chiamate al framework necessarie per impostare le proprietà o i listener corrispondenti. Ad esempio, l'adattatore di associazione può occuparsi di chiamare il metodo
setText()per impostare la proprietà di testo o chiamare il metodosetOnClickListener()per aggiungere un listener all'evento di clic. Gli adattatori di associazione più comuni, come quelli per la proprietàandroid:textutilizzati negli esempi di questa pagina, sono disponibili nel pacchettoandroid.databinding.adapters. Per un elenco degli adattatori di associazione comuni, consulta adattatori. Puoi anche creare adattatori personalizzati, come mostrato nell'esempio seguente:
Kotlin
@BindingAdapter("app:goneUnless")
fun goneUnless(view: View, visible: Boolean) {
view.visibility = if (visible) View.VISIBLE else View.GONE
}
Java
@BindingAdapter("app:goneUnless")
public static void goneUnless(View view, Boolean visible) {
view.visibility = visible ? View.VISIBLE : View.GONE;
}
- Associa le visualizzazioni di layout ai componenti dell'architettura
- L'Android Support Library include i componenti dell'architettura, che puoi utilizzare per progettare app robuste, testabili e gestibili. Puoi utilizzare i componenti dell'architettura con la libreria di associazione di dati per semplificare ulteriormente lo sviluppo della UI.
- Associazione di dati bidirezionale
- La libreria di associazione di dati supporta l'associazione di dati bidirezionale. La notazione utilizzata per questo tipo di associazione supporta la possibilità di ricevere modifiche ai dati di una proprietà e di ascoltare gli aggiornamenti degli utenti a quella proprietà contemporaneamente.
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
- Adattatori di associazione
- Layout ed espressioni di associazione
- Classi di associazione generate