CKTIS / JavaScript
HTMLElement.onload — gestire il caricamento di una risorsa
HTMLElement.onload è la proprietà del gestore dell’evento load. Le si assegna una funzione per reagire al caricamento della risorsa di un elemento, per esempio un’immagine. Un’assegnazione successiva sostituisce la funzione precedente, mentre null disattiva il gestore.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
element.onload = function (event) { /* handle load */ };
element.onload = null;HTMLElement.onload è la proprietà del gestore dell’evento load, esposta tramite il meccanismo GlobalEventHandlers. È un’interfaccia del browser definita da HTML, non una funzionalità di ECMAScript; la presenza di Node.js 24 non dimostra che sia disponibile.
Per un’immagine, load significa che la risorsa è stata caricata correttamente. Imposta la funzione prima di assegnare src, per non perdere l’evento. Il fatto che un elemento abbia questa proprietà non significa che ogni elemento emetta automaticamente load. Gli elementi body e frameset costituiscono un caso particolare: il loro onload gestisce l’evento di Window, non il caricamento di una risorsa separata dell’elemento.
Assegnare una nuova funzione sostituisce quella precedente; null rimuove il gestore. Usa addEventListener('load', handler) per sottoscrizioni indipendenti. Nell’esempio, l’immagine misura 1x1 e la funzione riceve event. La funzione ordinaria usa this per fare riferimento all’immagine.
Esempi
(() => {
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>'
);
})();Risultato
load: 1x1
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.