InputFilter：是什么，InputFilter接口及Android中的过滤

什么是InputFilter且为什么需要它？

InputFilter是来自android.text包的功能接口，定义了一个单一方法filter(CharSequence source, int start, int end, Spanned dest, int dstart, int dend)。每当用户尝试在EditText中输入、粘贴或替换文本时，它会自动被调用。返回值确定变更是否被接受、拒绝或修改。

InputFilter的主要目的是在文本进入字段之前防止错误输入。filter方法接收六个参数。如果方法返回null，变更被接受。如果返回空字符串“”，变更被拒绝。InputFilter不会修改原始数据源，只返回过滤后的版本。

InputFilter如何工作

例如，如果用户尝试在只允许数字的字段中输入字母“a”，过滤器返回“”，字符不会显示。InputFilter不会修改原始数据源，只返回过滤后的版本。

Android SDK中的标准过滤器

Android SDK提供了多种内置的InputFilter实现。最常见的是InputFilter.LengthFilter，它限制文本的最大长度。InputFilter.AllCaps将所有输入的字符转换为大写字母。

创建自定义InputFilter

要创建自定义过滤器，需要实现InputFilter接口并覆盖filter方法。DigitsInputFilter过滤器示例遍历所有输入字符并仅保留数字。

class DigitsInputFilter : InputFilter {
    override fun filter(
        source: CharSequence?,
        start: Int,
        end: Int,
        dest: Spanned?,
        dstart: Int,
        dend: Int
    ): CharSequence? {
        val sb = StringBuilder()
        for (i in start until end) {
            val c = source?.get(i)
            if (c != null && Character.isDigit(c)) {
                sb.append(c)
            }
        }
        return if (sb.length == end - start) null else sb
    }
}

另一个常见场景是禁止特殊字符的过滤器，用于用户名、搜索等不允许特殊字符的场景。

将InputFilter应用于EditText

过滤器通过setFilters(InputFilter[])方法设置在EditText上。过滤器数组替换当前过滤器。要将过滤器添加到现有过滤器，需要通过getFilters()获取当前过滤器，创建新数组并设置回去。

val editText = findViewById<EditText>(R.id.phone_input)
editText.filters = arrayOf(
    DigitsInputFilter(),
    InputFilter.LengthFilter(10)
)

示例中设置了两个过滤器：DigitsInputFilter（只允许数字）和LengthFilter（最大10个字符）。过滤器也可以通过XML属性android:inputType设置。

InputFilter和输入验证

InputFilter和TextWatcher具有不同的功能，常常一起使用。InputFilter在输入层面工作，TextWatcher在输入后工作。两种方法的组合产生最佳效果。