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

CKTIS / CSS

container-name — nommer les conteneurs de requête

La propriété container-name attribue des noms à un élément afin que les règles @container puissent sélectionner un conteneur. Le nommage seul n’active pas les requêtes de taille : celles-ci nécessitent un container-type approprié.

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

Syntaxe

container-name: none | <custom-ident>+;

container-name attribue à un élément un ou plusieurs noms qui filtrent les conteneurs pris en compte par @container. Une requête sélectionne l’ancêtre admissible le plus proche portant le nom indiqué ; elle ne porte pas sur l’élément mis en forme lui-même. Les noms n’ont pas besoin d’être uniques.

La valeur initiale none signifie qu’aucun nom n’est défini, et non que toutes les requêtes sont désactivées. La notation <custom-ident>+ désigne un ou plusieurs noms séparés par des espaces, sans virgules ni guillemets, par exemple panel sidebar. La casse des noms est significative. none, and, not et or ne peuvent pas être des noms ; les mots-clés globaux de CSS ne le sont pas non plus.

La propriété s’applique à tous les éléments, n’est pas héritée et n’est pas animable. Elle ne remplace pas container-type. En mode d’écriture horizontal, container-type: inline-size permet les requêtes sur la largeur physique (width). En mode d’écriture vertical, en revanche, l’axe en ligne correspond à la hauteur : un conteneur avec inline-size n’est donc pas admissible pour une requête sur width. Utilisez alors container-type: size pour permettre les requêtes sur les deux axes. Le raccourci container: panel / inline-size définit les deux propriétés ; omettre la partie après / réinitialise container-type à normal.

L’exemple utilise le mode d’écriture horizontal par défaut et le conteneur mesure 320px de large : la requête nommée, avec un seuil de 300px, donne donc une marge intérieure de 16px au descendant .card. Si le nom du conteneur devient other, la requête ne correspond plus et la marge intérieure reste de 4px.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>container-name</title>
<style>
  .panel {
    width: 320px;
    container-type: inline-size;
    container-name: panel sidebar;
  }
  .card { padding: 4px; }
  @container panel (min-width: 300px) {
    .card { padding: 16px; }
  }
</style>
<div class="panel">
  <div class="card">Card</div>
</div>
<script>
  const card = document.querySelector('.card');
  console.log(getComputedStyle(card).paddingTop);
</script>

Résultat

16px

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