Requêtes de conteneur CSS en 2026 : Créez des composants réactifs sans points de rupture de fenêtre d'affichage
Découvrez comment les requêtes de conteneur CSS permettent aux composants réactifs de s'adapter à leur espace disponible plutôt qu'à la fenêtre d'affichage du navigateur. Créez des cartes réutilisables, utilisez des conteneurs nommés et des unités de conteneur, et évitez les pièges courants de mise en page et de compatibilité.
Les requêtes de conteneur CSS en 2026 : Créer des composants responsifs sans points de rupture de viewport
Le design web responsif s'est traditionnellement appuyé sur les requêtes média. Les développeurs choisissent des points de rupture de viewport et ajustent les mises en page pour les téléphones, tablettes et ordinateurs de bureau. Cela fonctionne toujours bien pour les mises en page de niveau page, mais les composants modernes apparaissent souvent dans de nombreux contextes : sections pleine largeur, barres latérales étroites, tableaux de bord, modales et grilles.
Une carte sur un bureau de 1 440 pixels de large peut ne disposer que de 280 pixels disponibles à l'intérieur d'une barre latérale. Un point de rupture de viewport ne peut pas décrire de manière fiable l'espace de ce composant.
Les requêtes de conteneur CSS permettent aux composants de répondre à la taille d'un ancêtre éligible plutôt qu'au seul viewport. Cela les rend particulièrement utiles dans les systèmes de conception réutilisables, les thèmes de blocs WordPress, les modules Joomla et les constructeurs de pages.
Qu'est-ce que les requêtes de conteneur CSS ?
Une requête de conteneur de taille évalue les dimensions d'un conteneur ancêtre désigné. Un composant peut modifier sa mise en page interne lorsque l'espace qui lui est disponible franchit un seuil.
Par exemple, une carte pourrait afficher son image au-dessus de son texte lorsqu'elle est étroite, mais déplacer l'image à côté du texte lorsque son conteneur fait au moins 480 pixels de large.
Les requêtes média restent utiles pour la navigation de page entière et les préférences d'appareil. Les requêtes de conteneur résolvent le problème distinct de la responsivité au niveau du composant.
Requêtes média vs. requêtes de conteneur : comparaison visuelle et démo en direct
L'illustration compare les deux approches. Déplacez le curseur pour modifier la largeur disponible de la carte. La démonstration utilise une véritable requête de conteneur de taille CSS, et non un commutateur de mise en page contrôlé par JavaScript.
Media queries vs. container queries
Responds to browser viewport width.
Responds to available component space.
Try the 480px container breakpoint
A reusable card that adapts to the space available.
Read the guideHorizontal layout at 520px
Move the slider to change the container width. The card switches layout at 480px. On narrow screens the maximum width is limited to the available space.
Le point de rupture appartient à la conception du composant plutôt qu'à une catégorie d'appareil particulière. Sur un écran de téléphone étroit, la démo limite le conteneur à la largeur de viewport disponible.
Étape 1 : Construire une carte sémantique
Commencez par une carte qui pourrait apparaître dans une liste d'articles, une recommandation de produit ou un index de documentation :
<div class="card-container">
<article class="content-card">
<img class="content-card__image"
src="/images/example.webp"
alt="A laptop on a desk"
width="640" height="400">
<div class="content-card__body">
<h2>Building Better Web Components</h2>
<p>Learn how modern CSS makes layouts more reusable.</p>
<a href="/guide">Read the guide</a>
</div>
</article>
</div>
L'élément externe deviendra le conteneur de requête. L'article interne est le descendant dont la présentation change.
Cette distinction est importante : une requête de conteneur de taille ne met pas l'élément interrogé lui-même en forme. Elle évalue un conteneur ancêtre et met en forme les descendants correspondants.
Étape 2 : Écrire une mise en page par défaut robuste
Commencez par une mise en page qui reste utilisable sans requêtes de conteneur :
.card-container {
width: 100%;
}
.content-card {
display: grid;
grid-template-columns: minmax(0, 1fr);
gap: 1rem;
padding: 1rem;
border: 1px solid #d9dee5;
border-radius: 12px;
background: #fff;
}
.content-card__image {
display: block;
width: 100%;
height: auto;
aspect-ratio: 8 / 5;
object-fit: cover;
border-radius: 8px;
}
.content-card__body {
min-width: 0;
}
La mise en page par défaut image-au-dessus-du-texte fonctionne dans les espaces étroits. La piste de grille minmax(0, 1fr) et min-width: 0 réduisent le risque de débordement du contenu long.
Étape 3 : Déclarer le conteneur de requête
Utilisez la propriété container-type :
.card-container {
container-type: inline-size;
}
La valeur inline-size active les requêtes de taille le long de l'axe en ligne, qui correspond généralement à la largeur dans les modes d'écriture horizontaux.
Vous pouvez également rencontrer :
.card-container {
container-type: size;
}
La valeur size prend en charge les deux axes mais introduit des exigences de containment plus fortes. Pour la plupart des cartes responsives, inline-size est une valeur par défaut plus pratique.
Le containment est important car les navigateurs doivent être capables de calculer la taille du conteneur sans dépendances circulaires avec les styles des descendants.
Étape 4 : Ajouter la règle responsive
Modifiez maintenant la mise en page interne uniquement lorsque le conteneur ancêtre est suffisamment large :

