Interfaces de usuario de calidad: componentes, estado, accesibilidad y estados vacíos cuidados

Cómo construir una interfaz que no parezca generada: arquitectura de componentes, gestión del estado, coherencia con el sistema de diseño, accesibilidad, adaptabilidad, estados de carga y de error.

Metodologíametodologiafrontendaccessibilitàingegneria del software19 de noviembre de 2026 · 3 min de lectura

Una interfaz «generada» se reconoce de lejos: espaciados incoherentes, colores elegidos al azar, un botón al que no se llega con el teclado, una lista vacía que muestra una página en blanco. Construir una interfaz de calidad no lleva más tiempo, exige decidir de antemano unas pocas reglas y respetarlas.

Arquitectura de componentes

Cada componente tiene una responsabilidad. Los archivos que cambian juntos están juntos (el componente, su estilo, sus pruebas). Componentes pequeños y combinables vencen a los gigantescos con decenas de opciones. Se separa lo que muestra (presentación) de lo que decide y recupera datos (lógica).

Gestión del estado

El estado va donde hace falta, no más arriba. Primero el estado local del componente; si lo necesitan dos, el padre común; solo para lo que necesita media aplicación, un estado compartido. Un estado global para todo convierte cada cambio en un riesgo.

Coherencia con el sistema de diseño

Si existe un sistema de diseño, se usa: componentes, espaciados, tipografía, colores. Si no existe, se definen pocos valores y se reutilizan. Aquí se ven los signos de la interfaz «generada»: márgenes distintos en cada bloque, tres tonos de gris casi iguales, efectos decorativos sin motivo. Espaciados sobre una escala fija; tipografía con pocos niveles y una jerarquía clara; color con un significado (acción, error, estado) y contraste suficiente.

Accesibilidad

La referencia es el nivel AA de las pautas WCAG 2.1. En la práctica:

  • Teclado. Todo lo que se puede hacer con el ratón se hace con el teclado, con un orden de tabulación sensato y un foco visible.
  • Etiquetas. Cada elemento interactivo tiene un nombre comprensible también para un lector de pantalla (etiquetas y atributos ARIA donde el HTML no basta).
  • Gestión del foco. Cuando se abre un cuadro de diálogo el foco entra; cuando se cierra, vuelve al punto de partida.
  • Estados vacíos y de error con significado. Una lista vacía explica por qué lo está y qué hacer; un error dice qué ha ido mal y cómo remediarlo, no solo «error».

Adaptabilidad

Se parte del formato más pequeño y se amplía. Se prueba en varios anchos reales, no solo cambiando el tamaño de la ventana. Las zonas táctiles son lo bastante grandes; el contenido no se sale de la pantalla.

Cargas y transiciones

Toda operación que tarda tiene un estado visible (carga, progreso) y uno de fallo. Las transiciones ayudan a entender qué ha cambiado; no decoran.

Las excusas más comunes

ExcusaRealidad
«La accesibilidad la hacemos después»Rehacer la estructura después cuesta mucho más que hacerla bien.
«Funciona en mi pantalla»En un teléfono, o con el teclado, quizá no.
«El estado vacío lo ven pocos»Lo ve cualquiera en el primer acceso.

Un ejemplo

Una tabla de pedidos: sin datos muestra una tabla vacía con solo las cabeceras. Con cuidado: «Todavía no hay pedidos. Cuando un cliente haga uno, lo verás aquí» y un botón para crear un pedido de prueba. Cargando, filas esqueleto; en error, «No puedo cargar los pedidos. Inténtalo de nuevo» con el botón. Todo con el teclado y un nombre legible para cada control.

Cuándo usarlo

Al construir o modificar interfaces orientadas a los usuarios, componentes, diseños o gestión del estado, y cuando el resultado debe tener la calidad de un producto, no la de un prototipo.

Este método deriva de la familia de skills de código abierto agent-skills de Addy Osmani (licencia MIT), reescrita y adaptada.

Este artículo es una skill de OIAR

Lo que acabas de leer es el contenido de una skill del catálogo de OIAR, escrito para las personas. Un conocimiento como este pero más rico y profundo, escrito para los agentes, guía las entrevistas, el análisis y el informe dentro de la plataforma. Las skills se usan en OIAR: para probarla en un proyecto tuyo necesitas una cuenta.

frontend-ui-engineeringMétodo para construir interfaces de usuario de calidad: componentes pequeños, estado donde hace falta, coherencia con el sistema de diseño, accesibilidad AA, adaptabilidad, estados de carga, vacío y error. Úsese al crear o modificar una interfaz, un componente o un diseño.