Componentes
¿Cuándo conviene empaquetar un grupo de elementos como una pieza reutilizable y cuándo forzar la misma pieza en todas partes estropea el diseño?
La idea
Diseña para el peor texto real, no para el caso feliz
En la maqueta inicial el título tenía tres palabras («Cine al aire») y todo cabía perfecto. ¿Por qué se rompió la tarjeta el primer día que se conectó a los datos reales?
Ver la respuesta
Porque no se había diseñado un componente, sino un dibujo estático para un único caso feliz. Cuando llegó un evento real con catorce palabras de título, dos ponentes y sin fotografía adjunta, la caja de altura fija desbordó y dejó un hueco roto arriba. Un verdadero componente define qué partes son obligatorias, qué partes son opcionales y cómo se estira su estructura ante textos extremos.
Un componente no se diseña para el texto ideal de la maqueta: se diseña para el peor texto real que le va a tocar.
En una maqueta estática es fácil hacer que tres tarjetas se vean ordenadas: basta con inventar tres títulos de veinte caracteres, elegir tres fotos luminosas de la misma proporción y alinear los botones a mano. El espejismo dura hasta que la plantilla se conecta con la realidad: llega una conferencia con dieciocho palabras de título, sin fotografía y con dos ponentes de apellido compuesto.
Un componente no es un dibujo copiado y pegado. Es un contrato estructural que define qué elementos van siempre juntos, en qué orden se leen, qué ranuras pueden quedar vacías sin dejar huecos rotos y cómo crece la caja cuando el contenido se multiplica.
Míralo
Piezas armadas a mano frente a una estructura elástica común
En esta agenda académica con tres actividades, la columna izquierda muestra tarjetas armadas como casos aislados con huecos rígidos; la derecha muestra tres instancias de un mismo componente elástico.
No funciona: Tarjetas maquetadas a mano o con huecos rígidos
Funciona: Un mismo componente elástico en tres instancias distintas
Cuando cada tarjeta cambia el orden entre fecha, título y botón, quien lee tiene que reaprender a escanear cada recuadro. En la estructura compartida, aunque una actividad tenga foto, otra no la tenga y la tercera ocupe dos renglones de título, el ojo encuentra siempre la categoría arriba, el tema en el centro y la acción al pie.
Pruébalo
Pon un componente al límite de palabras, huecos y ancho
Banco de pruebas de resistencia · anatomía de un componente
Pon a prueba una tarjeta de catálogo sometiéndola a títulos de longitud extrema, ausencia de datos opcionales y cambios en el ancho de la columna donde se inserta.
Guía de exploración
5 pasos
Somete el título a una longitud real. Sube «Longitud del título (palabras)» a 18 o más.
El título pasa de caber en un renglón ideal a ocupar tres líneas completas. Como el componente tiene altura elástica, empuja hacia abajo el resumen y la botonera sin pisar ningún elemento.
Pista: Arrastra el primer deslizador hacia la derecha.
Quita las piezas opcionales. En «Datos opcionales presentes», selecciona «Sin imagen ni etiqueta».
Cuando faltan la miniatura y la categoría, el componente no deja un rectángulo gris vacío ni un hueco huérfano: el bloque de texto ocupa el ancho completo con limpieza.
Pista: Elige la tercera opción del selector de datos opcionales.
Estrecha el contenedor donde vive. Baja «Ancho del contenedor donde vive» a 280 px o menos.
En una columna estrecha, mantener la imagen al lado del texto aplastaría los renglones. El componente apila sus zonas verticalmente para proteger el ancho de lectura.
Pista: Mueve el deslizador de ancho hacia la izquierda.
Observa qué ocurre cuando el contenedor es rígido. Abre «Más controles» y en «Comportamiento ante contenido largo» elige «Altura fija (rígido)».
Al fijar la altura en píxeles como en una maqueta estática, un título real de veinte palabras desborda la caja y pisa el botón de acción.
Pista: Despliega «Más controles» y selecciona la segunda opción.
Inspecciona la anatomía interna en rayos X. Con «Más controles» abierto, vuelve a «Elástico (se adapta)» y activa «Vista de rayos X (anatomía de huecos y reglas)».
Las cotas muestran qué partes del componente son estructura fija (el marco, el pie de acción) y qué partes son ranuras elásticas u opcionales.
Pista: Elige «Elástico (se adapta)» y marca la casilla de rayos X.
Guía completada. Activa la vista de rayos X y prueba la combinación más exigente: contenedor estrecho de 250 px con un título de 22 palabras.
Comprueba cómo pasa de 1 línea ideal a 3 o 4 líneas reales sin romper el pie de la tarjeta.
Debajo de 340 px el componente apila sus bloques para no estrangular el texto.
Más controles
Dibuja con línea punteada las ranuras variables y las zonas fijas del componente.
Configuraciones para probar
Fija la versión corta con todos los datos como A y luego estira el título a 20 palabras y quita la imagen en B para comprobar qué reglas mantienen íntegra la pieza.
Úsalo en tus composiciones
Tres decisiones para construir componentes resistentes
Pruébalo primero con los datos más incómodos del archivo
Antes de aprobar un componente, busca el título más largo, el nombre más corto y el registro más incompleto que exista en tu base de datos. Si el diseño solo aguanta cuando todas las frases miden tres palabras, todavía no es un componente.
Declara qué zonas son obligatorias y cuáles son condicionales
Una tarjeta no puede existir sin título, pero a menudo tendrá que vivir sin foto, sin subtítulo o sin etiqueta de categoría. Diseña el colapso limpio de cada ranura opcional para que su ausencia nunca parezca un error de carga.
No conviertas un componente en una navaja suiza
Si para usar una tarjeta hay que configurar veinte interruptores porque sirve a la vez para mostrar eventos, reproducir pódcast y cobrar matrículas, en realidad tienes tres componentes distintos atrapados en el mismo archivo.
Tres errores frecuentes
Permite que el botón respire cuando el texto crece o se traduce
Un botón diseñado con un ancho fijo de 90 px para la palabra «Enviar» se desborda cuando cambia a «Guardar y continuar» o se traduce al alemán. Cambia la regla de ancho.
Botón de 90 px fijos desbordado por texto largo.
Colapsa la ranura cuando falta un dato opcional
El 40 % de los libros del catálogo antiguo no tienen portada digitalizada. Si la ranura de imagen es obligatoria, deja un cuadro roto. Haz que la ranura sea condicional.
Ficha bibliográfica sin imagen de portada.
Divide el «componente navaja suiza» en dos piezas claras
Intentaron meter en un solo componente una tarjeta de artículo, un reproductor de audio, una encuesta y una tabla de precios. El resultado tiene 28 propiedades y confunde a todos. Sepáralo por responsabilidad.
Supercomponente inflado con 4 funciones incompatibles.
Componentes en piezas reales
Este mismo sitio (Instrumento.astro): un marco fijo con cuatro ranuras (slots)
Ficha bibliográfica: campos obligatorios frente a metadatos opcionales
Fila de movimiento bancario: columna derecha blindada ante nombres largos
Ponte a prueba
Detecta cajas rígidas, huecos rotos y abstracciones prematuras
Ponte a prueba
5 rondas
Cinco rondas sobre pruebas de resistencia (stress test), ranuras opcionales, abstracción prematura y elasticidad.
Después de cada respuesta podrás consultar la explicación.
A fondo
Anatomía interna, abstracción prematura y límites de la reutilización
Qué es fijo y qué es variable dentro de un componente
En Modular Web Design (2009), Nathan Curtis mostró que documentar un componente por su apariencia en un único estado estático sirve de muy poco. Lo que define a un componente es su anatomía de zonas y sus reglas de adaptación:
- El contenedor y el ritmo interno: qué tokens de espacio interior, borde y color de superficie envuelven la pieza, y cómo responde cuando el contenedor padre se estrecha.
- Las zonas obligatorias: los elementos sin los cuales el componente pierde su sentido funcional (por ejemplo, el concepto y el importe en una fila bancaria, o el
idy eltituloenInstrumento.astro). - Las ranuras opcionales (slots): los huecos que solo se renderizan si reciben contenido (como la guía paso a paso, los controles avanzados o la miniatura de una ficha), colapsando su margen cuando están vacíos.
La regla de tres contra la abstracción prematura
Cuando un equipo descubre las ventajas de trabajar con componentes, suele caer en el exceso contrario: querer convertir cada bloque nuevo en un componente universal desde el primer día. Alla Kholmatova advierte en Design Systems (2017) que empaquetar demasiado pronto produce abstracciones torpes.
Una regla práctica saludable es esperar a que una pieza aparezca en tres lugares reales antes de extraerla como componente compartido. Si una composición gráfica existe únicamente para explicar un fenómeno específico —como el escenario interactivo de cada entrada de /diseno-visual—, debe vivir como pieza a medida dentro de un marco compartido, no forzarse dentro de una plantilla genérica.
De los átomos a los organismos: alcances y límites
La metáfora de Atomic Design propuesta por Brad Frost (2016) ayudó a visualizar que los componentes se anidan unos dentro de otros: controles simples (Deslizador, Opciones, Interruptor) se combinan dentro de bloques medianos (Guia) que a su vez habitan marcos mayores (Instrumento).
Sin embargo, el propio trabajo con sistemas enseña que la jerarquía no es una escalera rígida. Lo decisivo es que cada nivel tenga una responsabilidad única y clara: el control deslizador sabe leer y mostrar un número; el marco del instrumento sabe comparar el estado A con el estado B y sincronizar la URL; el escenario sabe dibujar el fenómeno visual.
Cómo se relacionan tokens, componentes, variantes y patrones
Los cuatro conceptos de este territorio operan en escalas complementarias:
- Los tokens guardan las decisiones atómicas con nombre semántico (
--tinta,--espacio-m). - Los componentes encapsulan una pieza funcional reutilizable (un botón, una tarjeta, un instrumento).
- Las variantes articulan las versiones hermanas de ese mismo componente (primario, secundario, compacto).
- Los patrones describen cómo organizar varios componentes para resolver una tarea recurrente (como revelar controles avanzados bajo demanda).
Se relaciona con
- Sistemas y excepciones
Los componentes materializan las reglas del sistema en piezas concretas que mantienen la coherencia mientras cambia el contenido.
- Tokens
Un componente bien construido no guarda colores ni medidas fijas en su interior, sino que lee tokens semánticos del sistema.
- Variantes
Cuando un mismo componente necesita expresar distinta jerarquía, densidad o estado sin cambiar su estructura, desarrolla variantes controladas.
- Patrones
Los componentes son los bloques de construcción; los patrones definen cómo se combinan y disponen para resolver una tarea completa.
- Retículas y alineación
Un componente debe responder con elasticidad al ancho de las columnas de la retícula donde se inserta.
Fuentes
- Brad Frost (2016). Atomic Design. Brad Frost.Descomposición jerárquica de interfaces en elementos básicos, grupos funcionales y bloques compuestos reutilizables.
- Alla Kholmatova (2017). Design Systems: A practical guide to creating design languages for digital products. Smashing Media.Criterios de modularidad, encapsulación, límites de reutilización y cuándo no convertir una pieza única en componente compartido.
- Nathan Curtis (2009). Modular Web Design: Creating Reusable Components for User Experience Design and Documentation. New Riders.Anatomía de un componente: contenedor, zonas fijas, zonas opcionales y reglas de comportamiento ante contenido extremo.