CKTIS / JavaScript
Prirodzené rozmery obrázka a stav `complete`
Zisti prirodzené rozmery obrázka v pixeloch CSS a rozlíš dokončenie požiadavky od úspešného načítania alebo dekódovania.
Verzia: 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 a naturalHeight sú vlastnosti objektu HTMLImageElement určené iba na čítanie. Vracajú prirodzenú šírku a výšku aktuálneho obrázka ako celé čísla v pixeloch CSS. Zohľadňujú hustotu pixelov vybraného zdroja a orientáciu z metadát, takže sa môžu líšiť od rozmerov uložených v súbore. Pri vykreslenom prvku naopak width a height opisujú jeho veľkosť na stránke.
Ak rozmery aktuálneho obrázka ešte nie sú dostupné, obe vlastnosti vracajú 0. Rozmery môžu byť známe pred koncom sťahovania, takže kladné hodnoty nedokazujú, že je celý obrázok načítaný alebo dekódovaný. Pred výpočtom img.naturalWidth / img.naturalHeight skontroluj, či sú oba rozmery kladné.
complete je booleovská vlastnosť určená iba na čítanie. Má hodnotu true, ak chýbajú src aj srcset alebo ak je src prázdne a srcset chýba. Hodnotu true má aj vtedy, ak je obrázok z aktuálnej požiadavky plne dostupný alebo požiadavka zlyhala a zároveň žiadna náhradná požiadavka nečaká na vybavenie. Inak má hodnotu false. Vyjadruje stav v okamihu čítania, nie úspech načítania.
Pred nastavením src zaregistruj obsluhu udalostí load a error, aby sa dalo rozlíšiť úspešné načítanie od chyby. Ak potrebuješ dekódovaný obrázok, po nastavení zdroja použi await img.decode() a ošetri zamietnutie prísľubu. Ide o webové API prehliadača, nie o súčasť jadra ECMAScriptu.
Prí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ýsledok
no source: true 0 0 load: true 24 16 error: true 0 0
Tri riadky ukazujú obrázok bez zdroja, platný SVG s rozmermi 24 × 16 a neplatný SVG. Vo všetkých prípadoch má `complete` hodnotu `true`. Otvor súbor HTML v prehliadači, ktorý povoľuje obrázky s URL `data:` a má zapnuté načítanie obrázkov. Výstup nájdeš vo vývojárskej konzole.
Súvisiace lekcie
- JavaScript · Lekcia 33 · Pokročilá · Verzia: 4