SVGImageElement: decode()-Methode

Baseline 2025

Neu verfügbar

Seit March 2025 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.

Die decode()-Methode der SVGImageElement-Schnittstelle initiiert das asynchrone Dekodieren eines Bildes und gibt ein Promise zurück, das aufgelöst wird, sobald das Bild dekodiert ist und es sicher ist, es an das DOM anzufügen.

In diesem Artikel

Syntax

decode()

Parameter

Keine.

Rückgabewert

Ein Promise, das mit undefined erfüllt wird, sobald die Bilddaten bereit sind, verwendet zu werden, zum Beispiel durch Anhängen an das DOM, Ersetzen eines bestehenden Bildes usw.

Ausnahmen

Keine.

Beispiele

Im folgenden Beispiel wird wahrscheinlich ein leeres Bild auf der Seite angezeigt, während das Bild heruntergeladen wird:

js
const SVG_NS = "http://www.w3.org/2000/svg";
const svg = document.querySelector("svg");

const img = document.createElementNS(SVG_NS, "image");
img.src = "img/logo.svg";
svg.appendChild(img);

Die Verwendung von decode() verzögert das Einfügen des Bildes in das DOM, bis es vollständig heruntergeladen und dekodiert ist, wodurch das Problem des leeren Bildes vermieden wird:

js
const SVG_NS = "http://www.w3.org/2000/svg";
const svg = document.querySelector("svg");

async function getImage() {
  const img = document.createElementNS(SVG_NS, "image");
  img.src = "img/logo.svg";
  await img.decode();
  svg.appendChild(img);
  const text = document.createElementNS(SVG_NS, "text");
  text.textContent = "Image is fully loaded!";
  svg.appendChild(text);
}

Dies ist besonders nützlich, wenn Sie dynamisch ein bestehendes Bild durch ein neues ersetzen, und verhindert auch, dass nicht zusammenhängende Wiedergaben außerhalb dieses Codes aufgehalten werden, während das Bild dekodiert wird.

HTMLImageElement.decode(): Dasselbe, aber für HTML-<img>-Elemente
What does the image decoding attribute actually do? auf tunetheweb.com (2023)

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden