CKTIS / JavaScript
HTMLElement.onload — obravnava nalaganja vira
HTMLElement.onload je lastnost obravnavalnika dogodka load. Dodelite ji funkcijo, ki se odzove na nalaganje vira elementa, na primer slike. Poznejša dodelitev zamenja prejšnjo funkcijo, null pa obravnavalnik onemogoči.
Različica: 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 je lastnost obravnavalnika dogodka load, ki jo zagotavlja mehanizem GlobalEventHandlers. Gre za vmesnik brskalnika, določen s standardom HTML, ne za funkcijo samega ECMAScripta; prisotnost Node.js 24 ne dokazuje, da je ta lastnost na voljo.
Pri sliki load pomeni, da se je vir uspešno naložil. Funkcijo nastavi pred dodelitvijo src, da dogodka ne zgrešiš. To, da ima element to lastnost, še ne pomeni, da vsak element samodejno sproži load. Poseben primer sta elementa body in frameset: njun onload obravnava dogodek na objektu Window, ne pa nalaganja ločenega vira elementa.
Dodelitev nove funkcije zamenja prejšnjo; null odstrani ta obravnavalnik. Za neodvisne naročnine uporabi addEventListener('load', handler). Slika v primeru meri 1x1, funkcija pa prejme event. Navadna funkcija uporablja this za sklicevanje na sliko.
Primeri
(() => {
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.