CKTIS / JavaScript
Přirozené rozměry obrázku a stav `complete`
Zjisti přirozené rozměry obrázku v pixelech CSS a rozlišuj dokončení požadavku od úspěšného načtení nebo dekódování.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
img.naturalWidth // number: natural width
img.naturalHeight // number: natural height
img.complete // boolean: completion state, not successnaturalWidth a naturalHeight jsou vlastnosti objektu HTMLImageElement pouze pro čtení. Vrací přirozenou šířku a výšku aktuálního obrázku jako celá čísla v pixelech CSS. Zohledňují hustotu pixelů vybraného zdroje i orientaci z metadat, takže se mohou lišit od rozměrů uložených v souboru. U vykresleného prvku naproti tomu width a height popisují jeho rozměry na stránce.
Pokud rozměry aktuálního obrázku ještě nejsou k dispozici, obě vlastnosti vracejí 0. Rozměry mohou být známé před koncem stahování, takže kladné hodnoty nedokazují, že je celý obrázek načtený nebo dekódovaný. Před výpočtem img.naturalWidth / img.naturalHeight ověř, že jsou oba rozměry kladné.
complete je booleovská vlastnost pouze pro čtení. Má hodnotu true, pokud chybí src i srcset nebo pokud je src prázdné a srcset chybí. Hodnotu true má také tehdy, je-li obrázek z aktuálního požadavku plně dostupný nebo požadavek selhal a zároveň žádný náhradní požadavek nečeká na vyřízení. Jinak vrací false. Popisuje stav v okamžiku čtení, nikoli úspěch načtení.
Před nastavením src zaregistruj obsluhu událostí load a error, abys rozlišil úspěch od chyby. Pokud potřebuješ dekódovaný obrázek, po nastavení zdroje použij await img.decode() a ošetři zamítnutí příslibu. Jde o webová API prohlížeče, nikoli o součást jádra ECMAScriptu.
Příklady
<!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>Výsledek
no source: true 0 0 load: true 24 16 error: true 0 0
Tři řádky ukazují obrázek bez zdroje, platný SVG o rozměrech 24 × 16 a neplatný SVG. Ve všech případech má `complete` hodnotu `true`. Otevři soubor HTML v prohlížeči, který povoluje obrázky s URL `data:` a má zapnuté načítání obrázků. Výstup najdeš ve vývojářské konzoli.
Související lekce
- JavaScript · Lekce 33 · Pokročilá · Verze: 4