Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

decoding: preferenza di decodifica dell’immagine

Distingui la disponibilità dei pixel da download, caricamento differito e disegno.

Versione: HTML Living Standard

Sintassi

<img decoding="async" src="/picture.svg" alt="Blue square">

L’attributo immagine decoding accetta sync, async o auto. Suggerisce di coordinare la decodifica con la presentazione di altri contenuti o completarla separatamente; valori mancanti e non validi usano lo stato automatico. È un’indicazione, non una promessa su uno specifico fotogramma o thread.

Non sostituisce caricamento differito, priorità di rete o dimensioni. Per attendere esplicitamente la decodifica prima dell’inserimento usa decode() e gestisci il rifiuto in caso di errore di caricamento o decodifica. Impostare l’attributo non informa il codice che i pixel sono pronti.

Il test richiede un’immagine locale, attende la decodifica riuscita e poi la aggiunge al documento. Verifica dimensioni naturali e inserimento reale. Non deduce dall’attributo una pianificazione asincrona del disegno garantita.

Esempi

<!doctype html><meta charset="utf-8"><div id="mount"></div><output id="result"></output><script>
const image = new Image(); image.alt = 'Blue square'; image.decoding = 'async'; image.src = '/picture.svg';
image.decode().then(() => {
  document.querySelector('#mount').append(image);
  document.querySelector('#result').textContent = 'decoded=' + (image.naturalWidth === 20) + '; mounted=' + image.isConnected;
});
</script>

Risultato

decoded=true; mounted=true

Il risultato prova decodifica e inserimento di questa immagine, non una pianificazione universale.

Fonti