Container queries en CSS: una tarjeta de producto que se adapta a su contenedor
En la práctica/ 9 min de lectura
container-type, @container y las unidades cqi explicados con una tarjeta de producto que pasa de una a tres columnas en una cuadrícula, una barra lateral o un carrito.
- Temas
- Rendimiento
- JavaScript
En este artículo (9)
Las container queries de CSS aplican estilos según el ancho del contenedor de un componente, no el de la ventana. Declaras container-type: inline-size en el padre, escribes @container (min-width: 24rem) y la misma tarjeta de producto se acomoda sola en una cuadrícula, una barra lateral o un carrito. Funcionan en todos los navegadores desde febrero de 2023.
Aquí está la tarjeta completa, con el CSS que probé en local con Playwright y Chromium 151: tres copias en huecos de 240, 480 y 720 px dentro de una ventana fija de 1280 px. Los números salen más abajo, medidos, no supuestos.
Media query vs. container queries en CSS
Una media query pregunta por la ventana: su ancho, su orientación, si el usuario prefiere menos movimiento. Una container query pregunta por el hueco donde vive el componente. La diferencia importa cuando una misma tarjeta aparece en una cuadrícula de colección, en una barra lateral y en un carrito: la ventana mide lo mismo en los tres sitios, pero el hueco no.
Lo medí con la misma tarjeta, en tres huecos y una ventana de 1280 px:
| Hueco | Con @container | Con @media (ventana de 1280 px) |
|---|---|---|
| 240 px | 1 columna, título de 16 px | 3 columnas |
| 480 px | 2 columnas, el botón bajo el título | 3 columnas |
| 720 px | 3 columnas, título de 21,6 px | 3 columnas |
Con @media, la tarjeta eligió tres columnas en los tres huecos, porque la ventana era la misma. Con @container, cada hueco recibió su diseño:
Desliza la figura para verla completa
Las media queries siguen siendo la herramienta para lo que depende de la página o del usuario: la navegación global, la cuadrícula principal, prefers-reduced-motion. Las container queries son para el componente.
container-type
Para que un elemento pueda ser consultado, hay que convertirlo en contenedor con container-type. Según MDN, tiene tres valores que importan aquí:
inline-size: consulta el eje en línea, o sea el ancho en texto horizontal. Aplica contención de estilo y de tamaño en línea: el ancho del contenedor se calcula sin mirar a los hijos.size: consulta ancho y alto. Aplica contención de tamaño en ambos ejes; sin un tamaño explícito o dado por el contexto, el elemento colapsa.normal: el valor por defecto. No es contenedor para consultas de tamaño, pero sirve para consultas de estilo y por nombre.
Casi siempre quieres inline-size. Lo mínimo para una tarjeta:
.card-slot {
container-type: inline-size;
container-name: card;
}
/* lo mismo, en la forma corta */
.card-slot {
container: card / inline-size;
}
- El primer bloque convierte
.card-sloten un contenedor que se consulta por su ancho. container-name: cardle da nombre, para que un@container cardapunte a este contenedor y a ningún otro.- El segundo bloque es la forma corta
container: nombre / tipo; usa uno u otro, no los dos.
Como el ancho no sale de los hijos, tiene que venir del contexto: un elemento de bloque que se estira al ancho de su padre, o un width explícito. Un contenedor sin ancho propio no sirve.
Hay una regla más, y la medí: una regla @container no puede estilizar al propio contenedor, solo a sus descendientes. Puse un outline sobre .card-slot dentro de un @container card y outline-style siguió en none. Por eso el contenedor es el hueco, no la tarjeta.
Desliza la figura para verla completa
@container
La consulta se escribe como una media query con un nombre opcional. MDN distingue dos formas:
- Sin nombre:
@container (min-width: 24rem)apunta al ancestro más cercano que sea contenedor. - Con nombre:
@container card (min-width: 24rem)apunta al contenedor concontainer-name: card.
Pon nombre. En un tema, entre tu tarjeta y la página puede haber otro ancestro con container-type (una sección, un carrusel) y una consulta sin nombre se enganchará a ese. MDN también acepta la sintaxis de rango, como @container (width > 700px); yo uso min-width por costumbre y porque es igual de válida.
La tarjeta de producto en tres contextos
El HTML es una tarjeta dentro de un hueco. El hueco es lo que la colección, el carrusel o el carrito controlan; la tarjeta no sabe dónde está:
<div class="card-slot">
<article class="card">
<img class="card__img" src="/camiseta.jpg" alt="Camiseta de algodón" width="400" height="300">
<h3 class="card__title">Camiseta de algodón</h3>
<button class="card__cta" type="button">Agregar</button>
</article>
</div>
.card-slotes el contenedor; lo pone quien coloca la tarjeta.- La imagen lleva
widthyheightpara reservar su espacio antes de cargar. - Título y botón son hijos directos de la tarjeta, para colocarlos con
grid-area.
Y el CSS, que es el que ejecuté en Chromium 151:
.card-slot {
container: card / inline-size;
}
.card {
display: grid;
grid-template-areas: "img" "title" "cta";
gap: 0.75rem;
padding: 0.75rem;
border: 1px solid #bbb;
}
.card__img {
grid-area: img;
width: 100%;
height: auto;
aspect-ratio: 4 / 3;
object-fit: cover;
}
.card__title {
grid-area: title;
margin: 0;
font-size: 1rem;
}
.card__cta {
grid-area: cta;
}
@container card (min-width: 24rem) {
.card {
grid-template-columns: 8rem 1fr;
grid-template-areas: "img title" "img cta";
align-items: start;
}
}
@container card (min-width: 36rem) {
.card {
grid-template-columns: 12rem 1fr auto;
grid-template-areas: "img title cta";
align-items: center;
}
.card__title {
font-size: clamp(1.125rem, 3cqi, 1.5rem);
}
}
.card-slotes el contenedor, con nombrecardy consulta por ancho..cardes una cuadrícula; sin ninguna consulta,grid-template-areasapila imagen, título y botón en una columna..card__imgocupa todo el ancho yaspect-ratio: 4 / 3mantiene su proporción, así no hay salto de diseño al cargar la foto..card__titley.card__ctatoman su sitio congrid-area; los nombres de área son los degrid-template-areas.- Desde
24rem(384 px con la fuente base de 16 px), dos columnas: imagen de8rema la izquierda, ocupando dos filas; título arriba y botón debajo. - Desde
36rem(576 px), tres columnas en una sola fila: imagen de12rem, título y botón a la derecha, centrados en vertical. - En ese mismo bloque, el título crece con
clamp(1.125rem, 3cqi, 1.5rem): el 3% del ancho del contenedor, entre 18 y 24 px. - Los dos bloques
@containerusanmin-width, así que el diseño base es el de una columna: un navegador que no los entienda lo muestra tal cual.
En un tema de Shopify el reparto es el mismo: el snippet de la tarjeta solo trae el CSS de .card, y el hueco .card-slot lo declara la plantilla que lo coloca. Y la imagen con medidas es el mismo principio que en cómo arreglar el CLS de un banner de cookies: reserva el espacio antes de que llegue el contenido.
Unidades de contenedor
MDN define seis unidades relativas al contenedor: cqw y cqh son el 1% de su ancho y de su alto; cqi y cqb, el 1% de su tamaño en línea y en bloque; cqmin y cqmax, el menor y el mayor de cqi y cqb. Valen para los descendientes de un contenedor con container-type de size o inline-size.
Medí dos casos con font-size: 10cqi:
- Dentro de un contenedor de 480 px:
48px, el 10% del contenedor. - Sin ningún contenedor, con una ventana de 1280 px:
128px. MDN lo dice: sin contenedor elegible, la unidad cae a la unidad de ventana pequeña de ese eje.
De ahí sale el primer cuidado con cqi: si olvidas el container-type, el texto se escala con la ventana y nadie te avisa. En la tarjeta, 3cqi dio 21,6 px en el hueco de 720 px, que es el 3% de 720.
Compatibilidad
La página de container-type en MDN marca la función como Baseline "Widely available": disponible en todos los navegadores desde febrero de 2023 (la leí el 12 de noviembre de 2026). MDN añade que algunas partes pueden tener distinto nivel de soporte; por ejemplo, el valor scroll-state, que no uso aquí. Si lo necesitas, revisa su tabla.
Desliza la figura para verla completa
Para quien no soporte @container, el navegador ignora esos bloques y se queda con el diseño base. Si prefieres una alternativa explícita, MDN propone una cuadrícula con una media query.
Errores comunes
- Poner
container-typeen el elemento que quieres cambiar. Una regla@containerno estiliza a su propio contenedor (medido: eloutlineno aplicó). Declara el contenedor en el hueco. - Usar
sizesin tamaño. Con contención de tamaño y sin altura o ancho dados por el contexto, el elemento colapsa. Casi siempre bastainline-size. - Un contenedor sin ancho propio. El ancho tiene que venir del contexto o de un
width; los hijos no cuentan. - Consultas sin nombre con contenedores anidados. Se enganchan al ancestro más cercano, que puede no ser el que piensas.
- Usar
cqisin contenedor. Cae a la ventana: medí128pxpara10cqien una ventana de 1280 px. - Imágenes sin
widthyheight. Al cambiar de columnas, la tarjeta salta cuando llega la foto.
Preguntas frecuentes
¿Funcionan en todos los navegadores?
Según MDN, container-type está disponible en todos los navegadores desde febrero de 2023 y figura como Baseline "Widely available" (consultado el 12 de noviembre de 2026). Algunas partes, como scroll-state, tienen otro nivel de soporte.
¿Reemplazan a las media queries?
No. Las media queries siguen siendo la herramienta para lo que depende de la ventana o del usuario, como la navegación global o prefers-reduced-motion. Las container queries son para componentes que viven en huecos de distinto tamaño.
¿Puedo consultar el alto?
Sí, con container-type: size, que consulta ancho y alto. Pero aplica contención de tamaño en los dos ejes y el elemento colapsa si el contexto no le da tamaño; para tarjetas, inline-size es lo habitual.
¿Dónde declaro el contenedor en un tema?
En el hueco donde se coloca la tarjeta (el elemento de la cuadrícula, la diapositiva del carrusel, la línea del carrito), no en la tarjeta. Así cada lugar decide su ancho y la tarjeta solo reacciona.
Checklist
- El contenedor es el hueco de la tarjeta, no la tarjeta, y tiene
container: nombre / inline-size. - El contenedor tiene un ancho que viene del contexto o de un
width. - Cada
@containerlleva el nombre del contenedor. - El diseño base, sin consultas, funciona en una columna.
- La imagen tiene
width,heightyaspect-ratio. - Cada
cqiestá dentro de un contenedor. - Probé la tarjeta en al menos tres anchos de hueco con la ventana fija.
Si la tarjeta lleva imágenes grandes, revisa también cómo arreglar un LCP lento por la imagen principal, y para evitar saltos al cargar, cómo arreglar el CLS de un banner de cookies. Las fuentes son las páginas de container queries y de container-type de MDN.
¿Viste esto en Instagram? Comenta CONTAINER en el Reel y te mando la guía.
Escrito por

Publicado el 12 de noviembre de 2026 · actualizado el 18 de noviembre de 2026