使用单向数据绑定,您可以在属性上设置值,并设置对该属性中的更改作出反应的侦听器:
<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注释,如以下代码片段所示:
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);
}
}
}
由于bindable属性的getter方法称为getRememberMe(),因此属性的相应setter方法会自动使用名称setRememberMe()。
有关使用BaseObservable和@Bindable的更多信息,请参阅使用可观察数据对象。
一、使用自定义属性进行双向数据绑定
该平台为最常见的双向属性和更改侦听器提供双向数据绑定实现,您可以将其用作应用程序的一部分。 如果要对自定义属性使用双向数据绑定,则需要使用@InverseBindingAdapter和@InverseBindingMethod注释。
例如,如果要在名为MyView的自定义视图中对“time”属性启用双向数据绑定,请完成以下步骤:
- 注释设置初始值的方法,并在使用@BindingAdapter更改值时进行更新:
@BindingAdapter("time")
public static void setTime(MyView view, Time newValue) {
// Important to break potential infinite loops.
if (view.time != newValue) {
view.time = newValue;
}
}
2.使用@InverseBindingAdapter注释从视图中读取值的方法:
@InverseBindingAdapter("time")
public static Time getTime(MyView view) {
return view.getTime();
}
此时,数据绑定知道数据更改时要执行的操作(它调用使用@BindingAdapter注释的方法)以及视图属性更改时调用的内容(它调用InverseBindingListener)。 但是,它不知道属性何时或如何更改。
为此,您需要在视图上设置一个侦听器。 它可以是与自定义视图关联的自定义侦听器,也可以是通用事件,例如失去焦点或文本更改。 将@BindingAdapter注释添加到为该属性的更改设置侦听器的方法:
@BindingAdapter("app:timeAttrChanged")
public static void setListeners(
MyView view, final InverseBindingListener attrChange) {
// Set a listener for click, focus, touch, etc.
}
侦听器包含InverseBindingListener作为参数。 您可以使用InverseBindingListener告知数据绑定系统该属性已更改。 然后,系统可以开始使用@InverseBindingAdapter调用注释方法,依此类推。
注意:每个双向绑定都会生成一个综合事件属性。 此属性与基本属性具有相同的名称,但它包含后缀“AttrChanged”。 合成事件属性允许库创建使用@BindingAdapter注释的方法,以将事件侦听器关联到View的相应实例。
在实践中,该侦听器包括一些非平凡的逻辑,包括用于单向数据绑定的侦听器。 有关示例,请参阅文本属性更改的适配器TextViewBindingAdapter。
二、转换器
如果绑定到View对象的变量需要在显示之前以某种方式进行格式化,转换或更改,则可以使用Converter对象。
例如,使用显示日期的EditText对象:
<EditText
android:id="@+id/birth_date"
android:text="@={Converter.dateToString(viewmodel.birthDate)}"
/>
viewmodel.birthDate属性包含Long类型的值,因此需要使用转换器对其进行格式化。
因为正在使用双向表达式,所以还需要一个逆转换器让库知道如何将用户提供的字符串转换回后备数据类型,在本例中为Long。 此过程通过将@InverseMethod注释添加到其中一个转换器并使此注释引用逆转换器来完成。 以下代码段中显示了此配置的示例:
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.
}
}
三、使用双向数据绑定的无限循环
使用双向数据绑定时,请注意不要引入无限循环。 当用户更改属性时,将调用使用@InverseBindingAdapter注释的方法,并将值分配给backing属性。 反过来,这将调用使用@BindingAdapter注释的方法,这将触发对使用@InverseBindingAdapter注释的方法的另一个调用,依此类推。
因此,通过比较使用@BindingAdapter注释的方法中的新旧值来打破可能的无限循环非常重要。
四、双向属性
当您使用下表中的属性时,该平台为双向数据绑定提供内置支持。
网友评论