База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници