¿Qué hace frontend?
Estándares para interfaces de navegador que usan personas reales con teclados, lectores de pantalla, teléfonos lentos e impresoras. Las reglas a continuación son las que se pasan por alto cuando la interfaz "se ve terminada".
Reglas que más importan
- Usa el elemento que significa lo que hace.
<button>para acciones,<a href>para navegación,<label>para cada campo,<table>para datos tabulares. Un<div>con un manejador de clic no es enfocable, no tiene rol y es invisible para la tecnología de asistencia. ARIA solo llena vacíos que un elemento nativo no puede cubrir. - Toda vista asíncrona tiene cuatro estados: cargando, error, vacío y con datos. Escribe los cuatro antes de dar la vista por terminada. Una región en blanco es un error.
- Nunca inventes datos. Un período faltante es un vacío o una etiqueta "Sin datos", nunca cero y nunca una línea interpolada. Las previsiones siempre deben ser visiblemente distintas de los datos reales.
- Nunca uses solo color para señalar algo. Cada estado codificado por color también lleva texto o un icono con un nombre accesible. La impresión en escala de grises y los lectores daltónicos no obtendrían nada si no.
- El estado compartible vive en la URL. Filtros, pestañas, términos de búsqueda, IDs seleccionados. Atrás, actualizar y compartir debe mantenerlo. El estado efímero (hover, un tooltip abierto) no va en la URL.
- Un valor derivado de varias piezas de estado obtiene una función, llamada cada vez que alguna de ellas cambia. Nunca lo calcules dentro del callback que pertenece a una de ellas. Ejemplo: un enlace de descarga construido a partir de un límite de tiempo y un filtro de grupo solo se reconstruía en el callback de búsqueda del límite, así que después de un cambio de filtro, la exportación apuntaba silenciosamente a la lista completa.
- Reajusta desde 320 píxeles CSS hacia arriba. Sin desplazamiento horizontal de página, sin contenido recortado, texto redimensionable al 200%. Prueba tanto en un ancho de teléfono como en el ancho de escritorio para el que diseñaste.
- Iguala las herramientas a la necesidad. En un repositorio existente, sigue el framework y la herramienta de construcción ya presentes. Para una página nueva pequeña o herramienta interna, considera HTML, CSS y un poco de JavaScript antes de agregar un pipeline de construcción; recurre a un framework cuando el estado realmente lo requiera.
Cuándo no usar
- Elegir una dirección visual, tipografía o paleta: las habilidades
designeryvisual-design. - iOS nativo, Android o React Native: la habilidad
mobile(yswiftpara código Swift). - Forma de la API y endpoints del servidor: las habilidades
api-designybackend-patterns. - Técnica de prueba en profundidad: las habilidades
tddytesting-strategy.
Dónde vive el estado
Decide antes de escribir el estado del componente. Empieza local y escala solo por una razón declarada.
| Estado | Hogar | Ejemplo |
|---|---|---|
| UI local | Estado del componente | Modal abierto, borrador de entrada, hover |
| Compartido por hermanos | Padre común más cercano | Pestaña activa leída por dos paneles |
| Datos del servidor | Biblioteca de caché de servidor (TanStack Query, SWR) o el cargador del framework | Respuestas de API, paginación, recarga |
| Estado de cliente de toda la app | Una tienda pequeña, solo si es necesario | Usuario conectado, cola de notificaciones |
| Estado de vista compartible | Consulta o ruta de URL | Filtros, búsqueda, ID seleccionado |
| Sobrevive a la recarga, por dispositivo | localStorage | Preferencias, borradores no enviados |
Escala solo cuando: dos componentes no relacionados necesitan el mismo estado (súbelo, o usa la caché del servidor); el estado debe sobrevivir a la recarga (URL o almacenamiento); los datos provienen de un servidor (caché del servidor, no una tienda global). Los datos del servidor copiados en una tienda global se vuelven obsoletos y duplican la lógica de carga y error.
Gráficos, impresión y vistas simplificadas
- Gráficos: un mapa de color compartido por el front y back end, un estado vacío explícito, vacíos honestos, una leyenda
HTML. Lee
references/charts.mdantes de construir o cambiar un gráfico. - Impresión o PDF: lee
references/print.mdantes de construir una vista imprimible. Los lienzos no se imprimen de manera confiable sin el paso de captura que describe. - Vistas simplificadas o de solo lectura para lectores no técnicos: sin controles de edición, texto generoso y tamaños de objetivo, estado como color y palabras, resúmenes en lenguaje sencillo calculados a partir de los datos, pocas pantallas, y números destacados con frases cortas en lugar de tablas en bruto.
Rendimiento
Arregla en orden de impacto: primero las cascadas de solicitudes, luego JavaScript enviado, luego tiempo de respuesta del servidor,
luego trabajo del hilo principal durante la interacción y microoptimizaciones al final. Objetivos: LCP 2.5 s o menos, INP
200 ms o menos, CLS 0.1 o menos en el percentil 75 de visitas reales. Lee references/performance.md
cuando una página sea lenta, antes de agregar una dependencia pesada o antes de un lanzamiento con objetivos de rendimiento.
Errores comunes
- Las rutas de renderizado son bucles calientes. El cuerpo de un componente o un getter calculado se ejecuta en cada hover y cada cambio de estado no relacionado. Una derivación pesada allí agota el hilo principal, y el primer síntoma puede ser una prueba inestable en otro lugar. Desduplica, luego memoiza en las entradas ascendentes.
- Una propiedad personalizada CSS no declarada falla silenciosamente.
var(--mono)cuando el token es--font-monohace que la declaración sea inválida en tiempo de valor calculado: la propiedad hereda, sin error. En una abreviatura (font: 400 10px/1 var(--mono)) el tamaño y la altura de línea también se pierden. Dale avar()un valor de respaldo o verifica los tokens declarados contra los referenciados en la hoja de estilo construida. - La altura de un gráfico va en su contenedor. Una altura en el
canvaslucha contra la lógica de redimensionamiento de la biblioteca y el gráfico crece en cada redimensionamiento. - El foco es tu responsabilidad en widgets personalizados. Abrir un diálogo mueve el foco dentro de él; cerrarlo devuelve el foco al
disparador; Escape cierra. Prefiere el elemento nativo
<dialog>. Reconstruir el marcado coninnerHTMLpierde el foco. outline: nonesin reemplazo elimina la única pista que tienen los usuarios de teclado. Usa:focus-visiblepara estilizarlo en su lugar.- Los botones solo con icono necesitan un nombre (
aria-labelo texto oculto visualmente). - El contenido que solo existe después de una obtención de cliente es lento en dispositivos débiles, en blanco cuando JavaScript falla y más débil para los rastreadores. Renderiza contenido significativo en el servidor donde la pila lo permita.
- Los medios sin tamaño desplazan el diseño. Establece
widthyheight(oaspect-ratio) en imágenes, video y embebidos. Nunca cargues diferidamente la imagen que es el elemento más grande visible en la pantalla. - Los desplegables, pestañas y controles deslizantes hechos a mano necesitan el modelo de teclado completo de las Prácticas de Autoría WAI-ARIA. Un elemento nativo es casi siempre más barato.
- Un DOM falso escrito a mano puede hacer que las pruebas sean inertes. Si el falso devuelve un objeto nuevo por búsqueda, cada
propiedad escrita en él (
href,disabled,value) se pierde y ninguna afirmación sobre ella puede fallar. Revierte la característica y exige que la prueba falle antes de confiar en ella. - Una versión fija de CDN, nunca una no fija. Un script no fijo cambia sin que hagas un commit.
Verificación
Pruébalo con lo que el proyecto ya tiene (su ejecutor de pruebas, linter, verificador de tipos, herramientas de accesibilidad) antes de agregar nuevas herramientas.
- Las pruebas, el linter y la verificación de tipos pasan. Se vio que cualquier prueba nueva fallaba con la característica revertida.
- La página se renderizó y se miró, en un ancho de teléfono y un ancho de escritorio. Cuando sea posible, da a los revisores una vista previa en ejecución además de capturas de pantalla.
- Solo teclado: cada control es alcanzable, operable y visiblemente enfocado; el orden coincide con el orden visual; sin trampa.
- Una auditoría de accesibilidad automatizada (axe, Lighthouse o la herramienta del proyecto) no tiene nuevas violaciones. Contraste verificado con una herramienta: 4.5:1 para texto del cuerpo, 3:1 para texto grande y bordes de componentes de IU (WCAG AA).
- Estados de cargando, error, vacío y con datos mostrados cada uno, forzando cada uno.
- El estado compartible sobrevive a la actualización y al botón atrás.
- La consola tiene cero errores y cero advertencias al cargar y durante el uso.
- Se verificó el presupuesto de rendimiento si el cambio agrega una dependencia o toca una vista pesada (analizador de bundle, un perfil limitado).
- Se verificó la vista previa de impresión si la página es imprimible.
Para una revisión, informa hallazgos por archivo con la regla incumplida y la corrección, lo peor primero.