CKTIS / JavaScript
HTMLElement.onload — obsluha načítania zdroja
HTMLElement.onload je vlastnosť obsluhy udalosti load. Priraďte jej funkciu, ktorá bude reagovať na načítanie zdroja prvku, napríklad obrázka. Neskoršie priradenie nahradí predchádzajúcu funkciu, zatiaľ čo null obsluhu deaktivuje.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.onload = function (event) { /* handle load */ };
element.onload = null;HTMLElement.onload je vlastnosť obsluhy udalosti load, sprístupnená mechanizmom GlobalEventHandlers. Ide o rozhranie prehliadača definované štandardom HTML, nie o funkciu samotného ECMAScriptu; dostupnosť Node.js 24 nedokazuje, že je táto vlastnosť k dispozícii.
Pri obrázku znamená load, že sa zdroj úspešne načítal. Funkciu nastavte pred priradením src, aby ste udalosť nezmeškali. To, že prvok túto vlastnosť má, neznamená, že každý prvok automaticky vysiela load. Osobitným prípadom sú prvky body a frameset: ich onload obsluhuje udalosť objektu Window, nie načítanie samostatného zdroja prvku.
Priradením novej funkcie nahradíte predchádzajúcu; null túto obsluhu odstráni. Na nezávislé prihlásenia na odber použite addEventListener('load', handler). Obrázok v príklade má rozmery 1x1 a funkcia dostane event. Bežná funkcia používa this na odkazovanie na obrázok.
Prí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ýsledok
load: 1x1
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.