CKTIS / HTML
sizes — szerokość obrazu przy wyborze źródła i rozmiary ikon
Atrybut sizes ma dwa różne znaczenia: w img i source opisuje szerokość obrazu używaną przy wyborze zasobu z srcset, a w link deklaruje dostępne rozmiary ikon. Nie zastępuje reguł CSS określających rozmiar wyświetlanego obrazu.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
img/source: sizes="(media-condition) length, fallback-length" | sizes="auto, fallback-length"
link: sizes="16x16 32x32" | sizes="any"W img oraz source wewnątrz picture atrybut sizes opisuje zamierzoną szerokość obrazu w układzie. Przeglądarka zestawia ją z kandydatami srcset oznaczonymi deskryptorem szerokości, np. 640w, aby wybrać zasób. To wskazówka do wyboru pliku, nie polecenie zmiany wymiarów w CSS. Nie służy do wyboru między kandydatami z deskryptorami 1x i 2x.
Lista jest rozdzielana przecinkami, np. (max-width: 600px) 100vw, 50vw. Pierwszy pasujący warunek wyznacza szerokość; końcowa długość bez warunku stanowi wartość zapasową. Długości muszą być nieujemne; dozwolone są jednostki takie jak px, em, vw i funkcje matematyczne, np. calc(), ale nie procenty. Gdy parser nie znajdzie użytecznej wartości, zwraca 100vw.
W img użycie deskryptorów w wymaga sizes. W source ta sama reguła obowiązuje, chyba że następujący po nim img dopuszcza automatyczny rozmiar. sizes="auto" wymaga, aby ten img miał loading="lazy" i własne sizes równe auto lub zaczynające się od auto,. auto musi być pierwsze; można dodać wartości zapasowe. Wtedy szerokość pochodzi z rozmiaru renderowanego obrazu. Podaj także wymiary przez width i height lub CSS. Pominięcie sizes w poprzedzającym source jest w tym przypadku równoważne auto.
W link znaczenie jest inne: sizes podaje doradczo rozmiary ikon i jest dozwolone tylko dla rel zawierającego icon lub apple-touch-icon. Wartość to unikalne tokeny rozdzielone spacjami, np. 16x16 32x32, albo any dla dowolnego rozmiaru. Pary oznaczają szerokość i wysokość w pikselach; liczby są dodatnie, bez zer wiodących, z separatorem x lub X. Tokeny nie rozróżniają wielkości liter ASCII. Przy wstępnym ładowaniu obrazów przez link odpowiednim atrybutem jest imagesizes, nie sizes.
Przykład zawiera obraz SVG bez zewnętrznych plików. CSS ustala rzeczywisty rozmiar, a sizes="160px" opisuje tę samą szerokość na potrzeby wyboru źródła. Odczyt atrybutu daje przewidywalny tekst; nie testuje algorytmu wyboru zasobu.
Przykłady
<!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>Wynik
sizes=160px
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.