InputType — qué es, atributos de entrada y su configuración en Android

¿Qué es InputType en Android?

InputType es una constante entera (Int) que codifica el modo de entrada para un campo de texto. En Android, está definida en la clase android.text.InputType. El valor InputType consta de dos partes: la clase de entrada (bits 0–4) y los modificadores (bits 5–31). La clase de entrada define el tipo de dato básico — texto, número, teléfono, fecha. Los modificadores refinan el comportamiento dentro de la clase seleccionada — por ejemplo, para la clase de texto, se puede habilitar la autocorrección, las mayúsculas o la entrada multilínea.

El mecanismo InputType funciona en tres niveles: a nivel del framework de Android, determina qué InputConnection se creará (la conexión entre EditText e IME); a nivel del IME (teclado), especifica qué caracteres mostrar y cómo manejar la entrada; a nivel de la aplicación, filtra los caracteres a través del InputFilter integrado en EditText. Según Android Source Code (AOSP, 2026), la máscara de bits se maneja en el método TextView.getInputType(), que devuelve el valor actual, y setInputType(), que reconfigura los filtros internos y la conexión con el IME.

Una característica importante de InputType es que no se puede leer desde otro proceso por razones de seguridad. Esto evita el robo de datos mediante el acceso al tipo de entrada (por ejemplo, determinar si un campo es una contraseña). Al intentar leer InputType desde otra aplicación, se devuelve TYPE_CLASS_TEXT de forma predeterminada.

// Constantes básicas de 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

// Máscara para extraer la clase
InputType.TYPE_MASK_CLASS       // 0x0000000F

Clases de InputType: TEXT, NUMBER, PHONE, DATETIME

Android define cuatro clases básicas de InputType. Cada clase corresponde a una categoría específica de datos y activa el tipo de teclado correspondiente. La clase se especifica en los bits 0–4 de la máscara y se puede extraer mediante la máscara TYPE_MASK_CLASS (0x0F).

TYPE_CLASS_DATETIME se usa raramente directamente — normalmente para la entrada de fechas se utiliza DatePicker o DatePickerDialog en lugar de un campo de texto. Sin embargo, en algunos escenarios (entrada manual rápida de fecha), esta clase puede ser útil. No tiene un teclado especializado y normalmente muestra un teclado numérico.

Cada clase de entrada se puede combinar con variaciones — subtipos especificados en los bits 5–7. Por ejemplo, TYPE_TEXT_VARIATION_PASSWORD (bit 5) añade entrada oculta a la clase TEXT. Bits de variación: 0x000000E0 (máscara TYPE_MASK_VARIATION).

Banderas modificadoras de InputType

Las banderas modificadoras de InputType (bits 8–31) añaden capacidades adicionales a la clase base. No cambian el tipo de teclado, pero modifican el comportamiento de entrada. Las banderas son específicas de cada clase — las banderas de TEXT no funcionan con NUMBER, y viceversa. A continuación se muestran los principales modificadores para cada clase.

Banderas para TEXT

• TYPE_TEXT_FLAG_CAP_CHARACTERS — todas las letras en mayúscula.
• TYPE_TEXT_FLAG_CAP_WORDS — cada palabra con mayúscula inicial.
• TYPE_TEXT_FLAG_CAP_SENTENCES — mayúscula al inicio de una oración (predeterminado).
• TYPE_TEXT_FLAG_AUTO_CORRECT — corrección automática de errores tipográficos.
• TYPE_TEXT_FLAG_AUTO_COMPLETE — autocompletado (para AutoCompleteTextView).
• TYPE_TEXT_FLAG_MULTI_LINE — entrada multilínea.
• TYPE_TEXT_FLAG_NO_SUGGESTIONS — deshabilitar sugerencias.

Banderas para NUMBER

• TYPE_NUMBER_FLAG_SIGNED — permite números negativos (signo menos).
• TYPE_NUMBER_FLAG_DECIMAL — permite punto decimal.

Según Android Developers Documentation (2026), las banderas de diferentes clases no se superponen — intentar usar una bandera de TEXT con NUMBER será ignorado. Para verificar una bandera establecida, use AND bit a bit: (inputType and FLAG) != 0.

Combinaciones de InputType: ejemplos para diferentes escenarios

La combinación correcta de clases y banderas de InputType es la clave para crear formularios fáciles de usar. Veamos escenarios típicos y sus configuraciones de InputType correspondientes. Cada escenario optimiza la entrada para un tipo de dato específico, haciendo que el formulario sea intuitivo y acelerando su cumplimentación.

// Combinación para campo de precio
editText.inputType = InputType.TYPE_CLASS_NUMBER or
    InputType.TYPE_NUMBER_FLAG_DECIMAL

// Combinación para campo de comentario
editText.inputType = InputType.TYPE_CLASS_TEXT or
    InputType.TYPE_TEXT_FLAG_CAP_SENTENCES or
    InputType.TYPE_TEXT_FLAG_MULTI_LINE

Trabajo programático con InputType

Establecer InputType programáticamente mediante setInputType() sobrescribe el valor anterior. Si necesita cambiar solo una parte de la máscara (por ejemplo, agregar una bandera), debe guardar el valor actual, modificarlo y aplicarlo de nuevo. Cada llamada a setInputType() reconfigura los filtros internos de EditText.

El método setRawInputType() se diferencia de setInputType en que no provoca la reconfiguración de filtros y sugerencias. Se utiliza para cambiar temporalmente InputType sin una recarga completa del estado de EditText. Después de llamar a setInputType(), se recomienda reiniciar el IME para actualizar el teclado.

Cambio de modos

// Alternar entre contraseña y texto visible
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
    }

    // Mantener posición del cursor
    val cursorPos = editText.selectionStart
    editText.setSelection(cursorPos)
}

Extracción de clase y variación

// Obtener clase de entrada
fun getInputClass(inputType: Int): Int {
    return inputType and InputType.TYPE_MASK_CLASS
}

// Obtener variación de entrada
fun getInputVariation(inputType: Int): Int {
    return inputType and InputType.TYPE_MASK_VARIATION
}

// Verificar si es campo de contraseña
fun isPasswordField(editText: EditText): Boolean {
    return (editText.inputType and
        InputType.TYPE_TEXT_VARIATION_PASSWORD) != 0
}

Mejores prácticas para elegir InputType

Elegir el InputType correcto no es solo una cuestión de UX, sino también de seguridad y corrección de datos. Las recomendaciones clave incluyen: especificar siempre un InputType explícito para cada EditText; usar la clase de entrada más específica posible; no combinar banderas de diferentes clases; usar variaciones PASSWORD para campos de datos sensibles; usar imeOptions="actionSearch" para campos de búsqueda.

InputType también afecta el funcionamiento de los servicios de accesibilidad (Accessibility). Los campos con el tipo textPassword reciben protección adicional de los lectores de pantalla — no leen en voz alta los caracteres introducidos. Para los campos textEmailAddress, el lector de pantalla informa al usuario de que el campo está destinado al correo electrónico y proporciona sugerencias adecuadas.

• Explicititud — establece siempre InputType explícitamente, no confíes en el valor predeterminado (textMultiLine).
• Especificidad — usa el tipo más específico: textEmailAddress, no text, para el correo electrónico.
• Seguridad — para contraseñas, PIN y datos de tarjetas, usa variaciones PASSWORD.
• Autocompletado — combina InputType con autofillHints para admitir gestores de contraseñas.
• Pruebas — prueba el comportamiento en diferentes teclados (Gboard, SwiftKey, Samsung Keyboard).

Según Material Design Guidelines (2025), InputType debe coincidir con el tipo de datos que el usuario está introduciendo. Un InputType incorrecto no solo ralentiza la entrada, sino que también puede provocar errores: por ejemplo, si se deja textMultiLine para un campo de número de teléfono, el teclado no mostrará el teclado numérico y el usuario tendrá que cambiar de diseño manualmente cada vez.