Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti