CKTIS / HTML
sizes — šířka obrázku pro výběr zdroje a rozměry ikon
Atribut sizes má dva odlišné významy: u img a source popisuje šířku obrázku používanou při výběru zdroje z srcset; u link uvádí dostupné rozměry ikon. Nenahrazuje pravidla CSS, která určují velikost zobrazeného obrázku.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
img/source: sizes="(media-condition) length, fallback-length" | sizes="auto, fallback-length"
link: sizes="16x16 32x32" | sizes="any"U img a u source uvnitř picture popisuje sizes zamýšlenou šířku obrázku v rozvržení stránky. Prohlížeč ji kombinuje s kandidáty srcset používajícími deskriptory šířky, například 640w, aby vybral zdroj. Jde o vodítko pro výběr souboru, nikoli o pokyn ke změně rozměrů CSS. Nepoužívá se k výběru mezi kandidáty s deskriptory 1x a 2x.
Seznam je oddělen čárkami, například (max-width: 600px) 100vw, 50vw. Šířku určuje první vyhovující podmínka; závěrečná délka bez podmínky slouží jako náhradní hodnota. Délky musí být nezáporné; povoleny jsou jednotky jako px, em, vw a matematické funkce jako calc(), nikoli však procenta. Pokud parser nenajde použitelnou hodnotu, vrátí 100vw.
U img vyžaduje použití deskriptorů w atribut sizes. U source platí stejné pravidlo, pokud následující img nepovoluje automatickou velikost. Pro použití sizes="auto" musí mít tento img loading="lazy" a vlastní sizes musí být auto nebo začínat na auto,. auto musí být první; za ním mohou následovat náhradní hodnoty. Šířka se pak odvozuje od velikosti vykresleného obrázku. Rozměry uveďte také pomocí width a height nebo CSS. V tomto případě je vynechání sizes u předchozího source ekvivalentní hodnotě auto.
U link má atribut jiný význam: sizes informativně uvádí dostupné rozměry ikon a je povolen pouze tehdy, když rel obsahuje icon nebo apple-touch-icon. Hodnota se skládá z jedinečných tokenů oddělených mezerami, například 16x16 32x32, nebo z any pro libovolné velikosti. Dvojice udávají šířku a výšku v pixelech; čísla jsou kladná, bez počátečních nul, a odděluje je x nebo X. U tokenů se nerozlišují velká a malá písmena ASCII. Pro předběžné načítání obrázků pomocí link slouží atribut imagesizes, nikoli sizes.
Příklad obsahuje SVG a nevyžaduje externí soubory. CSS nastavuje skutečné rozměry, zatímco sizes="160px" popisuje stejnou šířku pro výběr zdroje. Přečtení atributu vytvoří předvídatelný text; netestuje však algoritmus výběru zdroje.
Pří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ýsledek
sizes=160px
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.