WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

will-change — Rendering-Änderungen ankündigen

Die Eigenschaft `will-change` weist den Browser auf bevorstehende Änderungen hin. Sie startet weder Animationen noch garantiert sie schnelleres Rendering.

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

Syntax

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

will-change ist ein Rendering-Hinweis. Der Anfangswert auto lässt die üblichen Optimierungen unverändert. Die Eigenschaft wird weder vererbt noch ist sie animierbar.

Eine durch Kommas getrennte Liste akzeptiert scroll-position (Scrollen), contents (Inhalt) oder Eigenschaftsnamen wie transform, opacity. Ein unbekannter Name wird nur dann ignoriert, ohne die übrigen Listeneinträge zu beeinflussen, wenn er ein gültiger Bezeichner für will-change ist. Auch die Angabe einer benutzerdefinierten Eigenschaft hat keine Wirkung. none ist hier kein zulässiger Bezeichner: Die gesamte Deklaration will-change: opacity, none ist ungültig und setzt auch den Hinweis auf opacity nicht.

Verwende den Hinweis sparsam und rechtzeitig; setze danach wieder auto. Übermäßiger Gebrauch kann Ressourcen beanspruchen. Eine GPU-Ebene ist nicht garantiert.

Der Hinweis kann die Ebenenbildung verändern: will-change: opacity erzeugt auch bei opacity: 1 einen Stacking-Kontext. Wenn die angegebene Eigenschaft es erfordert, entstehen außerdem Containing Blocks für absolut oder fix positionierte Elemente.

Beispiele

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

Ergebnis

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

Ein Klick auf `Prepare` setzt den Hinweis auf `opacity`, lässt die Deckkraft aber bei `1`. Ein Klick auf `Change` setzt die Deckkraft auf `0.5` und stellt `will-change: auto` wieder her.

Quellen