Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri