Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

@container — consultar un contenedor ancestro

La regla @container condiciona los estilos de un descendiente al tamaño o estilo de un contenedor ancestro seleccionado, no solo al viewport.

Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxis

@container <container-condition># {
  <block-contents>
}

@container [<container-name>]? <container-condition> { <stylesheet> } es una regla de grupo condicional. Para cada elemento, el navegador elige el contenedor ancestro más cercano apto para todas las características de la condición; un nombre opcional filtra candidatos. Las consultas de tamaño requieren container-type: inline-size o size, y las de estilo examinan valores calculados expuestos por el contenedor.

Así un componente cambia su diseño cuando su propio panel dispone de espacio, aunque no cambie el viewport. La condición da estilo a descendientes: un elemento no puede consultar su propio tamaño para estilizarse. Sin ancestro apto, la consulta es desconocida y el bloque no se aplica. Un nombre permite seleccionar deliberadamente un contexto exterior.

Combina and, or y not según la gramática. Las unidades em de la condición usan el tamaño de fuente calculado del contenedor. Consultas anidadas pueden elegir contenedores distintos y no siempre se pueden fusionar. El ejemplo lee --state a 300 px, reduce el contenedor a 100 px y vuelve a leer el valor calculado real.

Ejemplos

const style = document.createElement('style');
style.textContent = `.host { container-type: inline-size; width: 300px; }
.target { --state: base; }
@container (inline-size > 200px) { .target { --state: wide; } }`;
document.head.append(style);
const host = document.createElement('div');
host.className = 'host';
host.innerHTML = '<div class="target">card</div>';
document.body.append(host);
const target = host.firstElementChild;
const wide = getComputedStyle(target).getPropertyValue('--state').trim();
host.style.width = '100px';
await new Promise(requestAnimationFrame);
const narrow = getComputedStyle(target).getPropertyValue('--state').trim();
console.log('300px=' + wide + '; 100px=' + narrow);

Resultado

300px=wide; 100px=base

La regla @container condiciona los estilos de un descendiente al tamaño o estilo de un contenedor ancestro seleccionado, no solo al viewport.

Fuentes