Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

imagesizes — rozmiar obrazu przy wstępnym ładowaniu

Atrybut imagesizes opisuje przewidywaną szerokość obrazu, aby przeglądarka mogła wybrać zasób z imagesrcset podczas wstępnego ładowania. Dotyczy elementu link z rel="preload" i as="image"; nie ustawia szerokości obrazu w układzie strony.

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

Składnia

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

imagesizes podaje rozmiar źródłowy używany przy wyborze obrazu z imagesrcset. Można go stosować wyłącznie na elemencie link z rel="preload" i as="image". Gdy imagesrcset zawiera deskryptory szerokości w, obecność imagesizes jest obowiązkowa.

Wartością jest lista rozmiarów źródłowych, podobnie jak w sizes obrazu: (max-width: 600px) 100vw, 50vw oznacza pełną szerokość obszaru widoku do 600 pikseli CSS, a następnie połowę tej szerokości. Obowiązuje pierwszy pasujący warunek; ostatnia długość stanowi wartość domyślną. Procenty nie są dozwolone jako długości rozmiaru źródłowego.

Dobierz imagesizes do sizes docelowego obrazu, a imagesrcset do jego srcset, aby oba etapy wybierały zgodny zasób. Deklaracja opisuje przewidywaną szerokość, lecz jej nie ustawia — układ określa się osobno, np. w CSS. Nie należy też mylić jej z sizes elementu link, które opisuje wymiary ikon.

Przykład zawiera dwa osadzone warianty SVG (80w i 160w), każdy z prostokątem w kolorze morskim, więc nie wymaga osobnych plików. Zarówno imagesizes, jak i sizes mają stałą wartość 80px, niezależną od szerokości obszaru widoku. Konsola potwierdza zgodność tych wartości i wyświetla osobno rozmiar źródłowy 80px oraz szerokość obrazu w układzie, ustawioną w CSS na 64px. Przykład nie mierzy przyspieszenia pobierania.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła