Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

sizes — širina slike za izbiro vira in mere ikon

Atribut sizes ima dva različna pomena: pri img in source opisuje širino slike, ki se uporablja za izbiro vira iz srcset; pri link navaja razpoložljive mere ikon. Ne nadomešča pravil CSS, ki določajo velikost prikazane slike.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

img/source: sizes="(media-condition) length, fallback-length" | sizes="auto, fallback-length"
link: sizes="16x16 32x32" | sizes="any"

Pri img in pri source znotraj picture atribut sizes opisuje predvideno širino slike v postavitvi. Brskalnik jo poveže s kandidati srcset, ki uporabljajo deskriptorje širine, na primer 640w, in tako izbere vir. Gre za namig pri izbiri datoteke, ne za navodilo za spreminjanje mer CSS. Ne uporablja se za izbiro med kandidati z deskriptorjema 1x in 2x.

Seznam je ločen z vejicami, na primer (max-width: 600px) 100vw, 50vw. Širino določi prvi ustrezni pogoj; končna dolžina brez pogoja je nadomestna vrednost. Dolžine ne smejo biti negativne; dovoljene so enote, kot so px, em, vw, in matematične funkcije, kot je calc(), ne pa odstotki. Če razčlenjevalnik ne najde uporabne vrednosti, vrne 100vw.

Pri img uporaba deskriptorjev w zahteva atribut sizes. Pri source velja isto pravilo, razen če naslednji img dovoljuje samodejno velikost. Za uporabo sizes="auto" mora ta img imeti loading="lazy", njegov lastni sizes pa mora biti auto ali se začeti z auto,. auto mora biti prvi; sledijo lahko nadomestne vrednosti. Širina se nato določi iz velikosti izrisane slike. Mere navedite tudi z width in height ali s CSS. Če v tem primeru izpustite sizes pri predhodnem source, je to enakovredno vrednosti auto.

Pri link ima atribut drugačen pomen: sizes informativno navaja razpoložljive mere ikon in je dovoljen samo, kadar rel vsebuje icon ali apple-touch-icon. Vrednost sestavljajo enolični žetoni, ločeni s presledki, na primer 16x16 32x32, ali any za poljubne velikosti. Pari označujejo širino in višino v slikovnih pikah; števila so pozitivna, brez začetnih ničel, ločuje pa jih x ali X. Pri žetonih se ne razlikuje med velikimi in malimi črkami ASCII. Za vnaprejšnje nalaganje slik prek link se uporablja atribut imagesizes, ne sizes.

Primer vsebuje SVG in ne potrebuje zunanjih datotek. CSS določa dejanske mere, sizes="160px" pa opisuje isto širino za izbiro vira. Branje atributa vrne predvidljivo besedilo, vendar ne preizkusi algoritma za izbiro vira.

Primeri

<!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>

Rezultat

sizes=160px

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri