Validate: ce este, validarea câmpurilor de intrare și implementarea în Android

Ce este validarea câmpurilor în Android?

Validarea câmpului — este verificarea unei singure valori introduse de utilizator pentru conformitate cu regulile stabilite. Fiecare câmp are propriul tip de date: email, număr, telefon, parolă, text. Pentru fiecare tip există propriile criterii: format, lungime, interval de valori, obligativitate. Validarea câmpului răspunde la întrebarea: este corectă intrarea în acest câmp?

Diferența dintre validarea câmpului și validarea formularului este că câmpul este verificat independent de celelalte câmpuri. Emailul este verificat după modelul de email, telefonul — după modelul de telefon. Dacă câmpul este invalid, utilizatorul vede eroarea exact pentru acest câmp. Formularul poate rămâne netrimis chiar dacă un câmp nu a trecut verificarea. Validarea câmpului este blocul de construcție pentru validarea completă a formularului.

Conform cercetărilor UX, utilizatorii se așteaptă să vadă eroarea de validare nu mai târziu de 1-2 secunde după terminarea introducerii. Întârzierea de peste 3 secunde este percepută ca o problemă cu aplicația. De aceea, validarea în timp real prin TextWatcher este preferabilă verificării doar la apăsarea butonului de trimitere.

Metode principale de validare a câmpurilor

Există trei abordări principale pentru validarea câmpurilor în Android. Prima — verificarea manuală prin operatori condiționali (if, when). Dezvoltatorul scrie o funcție care primește un șir și returnează Boolean sau un mesaj de eroare. Această abordare oferă control complet asupra logicii, dar necesită scrierea de cod pentru fiecare câmp și fiecare condiție.

A doua abordare — utilizarea claselor Android încorporate. De exemplu, Patterns.EMAIL_ADDRESS.matcher(email).matches() verifică emailul după modelul standard. Patterns.PHONE.matcher(phone).matches() — numărul de telefon. TextUtils.isEmpty() — verifică dacă este gol. Aceste metode acoperă scenariile de bază fără a conecta dependențe externe.

A treia abordare — biblioteci de validare. Bibliotecile precum InputValidator, AndroidValidator sau Commons Validator oferă adnotări gata făcute și lanțuri de verificări. Dezvoltatorul descrie regulile declarativ: @Email, @NotEmpty, @MinLength(6). Biblioteca efectuează singură verificarea și returnează o listă de erori. Aceasta accelerează dezvoltarea, dar adaugă o dependență.

Validarea email, telefon și parolă

Pentru email, verificarea standard include prezența simbolului @, a părții de domeniu și absența spațiilor și a caracterelor chirilice. Android oferă Patterns.EMAIL_ADDRESS, care acoperă majoritatea adreselor de email legitime. Cu toate acestea, dacă este necesară o verificare specifică (de exemplu, doar domenii corporative), trebuie scrisă o expresie regulată personalizată. Emailul se validează după terminarea introducerii, nu după fiecare caracter.

Numărul de telefon este verificat după masca țării sau regiunii. Pentru numere internaționale se utilizează formatul E.164: +codul țării, codul operatorului, numărul. Biblioteca libphonenumber de la Google este standardul industrial pentru validarea telefoanelor. Determină țara după cod, verifică lungimea și formatul numărului. În Android poți folosi PhoneNumberUtils.isGlobalPhoneNumber pentru verificarea de bază.

Parola are mai multe criterii de complexitate: lungime minimă, prezența literelor mari și mici, cifrelor, simbolurilor speciale. În Android nu există o clasă încorporată pentru verificarea parolei — fiecare proiect își stabilește propriile cerințe. De obicei, parola este verificată printr-o expresie regulată sau un set de condiții. Este important să nu dezvălui cerințele exacte în mesajul de eroare: „Parola este prea simplă" este mai bine decât „Este necesară o literă mare și o cifră".

data class ValidationResult(
    val isValid: Boolean,
    val errorMessage: String? = null
)

fun validatePassword(password: String): ValidationResult {
    if (password.length < 6)
        return ValidationResult(false, "Minimum 6 characters")
    if (!password.any { it.isUpperCase() })
        return ValidationResult(false, "Uppercase letter required")
    return ValidationResult(true)
}

