Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

HTMLElement.onload — obrada učitavanja resursa

HTMLElement.onload svojstvo je rukovatelja događajem load. Dodijelite mu funkciju koja reagira na učitavanje resursa elementa, primjerice slike. Kasnija dodjela zamjenjuje prethodnu funkciju, dok null onemogućuje rukovatelja.

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

Sintaksa

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

HTMLElement.onload svojstvo je rukovatelja događajem load, dostupno putem mehanizma GlobalEventHandlers. Riječ je o sučelju preglednika definiranom standardom HTML, a ne o značajci samog ECMAScripta; prisutnost Node.js 24 ne dokazuje da je ono dostupno.

Kod slike load znači da je resurs uspješno učitan. Postavite funkciju prije dodjele src kako ne biste propustili događaj. To što element ima to svojstvo ne znači da svaki element automatski emitira load. Poseban su slučaj elementi body i frameset: njihov onload obrađuje događaj na objektu Window, a ne učitavanje zasebnog resursa elementa.

Dodjela nove funkcije zamjenjuje prethodnu; null uklanja tog rukovatelja. Za neovisne pretplate upotrijebite addEventListener('load', handler). Slika u primjeru ima dimenzije 1x1, a funkcija prima event. Obična funkcija upotrebljava this za upućivanje na sliku.

Primjeri

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

Rezultat

load: 1x1

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori