InputType — cos'è, attributi di input e loro configurazione in Android

Cos'è InputType in Android

InputType è una costante intera (Int) che codifica la modalità di input per un campo di testo. In Android, è definita nella classe android.text.InputType. Il valore InputType è composto da due parti: la classe di input (bit 0–4) e i modificatori (bit 5–31). La classe di input definisce il tipo di dato di base — testo, numero, telefono, data. I modificatori specificano il comportamento all'interno della classe selezionata — ad esempio, per la classe testo, è possibile attivare la correzione automatica, le maiuscole o l'input multiline.

Il meccanismo InputType funziona a tre livelli: a livello del framework Android, determina quale InputConnection verrà creato (la connessione tra EditText e IME); a livello IME (tastiera), specifica quali caratteri visualizzare e come gestire l'input; a livello di applicazione, filtra i caratteri attraverso l'InputFilter integrato in EditText. Secondo Android Source Code (AOSP, 2026), la maschera di bit viene gestita nel metodo TextView.getInputType(), che restituisce il valore corrente, e setInputType(), che riconfigura i filtri interni e la connessione IME.

Una caratteristica importante di InputType è che non può essere letto da un altro processo per motivi di sicurezza. Ciò impedisce il furto di dati tramite l'accesso al tipo di input (ad esempio, determinare se un campo è una password). Quando si tenta di leggere InputType da un'altra applicazione, viene restituito TYPE_CLASS_TEXT per impostazione predefinita.

// Costanti InputType di base
InputType.TYPE_CLASS_TEXT       // 0x0001 = 1
InputType.TYPE_CLASS_NUMBER     // 0x0002 = 2
InputType.TYPE_CLASS_PHONE      // 0x0003 = 3
InputType.TYPE_CLASS_DATETIME   // 0x0004 = 4

// Maschera per estrarre la classe
InputType.TYPE_MASK_CLASS       // 0x0000000F

Classi InputType: TEXT, NUMBER, PHONE, DATETIME

Android definisce quattro classi di base InputType. Ogni classe corrisponde a una categoria di dati specifica e attiva il tipo di tastiera corrispondente. La classe è specificata nei bit 0–4 della maschera di bit e può essere estratta tramite la maschera TYPE_MASK_CLASS (0x0F).

TYPE_CLASS_DATETIME è usato raramente direttamente — per l'input di date si utilizzano solitamente DatePicker o DatePickerDialog invece di un campo di testo. Tuttavia, in alcuni scenari (inserimento manuale rapido di una data), questa classe può essere utile. Non ha una tastiera specializzata e di solito mostra una tastiera numerica.

Ogni classe di input può essere combinata con variazioni — sottotipi specificati nei bit 5–7. Ad esempio, TYPE_TEXT_VARIATION_PASSWORD (bit 5) aggiunge input nascosto alla classe TEXT. Bit di variazione: 0x000000E0 (maschera TYPE_MASK_VARIATION).

Flag modificatori di InputType

I flag modificatori di InputType (bit 8–31) aggiungono capacità aggiuntive alla classe base. Non cambiano il tipo di tastiera ma modificano il comportamento di input. I flag sono specifici per ogni classe — i flag TEXT non funzionano con NUMBER e viceversa. Di seguito sono elencati i principali modificatori per ogni classe.

Flag per TEXT

• TYPE_TEXT_FLAG_CAP_CHARACTERS — tutte le lettere maiuscole.
• TYPE_TEXT_FLAG_CAP_WORDS — ogni parola inizia con maiuscola.
• TYPE_TEXT_FLAG_CAP_SENTENCES — maiuscola all'inizio di frase (predefinito).
• TYPE_TEXT_FLAG_AUTO_CORRECT — correzione automatica degli errori di battitura.
• TYPE_TEXT_FLAG_AUTO_COMPLETE — completamento automatico (per AutoCompleteTextView).
• TYPE_TEXT_FLAG_MULTI_LINE — input multiline.
• TYPE_TEXT_FLAG_NO_SUGGESTIONS — disabilita suggerimenti.

Flag per NUMBER

• TYPE_NUMBER_FLAG_SIGNED — consente numeri negativi (segno meno).
• TYPE_NUMBER_FLAG_DECIMAL — consente punto decimale.

