Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje