Uso
Cuándo usar
- Para datos concisos que no requieran más de una línea, como el nombre de una persona, el correo electrónico o número de teléfono utilizá el campo de texto.
- Cuando se espera una respuesta larga, como una consulta, comentario o descripción, utilizá el campo de área de texto.
- Puede utilizarse para mostrar datos precargados que puedan requerir edición por parte de la persona usuaria.
Cuándo no usar
- Cuando haya opciones conocidas y definidas de antemano, por ejemplo: provincias, países, tipo de documento, utilizá el componente
selector
. - Cuando la persona usuaria necesite seleccionar más de una opción, utilizá el componente casilla de verificación.
- Cuando la persona usuaria necesite seleccionar una única opción visible, utilizá el componente botón de radio.
Campo de texto
Se utiliza para ingresar datos breves, de una sola línea, como nombres, dirección de correo electrónico o números de teléfonos.
Tipos de campos de texto
El componente campo de texto admite diferentes formatos para adaptarse a distintas necesidades del formulario. Su apariencia, validación y comportamiento pueden variar según el valor type configurado.
Podés acceder a la ficha de patrones de formulario para consultar el diseño sugerido para cada tipo de campo.
Tipo | Comportamiento | Consideraciones |
---|---|---|
Texto | Campo por defecto. Permite cualquier texto corto en una sola línea. | Usar cuando no hay validaciones específicas. Es necesario definir el propósito con un label. |
Contraseña | Oculta el valor ingresado y permite mostrar/ocultar contenido con un ícono. | Requiere accesibilidad del botón de "ver contraseña" (aria-label). |
Correo | Valida el formato de dirección de correo. En dispositivos mobile muestra teclado con el símbolo "@". | Evitar el uso de autocorrector. Informar a la persona usuaria si el formato ingresado no es válido. |
Número | Acepta sólo números. Muestra teclado numérico en mobile. | No siempre es ideal para datos como DNI o códigos postales ya que puede impedir caracteres no numéricos, como espacios. |
Teléfono | Permite ingresar números de teléfono. Muestra el teclado numérico en mobile. | A diferencia del tipo Número, acepta caracteres como +, -, y espacios. Considerar un placeholder para indicar el formato esperado. |
Fecha | Muestra un selector de fecha nativo (calendario). | El diseño del selector nativo puede variar entre navegadores. Considerar un placeholder para indicar el formato esperado. |
Hora | Muestra selector nativo de hora. | Funciona bien cuando el dato es específico, por ejemplo en turnos. Informar si el formato es 12h o 24h. |
Prefijos y sufijos
Son útiles cuando existe un símbolo o abreviatura que ayuden a entender mejor qué tipo de información se espera. Recomendamos no utilizar únicamente prefijos o sufijos, ya que los lectores de pantalla no los leerán.
Ejemplos de uso de prefijos
Evitar el uso de prefijos como único indicador del dato que se espera ingresar.
Utilizar el texto de prefijo para reforzar el tipo de dato que se espera, como los símbolos de una moneda.
Ejemplos de uso de sufijos
Evitar el uso de sufijos como único indicador del dato que se espera ingresar.
Utilizar el texto de prefijo para reforzar el tipo de dato que se espera, como los símbolos de una moneda.
Iconos accionables y decorativos
Se pueden incluir iconos dentro de los campos de texto para complementar visualmente su propósito o brindar acciones adicionales.
- Iconos decorativos. Se ubican al comienzo del campo, y ayudan a reforzar el contexto del dato que se espera, por ejemplo, un icono de ubicación en un campo de dirección.
- Iconos accionables. Se ubican generalmente al final del campo, y permiten ejecutar una acción relacionada, como copiar contenido, activar dictado por voz, o mostrar/ocultar contraseña.
Ejemplos de uso
Mensaje de error
Si los datos ingresados son inválidos, aparecerá un mensaje de error debajo del campo de texto describiendo lo que está mal. Los errores más comunes incluyen:
- Formato incorrecto de datos. El contenido no coincide con el formato esperado, por ejemplo, una dirección de correo sin "@".
- Caracteres no permitidos. Se ingresaron símbolos o letras que no están habilitados para ese campo, por ejemplo, letras en un campo numérico.
- Dejar un campo obligatorio incompleto. Falta completar un dato obligatorio que el formulario necesita para avanzar.
Ejemplos de uso
Evitá términos técnicos o específicos del sistema que puedan confundir.
Utilizá descripciones simples, directas y orientadas a la solución.
Área de texto
Se utiliza para permitir que las personas usuarias ingresen una cantidad de texto que sea más extensa de una sola línea. Se suele usar para comentarios o preguntas en formularios.
Contador de caracteres
Es un indicador que informa a las personas usuarias cuánto texto pueden ingresar cuando hay un límite en la cantidad de caracteres. Recomendamos utilizar este indicador sólo cuando exista una buena razón para limitar los caracteres, por ejemplo:
- Para mantener la información clara y fácil de leer en procesos como solicitudes o formularios breves.
- Restricciones técnicas o legales. Cuando el sistema tiene un límite específico, por ejemplo, en un campo de nombre o código.
- Dejar un campo obligatorio incompleto. Falta completar un dato obligatorio que el formulario necesita para avanzar.
Indicador de requerido y opcional
Indica si un campo es obligatorio u opcional, ayudando a las personas a completar el formulario con claridad. Podés consultar la ficha de patrones de formulario para conocer los lineamientos de uso del indicador.
Ancho mínimo y máximo
El ancho de cada campo debe ser proporcional a la longitud del contenido esperado.Podés conocer más sobre la disposición de los campos en la ficha de patrones de formulario.
- El ancho mínimo del campo de texto es de 160px.
- El ancho máximo del campo de texto es de 356px.
- En dispositivos mobile el campo ocupa todo el ancho disponible.
Contenidos
Etiquetas (label)
Cada campo de texto debe tener una etiqueta para identificar y describir su propósito. El texto de la etiqueta debe estar alineado a la izquierda. Recomendamos escribir el texto de la etiqueta en mayúsculas y minúsculas, siendo lo más conciso posible, y no utilizar dos puntos después de los nombres de las etiquetas.
Texto descriptivo
Es un texto que guía al usuario para ingresar datos en el formato apropiado, brindando una explicación del campo y ayudando a prevenir errores. El texto descriptivo aparece debajo del campo de texto, es opcional, pero recomendado, y no debe contener más de 3 líneas de texto.
Texto del marcador de posición (placeholder)
El texto de marcador de posición (placeholder) es opcional y proporciona sugerencias o ejemplos de lo que se debe ingresar. El placeholder desaparece una vez que la persona usuaria comienza a ingresar datos, por lo tanto, no debe sustituir a la etiqueta (label) ni contener información crucial. Además, sugerimos que se relacione con el texto descriptivo ya que los lectores de pantalla no lo leen y puede ser difícil para las personas recordar la información proporcionada.