CKTIS / JavaScript
Obrázky v JavaScriptu: `src`, `alt`, `load` a `error`
Nastavte adresu a alternativní text obrázku a pomocí událostí jeho prvku reagujte na úspěšné i neúspěšné načtení.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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() vytvoří prvek img typu HTMLImageElement, který je zpočátku mimo strom dokumentu. Jde o API webové platformy, nikoli o součást ECMAScriptu 2024. Běhové prostředí musí toto API poskytovat.
img.src je řetězcová vlastnost odrážející atribut src. Nastavení spustí asynchronní zpracování zdroje obrázku, i když prvek nebyl vložen do dokumentu. Při čtení img.src se platná relativní URL vyhodnotí vůči základní URL dokumentu; img.getAttribute("src") vrátí uloženou hodnotu atributu. U responzivních obrázků zjistíte URL vybranou prohlížečem z img.currentSrc.
img.alt odráží atribut alt. Napište text, který člověku, jenž obrázek nevidí, sdělí jeho význam nebo účel v daném kontextu. U čistě dekorativního obrázku nastavte alt = "", místo abyste atribut vynechali. alt není URL náhradního obrázku.
load oznamuje úspěšné načtení; error oznamuje, že vybraný zdroj nešlo načíst nebo použít. Jsou to události prvku, nikoli metody ani výjimky, které by zachytil try...catch kolem přiřazení do src. Oba posluchače zaregistrujte před nastavením src. Místo nich lze přiřadit obslužné funkce do onload a onerror; novým přiřazením nahradíte funkci v dané vlastnosti.
Pří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ýsledek
load: Blue dot error: Blue dot
Uložte příklad jako soubor HTML, otevřete ho v prohlížeči a výsledek zkontrolujte ve vývojářské konzoli. Kód bez síťových požadavků nejdřív vyzkouší platné SVG a pak neplatná obrazová data. Oba řádky uvádějí událost a nezměněnou hodnotu `alt`; neukazují, jak prohlížeč zobrazuje alternativní text. Pokud zásady zabezpečení obsahu (CSP) blokují obrázky `data:`, může nastat `error` i při prvním pokusu.
Související lekce
- JavaScript · Lekce 30 · Středně pokročilá · Verze: 3