参考:https://www.jianshu.com/p/a74843cf1b18
在学习了RxJava的使用后,我们已经对响应式编程有了一些了解。在此基础上,我们学习一下RxBinding的使用。什么是RxBinding?从字面上解释:以RxJava的方式去绑定UI事件。RxBinding是UI控件响应式编程框架。通过使用RxBinding,可以用RxJava的方式便捷的实现Android各种控件事件的监听。
RxBinding 能够把 Android 平台的兼容包内的 UI 控件变为 Observaber 对象. 可以把 UI 控件的事件当作 RxJava 中的数据流来使用.
为什么要用 RxBinding
RxBinding 的优点:
- 它是对 Android View 事件的扩展, 它使得开发者可以对 View 事件使用 RxJava 的各种操作.
- 提供了与 Rxjava 一致的回调, 使得代码简洁明了.
- 几乎支持所有的常用控件及事件, 还对 Kotlin 支持.
使用场景
- 可以应用于整个 App 的所有 UI 事件.
一.RxBinding的导入
GitHub地址:https://github.com/JakeWharton/RxBinding.我们可以从这里了解到RxBinding的最新版本。我使用的版本如下:
implementation 'com.jakewharton.rxbinding3:rxbinding:3.1.0'
注:依赖RxBinding就不需要再依赖RxJava了,内部已经包含了
二.RxBinding的使用
1.RxView
(1)clicks:点击监听
throttle:
v.使窒息;掐死;勒死 n.节流阀;节流杆;风门;风门杆
RxBinding通过使用RxView.clicks()来实现点击事件的监听,使用throttleFirst()来实现防抖动(例如我们设置为2秒,那么用户不论在2秒的时间内点击多少次,我们只响应一次点击事件),点击事件的代码如下:
RxView.clicks(btnClick)
.throttleFirst(2, TimeUnit.SECONDS)
.subscribe(new Consumer<Unit>() {
@Override
public void accept(Unit unit) throws Exception {
Toast.makeText(MainActivity.this, "点击按钮", Toast.LENGTH_SHORT).show();
}
});
(2)longClicks:长按监听
RxBinding通过使用RxView.longClicks()来实现长按事件的监听,示例代码如下:
RxView.longClicks(btnLongClick)
.subscribe(new Consumer<Unit>() {
@Override
public void accept(Unit unit) throws Exception {
Toast.makeText(MainActivity.this, "长按按钮", Toast.LENGTH_SHORT).show();
}
});
(3)scrollChangeEvents:滑动监听
RxBinding通过RxView.scrollChangeEvents()来实现滑动事件的监听,例如NestedScrollView、ListView等支持滑动的控件,示例代码如下:
RxView.scrollChangeEvents(scrollView)
.subscribe(new Consumer<ViewScrollChangeEvent>() {
@Override
public void accept(ViewScrollChangeEvent viewScrollChangeEvent) throws Exception {
tvTop.setText("滑动距离:" + viewScrollChangeEvent.getScrollY());
}
});
(4)visibility:可见性
boolean visible = false;
RxView.visibility(tvTop).accept(visible);
(5)draws:绘制
//当btnLogin绘制时触发
RxView.draws(btnLogin)
.subscribe(new Consumer<Object>() {
@Override
public void accept(Object o) throws Exception {
}
});
(6)drags:拖拽
//拖拽监听
RxView.drags(btnLogin)
.subscribe(new Consumer<DragEvent>() {
@Override
public void accept(DragEvent dragEvent) throws Exception {
Toast.makeText(MainActivity.this, "被拖拽了", Toast.LENGTH_LONG).show();
}
});
2.RxTextView
(1)textChanges:输入监听
RxBinding通过RxTextView.textChanges实现输入监听,示例代码如下:
RxTextView.textChanges(edt)
.subscribe(new Consumer<CharSequence>() {
@Override
public void accept(CharSequence charSequence) throws Exception {
tvChange.setText("输入的内容1:"+charSequence);
}
});
(2)textChangeEvents:输入监听
RxBinding通过RxTextView.textChangeEvents实现输入监听,与textChanges不同的是,textChangeEvents可以获取输入事件,其返回数据的类型为TextViewTextChangeEvent,内部包含详细的文本改变数据。示例代码如下:
RxTextView.textChangeEvents(edtEnter)
.subscribe(new Consumer<TextViewTextChangeEvent>() {
@Override
public void accept(TextViewTextChangeEvent textViewTextChangeEvent) throws Exception {
Log.e("rx_binding_test", "textChanges:文本改变了:
before:" + textViewTextChangeEvent.getBefore() +
",start:" + textViewTextChangeEvent.getStart() +
",text:" + textViewTextChangeEvent.getText() +
",count:" + textViewTextChangeEvent.getCount());
}
});
(3)debounce:限流
RxBinding通过debounce实现限流。在一些场景下,我们需要根据用户输入内容的变化去请求服务器的数据,如果请求过于频繁,将会带来极大的负担。因此,可以通过debounce设置请求的事件。示例代码如下:
RxTextView.textChanges(edt)
.debounce(500,TimeUnit.MILLISECONDS)//限流
.observeOn(AndroidSchedulers.mainThread())
.subscribe(new Consumer<CharSequence>() {
@Override
public void accept(CharSequence charSequence) throws Exception {
tvChange.setText("输入的内容1:"+charSequence);
}
});
正是由于RxBinding使用的是RxJava形式,所以RxJava中的操作符我们都可以使用。利用debounce操作符进行限流,就能避免因为用户输入速度过快导致多次请求服务器了。还可以利用map操作符将CharSequence转换为String再返回。
(4)editorActions:软键盘回车键监听
RxBinding可以使用RxTextView.editorActions实现对软键盘回车键的监听,使用这种方式监听存在一个问题:会监听两次,down事件和up事件都会监听到,示例代码如下:
RxTextView.editorActions(edt)
.subscribe(new Consumer<Integer>() {
@Override
public void accept(Integer integer) throws Exception {
Log.d("TTTT","integer:"+integer);
//会弹出两次,因为监听了down和up两个事件
Toast.makeText(MainActivity.this,"点击了回车键",Toast.LENGTH_SHORT).show();
}
});
(5)editorActionEvents:软键盘回车键监听
也可以使用editorActionEvents方式实现对软键盘回车键的监听,此方式比上面的方式更好,可以获取监听的事件,可以判断事件的类型是up或者down,可以判断action的种类,进而进行更具体的事件监听,示例代码如下:
RxTextView.editorActionEvents(edtEnter)
.subscribe(new Consumer<TextViewEditorActionEvent>() {
@Override
public void accept(TextViewEditorActionEvent textViewEditorActionEvent) throws Exception {
KeyEvent keyEvent = textViewEditorActionEvent.getKeyEvent();
if(keyEvent.getAction()==KeyEvent.ACTION_UP){
Toast.makeText(MainActivity.this,"点击了回车键",Toast.LENGTH_SHORT).show();
}
}
});
3.RxAdapterView
(1)itemClicks:ListView点击item事件
RxBinding通过RxAdapterView.itemClicks实现对ListView item点击事件的监听,示例代码如下:
RxAdapterView.itemClicks(mListView)
.subscribe(new Consumer<Integer>() {
@Override
public void accept(Integer integer) throws Exception {
Toast.makeText(MainActivity.this, "点击了第 " + integer + "个", Toast.LENGTH_SHORT).show();
}
});
(2)itemLongClicks:ListView长按item事件
RxBinding通过RxAdapterView.itemLongClicks实现对ListView item长按事件的监听,示例代码如下:
RxAdapterView.itemLongClicks(mListView)
.subscribe(new Consumer<Integer>() {
@Override
public void accept(Integer integer) throws Exception {
Toast.makeText(MainActivity.this, "长按了第 " + integer + "个", Toast.LENGTH_SHORT).show();
}
});
以上只是对android常用控件事件的监听,RxBinding几乎支持所有的Android控件的监听,感兴趣的朋友可以自行去学习和研究。