Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Obrázky v JavaScripte: `src`, `alt`, `load` a `error`

Nastavte adresu a alternatívny text obrázka a pomocou udalostí jeho prvku reagujte na úspešné aj neúspešné načítanie.

Verzia: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

const img = new Image();
img.alt = text;
img.addEventListener("load", onLoad);
img.addEventListener("error", onError);

// To use handler properties, replace the two listener registrations above with:
// img.onload = onLoad;
// img.onerror = onError;

img.src = url;

new Image() vytvorí prvok img typu HTMLImageElement, ktorý je spočiatku mimo stromu dokumentu. Ide o API webovej platformy, nie o súčasť ECMAScriptu 2024. Behové prostredie musí toto API poskytovať.

img.src je reťazcová vlastnosť, ktorá odráža atribút src. Nastavenie spustí asynchrónne spracovanie zdroja obrázka, aj keď prvok nebol vložený do dokumentu. Pri čítaní img.src sa platná relatívna URL vyhodnotí vzhľadom na základnú URL dokumentu; img.getAttribute("src") vráti uloženú hodnotu atribútu. Pri responzívnych obrázkoch zistíte z img.currentSrc, ktorú URL prehliadač vybral.

img.alt odráža atribút alt. Napíšte text, ktorý človeku, ktorý obrázok nevidí, sprostredkuje jeho význam alebo účel v danom kontexte. Pri čisto dekoratívnom obrázku nastavte alt = "" namiesto vynechania atribútu. alt nie je URL náhradného obrázka.

load oznamuje úspešné načítanie; error oznamuje, že vybraný zdroj sa nepodarilo načítať alebo použiť. Sú to udalosti prvku, nie metódy ani výnimky, ktoré by zachytil try...catch okolo priradenia do src. Oba poslucháče zaregistrujte pred nastavením src. Môžete tiež priradiť obslužné funkcie do onload a onerror; nové priradenie nahradí funkciu v danej vlastnosti.

Príklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Image load and error events</title>
</head>
<body>
<script>
(async () => {
  const svg = '<svg xmlns="http://www.w3.org/2000/svg" width="10" height="10"><circle cx="5" cy="5" r="5" fill="blue"/></svg>';
  const valid = 'data:image/svg+xml,' + encodeURIComponent(svg);
  const invalid = 'data:image/svg+xml,not-an-svg';

  function reportImage(url) {
    return new Promise((resolve) => {
      const img = new Image();
      img.alt = 'Blue dot';
      const report = (event) => {
        console.log(`${event.type}: ${img.alt}`);
        resolve();
      };
      img.addEventListener('load', report, { once: true });
      img.addEventListener('error', report, { once: true });
      img.src = url;
    });
  }

  await reportImage(valid);
  await reportImage(invalid);
})();
</script>
</body>
</html>

Výsledok

load: Blue dot
error: Blue dot

Uložte príklad ako súbor HTML, otvorte ho v prehliadači a výsledok skontrolujte vo vývojárskej konzole. Bez sieťových požiadaviek vyskúša najskôr platné SVG a potom neplatné obrazové údaje. Oba riadky uvádzajú udalosť a nezmenenú hodnotu `alt`; neukazujú, ako prehliadač zobrazuje alternatívny text. Ak pravidlá zabezpečenia obsahu (CSP) blokujú obrázky `data:`, aj prvý pokus môže vyvolať `error`.

Súvisiace lekcie

  • JavaScript · Lekcia 30 · Stredne pokročilá · Verzia: 3

Zdroje