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

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.

Zdroje