InputFilter: mi ez, az InputFilter interfész és szűrés Androidban

Mi az InputFilter és mire használjuk?

InputFilter egy funkcionális interfész az android.text csomagból, amely egyetlen filter(CharSequence source, int start, int end, Spanned dest, int dstart, int dend) metódust határoz meg. Automatikusan meghívódik, valahányszor a felhasználó megpróbál szöveget beírni, beilleszteni vagy cserélni az EditText-ben. A visszaadott érték határozza meg, hogy a változtatás elfogadásra, elutasításra vagy módosításra kerüljön.

Az InputFilter fő célja a helytelen bevitel megakadályozása, mielőtt a szöveg a mezőbe kerülne. A filter metódus hat paramétert fogad. Ha a metódus null-t ad vissza, a változtatás változtatás nélkül elfogadásra kerül. Ha egy üres karakterláncot „“ ad vissza, a változtatás blokkolva van. Az InputFilter nem módosítja az eredeti adatforrást, csak a szűrt verziót adja vissza.

Hogyan működik az InputFilter

Például, ha a felhasználó megpróbál beszúrni egy „a“ betűt egy olyan mezőbe, ahol csak számok engedélyezettek, a szűrő „“ értéket ad vissza, és a karakter nem jelenik meg. Az InputFilter nem módosítja az eredeti adatforrást, csak a szűrt verziót adja vissza.

Szabványos szűrők az Android SDK-ban

Az Android SDK több beépített InputFilter megvalósítást kínál. A legelterjedtebb az InputFilter.LengthFilter, amely korlàtozza a szöveg maximális hosszát. Az InputFilter.AllCaps az összes bevitt karaktert nagybetűvé alakítja.

Egyéni InputFilter létrehozása

Egyéni szűrő létrehozásához implementálni kell az InputFilter interfészt és felül kell írni a filter metódust. A DigitsInputFilter példa átmegy a bevitt szöveg összes karakterén, és csak a számokat tartja meg.

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

Egy másik népszerű forgatókönyv a speciális karaktereket tiltó szűrő, amelyet felhasználónév mezőkben, keresésben és más helyeken használnak, ahol a speciális karakterek nem engedélyezettek.

InputFilter alkalmazása EditText-re

A szűrők az EditText-en a setFilters(InputFilter[]) metódussal állíthatók be. A szűrő tömb felülírja a jelenlegi szűrőket. Ha szűrőt szeretne hozzáadni a meglévőkhöz, kérje le a jelenlegieket a getFilters() segítségével, hozzon létre egy új tömböt, és állítsa vissza.

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

A példában két szűrő van beállítva: DigitsInputFilter (csak számok) és LengthFilter (maximum 10 karakter). A szűrők a android:inputType XML attribútummal is beállíthatók.

InputFilter és beviteli érvényesítés

Az InputFilter és a TextWatcher különböző funkciókat látnak el, és gyakran használják őket együtt. Az InputFilter a bevitel szintjén működik, a TextWatcher a bevitel után működik. A két megközelítés kombinációja adja a legjobb eredményt.