Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
will-change
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since janeiro de 2020.
Sumário
A propriedadewill-change doCSS fornece um modo dos autores dizerem aos navegadores sobre que tipo de mudanças devem ser esperadas no elemento, então o navegador pode fazer as otimizações apropriadas com antecedência, antes do elemento ser efetivamente modificado.
Esses tipos de otimizações podem aumentar a capacidade de resposta de uma página, fazendo o trabalho potencialmente caro antes do tempo antes que eles são realmente necessários.
O uso adequado dessa propriedade pode ser um pouco complicado:
- Não aplique will-change em muitos elementos. O navegador já tenta ao máximo otimizar tudo. Algumas das otimizações mais fortes que podem utilizar o
will-changeacabam usando muitos recursos da máquina, e quando utilizados em demasia como neste caso, pode fazer a página para retardar o carregamento ou consumir uma grande quantidade de recursos. - Use com moderação. O comportamento normal do navegador para otimizações é fazê-las e depois voltar ao normal. Mas adicionando
will-changediretamente no estilo, implica que o elemento alvo está sempre alguns momentos antes da mudança, e o navegador irá manter as otimizações por muito mais tempo do que teria de outra forma. Então é uma boa prática colocar e retirar owill-changeusando script antes e depois da mudança ocorrer. - Não aplicar will-change em elementos para realizar a otimização prematura. Se sua página está performando bem, não adicione a propriedade
will-changenos elementos apenas para trazer mais velocidade.will-changeé entendido como algo para ser usado como último recurso, com o intuito de tentar solucionar problemas de performance . Ele não deve ser usado para antecipar esses possíveis problemas. O uso excessivo dowill-changepoderá resultar em excessivo uso de memória e causar uma renderização mais complexa enquanto o browser tenta se preparar para uma possível mudança. Isso levará a um pior desempenho. - Dê tempo suficiente para trabalhar. Essa propriedade destina-se como um método para os autores dizerem ao agente do browser sobre como mudarão as properiedades antes disso acontecer. Então o navegador pode escolher como aplicar qualquer otimização requisitada na propriedade antes do tempo da ação acontecer. Isso é importante para dar ao navegador algum tempo para fazer as otimizações. Identifique um jeito de prever as mudanças, e use a proiedade
will-changepra isso.
| Initial value | auto |
|---|---|
| Aplica-se a | all elements |
| Inherited | não |
| Computed value | as specified |
| Animation type | discrete |
In this article
Sintaxe
/* Valores chave */will-change: auto;will-change: scroll-position;will-change: contents;will-change: transform; /* Exemplo de <custom-ident> */will-change: opacity; /* Exemplo de <custom-ident> */will-change: left, top; /* Exemplo de dois <animateable-feature> *//* Valores globais */will-change: inherit;will-change: initial;will-change: unset;Valores
autoEssa palavra chave não expressa nenhuma intenção em particular; ouser agent deve aplicar qualquer otimização como normalmente ocorre.
O<animateable-feature> pode ser um dos seguintes valores:
scroll-positionIndica que o autor espera que haja uma animação ou mudança na posição do scroll do elemento no futuro.
contentsIndica que o autor espera que haja uma animação ou mudança no conteúdo do elemento no futuro.
<custom-ident>Indica que o autor espera que haja uma animação ou mudança na propriedade com o nome dado no elemento no futuro. Isso não pode ser um dos seguintes valores:
unset,initial,inherit,will-change,auto,scroll-position, orcontents. A especificação não define o comportamento de um valor em particular, mas é comum protransformser uma camada de composição. OChrome atualmente toma duas ações, dadas as propriedades particulares do CSS: estabelece uma nova camada de composição ou um novostacking context.
Sintaxe formal
will-change =
auto|
<animateable-feature>#
<animateable-feature> =
scroll-position|
contents|
<custom-ident>
Exemplos
.sidebar { will-change: transform;}O exemplo acima adiciona a propriedadewill-change diretamente no estilo, o que irá fazer com que o navegador mantenha a otimização em memória por muito mais tempo que o necessário e nós já vimos que isso deve ser evitado. Abaixo outro exemplo mostrando como aplicar owill-change através de script, o que provavelmente é o que você deve fazer na maioria dos casos.
var el = document.getElementById("element");// Set will-change quando ocorre hover no elementoel.addEventListener("mouseenter", hintBrowser);el.addEventListener("animationEnd", removeHint);function hintBrowser() { // As propriedades otimizáveis que vão mudar no bloco de animações this.style.willChange = "transform, opacity";}function removeHint() { this.style.willChange = "auto";}Entretanto pode ser apropriado incluirwill-change no seu estilo css para uma aplicação que fazpage flips quando uma tecla é pressionada como um álbum ou uma apresentação de slides, onde a página é grande e complexa. Isso irá dizer ao navegador para preparar a transição à frente do tempo e aceitar transições entre as páginas assim que a tecla for pressionada.
.slide { will-change: transform;}Especificações
| Specification |
|---|
| CSS Will Change Module Level 1> # will-change> |