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

CKTIS / CSS

will-change — antecipar alterações de apresentação

A propriedade `will-change` avisa o navegador sobre alterações futuras. Não inicia animações nem garante uma apresentação mais rápida.

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

Sintaxe

will-change: auto | <animateable-feature>#;
<animateable-feature> = scroll-position | contents | <custom-ident>

will-change é uma indicação para a apresentação. O valor inicial auto mantém as otimizações habituais. A propriedade não é herdada nem animável.

Uma lista separada por vírgulas aceita scroll-position (deslocação), contents (conteúdo) ou nomes de propriedades como transform, opacity. Um nome não reconhecido só é ignorado sem afetar os restantes itens da lista se for um identificador válido para will-change. Indicar uma propriedade personalizada também não produz efeito. none não é um identificador permitido neste contexto: a declaração will-change: opacity, none é inválida na íntegra e nem sequer define a indicação relativa a opacity.

Utilize a indicação com moderação e com antecedência; depois, restaure auto. O uso excessivo pode consumir recursos. Não é garantida a criação de uma camada GPU.

A indicação pode alterar a organização das camadas: will-change: opacity cria um contexto de empilhamento mesmo com opacity: 1. Quando a propriedade indicada o exige, também são criados blocos contentores para elementos com posicionamento absoluto ou fixo.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>will-change</title>
<style>
  #tile { padding: 1rem; background: navy; color: white; }
</style>
<button id="prepare" type="button">1. Prepare</button>
<button id="change" type="button">2. Change</button>
<button id="reset" type="button">Reset</button>
<p id="tile">will-change</p>
<pre id="status"></pre>
<script>
  const tile = document.querySelector('#tile');
  const status = document.querySelector('#status');

  function report() {
    const style = getComputedStyle(tile);
    status.textContent = `${style.willChange} | ${style.opacity}`;
  }

  document.querySelector('#prepare').addEventListener('click', () => {
    tile.style.willChange = 'opacity';
    report();
  });

  document.querySelector('#change').addEventListener('click', () => {
    tile.style.opacity = '0.5';
    tile.style.willChange = 'auto';
    report();
  });

  document.querySelector('#reset').addEventListener('click', () => {
    tile.style.opacity = '1';
    tile.style.willChange = 'auto';
    report();
  });

  report();
</script>
</html>

Resultado

Initial: auto | 1
After Prepare: opacity | 1
After Change: auto | 0.5
After Reset: auto | 1

Ao clicar em `Prepare`, é definida a indicação relativa a `opacity`, mas a opacidade mantém-se em `1`. Ao clicar em `Change`, a opacidade passa para `0.5` e é reposto `will-change: auto`.

Fontes