Las container queries en CSS permiten ajustar una tarjeta al espacio que le da su contenedor. Imagina que una noticia aparece en el cuerpo principal y también en una barra lateral. Aunque la ventana tenga la misma anchura, cada ubicación ofrece un espacio distinto.
En este tutorial prepararás una tarjeta que apila sus elementos cuando el contenedor es estrecho y los coloca en dos columnas cuando dispone de más sitio. El mismo marcado servirá en ambos lugares.
Define qué elemento aporta la medida
Para consultar el ancho de un contenedor debes establecer un contexto de consulta de tamaño. En el ejemplo, el envoltorio usa container-type: inline-size y un nombre. Ese envoltorio mide el espacio disponible. La tarjeta vive dentro y recibe los cambios de estilo cuando se cumple la condición.
Esta separación evita intentar que un elemento modifique su propia composición a partir de una consulta sobre sí mismo. Identifica primero el padre que conoce el espacio de la tarjeta. Después añade la consulta que afecta a sus descendientes.
Elige el umbral según el contenido
Una tarjeta con un precio y una frase breve puede funcionar en dos columnas antes que una noticia con un titular largo. Abre el prototipo y reduce el ancho hasta que la lectura resulte incómoda. Ese punto te da una referencia para el umbral.
El ejemplo cambia a partir de treinta y dos rem. Usa esa cifra como punto de partida para experimentar. Si tienes una familia de tarjetas, prueba la más exigente. También conviene comprobar la fuente definitiva y los textos traducidos antes de cerrar la regla.
Prueba la misma tarjeta en dos espacios
Copia el documento completo como index.html. Verás un ejemplo en una zona amplia y otro en una columna estrecha. La página organiza ambos espacios con una cuadrícula exterior. Cada envoltorio conserva el mismo nombre de contenedor y cada consulta se resuelve sobre el ancestro adecuado de su tarjeta.
La portada de color representa un área visual, así que el archivo funciona sin descargar imágenes. Sustitúyela luego por una fotografía con dimensiones y alternativa textual si tu diseño lo necesita. Mantén esa decisión separada del cambio de columnas.
<!doctype html>
<html lang="es">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Container queries en CSS</title>
<style>
body {
max-width: 70rem;
margin: 2rem auto;
padding: 1rem;
font: 1rem/1.6 system-ui, sans-serif;
color: #18263e;
}
.pagina { display: grid; grid-template-columns: minmax(0, 2fr) minmax(14rem, 1fr); gap: 1.5rem; }
.contenedor { container-type: inline-size; container-name: ficha; min-width: 0; }
.tarjeta { display: grid; overflow: hidden; border: 1px solid #bfd0ee; border-radius: 1rem; }
.visual { min-height: 8rem; background: linear-gradient(135deg, #1260ce, #62cfce); }
.contenido { padding: 1.5rem; min-width: 0; }
.contenido h2 { margin-top: 0; overflow-wrap: anywhere; }
@container ficha (min-width: 32rem) {
.tarjeta { grid-template-columns: 1fr 2fr; }
}
@media (max-width: 45rem) {
.pagina { grid-template-columns: minmax(0, 1fr); }
}
a:focus-visible { outline: 3px solid #a73d00; outline-offset: 4px; }
</style>
</head>
<body>
<h1>Una tarjeta, dos contenedores</h1>
<div class="pagina">
<div class="contenedor">
<article class="tarjeta"><div class="visual" aria-hidden="true"></div><div class="contenido"><h2>Diseña una agenda adaptable</h2><p>Practica con componentes que funcionan en varias zonas.</p><a href="#practica">Ver la práctica</a></div></article>
</div>
<aside class="contenedor" aria-label="Curso destacado">
<article class="tarjeta"><div class="visual" aria-hidden="true"></div><div class="contenido"><h2>Diseña una agenda adaptable</h2><p>Practica con componentes que funcionan en varias zonas.</p><a href="#practica">Ver la práctica</a></div></article>
</aside>
</div>
<section id="practica"><h2>Tu práctica</h2><p>Cambia el ancho de los contenedores y observa cada tarjeta.</p></section>
</body>
</html>Compara ventana y contenedor
Deja la ventana en un ancho de escritorio y observa las dos tarjetas a la vez. Una puede activar la disposición horizontal y la otra continuar apilada. Después estrecha la ventana. La regla exterior convierte la página en una sola columna cuando hace falta.
Las tarjetas siguen respondiendo al espacio de sus respectivos envoltorios. Abre el inspector y revisa el ancho calculado de cada padre. Esta prueba muestra por qué una media query de ventana podría aplicar la misma composición a dos tarjetas que necesitan soluciones diferentes.
Evita que el contenido decida una anchura inesperada
El contexto de consulta inline-size introduce contención en ese eje. En una cuadrícula, asegúrate de que el contenedor recibe un ancho a partir del diseño exterior. Una columna definida con minmax(0, 1fr) puede reducirse sin dejar que un texto largo imponga un mínimo excesivo.
Añade min-width: 0 donde el elemento de cuadrícula lo necesite. Comprueba además los enlaces largos y las imágenes. Si el padre no tiene un espacio establecido, la consulta puede acabar dependiendo de un diseño distinto del que imaginabas.
Usa nombres cuando existan varios niveles
Un proyecto puede tener un contenedor de página y otro dentro de cada tarjeta. Darles nombres distintos permite expresar cuál quieres consultar. El ejemplo usa ficha para el envoltorio de cada componente. Si introduces un contenedor adicional entre la tarjeta y su padre, revisa si la consulta sigue apuntando al nivel previsto.
Con un nombre explícito resulta más fácil seguir esa relación en el código. Usa nombres que describan una función estable. Evita llamarlos grande o pequeño si pueden cambiar de ancho al reutilizarse en otra zona.
Construye una base que siga siendo legible
Define primero el diseño apilado fuera de la consulta. Dentro de la condición añade solo los cambios necesarios para la versión amplia. Así el contenido conserva una composición útil incluso cuando esa mejora no se aplica. Prueba el CSS quitando temporalmente la regla de consulta.
El título, el párrafo y el enlace deben permanecer disponibles. Revisa los navegadores incluidos en tu proyecto antes de depender de esta función para una interacción esencial. Una tarjeta bien estructurada puede conservar su lectura con una presentación más sencilla.
Ejercicio con tres ubicaciones reales
Añade un tercer envoltorio dentro de un área de promociones. Dale un ancho diferente a los otros dos y conserva exactamente las mismas clases de tarjeta. Cambia después el titular por una frase larga. Comprueba si el umbral permite leerla y si el enlace recibe foco visible.
Si necesitas más de un cambio, puedes añadir otra consulta para un contenedor mucho más amplio. Justifica cada transición por una necesidad observable. Al terminar, mueve la tarjeta entre las tres áreas y confirma que responde sin agregar clases de tamaño a su marcado.
Continúa con esta práctica relacionada y compara cómo se combinan las reglas en tu proyecto.




