CKTIS / JavaScript
Natürliche Bildabmessungen und der Zustand `complete`
Lies die natürlichen Bildabmessungen in CSS-Pixeln aus und unterscheide den Abschluss einer Anfrage vom erfolgreichen Laden oder Dekodieren.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
img.naturalWidth // number: natural width
img.naturalHeight // number: natural height
img.complete // boolean: completion state, not successnaturalWidth und naturalHeight sind schreibgeschützte Eigenschaften von HTMLImageElement. Sie geben die natürliche Breite und Höhe des aktuellen Bildes als Ganzzahlen in CSS-Pixeln an. Die Pixeldichte der ausgewählten Ressource und die Ausrichtung aus den Metadaten fließen ein. Daher können die Werte von den in der Datei gespeicherten Abmessungen abweichen. width und height beschreiben bei einem gerenderten Element dagegen seine Größe auf der Seite.
Solange die Abmessungen des aktuellen Bildes nicht verfügbar sind, liefern beide natürlichen Maße 0. Die Maße können schon vor Ende des Downloads feststehen; positive Werte belegen daher weder das vollständige Laden noch das Dekodieren. Prüfe vor der Berechnung von img.naturalWidth / img.naturalHeight, ob beide Maße positiv sind.
complete ist eine schreibgeschützte boolesche Eigenschaft. Sie ist true, wenn src und srcset fehlen oder wenn src leer ist und srcset fehlt. Sie ist auch true, wenn das Bild aus der aktuellen Anfrage vollständig verfügbar ist oder die Anfrage fehlgeschlagen ist und keine Ersatzanfrage aussteht. Andernfalls ist sie false. Das ist eine Momentaufnahme, kein Erfolgsnachweis.
Registriere die Handler für load und error, bevor du src setzt, um Erfolg und Fehler zu unterscheiden. Wenn du ein dekodiertes Bild brauchst, verwende nach dem Setzen der Quelle await img.decode() und behandle eine mögliche Ablehnung des Promise. Diese Web-APIs gehören zur Browserplattform, nicht zum ECMAScript-Kern.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Natural image dimensions and completion</title>
</head>
<body>
<script>
(async () => {
function report(label, img) {
console.log(`${label}: ${img.complete} ${img.naturalWidth} ${img.naturalHeight}`);
}
async function inspect(src) {
const img = new Image();
const eventType = await new Promise((resolve) => {
img.onload = img.onerror = (event) => resolve(event.type);
img.src = src;
});
report(eventType, img);
}
const svg = '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="16"><rect width="24" height="16"/></svg>';
report('no source', new Image());
await inspect('data:image/svg+xml,' + encodeURIComponent(svg));
await inspect('data:image/svg+xml,not-an-svg');
})();
</script>
</body>
</html>Ergebnis
no source: true 0 0 load: true 24 16 error: true 0 0
Die drei Zeilen zeigen ein Bild ohne Quelle, ein gültiges SVG mit 24 × 16 und ein ungültiges SVG. In allen Fällen ist `complete` gleich `true`. Öffne die HTML-Datei in einem Browser, der `data:`-Bilder zulässt und Bilder lädt, und prüfe die Ausgabe in der Entwicklerkonsole.
Zugehörige Lektionen
- JavaScript · Lektion 33 · Fortgeschritten · Version: 4