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

CKTIS / CSS

contain — isoler les effets de rendu

La propriété contain limite les dépendances entre un élément et le reste du document lors du calcul des dimensions, de la mise en page, du style et de la peinture. Elle peut permettre des optimisations, mais modifie le comportement du rendu.

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

Syntaxe

contain: none | strict | content | [ [ size | inline-size ] || layout || style || paint ];

contain établit des limites d’isolation précises autour d’un sous-arbre. Sa valeur initiale est none ; elle n’est ni héritée ni animable. Elle ne garantit pas un rendu plus rapide.

size détermine les tailles intrinsèques comme si l’élément était vide ; inline-size ne le fait que sur l’axe en ligne, tout en préservant l’influence du contenu sur l’axe de bloc. layout établit un contexte de mise en forme indépendant. paint découpe la peinture des descendants à la limite de découpage du débordement. style délimite des effets tels que les opérations sur les compteurs, mais n’isole ni les sélecteurs ni l’héritage.

Les mots-clés peuvent être combinés dans n’importe quel ordre, sans répétition ; size et inline-size sont mutuellement exclusifs. none, strict et content s’emploient seuls. Dans le niveau 2, strict signifie size layout style paint, et content signifie layout style paint ; le niveau 1 omet style de ces deux raccourcis.

Attention : layout et paint créent un contexte d’empilement et un bloc conteneur pour les descendants ayant position: absolute et position: fixed. size peut réduire à zéro une hauteur automatique ; indiquez des dimensions appropriées ou utilisez contain-intrinsic-size. Chaque type de containment comporte des restrictions d’applicabilité propres au type de boîte.

L’exemple montre que size ne supprime ni ne découpe le contenu : #box a une hauteur de 0px, tandis que #child mesure toujours 40px de haut et déborde de son parent.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>contain: size</title>
<style>
  #box { contain: size; width: 120px; }
  #child { height: 40px; background: teal; }
</style>
<div id="box"><div id="child"></div></div>
<pre id="result"></pre>
<script>
  const box = document.getElementById('box');
  const child = document.getElementById('child');
  document.getElementById('result').textContent =
    `box: ${box.offsetHeight}px; child: ${child.offsetHeight}px`;
</script>

Résultat

box: 0px; child: 40px

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