このページは Cloud Translation API によって翻訳されました。

双方向データバインディング

一方向データバインディングを使用すると、属性に値を設定し、その属性の変更に反応するリスナーを実装します。

<CheckBox
    android:id="@+id/rememberMeCheckBox"
    android:checked="@{viewmodel.rememberMe}"
    android:onCheckedChanged="@{viewmodel.rememberMeChanged}"
/>

双方向データバインディングを使用すると、このプロセスをショートカットできます。

<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);
        }
    }
}

バインド可能なプロパティのゲッターメソッドは getRememberMe() であるため、プロパティに対応するセッターメソッドが、 setRememberMe()。

BaseObservable と @Bindable の使用方法については、Google Cloud コンソールの監視可能なデータオブジェクト。

カスタム属性を使用した双方向データバインディング

このプラットフォームでは、最も一般的なデータバインディングについて、双方向のデータバインディングを実装できます。双方向属性と変更リスナーを使用します。組み込むことが重要です双方向のデータバインディングをカスタム使用する場合は、 @InverseBindingAdapter および @InverseBindingMethod アノテーション。

たとえば、"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）。ただし、属性がいつ、どのように変更されるかはわかりません。

こうしたことから、リスナーはビューに設定する必要があります。カスタムリスナーや一般的なイベント（損失、損失、損失など）のテキストの変化などです。メソッドに @BindingAdapter アノテーションを追加する次のプロパティでは、プロパティの変更に対するリスナーを設定します。

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.
}

リスナーには InverseBindingListener がパラメータとして含まれています。 InverseBindingListener: 属性に属性があることをデータバインディングシステムに通知します。変更されました。その後、システムは @InverseBindingAdapter など

実際には、このリスナーには重要なロジックがいくつか含まれています。使用しています例については、テキスト属性のアダプターをご覧ください。変更、 TextViewBindingAdapter。

Converter

View オブジェクトにバインドされている変数が表示前になんらかの方法で書式設定、翻訳、変更する必要がある Converterオブジェクトを使用できます

例として、日付を表す EditText オブジェクトを見てみましょう。

<EditText
    android:id="@+id/birth_date"
    android:text="@={Converter.dateToString(viewmodel.birthDate)}"
/>

viewmodel.birthDate 属性には Long 型の値が含まれるため、変換して書式設定します。

双方向の式が使用されているため、 コンバータを使用して、ユーザーが指定した文字列を再変換する方法をライブラリに通知します。バッキングデータ型（この場合は Long）にマッピングします。このプロセスを実行するには、 @InverseMethod アノテーションその逆の URL を参照するようにして、ありませんこの構成の例を次のコードに示します。 snippet:

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.
    }
}