CKTIS / HTML
sizes — šírka obrázka na výber zdroja a rozmery ikon
Atribút sizes má dva odlišné významy: pri img a source opisuje šírku obrázka používanú pri výbere zdroja z srcset; pri link uvádza dostupné rozmery ikon. Nenahrádza pravidlá CSS, ktoré určujú veľkosť zobrazovaného obrázka.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
img/source: sizes="(media-condition) length, fallback-length" | sizes="auto, fallback-length"
link: sizes="16x16 32x32" | sizes="any"Pri img a pri source vo vnútri picture opisuje sizes zamýšľanú šírku obrázka v rozložení stránky. Prehliadač ju kombinuje s kandidátmi srcset používajúcimi deskriptory šírky, napríklad 640w, aby vybral zdroj. Ide o pomôcku na výber súboru, nie o pokyn na zmenu rozmerov CSS. Nepoužíva sa na výber medzi kandidátmi s deskriptormi 1x a 2x.
Zoznam je oddelený čiarkami, napríklad (max-width: 600px) 100vw, 50vw. Šírku určuje prvá vyhovujúca podmienka; záverečná dĺžka bez podmienky slúži ako náhradná hodnota. Dĺžky musia byť nezáporné; povolené sú jednotky ako px, em, vw a matematické funkcie ako calc(), nie však percentá. Ak parser nenájde použiteľnú hodnotu, vráti 100vw.
Pri img vyžaduje použitie deskriptorov w atribút sizes. Pri source platí rovnaké pravidlo, pokiaľ nasledujúci img nepovoľuje automatickú veľkosť. Na použitie sizes="auto" musí mať tento img loading="lazy" a vlastný sizes musí byť auto alebo sa začínať na auto,. auto musí byť prvé; za ním môžu nasledovať náhradné hodnoty. Šírka sa potom odvodzuje od veľkosti vykresleného obrázka. Rozmery uveďte aj pomocou width a height alebo CSS. V tomto prípade je vynechanie sizes pri predchádzajúcom source ekvivalentné hodnote auto.
Pri link má atribút iný význam: sizes informatívne uvádza dostupné rozmery ikon a je povolený iba vtedy, keď rel obsahuje icon alebo apple-touch-icon. Hodnota sa skladá z jedinečných tokenov oddelených medzerami, napríklad 16x16 32x32, alebo z any pre ľubovoľné veľkosti. Dvojice označujú šírku a výšku v pixeloch; čísla sú kladné, bez úvodných núl, a oddeľuje ich x alebo X. Pri tokenoch sa nerozlišujú veľké a malé písmená ASCII. Na predbežné načítanie obrázkov cez link slúži atribút imagesizes, nie sizes.
Príklad obsahuje SVG a nepotrebuje externé súbory. CSS nastavuje skutočné rozmery, zatiaľ čo sizes="160px" opisuje rovnakú šírku na výber zdroja. Prečítanie atribútu vytvorí predvídateľný text, netestuje však algoritmus výberu zdroja.
Príklady
<!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>Výsledok
sizes=160px
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.