Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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 success

naturalWidth 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

Zdroje