CKTIS / HTML
decoding : une préférence de décodage d’image
Distinguez le décodage du téléchargement, du chargement différé et du rendu.
Version : HTML Living Standard
Syntaxe
<img decoding="async" src="/picture.svg" alt="Blue square">L’attribut d’image decoding accepte sync, async ou auto. Il suggère de coordonner le décodage avec la présentation des autres contenus ou de le terminer séparément ; absence et valeur invalide donnent l’état automatique. C’est une indication, pas une promesse de trame ou de fil d’exécution précis.
Il ne remplace ni chargement paresseux, ni priorité réseau, ni dimensions. Pour attendre explicitement le décodage avant insertion, utilisez decode() et gérez son rejet en cas d’échec de chargement ou de décodage. Définir l’attribut ne signale pas au code que les pixels sont prêts.
L’exemple demande une image locale, attend son décodage réussi puis l’ajoute au document. Le test vérifie les dimensions naturelles et l’insertion réelle. Il ne déduit pas de calendrier de rendu asynchrone garanti à partir de l’attribut.
Exemples
<!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>Résultat
decoded=true; mounted=true
Le résultat prouve le décodage et l’insertion de cette image, pas un ordonnancement universel.