contain

Baseline 2023

Newly available

Since February 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Experimental: Esta é uma tecnologia experimental (en-US)
Verifique a tabela de compatibilidade entre Navegadores cuidadosamente antes de usar essa funcionalidade em produção.

A propriedade contain permite que um autor indique que elemento e seus conteúdos são, na medida do possível, independente do resto da árvore do documento. Isso permite que o navegador recalcule o layout, estilo, pintura, tamanho ou alguma combinação deles para uma área limitada do DOM e não da página inteira.

css

/* Sem contenção de layout. */
contain: none;

/* Ativa a contenção para layout, estilo, pintura, e tamanho. */
contain: strict;

/* Ativa a contenção para layout, estilo, e pintura. */
contain: content;

/* Ativa a contenção para um elemento. */
contain: size;

/* Ativa a contenção de layout para um elemento. */
contain: layout;

/* Ativa a contenção de estilo para um elemento. */
contain: style;

/* Ativa a contenção de pintura para um elemento. */
contain: paint;

Esta propriedade é útil em páginas que contêm um monte de widgets que são todos independentes, uma vez que pode ser usado para impedir que as regras CSS de um widget mude outras coisas na página.

Initial value	`none`
Aplica-se a	all elements
Inherited	não
Computed value	as specified
Animation type (en-US)	Not animatable

Sintaxe

Valores

none: Indica que o elemento processa como normal, sem contenção aplicada.
strict: Indica que todas as regras de contenção são aplicadas ao elemento. Isso equivale acontain: size layout style paint.
content: Indica que todas as regras de contenção, exceto size são aplicadas ao elemento. Isso equivale a contain: layout style paint.
size: Indica que o elemento pode ser dimensionado sem a necessidade de examinar seus dependentes para alterações de tamanho.
layout: Indica que nada fora do elemento pode afetar seu layout interno e vice-versa.
style: Indica que, para propriedades que podem ter efeitos em mais do que apenas um elemento e seus descendentes, esses efeitos não escape o elemento que contém.
paint: Indica que os descendentes do elemento não são exibidos fora de seus limites. Se um elemento estiver fora da tela ou de outra forma não visível, seus descendentes também são garantidos para não ser visível.

Sintaxe Formal

contain = 
  none                                  | (en-US)
  strict                                | (en-US)
  content                               | (en-US)
  [ (en-US) size || (en-US) layout || (en-US) style || (en-US) paint ] (en-US)

Especificações

Specification
CSS Containment Module Level 2 # contain-property

Compatibilidade com navegadores

BCD tables only load in the browser