TextWatcher作用为监测键盘输入并根据输入内容展示不同显示效果
接口分析(按回调顺序)
- 文本改变前
@Override
public void beforeTextChanged(CharSequence s, int start, int count, int after) {}
其中有4个参数:
-
CharSequence s：文本改变之前的内容 -
int start: 被替换文本区域起点位置 -
int count：将被替换的文本区域字符数目 -
int after：替换后的文本字符数目
文本 s 中的 start 位置之后的 count 个字符将被替换为 after 个新的字符
注:s为替换前的文本
- 文本改变时
@Override
public void onTextChanged(CharSequence s, int start, int before, int count) {}
其中有4个参数:
-
CharSequence s：文本改变之后的内容 -
int start: 被替换文本区域起点位置,setText时是替换所有内容,此时数值为0 -
int before：被替换之前的文本区域字符数目 -
int count：替换后的文本字符数目
文本 s 中的 start 位置之后的 before 个字符已经被替换为 count 个新的字符
注:s为替换后的新文本
- 文本改变后
@Override
public void afterTextChanged(Editable s) {}
其中有1个参数:
-
Editable s：文本改变之后的内容
TextWatcher使用
//所有继承自TextView的类
textView.addTextChangedListener(new TextWatcher() {
@Override
public void onTextChanged(CharSequence s, int start, int before, int count) {}
@Override
public void beforeTextChanged(CharSequence s, int start, int count, int after) {}
@Override
public void afterTextChanged(Editable s) {}
});
注意事项 :
- 在回调方法中获取的新字符串虽然已经设置到
TextView中,但是还未在UI界面中更新.
重要 :
经网上查阅,几乎没有人提到过回调方法过程中UI是否已经更新数据,而笔者比较在意是否处理数据导致页面闪烁.
发现有人已经注意到这一点,其情景为短时间内多次触发回调,但是页面只显示了最后一次数据结果,而评论中却归结为处理速度快导致分辨不出闪烁.
笔者在回调方法中加入延时,而UI更新时间为3个回调方法结束后.判断为只有在数据处理完毕后才会显示在UI上.
如若判断失误欢迎大家指正
- 有2种情况会触发TextWatcher的3个回调方法,
setText()和EditText键盘输入 - 如果在回调方法中调用
setText(),会进入无限循环,需要增加判断条件 -
afterTextChanged中去改变Editable s的值会触发TextWatcher的3个回调方法,会进入无限循环,需要增加判断条件 -
Editable s和CharSequence s获取的数据为去除空格和回车之后字符串.
应用场景
- 各种银行卡/激活码/手机号/电话号等等输入框,可根据输入的内容进行添加空格,破折号或加号等等,形成格式化.
- 对于微博,微信朋友圈等等场景多半对于字符串长度有要求,而直观的加入字数显示和剩余字数可提升用户体验.
- 特殊场景,比如输入银行卡时只能输入数字,身份证只能输入数字+X,输入激活码时全部大写等等.
- 输入联想,输入补全等等,例如商品搜索过程自动改变listview内容,例如输入邮箱过程中检测到@时自动显示常用后缀等等.
- 抛砖引玉,欢迎大家发掘更多应用场景
InputFilter过滤
InputFilter是系统提供的一个接口,是一个过滤器,修改传入的字符串,返回值类型为CharSequence.
自定义InputFilter
public class mInputFilter implements InputFilter {
@Override
public CharSequence filter(CharSequence source, int start, int end,
Spanned dest, int dstart, int dend) {
return null;
}
}
可以看到只需要实现filter()方法,而方法会传入6个参数,下面详细解释每个参数的含义
-
CharSequence source用来替换的新的字符串,包括键盘输入/setText()/粘贴的内容 -
int startsource的起始位置 -
int endsource的结束位置
以上3个参数描述出用来替换的新的字符串 -
Spanned dest修改前的字符串,setText()时dest为EMPTY_SPANNED,添加或修改时为输入框内的文本内容 -
int dstartdest选中范围的起始位置 -
int denddest选中范围的结束位置
textView.setFilters(inputFilters);
设置过滤器,inputFilters为InputFilter 数组.
注意事项
-
setFilters方法为替换过程,如果直接添加我们自定义的过滤器会导致原本textview自带的过滤方法失效,比如设置了maxLength属性会无效.具体方法如下
//获取到原来的InputFilter数组
textView.getFilters();
... //将获取到的InputFilter数组元素加入新建的数组中
//设置新的
textView.setFilters(inputFilters);
- 过滤操作在
beforeTextChanged回调方法之前进行 - 过滤操作是对InputFilter数组的元素进行遍历,需要考虑元素顺序对过滤的影响
int n = mFilters.length;
for (int i = 0; i < n; i++) {
CharSequence out = mFilters[i].filter(text, 0, text.length(), EMPTY_SPANNED, 0, 0);
if (out != null) {
text = out;
}
}
根据源码得知,当返回值为null时,不对输入数据进行任何过滤操作,数据不变
