Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

contain — isolar os efeitos de renderização

A propriedade contain limita as dependências entre um elemento e o resto do documento durante o cálculo dos tamanhos, do esquema, dos estilos e da pintura. Pode permitir otimizações, mas altera o comportamento da renderização.

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

Sintaxe

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

contain estabelece limites específicos de isolamento em torno de uma subárvore. O valor inicial é none; não é herdada nem animável. Não garante uma renderização mais rápida.

size determina os tamanhos intrínsecos como se o elemento estivesse vazio; inline-size fá-lo apenas no eixo em linha, mantendo a influência do conteúdo no eixo de bloco. layout estabelece um contexto de formatação independente. paint recorta a pintura dos descendentes na margem de recorte do overflow. style circunscreve efeitos como operações com contadores, mas não isola seletores nem a herança.

Podes combinar palavras-chave em qualquer ordem, sem as repetir; size e inline-size são mutuamente exclusivas. none, strict e content usam-se isoladamente. No nível 2, strict significa size layout style paint e content significa layout style paint; o nível 1 omite style em ambos os atalhos.

Atenção: layout e paint criam um contexto de empilhamento e um bloco contentor para descendentes com position: absolute e position: fixed. size pode reduzir uma altura automática a zero; define dimensões adequadas ou usa contain-intrinsic-size. Cada tipo de contenção tem restrições de aplicabilidade específicas do tipo de caixa.

O exemplo mostra que size não remove nem recorta o conteúdo: #box tem uma altura de 0px, enquanto #child continua com 40px de altura e extravasa o elemento pai.

Exemplos

<!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>

Resultado

box: 0px; child: 40px

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes