CKTIS / HTML
decoding: preference dekódování obrázku
Oddělte připravenost pixelů od stahování, odloženého načtení a vykreslování.
Verze: HTML Living Standard
Syntaxe
<img decoding="async" src="/picture.svg" alt="Blue square">Obrázkový atribut decoding přijímá sync, async nebo auto. Doporučuje sladit dekódování s prezentací ostatního obsahu nebo ho dokončit samostatně; chybějící či neplatná hodnota dává automatický stav. Jde o doporučení, ne příslib konkrétního snímku nebo vlákna.
Nenahrazuje líné načítání, prioritu stahování ani rozměry. Chcete-li před vložením výslovně počkat na dekódování, použijte decode() a zpracujte odmítnutí při chybě načtení či dekódování. Samotný zápis atributu nehlásí aplikaci připravené pixely.
Scénář vyžádá místní obrázek, počká na úspěšné dekódování a potom jej vloží do dokumentu. Test ověří přirozené rozměry a skutečné vložení. Z hodnoty atributu neodvozuje zaručený asynchronní plán vykreslení.
Příklady
<!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>Výsledek
decoded=true; mounted=true
Výsledek dokládá dekódování a vložení tohoto obrázku, ne univerzální plánování.