Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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í.

Zdroje