CSS Container Queries

Para usar container queries, necesitas declarar un containment context en un elemento, de esta manera el navegador sabrá que estás interesado en consultar las dimensiones del contenedor. Para hacer esto, usa la propiedad container-type (en-US) con los valores de size, inline-size, o normal. Estos valores tienen los siguientes efectos:

• size: La consulta toma como referencia las dimensiones de bloque y en línea del contenedor. Aplica contención de disposición, estilo y tamaño al contenedor.
• inline-size: La consulta se basa únicamente en la dimensión en línea del contenedor. Aplica contención de disposición, estilo y tamaño en línea al contenedor.
• normal: El elemento no es un query container para consultas de tamaño, pero se sigue comportando como un query container para consultas de estilos de contenedor (container style queries).

En el siguiente fragmento de HTML se muestra un ejemplo de un componente tipo tarjeta que tiene una imagen, un título y algo de texto:

<div class="container">
  <div class="card">
    <img src="image.png" alt="Un gato con sus dos ojos de diferente color" />
    <h2>Título de la tarjeta</h2>
    <p>Contenido de la tarjeta</p>
  </div>
</div>

Puedes crear un containment context en el contenedor div al usar la propiedad container-type:

.container {
  container-type: inline-size;
}

Una vez que el containment context es creado, puedes utilizar la regla at @container (en-US) para escribir una container query. La query en el siguiente ejemplo aplicará ciertos estilos a los elementos según el tamaño del elemento padre más cercano con un containment context. Específicamente, esta query aumentará el tamaño de fuente del título de la carta si el contenedor es más ancho que 700px:

/* Estilos por defecto para el título de la carta */
.card h2 {
  font-size: 1em;
}

/* Container query que se aplica si el contenedor es más ancho que 700px */
@container (min-width: 700px) {
  .card h2 {
    font-size: 2em;
  }
}

Si existen otras áreas dentro de la página que también sean containment contexts, puedes utilizar el mismo componente en esas areas y éste se adaptará a los distintos contextos. Esto hace que los componentes reutilizables sean aún más flexibles sin la necesidad de saber específicamente dónde serán utilizados en cada ocasión.

Para más información sobre la sintaxis de las container queries, mira la página de @container (en-US).

En la sección anterior vimos cómo utilizar una container query para aplicar estilos tomando como referencia al elmento padre más cercano con un containment context. Puedes darle un nombre a un containment context utilizando la propiedad container-name (en-US). Una vez con un nombre asociado, el nombre puede ser usado en una @container query para especificar un contenedor como objetivo específico. El siguiente ejemplo crea un containment context con el nombre sidebar:

.container {
  container-type: inline-size;
  container-name: sidebar;
}

Ahora puedes hacer referencia a este containment context usando la regla at @container:

@container sidebar (min-width: 700px) {
  .card {
    display: grid;
    grid-template-columns: 2fr 1fr;
  }
}

Para más información sobre los containment context con nombre, visita la página de la propiedad container-name (en-US).

La forma rápida para declarar un containment context es por medio de la propiedad container:

.container {
  container: sidebar / inline-size;
}

Para más información sobre esta propiedad, visita la referencia de container (en-US).

Cuando se usan container queries para aplicar estilos a un contenedor, puedes utilizar unidades de longitud de container queries. Con estas unidades se pueden definir longitudes relativas a las dimensiones del contenedor. Aquellos componentes que utilizan unidades de longitud relativas a su contenedor, permiten mayor flexibilidad para ser usados en distintos contenedores sin la necesidad de recalcular valores de longitud concretos.

Las unidades de longitud de container queries son:

• cqw: 1% del ancho del contenedor
• cqh: 1% de la altura del contenedor
• cqi: 1% del tamaño en línea del contenedor
• cqb: 1% del tamaño de bloque del contenedor
• cqmin: El valor más pequeño entre cqi y cqb
• cqmax: El valor más grande entre cqi y cqb

En el siguiente ejemplo se usa la unidad cqi para cambiar el tamaño de fuente de un título según el tamaño en línea del contenedor.

@container (min-width: 700px) {
  .card h1 {
    font-size: max(1.5em, 1.23em + 2cqi);
  }
}

Para más información acerca de estas unidades, mira la referencia de Unidades de longitud de container queries.

Se puede utilizar grid y flex para crear un efecto similar en los navegadores que aún no soportan las container queries. En el siguiente ejemplo se usa una declaración grid-template-columns para crear una disposición de dos columnas para el componente de tipo tarjeta.

.card {
  display: grid;
  grid-template-columns: 2fr 1fr;
}

Si deseas utilizar una disposición de una sola columna en dispositivos con un viewport más pequeño, puedas utilizar una media query para modificar la configuración de la cuadrícula.

@media (max-width: 700px) {
  .card {
    grid-template-columns: 1fr;
  }
}

• Media queries
• La regla at @container (en-US) de CSS
• La propiedad contain (en-US) de CSS
• La propiedad atajo container (en-US) de CSS
• La propiedad container-name (en-US) de CSS
• La propiedad content-visibility (en-US) de CSS
• Say Hello to CSS Container Queries por Ahmad Shadeed
• Container Queries: a Quick Start Guide
• Collection of Container Queries articles