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.