Skip to content

TextInput

El TextInput funciona como un campo tradicional de entrada de texto. Permite que el usuario ingrese un dato libre (un nombre, un correo, un alias, una contraseña) y lo acompaña con todo lo que necesita para completarlo bien: un label que nunca desaparece, un texto de ayuda, un límite visible y mensajes de error claros.


Hacé clic en un campo para ver la animación del label y escribí para ver cómo responde el contador.


El TextInput es la pieza base de cualquier formulario. Su función es capturar un dato escrito por el usuario manteniendo siempre visible el contexto: qué se está pidiendo, si es obligatorio, cuántos caracteres admite y qué salió mal si hay un error. El label flotante permite ahorrar espacio vertical sin perder legibilidad, porque el nombre del campo sigue a la vista incluso cuando ya tiene contenido.


  • Item
  • Item
  1. Label: Nombre del campo. Es obligatorio y tiene una animación flotante que depende del estado (ver más abajo).
  2. Opcional (booleano): Agrega el texto “(opcional)” junto al label. Por defecto el campo es requerido; el UX lo activa solo cuando el dato no es necesario para avanzar.
  3. Texto interno: El dato que ingresa el usuario.
  4. ActionIcon (booleano): Ícono accionable a la derecha del campo. Se usa para acciones propias del dato, como limpiar el contenido o mostrar y ocultar una contraseña.
  5. Stroke: El borde de la caja. Cambia de color y grosor según el estado (default, hover, focus, error, disabled).
  6. Icon (booleano): Ícono decorativo a la izquierda que refuerza el tipo de dato (persona, correo, búsqueda). No es interactivo.
  7. HelperText ó ErrorMessage (booleano): Texto de ayuda debajo del campo. Cuando el campo entra en error, el HelperText se reemplaza por el ErrorMessage en rojo con ícono de alerta.
  8. Contador de caracteres (booleano): Muestra los caracteres ingresados sobre el límite permitido (por ejemplo, 0/24). Se ubica a la derecha, en la misma línea del HelperText.
  9. Placeholder (booleano): Ejemplo del dato esperado. Solo aparece cuando el campo tiene el foco, porque en reposo ese espacio lo ocupa el label.
  10. Pill: Cada valor cargado en la variante múltiple. Se puede quitar individualmente con su propio ícono de cierre.

  • Mobile: el campo ocupa el 100% del ancho del viewport (respetando los márgenes de la pantalla).
  • Desktop: el campo no debe ocupar más de 6 columnas de la grilla. Usá el token “6col” como ancho máximo.
  • El componente se construye con el campo de entrada nativo del navegador, de modo que funciona con autocompletado, teclados móviles específicos (numérico, correo, teléfono) y tecnologías de asistencia.
  • El label está asociado al campo: hacer clic en el label enfoca el input y el lector de pantalla lo anuncia como su nombre.

Por defecto el componente es requerido, salvo que el UX active el booleano “opcional”. En ese caso se muestra “(opcional)” junto al label para indicarle al usuario que puede dejar el campo vacío.

El label se comporta con una animación flotante:

  • En estado default, el label está centrado verticalmente dentro del campo y funciona como una invitación a completarlo.
  • Al entrar en focus o cuando el campo tiene contenido, el label:
    • Se desplaza hacia arriba.
    • Reduce su tamaño.
    • Se posiciona sobre el borde superior, alineado con el campo.

Este comportamiento mejora la legibilidad y mantiene el contexto del campo en todo momento: el usuario nunca pierde de vista qué dato está completando.

El UX define si el campo tiene un límite o no. Cuando se activa:

  • El campo muestra un contador visible de caracteres (por ejemplo, 0/24) que se actualiza mientras el usuario escribe.
  • Si el campo tiene un límite, el contador siempre debe estar visible, en todos los estados. No se activa solo cuando el campo entra en error.
  • En la variante múltiple, el límite cuenta Pills en lugar de caracteres.
  • Cuando el usuario supera el límite, el campo entra en estado de error y se informa que se excedió la cantidad permitida.
  • Aun así, el usuario puede seguir escribiendo (o agregando Pills): no cortamos su texto. Lo que no puede es avanzar hasta volver a cumplir con el límite.

  • Default: Estado inicial, sin datos ingresados. El label está centrado dentro del campo y el stroke es gris.
  • Hover: Al pasar el cursor, el stroke se oscurece levemente para confirmar que el campo es interactivo.
  • Focus: El usuario acciona dentro del campo para empezar a completarlo. El label flota hacia el borde superior, el stroke toma el color primario y se vuelve más grueso, y aparece el placeholder.
  • Typing: El usuario está escribiendo. Se mantiene la apariencia de focus con el texto interno y el cursor visibles; el contador se actualiza en tiempo real.
  • Filled: El usuario ya escribió y salió del campo. El label queda flotando sobre el borde y el stroke vuelve a gris.
  • Disabled Filled: El campo tiene datos cargados pero no se puede editar. Fondo gris claro y textos atenuados: el dato se puede leer, no modificar.
  • Disabled Default: El campo está vacío y deshabilitado. Se usa cuando depende de completar otro paso antes.
  • Error campo vacío: El usuario no completó un campo obligatorio. Se muestra “Este campo es obligatorio.” en lugar del HelperText.
  • Error dato erróneo: El usuario ingresó un dato incorrecto (formato inválido, valor inexistente). El mensaje explica qué está mal y cómo corregirlo.

  • Todo el componente es accionable: un clic en cualquier parte de la caja enfoca el campo.
  • Tab entra al campo.
  • El usuario puede escribir directamente o presionar Enter para enviar si el campo está dentro de un formulario.
  • El siguiente Tab salta al próximo componente interactivo del formulario.
  • Tienen interacción la caja con texto y el ActionIcon.
  • Tab entra al primer foco disponible (normalmente el campo).
  • Segundo Tab salta al segundo foco, por ejemplo el botón de limpiar o el de mostrar contraseña.
  • Luego, Tab sigue el flujo normal del documento.

  • Para pedir datos cortos de texto libre: nombre, apellido, alias, correo, teléfono, número de documento, CBU.
  • Cuando el dato no se puede anticipar con una lista cerrada de opciones.
  • Para contraseñas y claves, sumando el ActionIcon de mostrar u ocultar.
  • Con la variante múltiple, para cargar varios valores del mismo tipo en un solo campo (por ejemplo, correos de destinatarios o etiquetas).
  • Textos largos o de varias líneas (comentarios, motivos, descripciones extensas): usá un Textarea.
  • Opciones conocidas y acotadas: usá un Select, Radio o Checkbox. Pedirle al usuario que escriba algo que podría elegir aumenta los errores.
  • Fechas: usá el Calendar o un selector de fecha para evitar formatos ambiguos.
  • Importes de dinero: usá el AmountFormatter, que resuelve el formato de moneda y los separadores.
  • Códigos de verificación de pocos dígitos (OTP, token): usá un campo de código segmentado, que comunica mejor la cantidad de caracteres esperados.
  • Label: corto y concreto, en sustantivo (“Correo electrónico”, no “Ingresá tu correo electrónico”).
  • HelperText: explica el formato o el para qué del dato (“Lo vas a usar para iniciar sesión”).
  • ErrorMessage: dice qué pasó y cómo resolverlo (“Ingresá un correo válido, por ejemplo nombre@correo.com”). Evitá mensajes genéricos como “Error” o “Dato inválido”.

  • Default: es el tamaño que se usa por defecto en ambos devices (mobile y desktop). Tiene una altura de 48 px, cómoda para el uso táctil.

Cuando está activa, el componente permite cargar varios valores como Pills dentro del mismo campo.

  • ana@correo.com
  • juan@correo.com
  • lucia@correo.com
  • Label
  • Label
  • Label
  • Label
  • Label
  • Label
  • Label
  • Label
  • Label
  • Label
  • El usuario escribe un valor y lo confirma con Enter o coma: el valor se convierte en una Pill.
  • Cada Pill tiene su propio ícono de cierre para quitarla. Con el campo vacío, Backspace quita la última Pill.
  • Las Pills se acomodan en varias filas y la caja crece en altura para mostrarlas todas.
  • El contador y el límite cuentan Pills, no caracteres.
  • El label se mantiene flotando sobre el borde mientras haya al menos una Pill.

El Icon decorativo y el ActionIcon son booleanos que se encienden según el tipo de dato.

  • Icon: usalo solo cuando ayude a reconocer el tipo de dato de un vistazo. Si todos los campos del formulario llevan íconos distintos sin un motivo claro, generan ruido visual.
  • ActionIcon de limpiar: aparece solo cuando el campo tiene contenido. Ideal para búsquedas o datos que se reemplazan completos.
  • ActionIcon de contraseña: alterna entre mostrar y ocultar los caracteres. El ícono cambia para reflejar el estado actual.

  • Se respeta lo documentado en Interacciones.
  • El foco siempre es visible: el stroke primario más grueso indica qué campo está activo.
  • En la variante múltiple, cada Pill tiene un botón de cierre alcanzable con Tab.
  • El campo obligatorio se anuncia como requerido.
  • En estado de error, el campo se anuncia como inválido y el mensaje de error se lee automáticamente.
  • El HelperText y el contador están vinculados al campo, por lo que se leen junto con él sin que la persona tenga que buscarlos.
  • El Icon es decorativo: se oculta al lector de pantalla para no agregar ruido.
  • El ActionIcon siempre tiene un nombre accesible que da contexto de su acción (“Mostrar contraseña”, “Borrar Buscar”).
  • Cada Pill se anuncia con su botón de cierre (“Quitar ana@correo.com”).

Consultá el historial de cambios de todos los componentes de este Design System en la Sheet de ChangeLog.