Secondo Android Developers Documentation (2026), i flag di classi diverse non si sovrappongono — tentare di usare un flag TEXT con NUMBER verrà ignorato. Per verificare un flag impostato, utilizzare AND bit a bit: (inputType and FLAG) != 0.

Combinazioni InputType: esempi per diversi scenari

La corretta combinazione di classi e flag di InputType è la chiave per creare moduli facili da usare. Esaminiamo scenari tipici e le relative configurazioni InputType. Ogni scenario ottimizza l'input per un tipo di dato specifico, rendendo il modulo intuitivo e accelerando la compilazione.

// Combinazione per campo prezzo
editText.inputType = InputType.TYPE_CLASS_NUMBER or
    InputType.TYPE_NUMBER_FLAG_DECIMAL

// Combinazione per campo commento
editText.inputType = InputType.TYPE_CLASS_TEXT or
    InputType.TYPE_TEXT_FLAG_CAP_SENTENCES or
    InputType.TYPE_TEXT_FLAG_MULTI_LINE

Lavoro programmatico con InputType

Impostare InputType programmaticamente tramite setInputType() sovrascrive il valore precedente. Se è necessario modificare solo una parte della maschera (ad esempio, aggiungere un flag), è necessario salvare il valore corrente, modificarlo e riapplicarlo. Ogni chiamata a setInputType() riconfigura i filtri interni di EditText.

Il metodo setRawInputType() differisce da setInputType in quanto non attiva la riconfigurazione di filtri e suggerimenti. Viene utilizzato per modificare temporaneamente InputType senza ricaricare completamente lo stato di EditText. Dopo aver chiamato setInputType(), si consiglia di riavviare l'IME per aggiornare la tastiera.

Cambio di modalità

// Alterna tra password e testo visibile
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
    }

    // Mantieni posizione cursore
    val cursorPos = editText.selectionStart
    editText.setSelection(cursorPos)
}

Estrazione di classe e variazione

// Ottieni classe di input
fun getInputClass(inputType: Int): Int {
    return inputType and InputType.TYPE_MASK_CLASS
}

// Ottieni variazione di input
fun getInputVariation(inputType: Int): Int {
    return inputType and InputType.TYPE_MASK_VARIATION
}

// Verifica se è campo password
fun isPasswordField(editText: EditText): Boolean {
    return (editText.inputType and
        InputType.TYPE_TEXT_VARIATION_PASSWORD) != 0
}

Best practice per la scelta di InputType

Scegliere il InputType corretto non è solo una questione di UX, ma anche di sicurezza e correttezza dei dati. Le raccomandazioni principali includono: specificare sempre un InputType esplicito per ogni EditText; utilizzare la classe di input più specifica possibile; non combinare flag di classi diverse; utilizzare variazioni PASSWORD per campi con dati sensibili; utilizzare imeOptions="actionSearch" per campi di ricerca.

InputType influisce anche sul funzionamento dei servizi di accessibilità (Accessibility). I campi con tipo textPassword ricevono protezione aggiuntiva dagli screen reader — non leggono ad alta voce i caratteri inseriti. Per i campi textEmailAddress, lo screen reader informa l'utente che il campo è destinato all'email e fornisce suggerimenti appropriati.

• Esplicità — imposta sempre InputType esplicitamente, non affidarti al valore predefinito (textMultiLine).
• Specificità — usa il tipo più specifico: textEmailAddress, non text, per l'email.
• Sicurezza — per password, PIN e dati di carte, utilizza variazioni PASSWORD.
• Riempimento automatico — combina InputType con autofillHints per supportare i gestori di password.
• Test — testa il comportamento su diverse tastiere (Gboard, SwiftKey, Samsung Keyboard).

Secondo Material Design Guidelines (2025), InputType dovrebbe corrispondere al tipo di dati che l'utente sta inserendo. Un InputType errato non solo rallenta l'inserimento, ma può anche causare errori: ad esempio, se si lascia textMultiLine per un campo di numero di telefono, la tastiera non mostrerà il tastierino numerico e l'utente dovrà cambiare manualmente disposizione ogni volta.