Requête de conteneur

A container query applies CSS based on the size of a parent container, not the whole screen, so a component adapts to wherever it is placed.
Design
Created on
23.08.2026

Résumer avec

Une requête de conteneur applique des styles en fonction de la taille d'un conteneur parent, et non de tout le viewport. Elle permet à un composant de s'adapter à l'espace où il se trouve réellement, si bien que la même carte s'affiche correctement dans une large colonne principale comme dans une barre latérale étroite. C'est la pièce qui manquait au responsive design pour de vraies mises en page par composants.

Comment fonctionne une requête de conteneur

On désigne un élément comme conteneur de requête, puis on écrit des règles sur sa largeur.

  • Déclarer le conteneur : .card-wrap { container-type: inline-size; }
  • L'interroger : @container (min-width: 400px) { .card { display: flex; } }
  • Le nommer au besoin avec container-name pour cibler un ancêtre précis.

Requête de conteneur ou media query

Les deux appliquent des styles conditionnels, mais mesurent des choses différentes.

CritèreMedia queryRequête de conteneur
MesureLe viewport (tout l'écran)Un conteneur parent
Idéal pourLa mise en page globaleLes composants réutilisables
RéutilisabilitéLiée à la taille d'écranFonctionne partout où on le place

Les unités de requête de conteneur

En plus des règles, des unités dimensionnent selon le conteneur : cqw (1 % de sa largeur), cqh (hauteur), et cqi / cqb (taille inline et block). Elles laissent le texte et l'espacement s'adapter au composant plutôt qu'à l'écran.

Pourquoi c'est important pour les design systems

Dans un système par composants, la même carte, liste ou objet média est placé dans de nombreuses mises en page. Les media queries ne savent pas quelle largeur fait ce créneau ; les requêtes de conteneur, si. Cela rend les composants vraiment autonomes, et c'est pourquoi les design systems les ont adoptées vite.

Compatibilité et bonnes pratiques

Les requêtes de conteneur sont prises en charge par tous les navigateurs modernes. Déclarez le conteneur sur un wrapper plutôt que sur le composant lui-même pour qu'il reste réutilisable, et gardez les media queries pour la structure de la page tout en utilisant les requêtes de conteneur pour les éléments à l'intérieur.

Les requêtes de conteneur chez BeBranded

Chez BeBranded, nous construisons des composants qui s'adaptent à leur créneau avec les requêtes de conteneur, pour qu'une carte se comporte correctement où qu'elle se trouve. Cela fait partie du front-end systématique et orienté composants de notre travail de design.

FAQ

Une requête de conteneur applique du CSS selon la taille d'un conteneur parent au lieu du viewport, si bien qu'un composant s'adapte à l'espace où il se trouve plutôt qu'à tout l'écran.
Une media query réagit à la taille du viewport, une requête de conteneur à un parent. Les media queries conviennent à la mise en page de la page ; les requêtes de conteneur aux composants réutilisables.
Définissez container-type: inline-size sur un wrapper, puis écrivez @container (min-width: 400px) { ... }. Les règles s'appliquent selon la largeur de ce conteneur, pas de l'écran.
Des unités comme cqw, cqh, cqi et cqb dimensionnent selon le conteneur : cqw vaut 1 % de sa largeur. Elles laissent le texte et l'espacement s'adapter au composant plutôt qu'au viewport.
Oui. Elles sont prises en charge par tous les navigateurs modernes, elles sont donc sûres à utiliser sur les projets actuels, avec un repli progressif pour les très anciens.
Utilisez une requête de conteneur pour un composant réutilisable qui peut apparaître à différentes largeurs, et une media query pour la mise en page globale. Elles se complètent.

Prêt à booster vos conversions ?

Notre équipe est là pour comprendre vos besoins et travailler avec vous pour créer vos prochains projets.
Recevez des news et des ressources.
Des conseils pratiques directement dans votre boîte mail.
Merci ! Votre demande a bien été reçue.
Oups ! Une erreur est survenue lors de l'envoi du formulaire.