InputType — ce este, atributele de introducere și configurarea lor în Android

Ce este InputType în Android

InputType — este o constantă întreagă (Int) care codifică modul de introducere pentru un câmp de text. În Android, este definită în clasa android.text.InputType. Valoarea InputType constă din două părți: clasa de intrare (biții 0–4) și modificatorii (biții 5–31). Clasa de intrare determină tipul de bază al datelor — text, număr, telefon, dată. Modificatorii specifică comportamentul în cadrul clasei selectate — de exemplu, pentru clasa de text se poate activa autocorectarea, literele mari sau introducerea multilinie.

Mecanismul InputType funcționează la trei niveluri: la nivelul framework-ului Android determină care InputConnection va fi creat (conexiunea între EditText și IME); la nivelul IME (tastatură) indică ce caractere să afișeze și cum să proceseze introducerea; la nivelul aplicației filtrează caracterele prin InputFilter încorporat în EditText. Conform Android Source Code (AOSP, 2026), masca binară este procesată în metoda TextView.getInputType(), care returnează valoarea curentă, și setInputType(), care reconfigură filtrele interne și conexiunea cu IME.

O caracteristică importantă a InputType — nu poate fi citit din alt proces din motive de securitate. Acest lucru previne furtul de date prin accesarea tipului de intrare (de exemplu, determinarea dacă un câmp este parolă). La încercarea de a citi InputType din altă aplicație, se returnează TYPE_CLASS_TEXT în mod implicit.

// Constantele de bază InputType
InputType.TYPE_CLASS_TEXT       // 0x0001 = 1
InputType.TYPE_CLASS_NUMBER     // 0x0002 = 2
InputType.TYPE_CLASS_PHONE      // 0x0003 = 3
InputType.TYPE_CLASS_DATETIME   // 0x0004 = 4

// Masca pentru extragerea clasei
InputType.TYPE_MASK_CLASS       // 0x0000000F

Clasele InputType: TEXT, NUMBER, PHONE, DATETIME

În Android sunt definite patru clase de bază InputType. Fiecare clasă corespunde unei categorii specifice de date și activează tipul corespunzător de tastatură. Clasa este indicată în biții 0–4 ai măștii binare și poate fi extrasă prin masca TYPE_MASK_CLASS (0x0F).

TYPE_CLASS_DATETIME este rar folosit direct — de obicei pentru introducerea datei se utilizează DatePicker sau DatePickerDialog, nu un câmp de text. Cu toate acestea, în unele scenarii (introducerea rapidă manuală a datei) această clasă poate fi utilă. Nu are tastatură specializată și afișează de obicei tastatura numerică.

Fiecare clasă de intrare poate fi combinată cu variații (variation) — subtipuri indicate în biții 5–7. De exemplu, TYPE_TEXT_VARIATION_PASSWORD (bitul 5) adaugă clasei TEXT introducerea ascunsă. Biții de variație: 0x000000E0 (masca TYPE_MASK_VARIATION).

Flagurile-modificatoare InputType

Flagurile-modificatoare InputType (biții 8–31) adaugă capacități suplimentare clasei de bază. Ele nu schimbă tipul tastaturii, dar modifică comportamentul de introducere. Flagurile sunt specifice fiecărei clase — flagurile pentru TEXT nu funcționează cu NUMBER și invers. Mai jos sunt enumerați modificatorii principali pentru fiecare clasă.

Flaguri pentru TEXT

• TYPE_TEXT_FLAG_CAP_CHARACTERS — toate literele mari.
• TYPE_TEXT_FLAG_CAP_WORDS — fiecare cuvânt cu literă mare.
• TYPE_TEXT_FLAG_CAP_SENTENCES — literă mare la începutul propoziției (implicit).
• TYPE_TEXT_FLAG_AUTO_CORRECT — corectarea automată a greșelilor.
• TYPE_TEXT_FLAG_AUTO_COMPLETE — autocompletare (pentru AutoCompleteTextView).
• TYPE_TEXT_FLAG_MULTI_LINE — introducere multilinie.
• TYPE_TEXT_FLAG_NO_SUGGESTIONS — dezactivarea sugestiilor.

Flaguri pentru NUMBER

• TYPE_NUMBER_FLAG_SIGNED — permite numere negative (semnul minus).
• TYPE_NUMBER_FLAG_DECIMAL — permite punctul zecimal.

Conform Android Developers Documentation (2026), flagurile pentru diferite clase nu se suprapun — încercarea de a folosi un flag TEXT cu NUMBER va fi ignorată. Pentru verificarea unui flag setat se utilizează ȘI binar: (inputType and FLAG) != 0.

