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

CKTIS / CSS

container — raccourci pour les conteneurs de requête

La propriété CSS container définit conjointement container-name et container-type. Elle nomme un conteneur et précise quelles requêtes peuvent l’utiliser pour appliquer un style conditionnel à ses descendants.

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

Syntaxe

container: <'container-name'> [ / <'container-type'> ]?;

container est un raccourci pour container-name et container-type, et non pour la règle @container. Les noms se placent avant / et le type après. La déclaration container: demo / inline-size attribue le nom demo et permet les requêtes de taille selon l’axe en ligne du conteneur.

inline-size concerne l’axe en ligne, tandis que size concerne les deux axes. Ces types limitent également la manière dont la taille du conteneur dépend de son contenu ; prévoyez donc des dimensions adaptées dans la mise en page. Un nom seul ne permet pas les requêtes de taille.

Si le type est omis, container-type est réinitialisé à normal : container: demo ne conserve pas une valeur inline-size définie auparavant. container: none supprime les noms et réinitialise aussi le type. Aucune des deux propriétés longues n’est héritée.

La règle @container demo (...) sélectionne l’ancêtre admissible le plus proche nommé demo ; un élément ordinaire ne peut pas ainsi effectuer une requête sur lui-même. Dans l’exemple, la condition modifie l’arrière-plan de .card, et non celui de .panel. La requête dépend de la taille du conteneur, et non directement de celle de la fenêtre d’affichage.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Named container query at two widths</title>
  <style>
    .panel {
      container: demo / inline-size;
      writing-mode: horizontal-tb;
      margin-block-end: 8px;
    }
    .wide { inline-size: 320px; }
    .narrow { inline-size: 280px; }
    .card { background-color: lightgray; color: black; padding: 8px; }
    @container demo (inline-size >= 300px) {
      .card { background-color: lightgreen; }
    }
  </style>
</head>
<body>
  <div class="panel wide"><div class="card">Card in the 320px container</div></div>
  <div class="panel narrow"><div class="card">Card in the 280px container</div></div>
  <script>
    for (const panel of document.querySelectorAll('.panel')) {
      const width = getComputedStyle(panel).inlineSize;
      const color = getComputedStyle(panel.querySelector('.card')).backgroundColor;
      console.log(`${width}: ${color}`);
    }
  </script>
</body>
</html>

Résultat

320px: rgb(144, 238, 144)
280px: rgb(211, 211, 211)

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources