Android InputFilter详解
创始人
2025-05-29 16:53:41
0次

项目中遇到一个需求,需要限制EditText只能输入到小数点后两位

网上有两种方案,一种是使用TextWatcher,另一种就是使用InputFilter,感觉使用InputFilter的方式比较优雅,比如EditText android:inputType限制各种输入类型就是通过各种各种InputType来实现的。还有maxLength限制EditText输入长度也是通过InputFilter实现的

源码

先来看下InputFilter的源码

就是一个简单的接口,里面还有两个默认的实现类AllCaps和LengthFilter,其中LengthFilter就是限制EditText输入内容最大长度的实现类,很简单,也很具有参考价值,感兴趣的同学可以研究下

package android.text;
import android.annotation.NonNull;
import com.android.internal.util.Preconditions;
import java.util.Locale;/*** InputFilters can be attached to {@link Editable}s to constrain the* changes that can be made to them.*/
public interface InputFilter
{/*** This method is called when the buffer is going to replace the* range dstart … dend of dest* with the new text from the range start … end* of source.  Return the CharSequence that you would* like to have placed there instead, including an empty string* if appropriate, or null to accept the original* replacement.  Be careful to not to reject 0-length replacements,* as this is what happens when you delete text.  Also beware that* you should not attempt to make any changes to dest* from this method; you may only examine it for context.** Note: If source is an instance of {@link Spanned} or* {@link Spannable}, the span objects in the source should be* copied into the filtered result (i.e. the non-null return value).* {@link TextUtils#copySpansFrom} can be used for convenience if the* span boundary indices would be remaining identical relative to the source.*/public CharSequence filter(CharSequence source, int start, int end,Spanned dest, int dstart, int dend);/*** This filter will capitalize all the lowercase and titlecase letters that are added* through edits. (Note that if there are no lowercase or titlecase letters in the input, the* text would not be transformed, even if the result of capitalization of the string is* different from the string.)*/public static class AllCaps implements InputFilter {// 省略好多代码}/*** This filter will constrain edits not to make the length of the text* greater than the specified length.*/public static class LengthFilter implements InputFilter {private final int mMax;public LengthFilter(int max) {mMax = max;}public CharSequence filter(CharSequence source, int start, int end, Spanned dest,int dstart, int dend) {int keep = mMax - (dest.length() - (dend - dstart));if (keep <= 0) {return "";} else if (keep >= end - start) {return null; // keep original} else {keep += start;if (Character.isHighSurrogate(source.charAt(keep - 1))) {--keep;if (keep == start) {return "";}}return source.subSequence(start, keep);}}/*** @return the maximum length enforced by this input filter*/public int getMax() {return mMax;}}
}

源码分析

看完InputFilter的接口定义是很简单,但是到底怎么使用呢,filter()方法里的六个参数又分别表示什么呢?初看源码里的英文注释觉得懵懵的,但是如果理解了再返回看其实注释里讲得挺清晰的。网上很多文章对这些参数的说明都是一笔带过,讲得不明不白的。但是如果你想使用InputFilter就必须把这几个参数分别表示什么都搞明白。

  • source:新输入的内容

  • start:新输入内容起始位置

  • end:新输入内容结束位置

  • dest:原来的内容

  • dstart:待输入(插入)位置光标的起点

  • dend:待输入(插入)位置光标的终点

这样写相信大家还是看不明白,下面会对每个参数再做说明

我们可以先写一个最简单的InputFilter,然后打印看看各个参数的值

public class MyInputFilter implements InputFilter {@Overridepublic CharSequence filter(CharSequence source, int start, int end, Spanned dest, int dstart, int dend) {Log.d("InputFilter", source.toString() + " " + start + " " + end+ " " + dest.toString() + " " + dstart + " " + dend);// 返回null表示不做任何过滤转换return null;}
}
mInput.setFilters(new InputFilter[]{new MyInputFilter()});

假设我们有一个EditText,内容为野原新一,输入的光标停留在内容最后,然后我们新输入了A这个字母,但A还没最终在EditText上显示出来,设置InputFilter的作用就是对新输入的内容做过滤变换等各种操作,在我们输入A后还未在EditText中显示出来前,会先走到InputFilter的的filter方法,此时各个参数的值如下

