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.