InputFilter: шта је то, интерфејс InputFilter и филтрација у Android-у

Шта је InputFilter и зашто је потребан?

InputFilter је функционални интерфејс из пакета android.text који дефинише јединствену методу filter(CharSequence source, int start, int end, Spanned dest, int dstart, int dend). Позива се автоматски сваки пут када корисник покушава да унесе, уметне или замени текст у EditText. Повратна вредност одређује да ли ће промена бити прихваћена, одбијена или измењена.

Основна намена InputFilter-а је спречавање неисправног уноса пре него што текст стигне у поље. За разлику од валидације кроз TextWatcher, филтер не дозвољава погрешним знаковима да се чак појаве на екрану.

Метода filter прима шест параметара. Ако врати null, промена је прихваћена. Ако врати празан низ "", промена је блокирана. InputFilter не мења оригинални извор података, већ само враћа филтрирану версију.

Како ради InputFilter

Метода filter прима шест параметара: source — унети текст, start и end — границе унетог фрагмента, dest — тренутни садржај поља, dstart и dend — позиција уметања текста.

На примјер, ако корисник покушава да уметне слово "a" у поље где су дозвољене само цифре, филтер враћа "", и знак се не појављује. InputFilter не мења оригинални извор података, већ само враћа филтрирану версију.

Стандардни филтери у Android SDK

Android SDK пружа неколико уграђених имплементација InputFilter-а. Најпопуларнији је InputFilter.LengthFilter који ограничава максималну дужину текста. InputFilter.AllCaps претвара све унете знакове у велика слова.

Креирање прилагођеног InputFilter-а

За креирање прилагођеног филтера потребно је имплементирати интерфејс InputFilter и преписати методу filter. Чест задатак је филтер који дозвољава само цифре.

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
    }
}

Примјер филтера DigitsInputFilter пролази кроз све знакове унетог текста и оставља само цифре. Други популаран сценариј је филтер за забрану специјалних знакова.

Примена InputFilter-а на EditText

Филтери се постављају на EditText путем методе setFilters(InputFilter[]). Низ филтера замењује тренутне филтере.

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 ради након уноса.