Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

HTMLElement.onload — obsługa załadowania zasobu

HTMLElement.onload to właściwość obsługi zdarzenia load. Przypisuje się do niej funkcję reagującą na załadowanie zasobu elementu, na przykład obrazu. Kolejne przypisanie zastępuje poprzednią funkcję, a null wyłącza tę obsługę.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

element.onload = function (event) { /* handle load */ };
element.onload = null;

HTMLElement.onload jest właściwością obsługi zdarzenia load, udostępnianą przez mechanizm GlobalEventHandlers. To interfejs przeglądarki określony przez HTML, nie funkcja samego ECMAScript; obecność Node.js 24 nie dowodzi jego dostępności.

Dla obrazu load oznacza pomyślne załadowanie zasobu. Ustaw funkcję przed przypisaniem src, aby nie przegapić zdarzenia. Samo istnienie właściwości na elemencie nie oznacza, że każdy element automatycznie emituje load. Szczególny przypadek stanowią elementy body i frameset: ich onload obsługuje zdarzenie obiektu Window, a nie ładowanie osobnego zasobu elementu.

Przypisanie nowej funkcji zastępuje dotychczasową; null usuwa tę obsługę. Do niezależnych subskrypcji służy addEventListener('load', handler). W przykładzie obraz ma rozmiar 1x1, a funkcja otrzymuje event. Zwykła funkcja używa this do odwołania się do obrazu.

Przykłady

(() => {
  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>'
  );
})();

Wynik

load: 1x1

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła