Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Naravne mere slike in stanje `complete`

Preberi naravne mere slike v slikovnih pikah CSS in loči zaključek zahteve od uspešnega nalaganja ali dekodiranja.

Različica: 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 success

naturalWidth in naturalHeight sta lastnosti objekta HTMLImageElement, namenjeni samo branju. Vrneta naravno širino in višino trenutne slike kot celi števili v slikovnih pikah CSS. Upoštevata gostoto slikovnih pik izbranega vira in usmerjenost iz metapodatkov, zato se lahko razlikujeta od mer, zapisanih v datoteki. Pri izrisanem elementu pa width in height opisujeta njegovo velikost na strani.

Dokler mere trenutne slike niso na voljo, obe lastnosti vrneta 0. Mere so lahko znane že pred koncem prenosa, zato pozitivne vrednosti ne dokazujejo, da je bila celotna slika naložena ali dekodirana. Pred izračunom img.naturalWidth / img.naturalHeight preveri, ali sta obe meri pozitivni.

complete je logična lastnost, namenjena samo branju. Vrne true, če manjkata tako src kot srcset ali če je src prazen in srcset manjka. Vrne tudi true, če je slika iz trenutne zahteve v celoti na voljo ali če je zahteva spodletela, pod pogojem, da ni čakajoče nadomestne zahteve. Sicer vrne false. To je stanje ob branju, ne dokaz uspešnega nalaganja.

Preden nastaviš src, registriraj obdelovalnika dogodkov load in error, da ločiš uspeh od napake. Če potrebuješ dekodirano sliko, po nastavitvi vira uporabi await img.decode() in obravnavaj zavrnitev obljube. To so spletni API-ji brskalnika, ne del jedra ECMAScripta.

Primeri

<!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 vrstice prikazujejo sliko brez vira, veljaven SVG velikosti 24 × 16 in neveljaven SVG. V vseh treh primerih je `complete` enak `true`. Odpri datoteko HTML v brskalniku, ki dovoljuje slike `data:` in ima omogočeno nalaganje slik, nato preveri izpis v razvijalski konzoli.

Povezane lekcije

  • JavaScript · Lekcija 33 · Napredna · Različica: 4

Viri