În exemplu, validatePassword returnează un ValidationResult cu câmpul isValid și un mesaj de eroare opțional. Această abordare este convenabilă pentru compoziție: mai multe verificări sunt executate secvențial și se returnează prima eroare găsită. Validările de email și telefon se construiesc după același principiu — fiecare returnează un rezultat cu un mesaj sau succes.

Când să efectuezi validarea?

Momentul validării influențează critic UX-ul. Există trei strategii: validarea după fiecare caracter (instant), după pierderea focusului (onFocusLost) și la trimiterea formularului (onSubmit). Fiecare strategie este potrivită pentru diferite scenarii. Validarea instantanee este bună pentru câmpuri cu restricții stricte — număr de telefon, cod PIN. OnFocusLost — pentru email și nume. OnSubmit — pentru câmpuri obligatorii.

Conform Material Design Guidelines, se recomandă combinarea strategiilor: câmpul trebuie verificat la pierderea focusului, precum și la trimiterea formularului. Validarea instantanee este potrivită când restricția este evidentă — de exemplu, lungimea maximă a câmpului. Dacă se afișează eroarea după fiecare caracter pentru email, utilizatorul va vedea mesajul fără să fi terminat introducerea. Acest lucru irită și reduce conversia.

Regula primei erori: la trimiterea formularului, afișează eroarea doar pentru primul câmp invalid. Nu copleși utilizatorul cu o listă de 10 erori. După corectarea primei erori, poți afișa următoarea. Acest ghid pas cu pas reduce încărcarea cognitivă și ajută utilizatorul să completeze formularul mai repede.

Instrumente și biblioteci pentru validare

Android SDK oferă instrumente de bază pentru Validate: Patterns pentru email și telefon, TextUtils pentru verificarea golului, expresii regulate pentru modele arbitrare. Pentru proiecte cu 1-3 câmpuri, acest lucru este suficient. Cu toate acestea, în formularele cu 10+ câmpuri, validarea manuală devine greu de întreținut — fiecare câmp nou necesită o funcție separată și actualizarea logicii de trimitere.

Biblioteci populare de validare: Android Saripaar (adnotări @Email, @NotEmpty, @Password), Commons Validator de la Apache (verificare email, URL, număr card de credit), RxBinding + RxJava pentru validare reactivă. Saripaar permite plasarea adnotărilor direct pe câmpurile de intrare și apelarea validării cu o singură linie: validator.validate(). Biblioteca afișează automat erorile prin setError.

Google recomandă utilizarea Material Design Components cu TextInputLayout. Validarea încorporată prin setError, setHelperText și setCounterEnabled acoperă scenariile de bază fără biblioteci externe. Pentru proiecte complexe (fintech, medicină), este mai bine să folosești o combinație: Material Components + validare personalizată cu modele din stratul de domeniu al Clean Architecture.

Erori la validarea câmpurilor

Prima eroare — afișarea erorii înainte de începerea introducerii. Dacă câmpul este obligatoriu, dar utilizatorul nu a început încă să îl completeze, nu afișa „Câmp obligatoriu". Acest lucru creează o falsă impresie de problemă. Eroarea ar trebui să apară doar după ce utilizatorul a interacționat cu câmpul: a început să introducă, a părăsit câmpul, a încercat să trimită formularul.

A doua eroare — mesaj de eroare neclar. Mesajul trebuie să fie concret și să sugereze cum să rezolvi problema. „Email incorect" — prost. „Emailul trebuie să conțină @ și domeniu, de exemplu user@example.com" — bine. Utilizatorul trebuie să înțeleagă exact ce este în neregulă și cum să repare, fără a consulta documentația.

A treia eroare — blocarea trimiterii fără explicație. Dacă butonul de trimitere este inactiv din cauza erorilor de validare, utilizatorul trebuie să vadă care câmpuri sunt invalide. Un buton gri fără mesaje este o fundătură pentru utilizator. Evidențiază întotdeauna câmpurile cu erori și afișează textul erorii lângă fiecare câmp invalid.