CKTIS / HTML
sizes — ширина на изображението за избор на източник и размери на икони
Атрибутът sizes има две различни значения: при img и source описва ширината на изображението, използвана за избор на ресурс от srcset; при link указва наличните размери на икони. Той не замества CSS правилата, които определят размера на показваното изображение.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
img/source: sizes="(media-condition) length, fallback-length" | sizes="auto, fallback-length"
link: sizes="16x16 32x32" | sizes="any"При img и при source в picture атрибутът sizes описва предвидената ширина на изображението в оформлението. Браузърът я съчетава с кандидатите в srcset, които използват дескриптори за ширина, например 640w, за да избере ресурс. Това е подсказка за избор на файл, а не указание за промяна на CSS размерите. Не се използва за избор между кандидати с дескрипторите 1x и 2x.
Списъкът е разделен със запетаи, например (max-width: 600px) 100vw, 50vw. Първото съвпадащо условие задава ширината; последната дължина без условие служи като резервна стойност. Дължините трябва да са неотрицателни; позволени са единици като px, em, vw и математически функции като calc(), но не и проценти. Ако парсерът не намери използваема стойност, връща 100vw.
При img използването на дескриптори w изисква sizes. При source важи същото правило, освен ако следващият img позволява автоматичен размер. За sizes="auto" този img трябва да има loading="lazy", а собственият му sizes трябва да е auto или да започва с auto,. auto трябва да е първо; след него могат да се добавят резервни стойности. Тогава ширината се определя от размера на изобразеното изображение. Посочете размерите и чрез width и height или CSS. В този случай пропускането на sizes при предходен source е равностойно на auto.
При link значението е различно: sizes дава ориентировъчна информация за наличните размери на икони и е позволен само когато rel съдържа icon или apple-touch-icon. Стойността се състои от уникални токени, разделени с интервали, например 16x16 32x32, или от any за произволни размери. Двойките означават ширина и височина в пиксели; числата са положителни, без водещи нули, и се разделят с x или X. При токените не се прави разлика между ASCII главни и малки букви. За предварително зареждане на изображения чрез link съответният атрибут е imagesizes, а не sizes.
Примерът съдържа вграден SVG и не изисква външни файлове. CSS задава действителните размери, а sizes="160px" описва същата ширина за избора на източник. Прочитането на атрибута дава предвидим текст, но не тества алгоритъма за избор на ресурс.
Примери
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>sizes</title>
<style>img { display: block; width: 160px; height: 80px; }</style>
<img id="sample" alt="Blue rectangle" width="160" height="80"
sizes="160px"
srcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='160'%20height='80'%3E%3Cpath%20fill='blue'%20d='M0,0H160V80H0Z'/%3E%3C/svg%3E 160w">
<pre id="result"></pre>
<script>
document.getElementById('result').textContent =
'sizes=' + document.getElementById('sample').getAttribute('sizes');
</script>
</html>Резултат
sizes=160px
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.