Атрибут decoding в HTML: что это и как использовать

Атрибут decoding (от английского decoding, «декодирование») подсказывает браузеру, как превращать файл картинки в пиксели: вместе с показом страницы или отдельно от него. Закрывающий тег для него не нужен: атрибут пишется внутри открывающего тега, например decoding="async", а у самого <img> закрывающего тега нет.

У атрибута три значения: sync, async и auto. Главное, что нужно знать сразу: это именно подсказка, и её эффект в обычной вёрстке трудно заметить. Я сравнил все три значения на картинке 6000 на 6000 пикселей и не увидел разницы, поэтому в статье нет обещаний вроде «страница станет быстрее». Зато есть полезный метод decode(), о котором тоже расскажу.

HTML
<img src="photo.jpg" alt="Фото"
  width="800" height="600"
  decoding="async">

Что такое атрибут decoding в HTML и зачем он нужен

Файл картинки (JPEG, PNG, WebP) хранит сжатые данные. Прежде чем показать картинку, браузер разворачивает их в пиксели. Эта работа называется декодированием, и для больших картинок она заметна. Атрибут decoding подсказывает, как её выполнить: вместе с остальной отрисовкой страницы или отдельно.

Важно, чем decoding не является. Он не меняет момент скачивания файла: за это отвечает loading. Не меняет и размер картинки: его задают width и height. Он касается только последнего шага, когда файл уже на месте.

  • sync: расшифровать вместе с показом, содержимое ждёт картинку.
  • async: расшифровать отдельно, остальное содержимое не ждёт картинку.
  • auto: решение за браузером. Так работает любая картинка без атрибута.

Для каких тегов работает decoding: img и SVG image

Атрибут есть у тега <img> и у элемента image внутри <svg>. Свойство decoding у этих двух элементов существует, а у остальных тегов нет: я проверил <iframe>, <video>, <picture>, <source>, <input>, <object>, <canvas> и <embed>.

Теги, у которых работает decoding
ТегЧто делает decodingПример записи
<img>Подсказывает, как декодировать картинку<img src="a.jpg" alt="Кот" decoding="async">
image внутри <svg>То же для картинки внутри SVG<image href="a.png" width="100" height="100" decoding="async"/>

Если картинка расположена внутри <picture>, атрибут пишут у вложенного img. Обычное место атрибута рядом с src и alt.

Какие значения принимает decoding: sync, async и auto

Допустимы три значения. Остальные браузер не принимает: страницу они не ломают, но атрибут будет считаться равным auto. Ниже результаты проверки свойства img.decoding в браузере, на котором я проверял.

Что возвращает свойство decoding при разных записях
ЗаписьСвойство img.decodingПример записи
syncsyncdecoding="sync"
asyncasyncdecoding="async"
autoautodecoding="auto"
ASYNC, Asyncasync: регистр не важенdecoding="ASYNC"
async с пробелом в началеauto: пробел делает значение невернымdecoding=" async"
Пустое значениеautodecoding=""
Любой другой текстautodecoding="garbage"

Если атрибута нет совсем, свойство тоже возвращает auto. Это значение по умолчанию, поэтому писать decoding="auto" незачем: оно ничего не меняет.

Пример: какие значения decoding принимает браузер

Выберите значение и посмотрите, что записано в атрибуте и что вернуло свойство. Строка «По стандарту» показывает, допустима ли запись.

Результат

Свойство возвращает ваш браузер, результат может отличаться от моих замеров. Картинка создаётся прямо в демонстрации.

Что на самом деле меняет decoding

Теоретически разница понятна: при async браузер может показать текст и остальные элементы, не дожидаясь расшифровки большой картинки. На практике браузер волен выбрать иное, поэтому эффект зависит от него.

Я проверил это замером. На странице появлялась картинка 6000 на 6000 пикселей, а скрипт измерял самый длинный перерыв между кадрами. В браузере, на котором я проверял, получилось: для sync, async и auto самый длинный перерыв составил около 400 миллисекунд. Разницы между значениями я не увидел. Из этого не следует, что атрибут бесполезен: на других картинках, в других браузерах и на слабых устройствах результат может быть иным. Но обещать ускорение нельзя.

Чем decoding отличается от соседних атрибутов
АтрибутНа какой вопрос отвечаетПример записи
loadingКогда скачивать файл: сразу или когда понадобитсяloading="lazy"
decodingКак превращать скачанный файл в пикселиdecoding="async"
width и heightКакого размера оставить место под картинкуwidth="800" height="600"

Если вы хотите ускорить страницу, начните с этих трёх соседей и со сжатия файла. decoding оставьте напоследок: в одиночку он редко что-то меняет. Подробности о подходе описаны в статье Tune The Web.

Метод decode(): дождаться картинки перед показом

У самой картинки в JavaScript есть метод decode(). Он возвращает промис, который завершается, когда файл загружен и расшифрован. Метод полезен, когда нужно вставить картинку на страницу сразу готовой, без рывка.

