CKTIS / HTML
decoding: предпочитание за декодиране на изображение
Отделете готовността след декодиране от изтеглянето, отложеното зареждане и рисуването.
Версия: HTML Living Standard
Синтаксис
<img decoding="async" src="/picture.svg" alt="Blue square">Атрибутът за изображения decoding приема sync, async или auto. Той подсказва дали декодирането да се съгласува с представянето на друго съдържание, или да завърши отделно; липсващи и невалидни стойности използват автоматичното състояние. Това е подсказка, а не обещание за конкретен кадър или нишка.
Той не заменя отложеното зареждане, приоритета на извличане или размерите на изображението. За изрично изчакване на декодирането преди вмъкване използвайте decode() и обработете отхвърлянето при грешка в зареждането или декодирането. Самото задаване на атрибута не уведомява приложението, че пикселите са готови.
Примерът заявява локално изображение, изчаква успешно декодиране и едва тогава го добавя в документа. Тестът проверява естествените размери и действителното вмъкване. Не извежда гарантиран график за асинхронно рисуване от стойността на атрибута.
Примери
<!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>Резултат
decoded=true; mounted=true
Резултатът доказва декодиране и вмъкване на конкретното изображение, а не универсално планиране.