CKTIS / JavaScript
HTMLElement.onload — het laden van een resource afhandelen
HTMLElement.onload is de event-handlerproperty voor load. Wijs er een functie aan toe om te reageren op het laden van de resource van een element, zoals een afbeelding. Een latere toewijzing vervangt de eerdere functie; null schakelt de handler uit.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.onload = function (event) { /* handle load */ };
element.onload = null;HTMLElement.onload is de event-handlerproperty voor load, beschikbaar via het mechanisme GlobalEventHandlers. Het is een browserinterface die door HTML is gedefinieerd, geen functie van ECMAScript zelf; de aanwezigheid van Node.js 24 bewijst niet dat deze beschikbaar is.
Bij een afbeelding betekent load dat de resource met succes is geladen. Stel de functie in voordat je src toewijst, zodat je de gebeurtenis niet mist. Dat een element deze property heeft, betekent niet dat elk element automatisch load uitzendt. De elementen body en frameset vormen een bijzonder geval: hun onload handelt de gebeurtenis op Window af, niet het laden van een afzonderlijke elementresource.
Een nieuwe functie toewijzen vervangt de vorige; null verwijdert die handler. Gebruik addEventListener('load', handler) voor onafhankelijke abonnementen. In het voorbeeld is de afbeelding 1x1 groot en ontvangt de functie event. De gewone functie gebruikt this om naar de afbeelding te verwijzen.
Voorbeelden
(() => {
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>'
);
})();Resultaat
load: 1x1
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.