WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

decoding: eine Präferenz für Bilddekodierung

Trennen Sie Dekodierbereitschaft von Download, verzögertem Laden und Darstellung.

Version: HTML Living Standard

Syntax

<img decoding="async" src="/picture.svg" alt="Blue square">

Das Bildattribut decoding akzeptiert sync, async oder auto. Es empfiehlt, Dekodierung mit der Darstellung anderer Inhalte abzustimmen oder getrennt abzuschließen; fehlende und ungültige Werte bedeuten automatisch. Das ist ein Hinweis, keine Zusage für einen bestimmten Frame oder Thread.

Es ersetzt weder Lazy Loading noch Abrufpriorität oder Bildabmessungen. Um vor dem Einfügen ausdrücklich auf Dekodierung zu warten, verwenden Sie decode() und behandeln eine Ablehnung bei Lade- oder Dekodierfehlern. Das bloße Setzen des Attributs meldet der Anwendung keine fertigen Pixel.

Die Testseite lädt ein lokales Bild, wartet auf erfolgreiche Dekodierung und fügt es erst danach ein. Geprüft werden natürliche Abmessungen und tatsächliches Einfügen. Aus dem Attributwert wird kein garantierter asynchroner Zeichenablauf abgeleitet.

Beispiele

<!doctype html><meta charset="utf-8"><div id="mount"></div><output id="result"></output><script>
const image = new Image(); image.alt = 'Blue square'; image.decoding = 'async'; image.src = '/picture.svg';
image.decode().then(() => {
  document.querySelector('#mount').append(image);
  document.querySelector('#result').textContent = 'decoded=' + (image.naturalWidth === 20) + '; mounted=' + image.isConnected;
});
</script>

Ergebnis

decoded=true; mounted=true

Das Ergebnis belegt Dekodierung und Einfügen dieses Bildes, kein allgemeines Scheduling-Verhalten.

Quellen