CKTIS / HTML
decoding: preferencia dekódovania obrázka
Oddeľte pripravenosť pixelov od sťahovania, odloženého načítania a vykresľovania.
Verzia: HTML Living Standard
Syntax
<img decoding="async" src="/picture.svg" alt="Blue square">Obrázkový atribút decoding prijíma sync, async alebo auto. Odporúča zladiť dekódovanie s prezentáciou ostatného obsahu alebo ho dokončiť samostatne; chýbajúca či neplatná hodnota dáva automatický stav. Je to odporúčanie, nie prísľub konkrétnej snímky alebo vlákna.
Nenahrádza lenivé načítanie, prioritu sťahovania ani rozmery. Ak chcete pred vložením výslovne počkať na dekódovanie, použite decode() a spracujte odmietnutie pri chybe načítania či dekódovania. Samotný zápis atribútu nehlási aplikácii pripravené pixely.
Scenár vyžiada miestny obrázok, počká na úspešné dekódovanie a potom ho pridá do dokumentu. Test overí prirodzené rozmery a skutočné vloženie. Z atribútu neodvodzuje zaručený asynchrónny plán vykreslenia.
Prí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ýsledok
decoded=true; mounted=true
Výsledok dokladá dekódovanie a vloženie tohto obrázka, nie univerzálne plánovanie.