Biblioteka wiązania danych Jest częścią Android Jetpack.
Biblioteka wiązania danych to biblioteka pomocnicza, która umożliwia wiązanie komponentów interfejsu w układach ze źródłami danych w aplikacji przy użyciu formatu deklaratywnego, a nie programistycznego.
Układy są często definiowane w aktywnościach za pomocą kodu, który wywołuje metody platformy UI. Na przykład ten kod wywołuje funkcję findViewById(), aby znaleźć widżet TextView i powiązać go z właściwością userName zmiennej viewModel:
Kotlin
findViewById<TextView>(R.id.sample_text).apply {
text = viewModel.userName
}
Java
TextView textView = findViewById(R.id.sample_text);
textView.setText(viewModel.getUserName());
Poniższy przykład pokazuje, jak za pomocą biblioteki wiązania danych przypisać tekst do widżetu bezpośrednio w pliku układu. Dzięki temu nie trzeba wywoływać żadnego z powyższych kodów Java. Zwróć uwagę na użycie składni @{} w wyrażeniu przypisania:
<TextView
android:text="@{viewmodel.userName}" />
Powiązanie komponentów w pliku układu pozwala usunąć wiele wywołań platformy UI w aktywnościach, dzięki czemu są one prostsze i łatwiejsze w utrzymaniu. Może to też poprawić wydajność aplikacji i pomóc w zapobieganiu wyciekom pamięci oraz wyjątkom wskaźnika o wartości null.
Korzystanie z biblioteki wiązania danych
Na tych stronach dowiesz się, jak używać biblioteki wiązania danych w aplikacjach na Androida.
- Rozpocznij
- Dowiedz się, jak przygotować środowisko programistyczne do pracy z biblioteką wiązania danych, w tym jak uzyskać obsługę kodu wiązania danych w Android Studio.
Język wyrażeń umożliwia pisanie wyrażeń, które łączą zmienne z widokami w układzie. Biblioteka wiązania danych automatycznie generuje klasy wymagane do powiązania widoków w układzie z obiektami danych. Biblioteka udostępnia funkcje takie jak importy, zmienne i elementy include, których możesz używać w układach.
Te funkcje biblioteki bezproblemowo współistnieją z dotychczasowymi układami.
Na przykład zmienne wiązania, których można używać w wyrażeniach, są definiowane w elemencie data, który jest elementem równorzędnym elementu głównego układu interfejsu.
Oba elementy są opakowane w tag layout, jak w tym przykładzie:
<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>
- Praca z obiektami danych dostępnych do obserwacji
- Biblioteka wiązania danych udostępnia klasy i metody do obserwowania zmian danych. Nie musisz się martwić o odświeżanie interfejsu, gdy zmienia się źródło danych. Możesz ustawić zmienne lub ich właściwości jako możliwe do obserwowania. Biblioteka umożliwia obserwowanie obiektów, pól lub kolekcji.
- Wygenerowane klasy powiązań
- Biblioteka wiązania danych generuje klasy wiązania, które służą do uzyskiwania dostępu do zmiennych i widoków układu. Na tej stronie dowiesz się, jak używać i dostosowywać wygenerowane klasy powiązań.
- Adaptery wiązania
Dla każdego wyrażenia układu istnieje adapter wiązania, który wykonuje wywołania platformy wymagane do ustawienia odpowiednich właściwości lub detektorów. Na przykład adapter wiązania może wywołać metodę
setText(), aby ustawić właściwość tekstową, lub metodęsetOnClickListener(), aby dodać detektor do zdarzenia kliknięcia. Najpopularniejsze adaptery wiązania, takie jak adaptery właściwościandroid:textużywane w przykładach na tej stronie, są dostępne w pakiecieandroid.databinding.adapters. Listę typowych adapterów wiązania znajdziesz w sekcji Adaptery. Możesz też tworzyć niestandardowe adaptery, jak w tym przykładzie:
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;
}
- Wiązanie widoków układu z komponentami architektury
- Biblioteka pomocy Androida zawiera komponenty architektury, które można wykorzystać do projektowania niezawodnych, testowalnych i łatwych w utrzymaniu aplikacji. Możesz używać komponentów architektury z biblioteką wiązania danych, aby jeszcze bardziej uprościć tworzenie interfejsu.
- Dwukierunkowe wiązanie danych
- Biblioteka wiązania danych obsługuje dwukierunkowe wiązanie danych. Notacja używana w przypadku tego typu powiązania umożliwia otrzymywanie zmian danych we właściwości i jednoczesne nasłuchiwanie aktualizacji tej właściwości przez użytkownika.
Dodatkowe materiały
Więcej informacji o wiązaniu danych znajdziesz w tych materiałach.
Przykłady
Codelabs
Posty na blogu
Polecane dla Ciebie
- Uwaga: tekst linku jest wyświetlany, gdy język JavaScript jest wyłączony.
- Adaptery wiązania
- Układy i wyrażenia wiążące
- Wygenerowane klasy powiązań