@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.
Exemple
#.slot {
container-type: inline-size;
}
.card {
display: grid;
gap: 10px;
}
@container (width >= 240px) {
.card {
grid-template-columns: 96px 1fr;
align-items: center;
}
}<style>
.layout { display: flex; flex-wrap: wrap; align-items: start; gap: 10px; }
.narrow { flex: 0 0 180px; }
.wide { flex: 1 1 260px; }
.card { padding: 10px; border: 1px solid #27272a; border-radius: 12px; background: #18181b; }
.thumb { height: 60px; border-radius: 8px; background: linear-gradient(135deg, #7c3aed, #0ea5e9); }
.card p { margin: 2px 0 0; color: #a1a1aa; font-size: 13px; }
</style>
<div class="layout">
<div class="slot narrow">
<article class="card"><div class="thumb"></div><div><strong>Flexbox</strong><p>Module 7 · 9 leçons</p></div></article>
</div>
<div class="slot wide">
<article class="card"><div class="thumb"></div><div><strong>Flexbox</strong><p>Module 7 · 9 leçons</p></div></article>
</div>
</div>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
#.parent { container-type: inline-size; container-name: <nom>; }
@container <nom>? (<condition de taille>) {
sélecteur { propriété: valeur; }
}Variantes de requêtes
#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.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.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.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, etclamp()le maintient dans des limites raisonnables. Faites glisser le coin du cadre et observez le texte.
Variantes de requêtes en pratique
#(width >= 240px)
@container (width >= 240px) {
.card {
grid-template-columns: 72px 1fr;
align-items: center;
}
}(width < 200px)
@container (width < 200px) {
.meta { display: none; }
.title { font-size: 14px; }
}lesson (width >= 240px)
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
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
#.hero {
container: hero / inline-size;
}
.hero h2 {
font-size: clamp(1.1rem, 7cqi, 2.2rem);
}
@container hero (width < 320px) {
.hero .actions {
flex-direction: column;
}
}<style>
.hero { resize: horizontal; overflow: hidden; width: 100%; min-width: 180px; max-width: 100%; padding: 16px; border: 2px dashed #7c3aed; border-radius: 14px; background: #18181b; }
.hero h2 { margin: 0 0 12px; line-height: 1.15; }
.actions { display: flex; gap: 8px; }
.actions button { padding: 8px 14px; border: 0; border-radius: 8px; background: #7c3aed; color: #fff; font: inherit; }
.actions button + button { background: #3f3f46; }
</style>
<section class="hero">
<h2>Lancez-vous dans le CSS</h2>
<div class="actions"><button type="button">Démarrer</button><button type="button">Programme du cours</button></div>
</section>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
@containerne 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 :
@mediapour les décisions concernant toute la page, comme la disposition en colonnes et la navigation, et@containerpour les composants utilisés à différents endroits.
Entrées associées
#- @mediaN’active des styles que lorsque l’appareil remplit une condition : largeur de fenêtre adaptée, thème sombre, souris ou impression de la page.
- UnitésPanorama des unités de longueur en CSS : des pixels fixes, en passant par em et rem liées à la police, jusqu’aux unités de la fenêtre, du conteneur et de la grille.
- clamp()Maintient une valeur entre un minimum et un maximum, et la laisse croître en douceur entre les deux. La base de la typographie fluide.
- @supportsN’active des styles que dans les navigateurs qui gèrent une propriété, une valeur ou un sélecteur donné, pour utiliser les nouveautés sans risque.
- grid-template-columnsDéfinit les colonnes de la grille : leur nombre et leur largeur.
- container-typeTransforme un élément en conteneur dont les règles @container peuvent interroger la taille. Couvre aussi container-name et le raccourci container.
Pratiquer dans les leçons
#Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.