CKTIS / JavaScript
Immagini in JavaScript: `src`, `alt`, `load` ed `error`
Imposta l’URL e il testo alternativo di un’immagine, poi gestisci il successo o il fallimento del caricamento tramite gli eventi dell’elemento.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
const img = new Image();
img.alt = text;
img.addEventListener("load", onLoad);
img.addEventListener("error", onError);
// To use handler properties, replace the two listener registrations above with:
// img.onload = onLoad;
// img.onerror = onError;
img.src = url;new Image() crea un elemento img di tipo HTMLImageElement, inizialmente fuori dall’albero del documento. L’API appartiene alla piattaforma web, non a ECMAScript 2024. L’ambiente di esecuzione deve metterla a disposizione.
img.src è una proprietà di tipo stringa che riflette l’attributo src. Impostarla avvia l’elaborazione asincrona della sorgente, anche se l’elemento non è stato inserito nel documento. In lettura, img.src risolve un URL relativo valido rispetto all’URL di base del documento; img.getAttribute("src") restituisce il valore memorizzato dell’attributo. Con le immagini adattive, img.currentSrc indica quale URL ha selezionato il browser.
img.alt riflette l’attributo alt. Scrivi un testo che comunichi il significato o lo scopo dell’immagine nel contesto a chi non può vederla. Se l’immagine è puramente decorativa, imposta alt = "" anziché omettere l’attributo. alt non è l’URL di un’immagine di riserva.
load segnala che l’immagine è stata caricata; error segnala che non è stato possibile caricare o usare la risorsa selezionata. Sono eventi dell’elemento, non metodi né eccezioni intercettate da un try...catch attorno all’assegnazione a src. Registra entrambi i listener prima di impostare src. In alternativa, assegna i gestori a onload e onerror: una nuova assegnazione sostituisce il gestore della proprietà corrispondente.
Esempi
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Image load and error events</title>
</head>
<body>
<script>
(async () => {
const svg = '<svg xmlns="http://www.w3.org/2000/svg" width="10" height="10"><circle cx="5" cy="5" r="5" fill="blue"/></svg>';
const valid = 'data:image/svg+xml,' + encodeURIComponent(svg);
const invalid = 'data:image/svg+xml,not-an-svg';
function reportImage(url) {
return new Promise((resolve) => {
const img = new Image();
img.alt = 'Blue dot';
const report = (event) => {
console.log(`${event.type}: ${img.alt}`);
resolve();
};
img.addEventListener('load', report, { once: true });
img.addEventListener('error', report, { once: true });
img.src = url;
});
}
await reportImage(valid);
await reportImage(invalid);
})();
</script>
</body>
</html>Risultato
load: Blue dot error: Blue dot
Salva l’esempio come file HTML, aprilo in un browser e controlla l’output nella console di sviluppo. Senza richieste di rete, il codice prova prima un SVG valido e poi dati immagine non validi. Entrambe le righe riportano l’evento e il valore invariato di `alt`; non mostrano come il browser visualizza il testo alternativo. Una Content Security Policy che blocca le immagini `data:` può far scattare `error` anche nella prima prova.
Lezioni correlate
- JavaScript · Lezione 30 · Intermedio · Versione: 3