  • source:A

  • start:0

  • end:1

  • dest:野原新一

  • dstart:4

  • dend:4

日志打印如下,如我所预料的

A 0 1 野猿新一 4 4

看完上面最简单的示例后是不是就比较好理解了,下面再对每个参数做更详细的分析

参数source

参数source就是新输入但是还没生效的内容,在生效前可以通过InputFilter来做各种过滤和转换

参数source在上面简单的例子为一个字符A,长度为1,正常的软键盘输入字母或者数字的情况下每次的source都是一个字符,但是对于比如汉字的拼音输入方,有可能source为多个字符,比如用拼音yuyuan输入野原这两个汉字,这时source长度是2

source长度大于2还有另一种情况就是复制黏贴的情况,比如我们复制了野原新二四个字黏贴到EditText后面,此时的source就变成野原新二四个字,长度为4,此时的start为0,end为4

end正常情况下就是等于source的长度

参数start

正常情况下都是0,不正常情况我也不几道

参数end

正常情况下都是等于source.length(),不正常情况我也布吉岛

参数dest

参数dest就是原来新输入内容还没生效前的原来的内容

参数dstart

参数dstart正常情况下,也就是光标在输入框内容最后面的情况下,dstart的值为dest.length(),也就是原来内容的长度

不正常情况下就是输入内容不是在尾部,而是从中间插入,或者插入到前面,这时候dstart的值就是光标的位置,这里说的光标位置是指起始的光标位置,结束光标的位置在参数dend的说明时会说到

参数dend

参数dend正常情况下的值等于dstart的值,也就是光标的位置,这种情况下是只考虑输入内容为插入的情况

还有一种情况是替换内容,这时候光标是有一个范围的,分为起始光标dstart和结束光标,起始光标和结束光标间选中的内容,在新输入内容生效后会被新的内容替换

如下图所示的内容,此时的dstart=2,dend=6,这样就很好理解了,dstart等于替换内容第一个字符的位置,dend等于替换内容最后一个字符的后一个位置,也就是dend的值是exclude不包含的

删除的情况

前面考虑的都是输入内容的情况,删除(或者剪切)内容的情况也是会调用InputFilter的

比如EditText原来的内容为‘野原新一’,当我们删除最后一个字符‘一’的时候,filter()方法打印的各个参数内容如下

  0 0 野猿新一 3 4
  • source:

  • start:0

  • end:0

  • dest:野原新一

  • dstart:3

  • dend:4

直接看打印的参数值就很清晰明了,因为是删除,所以source是空的,dstart就是删除的最后一个字符的位置

返回值

对于InputFilter除了要理解各个参数的含义外,还需要知道不同的返回值的不同含义

  • 返回null:不做任何过滤和转换,输入什么就是什么

  • 返回"":将source替换为空,也就是不允许任何输入

  • 返回具体的内容:将source替换为具体的内容

最简单的实例

下面我们写几个最简单的示例来验证我们上面的结论

下面例子非常简单,filter()方法直接返回"",也就是任何输入都替换成空,这个例子可以用来禁止EditText输入任何的内容

public class InputFilter1 implements InputFilter {@Overridepublic CharSequence filter(CharSequence source, int start, int end, Spanned dest, int dstart, int dend) {return "";}
}

这个例子会把任何输入的内容都替换成‘野原新一’这四个字,比如你在键盘输入'A',在EditText中会显示‘野原新一’

public class InputFilter1 implements InputFilter {@Overridepublic CharSequence filter(CharSequence source, int start, int end, Spanned dest, int dstart, int dend) {return "野原新一";}
}

只要理解了InputFilter的filter()方法中各个参数的含义及retuan的使用方法,不管任何需求,任何复杂的过滤和变换都可以实现。

相关内容

热门资讯

在大吉订购APP订购交易亏损被...   近期,不少投资者反映在“大吉订购App”上投资白银、铂金等商品遭遇严重亏损。该平台宣称提供现货订...
铂银壹号APP商品订购交易亏损...   许多中小投资者误以为网上的“商品现货订购”是合规合法的理财渠道,殊不知这背后隐藏着巨大的合规风险...
兴鑫淘金APP贵金属订购交易亏...   白银、贵金属或其他商品类投资,除国家批准的正规期货交易场所及持牌期货公司外,市面上大量第三方交易...
铂银掘金APP无资质的违规平台...   铂银掘金等平台的投资者,往往是被“注册送现金”“充值返现券”“首单免亏”等广告话术吸引,进而下载...
八方淘金APP订购交易不合规,...   “八方淘金APP”“铂银掘金APP”“铂银壹号APP”等软件被指以“现货订购”为名,实际采用高杠...
在指尖订购APP订购商品亏损被...   指尖订购APP这类平台,表面是“订购交易”,实则是披着电商外衣的非法期货陷阱。绝大多数投资者被蒙...
在犀贝易购APP做商品订购交易...   市面上打着“现货投资”“贵金属交易”旗号的APP并不少,但真正合规、受监管的平台并不多。犀贝易购...
易达淘金APP虚假商品订购交易...   易达淘金APP存在严重的虚假宣传与违规交易行为。该平台打着“商品订购”的旗号,实则通过不合规的交...
大浪淘金APP白银订购亏损被骗...   大浪淘金APP最隐蔽的套路,在于其完全封闭的内盘交易系统。表面上,它宣称与国际贵金属市场接轨;实...
一品好购APP上订购白银出现亏...   一品好购APP原名“一品订购”,运营方为上海宝智未来信息技术有限公司。近期不少投资者反映在该平台...
九州订购APP贵金属订购投资骗...   九州订购APP正通过抖.音、快手、今日头条等平台大量投放投资广告,用“5元起投”“充值返现”“0...
坚锅淘金APP交易软件并不正规...   当前,市面上大量所谓的“现货商城订购”交易软件,早已偏离了正常的实物商品买卖,演变为高杠杆、高手...
斗金订购APP贵金属期货交易骗...   斗金订购APP的投资者往往被铺天盖地的广告宣传所诱导——注册即送现金、充值返现券等看似诱人的福利...
警惕!云启购APP违规经营,披...   "5元起投、充值返现、稳赚不赔"——这些诱人的广告语背后,可能是一个精心设计的金融陷阱。  近期...
量子淘金APP贵金属投资不合规...   "4元起投""充值返券""月入过万"——这些极具诱惑力的广告语在短视频平台、社交软件上铺天盖地。...
鑫汇智投APP贵金属商品订购骗...   鑫汇智投APP非法期货投资骗局,受害者在投资过程中根本不懂交易,也不去研究和验证这个平台是否正规...
矅光智策APP平台违规经营非法...   矅光智策APP对外宣称是“商城订购”“现货交易”,但查询其经营范围,并未显示具备开展现货期货交易...
黄金珠宝怎么选?内侧刻字都代表... 潮新闻客户端 记者 马焱 通讯员 任倩影 9月8日下午,“云游杭州 乐购金秋”——“浙城·浙放心”活...
原创 冰... 最近全球国债市场正在上演魔幻一幕: 美债、日债、欧债遭遇猛烈抛售,收益率冲到几十年新高,美国财政部都...
日韩股市开盘表现分化 上证报中国证券网讯 9月9日,日韩股市开盘表现分化,韩国综合指数开盘上涨0.26%,报6972.87...