Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

will-change — anticiper les changements de rendu

La propriété `will-change` avertit le navigateur de changements à venir. Elle ne lance pas d’animations et ne garantit pas un rendu plus rapide.

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

Syntaxe

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

will-change est une indication destinée au rendu. Sa valeur initiale auto laisse les optimisations habituelles en place. La propriété n’est ni héritée ni animable.

Une liste séparée par des virgules accepte scroll-position (défilement), contents (contenu) ou des noms de propriétés tels que transform, opacity. Un nom non reconnu n’est ignoré sans effet sur le reste de la liste que s’il s’agit d’un identifiant valide pour will-change. Indiquer une propriété personnalisée n’a pas non plus d’effet. none n’est pas un identifiant autorisé ici : toute la déclaration will-change: opacity, none est invalide et même l’indication relative à opacity n’est pas prise en compte.

Utilisez cette indication avec parcimonie et à l’avance ; rétablissez ensuite auto. Un usage excessif peut consommer des ressources. La création d’une couche GPU n’est pas garantie.

L’indication peut modifier la composition des couches : will-change: opacity crée un contexte d’empilement même avec opacity: 1. Lorsque la propriété indiquée l’exige, des blocs conteneurs sont également créés pour les éléments positionnés de façon absolue ou fixe.

Exemples

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

Résultat

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

Un clic sur `Prepare` définit l’indication relative à `opacity`, mais laisse l’opacité à `1`. Un clic sur `Change` fixe l’opacité à `0.5` et rétablit `will-change: auto`.

Sources