Как ведёт себя decode()
СитуацияЧто получилосьПример записи
Верный файлПромис завершился, naturalWidth уже больше нуляawait img.decode()
Битый адресОшибка EncodingErrorimg.src = 'missing.png'
Нет srcОшибка EncodingErrornew Image().decode()
Смена src во время ожиданияОшибка EncodingErrorimg.src = 'other.png'
Повторный вызовРаботает, оба промиса завершаютсяimg.decode(); img.decode();
Картинка уже вставлена в страницуРаботает так жеdocument.body.append(img); await img.decode();

Ошибку нужно обрабатывать: без catch битая картинка превратится в необработанную ошибку в консоли.

HTML
const img = new Image();
img.src = 'photo.jpg';

img.decode()
  .then(() => box.append(img))
  .catch(() => console.log('Не вышло'));

Пример: показ картинки сразу и через decode()

Выберите файл и способ показа. Строка про naturalWidth показывает, готова ли картинка в момент вставки.

Результат

Время и размеры считает ваш браузер. Для верного файла результат почти мгновенный, потому что файл создан на этой же странице.

Когда decoding нужен и когда его можно не писать

Большинству картинок атрибут не нужен: значение по умолчанию подходит. Он имеет смысл в нескольких случаях.

Какое значение выбирать
СлучайЧто записатьПример записи
Лента или галерея с большими картинкамиasync<img src="a.jpg" alt="" width="800" height="600" decoding="async">
Большая картинка, добавляемая скриптомМетод decode() перед вставкойimg.decode().then(() => box.append(img))
Картинка и текст должны появиться вместеsync<img src="a.jpg" alt="" decoding="sync">
Маленькие значки и логотипыНичего не писать<img src="logo.svg" alt="Лого">
Остальные случаиНичего не писать<img src="a.jpg" alt="">

Это рекомендации по смыслу, а не результат замеров: измеримой разницы я не получил. Ориентир простой: писать async там, где картинок много и они большие, а во всём остальном полагаться на значение по умолчанию.

Decoding в JavaScript: свойство decoding и new Image()

Атрибут доступен как свойство decoding у картинки. Запись в свойство меняет атрибут, а чтение приводит значение к допустимому.

Как работает свойство decoding
ДействиеЧто получилосьПример записи
Чтение без атрибутаВернулось autoimg.decoding
Запись допустимого значенияАтрибут в разметке изменилсяimg.decoding = 'async'
Запись неверного значенияАтрибут записан как есть, а свойство возвращает autoimg.decoding = 'junk'

У картинки, созданной скриптом через new Image(), свойство записывают так же. Рядом с ним обычно задают width и height, как для любой картинки.

HTML
const img = new Image();
img.decoding = 'async';
img.width = 800;
img.height = 600;
img.src = 'photo.jpg';

console.log(img.decoding);   // "async"

Частые ошибки в атрибуте decoding

Большинство ошибок связано с тем, что от decoding ждут слишком многого или путают его с соседним loading.

ОшибкаЧто происходитКак исправить
decoding="fast", decoding="true"Неизвестное значение читается как autoПисать только sync, async или auto
decoding=" async"Пробел делает значение неверным, свойство возвращает autoПисать без пробелов
decoding="auto"Это и так значение по умолчанию, запись ничего не меняетУбрать атрибут
Ждут, что async ускорит скачиваниеАтрибут не влияет на скачивание, только на последний шагДля отложенной загрузки использовать loading
Путают decoding="async" и loading="lazy"Первое про декодирование, второе про момент скачиванияРазделять задачи: один атрибут на один вопрос
Ждут от async заметного эффектаВ моём замере разницы между значениями не былоСчитать значение подсказкой, не гарантией
decoding="async" у каждого значкаДля маленьких файлов выгоды нетОставить значение по умолчанию
new Image().decode() до присвоения srcОшибка EncodingErrorСначала записать src, потом вызвать decode()
Не обработали ошибку decode()Для битого адреса появляется необработанная ошибкаДобавить catch
Меняют src, пока decode() ждётОжидание завершается ошибкой EncodingErrorВызывать decode() заново после смены
decoding у picture, source или iframeУ этих тегов такого атрибута нетЗаписать атрибут у вложенного img
img.decoding = 'junk'Атрибут остаётся junk, а свойство возвращает autoЗаписывать только допустимые значения

Шпаргалка по атрибуту decoding

Всё главное из статьи в одной таблице.

Атрибут decoding: что и как писать
ЗадачаКак записатьПример записи
Декодировать отдельно от показаЗначение async<img src="a.jpg" alt="" decoding="async">
Декодировать вместе с показомЗначение sync<img src="a.jpg" alt="" decoding="sync">
Оставить выбор браузеруБез атрибута<img src="a.jpg" alt="">
Допустимые значенияТри значения без пробеловsync | async | auto
Вставить картинку готовойМетод decode()img.decode().then(() => box.append(img))
Обработать ошибкуcatch у промисаimg.decode().catch(() => {})
Прочитать значениеСвойство decodingimg.decoding
Не путатьloading отвечает за скачиваниеloading="lazy"
Категория
Поделиться в социальных сетях

Отправить комментарий

0 Комментарии

Отправить комментарий (0)

#buttons=(Хорошо) #days=(20)

Мы используем файлы cookie для улучшения работы сайта. Подробнее
Хорошо
×