Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

imagesizes — velikost zdroje obrázku pro předběžné načtení

Atribut imagesizes popisuje očekávanou šířku obrázku, aby prohlížeč mohl při předběžném načítání vybrat prostředek z imagesrcset. Používá se u link s rel="preload" a as="image"; nenastavuje šířku obrázku v rozvržení stránky.

Verze: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<link rel="preload" as="image" imagesrcset="…" imagesizes="(max-width: 600px) 100vw, 50vw">

imagesizes udává velikost zdroje, která se používá při výběru obrázku z imagesrcset. Je povolen pouze u prvku link s rel="preload" a as="image". Pokud imagesrcset obsahuje deskriptory šířky w, je imagesizes povinný.

Hodnota je seznam velikostí zdroje, podobně jako sizes u obrázku: (max-width: 600px) 100vw, 50vw znamená celou šířku zobrazovací oblasti až do 600 CSS pixelů a poté její polovinu. Platí první odpovídající podmínka; poslední délka je záložní hodnota. Procenta nejsou jako délky velikosti zdroje povolena.

Sladěte imagesizes s sizes cílového obrázku a imagesrcset s jeho srcset, aby oba kroky vybíraly odpovídající prostředek. Deklarace popisuje očekávanou šířku, ale nenastavuje ji — rozvržení určete samostatně, například pomocí CSS. Nezaměňujte ji ani za sizes prvku link, který popisuje rozměry ikon.

Příklad používá dvě vložené varianty SVG (80w a 160w), každou s modrozeleným obdélníkem, takže nejsou potřeba samostatné soubory. Atributy imagesizes a sizes mají pevnou hodnotu 80px bez ohledu na šířku zobrazovací oblasti. Konzole potvrzuje, že se hodnoty shodují, a vypisuje zvlášť velikost zdroje 80px a šířku obrázku v rozvržení 64px, nastavenou pomocí CSS. Příklad neměří, zda předběžné načtení zrychluje stahování.

Příklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Source size for image preloading</title>
  <link id="preload" rel="preload" as="image" imagesizes="80px"
        imagesrcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='80'%20height='40'%3E%3Crect%20width='80'%20height='40'%20fill='teal'/%3E%3C/svg%3E 80w,
                     data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='160'%20height='80'%3E%3Crect%20width='160'%20height='80'%20fill='teal'/%3E%3C/svg%3E 160w">
  <style>
    #sample { display: block; width: 64px; height: auto; }
  </style>
</head>
<body>
  <h1>Preload source size and layout width</h1>
  <img id="sample" alt="Teal rectangle" width="80" height="40" sizes="80px"
       src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='80'%20height='40'%3E%3Crect%20width='80'%20height='40'%20fill='teal'/%3E%3C/svg%3E"
       srcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='80'%20height='40'%3E%3Crect%20width='80'%20height='40'%20fill='teal'/%3E%3C/svg%3E 80w,
               data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='160'%20height='80'%3E%3Crect%20width='160'%20height='80'%20fill='teal'/%3E%3C/svg%3E 160w">
  <script>
    const preload = document.getElementById('preload');
    const image = document.getElementById('sample');
    if ('imageSizes' in preload) {
      console.log(`Preload source size: ${preload.imageSizes}`);
      console.log(`Preload and image source sizes match: ${preload.imageSizes === image.sizes}`);
      console.log(`Image layout width: ${getComputedStyle(image).width}`);
    } else {
      console.log('imagesizes reflection is unsupported');
    }
  </script>
</body>
</html>

Výsledek

Preload source size: 80px
Preload and image source sizes match: true
Image layout width: 64px

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.

Zdroje