InputFilter: ce este, interfața InputFilter și filtrarea în Android

Ce este InputFilter și de ce este necesar?

InputFilter este o interfață funcțională din pachetul android.text care definește o singură metodă filter(CharSequence source, int start, int end, Spanned dest, int dstart, int dend). Este apelată automat de fiecare dată când utilizatorul încearcă să introducă, să insereze sau să înlocuiască text în EditText. Valoarea returnată determină dacă modificarea va fi acceptată, respinsă sau modificată.

Scopul principal al InputFilter este prevenirea introducerii incorecte înainte ca textul să ajungă în câmp. De exemplu, în câmpul pentru introducerea cifrelor numărului de telefon, filtrul poate interzice literele și caracterele speciale. În câmpul parolei — să limiteze lungimea minimă. În câmpul codului de confirmare — să permită doar cifrele.

Metoda filter primește șase parametri: source — textul introdus, start și end — limitele fragmentului introdus, dest — conținutul curent al câmpului, dstart și dend — poziția unde este inserat textul. Dacă metoda returnează null, modificarea este acceptată fără schimbări. Dacă returnează un șir gol „“, modificarea este blocată. Dacă returnează un nou CharSequence, textul original este înlocuit cu cel returnat.

Important: InputFilter nu modifică sursa originală de date, ci doar returnează versiunea filtrată. Android aplică singur valoarea returnată la Editable. Dacă filtrul returnează null, nu sunt necesare acțiuni suplimentare. Dacă returnează text modificat, Android șterge intervalul original și inserează unul nou.

Cum funcționează InputFilter

Metoda filter primește șase parametri. Dacă returnează null, modificarea este acceptată. Dacă returnează un șir gol „“, modificarea este blocată. Dacă returnează un nou CharSequence, textul original este înlocuit.

De exemplu, dacă utilizatorul încearcă să insereze litera „a“ într-un câmp unde sunt permise doar cifrele, filtrul returnează „“, iar caracterul nu apare. Dacă inserează „123“, filtrul poate returna „1-2-3“, adăugând separatori. Acest mecanism permite implementarea formatării automate a numărului de telefon, datei și altor date structurate fără participarea TextWatcher.

InputFilter nu modifică sursa originală de date, ci doar returnează versiunea filtrată. Android aplică singur valoarea returnată la Editable.

Filtre standard în Android SDK

Android SDK oferă mai multe implementări încorporate ale InputFilter. Cel mai răspândit este InputFilter.LengthFilter, care limitează lungimea maximă a textului. InputFilter.AllCaps transformă toate caracterele introduse în majuscule.

Crearea unui InputFilter personalizat

Pentru a crea un filtru personalizat, trebuie să implementați interfața InputFilter și să suprascrieți metoda filter. O sarcină frecventă este un filtru care permite doar cifrele.

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

Exemplul filtrului DigitsInputFilter parcurge toate caracterele textului introdus și păstrează doar cifrele. Un alt scenariu popular este filtrul care interzice caracterele speciale, utilizat în câmpurile de nume de utilizator, căutare și alte locuri unde caracterele speciale nu sunt permise.

Aplicarea InputFilter la EditText

Filtrele se setează pe EditText prin metoda setFilters(InputFilter[]). Tabloul de filtre înlocuiește filtrele curente.

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

În exemplu, se setează două filtre: DigitsInputFilter (doar cifre) și LengthFilter (maximum 10 caractere). Filtrele pot fi setate și prin atributul XML android:inputType.

InputFilter și validarea intrării

InputFilter și TextWatcher au funcții diferite și sunt adesea utilizate împreună. InputFilter acționează la nivelul introducerii — nu permite caracterelor incorecte să ajungă în câmp. TextWatcher acționează după introducere — permite reacția la modificări, validarea regulilor complexe și actualizarea UI.