CKTIS / JavaScript
Prirodne dimenzije slike i stanje `complete`
Očitaj prirodne dimenzije slike u CSS pikselima i razlikuj završetak zahtjeva od uspješnog učitavanja ili dekodiranja.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
img.naturalWidth // number: natural width
img.naturalHeight // number: natural height
img.complete // boolean: completion state, not successnaturalWidth i naturalHeight svojstva su objekta HTMLImageElement samo za čitanje. Vraćaju prirodnu širinu i visinu trenutačne slike kao cijele brojeve u CSS pikselima. Uzimaju u obzir gustoću piksela odabranog resursa i orijentaciju iz metapodataka pa se mogu razlikovati od dimenzija zapisanih u datoteci. Za element koji se iscrtava width i height opisuju njegovu veličinu na stranici.
Dok dimenzije trenutačne slike nisu dostupne, oba svojstva vraćaju 0. Dimenzije mogu biti poznate prije završetka preuzimanja, stoga pozitivne vrijednosti ne dokazuju da je cijela slika učitana ili dekodirana. Prije izračuna img.naturalWidth / img.naturalHeight provjeri jesu li obje dimenzije pozitivne.
complete je logičko svojstvo samo za čitanje. Vraća true ako nedostaju i src i srcset ili ako je src prazan, a srcset nedostaje. Vraća true i ako je slika iz trenutačnog zahtjeva potpuno dostupna ili je zahtjev neuspješan, pod uvjetom da nijedan zamjenski zahtjev nije na čekanju. Inače vraća false. To je stanje u trenutku očitanja, a ne potvrda uspješnog učitavanja.
Registriraj rukovatelje događajima load i error prije postavljanja src kako bi razlikovao uspjeh od pogreške. Ako ti treba dekodirana slika, nakon postavljanja izvora upotrijebi await img.decode() i obradi odbijanje obećanja. To su web API-ji preglednika, a ne dio jezgre ECMAScripta.
Primjeri
<!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>Rezultat
no source: true 0 0 load: true 24 16 error: true 0 0
Tri retka prikazuju sliku bez izvora, valjani SVG veličine 24 × 16 i nevaljani SVG. U sva tri slučaja `complete` iznosi `true`. Otvori HTML datoteku u pregledniku koji dopušta slike `data:` i u kojem je omogućeno učitavanje slika, a zatim provjeri ispis u razvojnoj konzoli.
Povezane lekcije
- JavaScript · Lekcija 33 · Napredno · Verzija: 4