Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

source — alternatywne źródła obrazów i multimediów

Element `source` deklaruje alternatywne zasoby dla `picture`, `audio` lub `video`. Sam niczego nie wyświetla. W `picture` wymaga `srcset`, a w `audio` i `video` — `src`; tych zastosowań nie należy mylić.

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

Składnia

<picture>
  <source srcset="image.svg" type="image/svg+xml">
  <img src="fallback.png" alt="Description">
</picture>

source jest elementem pustym: nie zawiera treści i nie ma znacznika zamykającego. W picture umieszcza się go przed wymaganym img. W audio i video elementy source są dozwolone tylko wtedy, gdy element nadrzędny nie ma atrybutu src, i umieszcza się je przed elementami track oraz treścią zastępczą. Jeśli element nadrzędny ma atrybut src, przy wyborze zasobu używany jest ten atrybut, a nie podrzędne elementy source.

W picture wymagany jest srcset, a src jest niedozwolony. Obraz wyświetla img, który zapewnia też tekst alt i źródło zastępcze. sizes opisuje rozmiar obrazu przy kandydatach z deskryptorami szerokości; jest wymagany, chyba że img dopuszcza automatyczne rozmiary. width i height mogą określać wymiary oraz proporcje wybranego wariantu.

W audio i video każdy source wymaga niepustego adresu src. Opcjonalny type podaje typ MIME i pomaga pominąć nieobsługiwany format bez pobierania. media zawiera zapytania o środowisko: w picture wybór reaguje na jego zmiany, natomiast dla multimediów warunek jest oceniany tylko raz podczas wyboru zasobu.

Sama zmiana src lub type istniejącego źródła w audio albo video nie zmienia odtwarzania; ustaw src rodzica. W przykładzie osadzone obrazy eliminują zależności sieciowe: przy szerokości obszaru widoku co najmniej 600 pikseli CSS wybierany jest niebieski wariant, a poniżej tego progu — pomarańczowy.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>source demo</title>
<picture>
  <source media="(min-width: 600px)" type="image/svg+xml"
    srcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='120'%20height='80'%3E%3Cpath%20fill='blue'%20d='M0,0H120V80H0Z'/%3E%3C/svg%3E">
  <img width="120" height="80" alt="Color sample"
    src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='120'%20height='80'%3E%3Cpath%20fill='orange'%20d='M0,0H120V80H0Z'/%3E%3C/svg%3E">
</picture>
</html>

Wynik

Viewport >= 600 CSS px: blue rectangle, 120 × 80 CSS px.
Viewport < 600 CSS px: orange rectangle, 120 × 80 CSS px.

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

Źródła