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 start source的起始位置
int end source的结束位置
以上3个参数描述出用来替换的新的字符串
Spanned dest 修改前的字符串,setText()时dest为EMPTY_SPANNED,添加或修改时为输入框内的文本内容
int dstart dest选中范围的起始位置
int dend dest选中范围的结束位置

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时,不对输入数据进行任何过滤操作,数据不变

本文由 bt 创作，采用知识共享署名4.0 国际许可协议进行许可。
本站文章除注明转载/出处外，均为本站原创或翻译，转载前请务必署名。