TextWatcher使用和应用场景

TextWatcher作用为监测键盘输入并根据输入内容展示不同显示效果
接口分析(按回调顺序)
  1. 文本改变前
@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为替换前的文本
  1. 文本改变时
@Override public void onTextChanged(CharSequence s, int start, int before, int count) {}

【TextWatcher使用和应用场景】其中有4个参数:
  • CharSequence s:文本改变之后的内容
  • int start : 被替换文本区域起点位置,setText时是替换所有内容,此时数值为0
  • int before:被替换之前的文本区域字符数目
  • int count:替换后的文本字符数目
文本 s 中的 start 位置之后的 before 个字符已经被替换为 count 个新的字符
注:s为替换后的新文本
  1. 文本改变后
@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 sCharSequence s获取的数据为去除空格和回车之后字符串.
应用场景
  1. 各种银行卡/激活码/手机号/电话号等等输入框,可根据输入的内容进行添加空格,破折号或加号等等,形成格式化.
  2. 对于微博,微信朋友圈等等场景多半对于字符串长度有要求,而直观的加入字数显示和剩余字数可提升用户体验.
  3. 特殊场景,比如输入银行卡时只能输入数字,身份证只能输入数字+X,输入激活码时全部大写等等.
  4. 输入联想,输入补全等等,例如商品搜索过程自动改变listview内容,例如输入邮箱过程中检测到@时自动显示常用后缀等等.
  5. 抛砖引玉,欢迎大家发掘更多应用场景
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()destEMPTY_SPANNED,添加或修改时为输入框内的文本内容
  • int dstart dest选中范围的起始位置
  • int dend dest选中范围的结束位置
textView.setFilters(inputFilters);

设置过滤器,inputFiltersInputFilter 数组.
注意事项
  1. setFilters方法为替换过程,如果直接添加我们自定义的过滤器会导致原本textview自带的过滤方法失效,比如设置了maxLength属性会无效.具体方法如下
//获取到原来的InputFilter数组 textView.getFilters(); ...//将获取到的InputFilter数组元素加入新建的数组中 //设置新的 textView.setFilters(inputFilters);

  1. 过滤操作在beforeTextChanged回调方法之前进行
  2. 过滤操作是对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时,不对输入数据进行任何过滤操作,数据不变

    推荐阅读