¿Qué hace Layout que comunica estructura?
El layout comunica antes de que se lea una sola palabra: la posición, el espaciado y la alineación transmiten jerarquía por sí mismos, y el espacio generoso supera a la decoración. Un buen layout también sobrevive al estrés: redimensionarlo, traducirlo, reflejarlo para RTL, y debería mantenerse firme. Aplica estos principios al construir o revisar código de UI, y expresa cada cambio en el sistema de estilos existente del proyecto (Tailwind, CSS plano, CSS-in-JS); nunca introduzcas un segundo enfoque de estilos.
Los tamaños de las áreas táctiles y el comportamiento de enfoque están cubiertos por el skill better-accessibility; el pulido visual (radio, sombras, animación) por el skill better-ui; la longitud de línea y el espaciado de texto por el skill better-typography.
Trata los valores numéricos a continuación como puntos de partida para interfaces sin un sistema de densidad o espaciado establecido. Preserva el chrome deliberado de la plataforma, las herramientas profesionales compactas y los tokens del proyecto cuando sigan siendo utilizables bajo pruebas de estrés de área táctil, zoom, localización y viewport.
Referencia rápida
| Categoría | Cuándo usarlo |
|---|---|
| Agrupación y Alineación | Espacio vs separadores, bordes de alineación, propiedades lógicas, orden por importancia |
| Espaciado y Adaptabilidad | Espaciado entre objetivos, márgenes de layout, revelación progresiva, contenido a sangre, breakpoints, crecimiento i18n |
Principios fundamentales
1. Agrupa con espacio, no con líneas
El espacio negativo es la herramienta principal de agrupación; las formas de fondo, secundarias; las líneas separadoras, al final, solo donde el espacio por sí solo no puede transmitir la estructura. El espacio entre grupos debe ser al menos 2× el espacio dentro de un grupo (8px intra-grupo → 16px+ inter-grupo), o la agrupación se lee como ruido.
2. Mantén los controles distintos del contenido
Los elementos interactivos deben verse interactivos: una forma de fondo, un borde o una zona de colocación consistente. Nunca estilices un control de manera idéntica al texto estático adyacente.
3. Alinea a bordes compartidos
Elige bordes de alineación y mantente en ellos; cada borde suelto se lee como ruido. Usa un escalón de espaciado del proyecto para cada nivel de subordinación (16px es un valor predeterminado útil). Usa propiedades lógicas (padding-inline-start, margin-inline-end) para layout dependiente de dirección; reserva left/right físicos solo para geometría genuinamente física.
4. Ordena por importancia
El contenido más importante se sitúa cerca de la parte superior y del borde principal; el orden de lectura fluye de arriba a abajo, de principal a final. Piensa en términos de principal/final, no izquierda/derecha.
5. Insinúa el contenido oculto
La revelación progresiva necesita una señal visual. Usa la señal establecida del proyecto; sin ella, deja que el siguiente elemento se asome 16–32px más allá del borde de desplazamiento o muestra un control de revelación. El contenido oculto sin señal puede que no exista.
6. Espacio de respiración entre objetivos
Sin un sistema de densidad establecido, comienza con 12px entre controles adyacentes con borde o relleno, y 24px de espacio alrededor de controles sin borde solo de texto o icono. Los layouts compactos pueden usar menos cuando las áreas táctiles de better-accessibility no se superponen y los controles siguen siendo visualmente distintos.
7. Botones insertados desde los bordes
En layouts de contenido, mantén los botones de ancho completo dentro de los márgenes del layout (comienza cerca de 16px en línea en móvil) con un radio visible. Las acciones de borde a borde son aceptables cuando siguen intencionalmente el chrome establecido de la plataforma o la aplicación, tienen en cuenta las áreas seguras y siguen siendo distinguibles de la UI del sistema.
8. El contenido sangra, los controles flotan
Los fondos y los medios se extienden hasta los bordes del viewport; los controles y el texto permanecen dentro de los márgenes del layout y las áreas seguras (env(safe-area-inset-*)). El chrome fijo flota sobre la capa de contenido, no la represa.
9. Mantén la estructura hasta que se rompa
Los breakpoints provienen del contenido, no de valores predefinidos de dispositivos. Mantén el layout expandido mientras realmente encaje y colapsa tarde; prefiere container queries para la adaptación a nivel de componente. Prueba primero los tamaños más pequeño y más grande.
10. Planifica el crecimiento y el recorte
Planifica un crecimiento sustancial de cadenas dependiente del idioma en lugar de confiar en un porcentaje universal: no uses anchos ni altos fijos en contenedores de texto, y deja que las filas se envuelvan. Nunca coloques acciones críticas donde redimensionar o desplazar las recorte; mantenlas alcanzables en el flujo normal o en un chrome estable adecuado al producto.
Errores comunes
| Error | Solución |
|---|---|
| Línea separadora donde bastaría con espacio | Elimina la línea, duplica el espacio entre grupos |
margin-left / padding-right en un layout localizable | margin-inline-start / padding-inline-end |
| Botón de layout de contenido toca accidentalmente el viewport | Inserta dentro de los márgenes del proyecto; preserva el chrome deliberado de la plataforma |
| Carrusel/scroller que parece completo | Deja que el siguiente elemento se asome 16–32px más allá del borde |
| Controles adyacentes se fusionan o las áreas táctiles expandidas se superponen | Aumenta el espacio usando la escala del proyecto; usa 12px/24px como puntos de partida |
| Breakpoints en 768/1024 porque son los valores predeterminados | Rompe donde el contenido realmente deja de encajar |
| Contenedor de texto de ancho fijo dimensionado para un idioma | max-width + wrapping; prueba pseudolocalización y configuraciones regionales representativas |
| Acción principal en la parte inferior propensa a recorte de un panel | Posicionamiento sticky o chrome estable con padding de área segura |
Formato de salida de revisión
Usa este formato solo cuando el usuario solicite una revisión de layout independiente. Cuando better-interface orqueste la revisión, proporciona evidencia de dominio y hallazgos a ese skill y deja que su formato de salida, escala de gravedad, reglas de consolidación, límite y veredicto tengan prioridad.
Presenta la revisión independiente en dos partes.
Hallazgos
Agrupa todos los hallazgos confirmados por principio. Usa una tabla markdown con las columnas Gravedad, Ubicación, Antes, Después y Por qué. Nunca uses líneas separadas "Antes:" / "Después:".
- Gravedad:
ALTAbloquea contenido o una acción en un viewport admitido;MEDIAdaña la jerarquía, el orden de lectura o la adaptabilidad;BAJAes pulido aislado de alineación o espaciado. - Ubicación: cita
ruta/al/archivo:línea. Si el artefacto no tiene archivos fuente, cita la pantalla y el componente exactos. - Antes / Después: muestra el layout actual y un reemplazo procesable.
- Por qué: nombra el principio violado y su efecto en la comprensión o adaptabilidad.
Consolida un problema sistémico repetido en una fila y enumera todas las ubicaciones afectadas. Omite principios sin hallazgos.
Ejemplo
Agrupa con espacio, no con líneas
| Gravedad | Ubicación | Antes | Después | Por qué |
|---|---|---|---|---|
| BAJA | src/Settings.tsx:41 | border-b en cada fila de configuración | Elimina bordes; usa space-y-2 dentro de grupos y space-y-8 entre grupos | El espaciado comunica agrupación con menos ruido visual |
| BAJA | src/ProfileForm.tsx:58 | <hr> entre secciones del formulario | Reemplaza con mt-10 en cada encabezado de sección | La jerarquía de secciones no debe depender de reglas repetidas |
Alinea a bordes compartidos
| Gravedad | Ubicación | Antes | Después | Por qué |
|---|---|---|---|---|
| BAJA | src/Card.tsx:24 | Texto de tarjeta en pl-4, icono de tarjeta en pl-3 | Alinea ambos al mismo borde pl-4 | Los bordes compartidos crean una estructura legible |
| MEDIA | src/Nav.css:19 | margin-left: 16px | margin-inline-start: 16px | Las propiedades físicas rompen los layouts conscientes de la dirección |
Verificación y veredicto
Después de los hallazgos:
- Verificación: enumera las comprobaciones exactas realizadas y sus resultados observados en los anchos de viewport, orden de lectura, zoom y estado RTL relevantes. Si no se realizó una comprobación, indica qué necesita verificación aún.
- Veredicto:
Bloqueadosi queda algún hallazgoALTA,Necesita cambiossi solo quedan hallazgosMEDIAoBAJA, yAprobadosolo cuando no queden hallazgos procesables.
Cuando no haya hallazgos, omite las tablas, indica "Sin hallazgos de layout procesables", informa la verificación y termina con Aprobado.