Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

@container — interroger un conteneur ancêtre

La règle @container conditionne les styles d’un descendant à la taille ou au style d’un conteneur ancêtre choisi, et non au seul viewport.

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

Syntaxe

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

@container [<container-name>]? <container-condition> { <stylesheet> } est une règle de groupe conditionnelle. Pour chaque élément ciblé, le navigateur choisit l’ancêtre conteneur le plus proche capable de traiter toutes les caractéristiques ; un nom facultatif filtre les candidats. Les requêtes de taille exigent container-type: inline-size ou size, tandis que les requêtes de style consultent des valeurs calculées.

Un composant peut ainsi changer de disposition lorsque son propre panneau est assez large, sans modification du viewport. La condition stylise les descendants : un élément ne peut pas interroger sa propre taille pour se styliser. Sans ancêtre admissible, la requête est inconnue et le bloc ne s’applique pas. Un nom permet de sélectionner volontairement un contexte plus éloigné.

Combine and, or et not selon la grammaire. Les unités em de la condition se rapportent à la taille de police calculée du conteneur. Des requêtes imbriquées peuvent choisir des conteneurs différents et ne sont pas toujours fusionnables. L’exemple lit --state à 300 px, réduit le conteneur à 100 px puis relit la valeur calculée réelle.

Exemples

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);

Résultat

300px=wide; 100px=base

La règle @container conditionne les styles d’un descendant à la taille ou au style d’un conteneur ancêtre choisi, et non au seul viewport.

Sources