@container (min-width: 480px) {
.content-card {
grid-template-columns: 180px minmax(0, 1fr);
align-items: center;
}
.content-card__image {
height: 100%;
}
}
Une barre latérale de bureau large mais ne faisant que 300 pixels de large conserve la mise en page empilée. Une carte dans une colonne de contenu de 600 pixels devient horizontale, même si le viewport n'est pas particulièrement large.
C'est l'avantage central : le composant répond à son propre espace disponible.
Étape 5 : Utiliser des conteneurs nommés pour les mises en page complexes
Dans un modèle de tableau de bord ou de CMS, un composant peut avoir plusieurs conteneurs imbriqués. Par défaut, une requête de taille trouve l'ancêtre éligible le plus proche.
Nommez le conteneur visé lorsque vous avez besoin de plus de contrôle :
.article-list-item {
container: article-card / inline-size;
}
@container article-card (min-width: 480px) {
.content-card {
grid-template-columns: 180px minmax(0, 1fr);
}
}
L'abréviation container définit à la fois le nom et le type. Le nommage aide à empêcher un conteneur imbriqué sans rapport de devenir la cible de la requête.
Étape 6 : Utiliser les unités relatives au conteneur
CSS inclut des unités de longueur basées sur un conteneur de requête éligible :
| Unité | Signification |
|---|---|
cqw |
1 % de la largeur du conteneur |
cqh |
1 % de la hauteur du conteneur |
cqi |
1 % de la taille en ligne du conteneur |
cqb |
1 % de la taille de bloc du conteneur |
cqmin |
La plus petite de cqi et cqb |
cqmax |
La plus grande de cqi et cqb |
Pour la typographie fluide des composants :
.card-container {
container: article-card / inline-size;
}
.content-card h2 {
font-size: clamp(1.1rem, 4cqi, 1.8rem);
}
Contrairement à vw, cqi peut adapter le texte au conteneur du composant. Testez toujours la lisibilité, le zoom du navigateur et les longs titres traduits. Si aucun conteneur éligible n'existe, les unités relatives au conteneur suivent le comportement de repli spécifié plutôt que de devenir invalides.
Étape 7 : Ajouter une amélioration progressive
Conservez la mise en page empilée par défaut et activez conditionnellement le comportement plus avancé :
.content-card {
display: grid;
grid-template-columns: 1fr;
}
@supports (container-type: inline-size) {
.card-container {
container-type: inline-size;
}
@container (min-width: 480px) {
.content-card {
grid-template-columns: 180px minmax(0, 1fr);
}
}
}
Les navigateurs ne disposant pas de la fonctionnalité concernée conservent une mise en page fonctionnelle. Le repli n'a pas besoin de correspondre à chaque amélioration ; il doit rester lisible et utilisable.
Les requêtes de conteneur ne remplacent pas Grid ni Flexbox
Grid et Flexbox organisent les éléments. Les requêtes de conteneur déterminent quand certaines règles CSS doivent s'appliquer.
Par exemple, une collection responsivede cartes peut n'avoir besoin que de Grid :
.product-grid {
display: grid;
grid-template-columns:
repeat(auto-fit, minmax(min(100%, 240px), 1fr));
gap: 1.5rem;
}
Ajoutez des requêtes de conteneur lorsque la conception interne de chaque carte doit changer en fonction de sa largeur assignée. Évitez d'introduire des conteneurs de requête là où Grid ou Flexbox standard résout déjà le problème.
Et les requêtes de style de conteneur ?
Les requêtes de conteneur peuvent également tester certaines conditions de style calculé, y compris les propriétés personnalisées dans les navigateurs les prenant en charge :
.feature-panel {
--panel-theme: dark;
}
@container style(--panel-theme: dark) {
.feature-panel__title {
color: white;
}
}
Ceci illustre la syntaxe ; les requêtes de style et les nouvelles fonctionnalités de requête ont des détails de support navigateur distincts. Le support des requêtes de taille ne garantit pas le support de chaque requête de style, propriété ou fonctionnalité d'état de défilement plus récente. Vérifiez la fonctionnalité exacte par rapport aux tables de compatibilité actuelles avant le déploiement en production.
Cinq erreurs courantes
1. Interroger la taille propre d'un élément pour se mettre en forme soi-même

