CKTIS / JavaScript
HTMLElement.onload — obsluha načtení zdroje
HTMLElement.onload je vlastnost obsluhy události load. Přiřaďte jí funkci, která bude reagovat na načtení zdroje prvku, například obrázku. Pozdější přiřazení nahradí předchozí funkci, zatímco null obsluhu deaktivuje.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
element.onload = function (event) { /* handle load */ };
element.onload = null;HTMLElement.onload je vlastnost obsluhy události load, zpřístupněná mechanismem GlobalEventHandlers. Jde o rozhraní prohlížeče definované standardem HTML, nikoli o funkci samotného ECMAScriptu; dostupnost Node.js 24 nedokazuje, že je tato vlastnost k dispozici.
U obrázku znamená load, že se zdroj úspěšně načetl. Funkci nastavte před přiřazením src, abyste událost nezmeškali. To, že prvek tuto vlastnost má, neznamená, že každý prvek automaticky vysílá load. Zvláštním případem jsou prvky body a frameset: jejich onload obsluhuje událost objektu Window, nikoli načtení samostatného zdroje prvku.
Přiřazením nové funkce nahradíte předchozí; null tuto obsluhu odstraní. Pro nezávislá přihlášení k události použijte addEventListener('load', handler). Obrázek v příkladu má rozměry 1x1 a funkce obdrží event. Běžná funkce používá this pro odkaz na obrázek.
Příklady
(() => {
const image = document.createElement('img');
image.onload = function (event) {
console.log(event.type + ': ' + this.naturalWidth + 'x' + this.naturalHeight);
this.onload = null;
};
image.onerror = () => console.log('error');
image.src = 'data:image/svg+xml,' + encodeURIComponent(
'<svg xmlns="http://www.w3.org/2000/svg" width="1" height="1"></svg>'
);
})();Výsledek
load: 1x1
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.