Règle CSSRègles @

@container

Applique des styles selon la taille d’un conteneur plutôt que celle de la fenêtre entière. Un composant s’adapte à la place qu’il reçoit dans la mise en page.

Sur cette page

Exemple

#
CSS
.slot {
  container-type: inline-size;
}

.card {
  display: grid;
  gap: 10px;
}

@container (width >= 240px) {
  .card {
    grid-template-columns: 96px 1fr;
    align-items: center;
  }
}
Aperçu

Les deux cartes ont le même HTML et les mêmes styles. La colonne de gauche fait 180 px, la carte est donc verticale, tandis que celle de droite dépasse 240 px et la carte s’y dispose à l’horizontale. Sur un téléphone, la colonne de droite passe sous celle de gauche, mais elle reste assez large pour la disposition horizontale.

Définition et utilisation

#

La règle @container fonctionne comme @media, mais au lieu de la largeur de la fenêtre, elle vérifie la taille d’un ancêtre choisi, le conteneur. Ainsi, une même carte peut être verticale dans une colonne latérale étroite et horizontale dans le contenu principal large. Vous déplacez le composant ailleurs dans la page et il s’adapte de lui-même à l’espace disponible.

Il faut d’abord désigner le conteneur. La propriété container-type: inline-size demande au navigateur de suivre sa largeur, et container-type: size également sa hauteur. L’option container-name lui donne un nom, et le raccourci container: carte / inline-size définit le nom et le type en une fois. Une requête @container (width >= 400px) cible l’ancêtre le plus proche qui est un conteneur, et @container carte (width >= 400px) le plus proche portant ce nom.

Les règles de @container ne s’appliquent qu’aux descendants du conteneur, jamais à lui-même, car la taille du conteneur ne peut pas dépendre de styles qui dépendent de cette taille. Pour la même raison, la largeur du conteneur ne découle plus de son contenu : un élément dimensionné selon son contenu, comme un inline-block ou un float, peut se réduire à zéro. Avec container-type: size, vous devez aussi définir vous-même la hauteur.

À l’intérieur d’un conteneur, les unités de requête de conteneur sont disponibles : cqi vaut 1 % de la largeur du conteneur, cqb 1 % de sa hauteur, et cqmin et cqmax respectivement la plus petite et la plus grande de ces dimensions. Un titre avec font-size: clamp(1rem, 6cqi, 2rem) grandit avec la carte, et non avec la fenêtre.

Syntaxe

#
Syntaxe
.parent { container-type: inline-size; container-name: <nom>; }

@container <nom>? (<condition de taille>) {
  sélecteur { propriété: valeur; }
}

Variantes de requêtes

#
  • (width >= 240px)

    le conteneur fait au moins 240 px

    Quand le conteneur fait au moins 240 px de large, l’image se place à côté du texte. Faites glisser le coin inférieur droit du cadre vers la gauche et la carte revient à la disposition verticale.
  • (width < 200px)

    conteneur plus étroit que 200 px

    Dans un conteneur très étroit, la description disparaît et le titre rétrécit. Réduisez le cadre sous 200 px en faisant glisser son coin inférieur droit pour le voir.
  • lesson (width >= 240px)

    le conteneur le plus proche nommé lesson

    Une requête avec un nom ignore les conteneurs portant d’autres noms et cherche l’ancêtre le plus proche nommé lesson. C’est utile quand les conteneurs sont imbriqués et que vous voulez interroger un conteneur précis, par exemple la colonne de la page.
  • cqi

    1 % de la largeur du conteneur

    Une unité de requête de conteneur. Le titre fait 7 % de la largeur du conteneur, il grandit et rétrécit donc avec le cadre, et clamp() le maintient dans des limites raisonnables. Faites glisser le coin du cadre et observez le texte.

Variantes de requêtes en pratique

#

(width >= 240px)

Quand le conteneur fait au moins 240 px de large, l’image se place à côté du texte. Faites glisser le coin inférieur droit du cadre vers la gauche et la carte revient à la disposition verticale.
@container (width >= 240px) {
  .card {
    grid-template-columns: 72px 1fr;
    align-items: center;
  }
}

(width < 200px)

Dans un conteneur très étroit, la description disparaît et le titre rétrécit. Réduisez le cadre sous 200 px en faisant glisser son coin inférieur droit pour le voir.
@container (width < 200px) {
  .meta { display: none; }
  .title { font-size: 14px; }
}

lesson (width >= 240px)

Une requête avec un nom ignore les conteneurs portant d’autres noms et cherche l’ancêtre le plus proche nommé lesson. C’est utile quand les conteneurs sont imbriqués et que vous voulez interroger un conteneur précis, par exemple la colonne de la page.
.demo { container-name: lesson; }

@container lesson (width >= 240px) {
  .card {
    grid-template-columns: 72px 1fr;
    align-items: center;
    background: #1e1b4b;
  }
}

cqi

Une unité de requête de conteneur. Le titre fait 7 % de la largeur du conteneur, il grandit et rétrécit donc avec le cadre, et clamp() le maintient dans des limites raisonnables. Faites glisser le coin du cadre et observez le texte.
.title {
  font-size: clamp(14px, 7cqi, 26px);
}

Plus d’exemples

#
Un conteneur nommé et un titre en unités cqi
CSS
.hero {
  container: hero / inline-size;
}

.hero h2 {
  font-size: clamp(1.1rem, 7cqi, 2.2rem);
}

@container hero (width < 320px) {
  .hero .actions {
    flex-direction: column;
  }
}
Aperçu

Faites glisser le coin inférieur droit du cadre. Le titre s’adapte grâce à l’unité cqi, et quand le conteneur devient plus étroit que 320 px, les boutons s’empilent l’un sous l’autre.

Compatibilité des navigateurs

#

Largement disponible · depuis 2023

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Faites d’un élément dont la largeur découle de la mise en page le conteneur : une colonne de grille, une section ou un emplacement pour un composant. En général, ne marquez pas la carte elle-même comme conteneur, mais son enveloppe.
  • Une règle @container ne stylise que les descendants. Si vous voulez changer l’apparence du conteneur lui-même, ajoutez à l’intérieur un élément enveloppant et stylisez-le.
  • La répartition des rôles est simple : @media pour les décisions concernant toute la page, comme la disposition en colonnes et la navigation, et @container pour les composants utilisés à différents endroits.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.