Cela ne fonctionne pas comme prévu :
.card {
container-type: inline-size;
}
@container (min-width: 480px) {
.card {
display: grid;
}
}
Le conteneur interrogé doit être un ancêtre de l'élément mis en forme. Introduisez un élément englobant externe ou déplacez le containment vers un ancêtre approprié.
2. Oublier de déclarer un conteneur
Une règle @container seule ne fait pas automatiquement du parent le plus proche un conteneur de taille éligible. Déclarez container-type: inline-size ou utilisez l'abréviation correspondante.
3. Réutiliser aveuglément les points de rupture de viewport
N'utilisez pas automatiquement 768 px ou 1024 px simplement parce que ces nombres sont familiers. Choisissez un point de rupture où le contenu du composant a réellement besoin d'un agencement différent.
4. Appliquer le containment partout
Le containment modifie le comportement de dimensionnement. Trop de conteneurs peuvent compliquer le débogage, en particulier lorsqu'un élément dépend des descendants pour ses dimensions. Établissez des conteneurs intentionnellement.
5. Partir du principe que chaque fonctionnalité de requête de conteneur est également supportée
Les requêtes de taille, les requêtes de style et les nouvelles capacités ont des historiques de compatibilité différents. Vérifiez la syntaxe exacte que vous prévoyez de déployer.
Considérations de performance
Les requêtes de conteneur s'exécutent dans le moteur CSS/mise en page du navigateur. Elles peuvent éliminer certains observateurs de redimensionnement basés sur JavaScript et les mesures manuelles du DOM.
Cette simplification architecturale est utile, mais les requêtes de conteneur ne garantissent pas un site web plus rapide. Le coût de rendu dépend de la feuille de style, de la complexité du DOM, de la structure de mise en page et des choix de containment.
Mesurez les performances et évitez les couches de requêtes inutiles.
Applications pratiques dans WordPress et Joomla
Thèmes de blocs WordPress : Le même bloc peut apparaître dans une section pleine largeur, une colonne étroite ou une barre latérale. Les requêtes de conteneur permettent au bloc de s'adapter sans variantes distinctes pour bureau et mobile.
Modèles et modules Joomla : Un module peut être assigné à différentes positions de modèle. Une mise en page basée sur des composants peut s'adapter à la largeur réelle du module au lieu de deviner à partir du viewport.
Constructeurs de pages : Les éditeurs déplacent fréquemment des composants entre colonnes imbriquées. Les règles basées sur les conteneurs peuvent rendre ces composants plus résilients aux changements de mise en page.
Tableaux de bord : Les panneaux et widgets redimensionnables peuvent ajuster leurs mises en page internes à mesure que l'espace disponible change.
Quand devez-vous encore utiliser les requêtes média ?
Les requêtes média restent appropriées pour la navigation dépendante du viewport, les styles d'impression, les préférences de réduction du mouvement, les capacités de pointeur et autres caractéristiques utilisateur/appareil.
Une directive utile est requêtes média pour la page ; requêtes de conteneur pour le composant. Ce n'est pas une règle absolue, mais c'est une manière claire de diviser les responsabilités.
Comment tester les requêtes de conteneur
Testez le même composant dans une zone de contenu large, une barre latérale étroite, une grille et une modale. Redimensionnez le conteneur, et pas seulement la fenêtre du navigateur.
Vérifiez le débordement horizontal, la distorsion des images, les longs titres, le zoom du navigateur, le contenu traduit et les modes d'écriture de droite à gauche le cas échéant.
Utilisez les outils de développement des navigateurs pour inspecter les propriétés de conteneur calculées et confirmer quelles règles s'appliquent. Testez sur des appareils étroits réels ainsi que sur des simulations de bureau.
Conclusion
Les requêtes de conteneur CSS remédient à une limitation de longue date du design responsif basé sur le viewport : l'espace disponible d'un composant ne correspond pas nécessairement à la largeur du navigateur.
En combinant des conteneurs de taille avec Grid, Flexbox et des replis sensés, les développeurs peuvent créer des composants réutilisables qui s'adaptent naturellement entre thèmes, modules, constructeurs de pages et applications.
Commencez par une mise en page par défaut fonctionnelle, déclarez uniquement des conteneurs significatifs, choisissez des points de rupture basés sur le contenu et testez dans plusieurs contextes.
Le design responsif ne concerne plus seulement la taille de l'écran. Il concerne également l'espace disponible pour chaque composant.