Combinații InputType: exemple pentru diferite scenarii

Combinația corectă a InputType cu clase și flaguri este cheia creării de formulare confortabile. Să examinăm scenariile tipice și configurațiile InputType corespunzătoare. Fiecare scenariu optimizează introducerea pentru un tip specific de date, făcând formularul intuitiv și accelerând completarea.

// Combinația pentru câmpul preț
editText.inputType = InputType.TYPE_CLASS_NUMBER or
    InputType.TYPE_NUMBER_FLAG_DECIMAL

// Combinația pentru câmpul comentariu
editText.inputType = InputType.TYPE_CLASS_TEXT or
    InputType.TYPE_TEXT_FLAG_CAP_SENTENCES or
    InputType.TYPE_TEXT_FLAG_MULTI_LINE

Lucrul programatic cu InputType

Setarea InputType programatic prin setInputType() suprascrie valoarea anterioară. Dacă trebuie schimbată doar o parte a măștii (de exemplu, adăugarea unui flag), trebuie salvată valoarea curentă, modificată și aplicată din nou. Fiecare apel setInputType() reconfigură filtrele interne ale EditText.

Metoda setRawInputType() se deosebește de setInputType prin faptul că nu provoacă reconfigurarea filtrelor și sugestiilor. Este folosită pentru modificarea temporară a InputType fără reîncărcarea completă a stării EditText. După apelarea setInputType(), se recomandă repornirea IME pentru ca tastatura să se actualizeze.

Comutarea modurilor

// Comutarea între parolă și text vizibil
fun togglePasswordVisibility(editText: EditText) {
    val currentType = editText.inputType
    val isPassword = (currentType and
        InputType.TYPE_TEXT_VARIATION_PASSWORD) != 0

    editText.inputType = if (isPassword) {
        InputType.TYPE_CLASS_TEXT or
            InputType.TYPE_TEXT_VARIATION_VISIBLE_PASSWORD
    } else {
        InputType.TYPE_CLASS_TEXT or
            InputType.TYPE_TEXT_VARIATION_PASSWORD
    }

    // Păstrează poziția cursorului
    val cursorPos = editText.selectionStart
    editText.setSelection(cursorPos)
}

Extragerea clasei și variației

// Obține clasa de intrare
fun getInputClass(inputType: Int): Int {
    return inputType and InputType.TYPE_MASK_CLASS
}

// Obține variația de intrare
fun getInputVariation(inputType: Int): Int {
    return inputType and InputType.TYPE_MASK_VARIATION
}

// Verifică dacă este câmp de parolă
fun isPasswordField(editText: EditText): Boolean {
    return (editText.inputType and
        InputType.TYPE_TEXT_VARIATION_PASSWORD) != 0
}

Cele mai bune practici de alegere a InputType

Alegerea corectă a InputType nu este doar despre UX, ci și despre securitate și corectitudinea datelor. Recomandările principale includ: specificați întotdeauna InputType explicit pentru fiecare EditText; utilizați cea mai specifică clasă de intrare; nu combinați flaguri din clase diferite; pentru câmpurile cu date sensibile utilizați variațiile PASSWORD; pentru câmpurile de căutare utilizați imeOptions=„actionSearch”.

InputType influențează și funcționarea serviciilor de accesibilitate (Accessibility). Câmpurile cu tipul textPassword beneficiază de protecție suplimentară față de cititoarele de ecran — acestea nu citesc cu voce tare caracterele introduse. Pentru câmpurile cu textEmailAddress, Screen Reader îl informează pe utilizator că câmpul este destinat emailului și oferă sugestii corespunzătoare.

• Explicitarea — setează întotdeauna InputType explicit, nu te baza pe valoarea implicită (textMultiLine).
• Specificitatea — folosește cel mai specific tip: textEmailAddress, nu text pentru email.
• Securitatea — pentru parole, PIN și date ale cardurilor utilizează variațiile PASSWORD.
• Autocompletarea — combină InputType cu autofillHints pentru suportarea managerilor de parole.
• Testarea — verifică comportamentul pe diferite tastaturi (Gboard, SwiftKey, Samsung Keyboard).

Conform Material Design Guidelines (2025), InputType trebuie să corespundă tipului de date pe care utilizatorul le introduce. Un InputType incorect nu doar încetinește introducerea, dar poate duce și la erori: de exemplu, dacă pentru introducerea numărului de telefon se lasă textMultiLine, tastatura nu va afișa blocul numeric, iar utilizatorul va fi nevoit să schimbe manual aspectul de fiecare dată.