Saltar al contenido

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)
  1. Media query vs. container queries en CSS
  2. container-type
  3. @container
  4. La tarjeta de producto en tres contextos
  5. Unidades de contenedor
  6. Compatibilidad
  7. Errores comunes
  8. Preguntas frecuentes
  9. Checklist

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:

HuecoCon @containerCon @media (ventana de 1280 px)
240 px1 columna, título de 16 px3 columnas
480 px2 columnas, el botón bajo el título3 columnas
720 px3 columnas, título de 21,6 px3 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:

la misma tarjeta en tres contenedores de distinto ancho240 px480 px720 px1 columna2 columnas3 columnasbasemin-width: 24remmin-width: 36rem@container card (min-width: …) { .card { grid-template-columns: … } }un solo CSS, tres diseños, sin tocar la ventanamedido en local con Chromium 151: 1, 2 y 3 columnas con la ventana en 1280 px

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;
}
  1. El primer bloque convierte .card-slot en un contenedor que se consulta por su ancho.
  2. container-name: card le da nombre, para que un @container card apunte a este contenedor y a ningún otro.
  3. 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.

la consulta mide al contenedor y estiliza a sus descendientes.card-slotcontainer: card / inline-size.cardgrid-template-columnsfont-size× no aplica al contenedormedido: outline-style none@container card(min-width: 24rem)estiliza a .cardel contenedor no puede cambiarse a sí mismomedido en Chromium 151: una regla sobre el propio contenedor no aplica

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 con container-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>
  1. .card-slot es el contenedor; lo pone quien coloca la tarjeta.
  2. La imagen lleva width y height para reservar su espacio antes de cargar.
  3. 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);
  }
}
  1. .card-slot es el contenedor, con nombre card y consulta por ancho.
  2. .card es una cuadrícula; sin ninguna consulta, grid-template-areas apila imagen, título y botón en una columna.
  3. .card__img ocupa todo el ancho y aspect-ratio: 4 / 3 mantiene su proporción, así no hay salto de diseño al cargar la foto.
  4. .card__title y .card__cta toman su sitio con grid-area; los nombres de área son los de grid-template-areas.
  5. Desde 24rem (384 px con la fuente base de 16 px), dos columnas: imagen de 8rem a la izquierda, ocupando dos filas; título arriba y botón debajo.
  6. Desde 36rem (576 px), tres columnas en una sola fila: imagen de 12rem, título y botón a la derecha, centrados en vertical.
  7. 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.
  8. Los dos bloques @container usan min-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.

cada pieza de container queries y desde cuándo funcionapiezaqué hacea recordarcontainer-type: inline-sizeconsulta el anchoel ancho viene del contextocontainer-type: sizeconsulta ancho y altocolapsa sin tamaño propiocontainer-type: normalno consulta tamañovalor por defecto@container card (…)consulta con nombrebusca al ancestro cardcqi · cqw · cqb · cqh1% del contenedorsin contenedor: unidad sv*BaselineWidely availabledesde febrero de 2023disponible en todos los navegadores desde 2023fuente: MDN, container-type y container queries · 12 nov 2026

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-type en el elemento que quieres cambiar. Una regla @container no estiliza a su propio contenedor (medido: el outline no aplicó). Declara el contenedor en el hueco.
  • Usar size sin tamaño. Con contención de tamaño y sin altura o ancho dados por el contexto, el elemento colapsa. Casi siempre basta inline-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 cqi sin contenedor. Cae a la ventana: medí 128px para 10cqi en una ventana de 1280 px.
  • Imágenes sin width y height. 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 @container lleva el nombre del contenedor.
  • El diseño base, sin consultas, funciona en una columna.
  • La imagen tiene width, height y aspect-ratio.
  • Cada cqi está 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

Luis Morales

Luis Morales

Desarrollador frontend y Shopify, EcomLabs

@luismoralesdev en Instagram

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

← Blog