Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

src — adres zasobu

Atrybut `src` wskazuje URL zasobu używanego przez element HTML, np. obrazu, skryptu lub nagrania. Nie jest atrybutem globalnym: jego zastosowanie, obowiązkowość i sposób ładowania zależą od elementu.

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

Składnia

src="URL"

src podaje adres zasobu, a nie jego treść ani tekst alternatywny. Podana wartość musi być poprawnym, niepustym URL-em; dozwolone są otaczające spacje. Adres względny jest rozwiązywany względem bazowego URL-a dokumentu. Nie używaj src="" jako zamiennika braku atrybutu.

W img wskazuje obraz; wymagany jest co najmniej jeden z atrybutów src i srcset. Wybór responsywny przez srcset lub picture może sprawić, że zostanie użyty inny obraz. alt dostarcza tekst alternatywny, nie adres. W input atrybut src dotyczy wyłącznie type="image" i jest wtedy wymagany. W iframe wskazuje stronę, lecz obecny srcdoc ma pierwszeństwo; w embed wskazuje osadzany zasób.

W audio i video wskazuje nagranie. Alternatywne zasoby zapisuj jako elementy source, pomijając src na elemencie nadrzędnym. Każdy taki source wymaga src. Natomiast source wewnątrz picture musi używać srcset i nie może mieć src. W track wymagany src wskazuje dane ścieżki tekstowej, np. napisów. Sama zmiana source.src w istniejącym elemencie multimedialnym nie przełącza odtwarzania; zmiana src na audio lub video uruchamia algorytm ładowania.

W script atrybut src pobiera kod zamiast używać tekstu wewnątrz elementu. Jest dozwolony tylko dla skryptów klasycznych i modułów JavaScript, nie dla map importów ani bloków danych. Nie traktuj tekstu wewnątrz skryptu z src jako kodu awaryjnego. Przykład używa samodzielnego obrazu SVG w URL-u data:, więc nie wymaga osobnego pliku obrazu.

Przykłady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>src example</title>
</head>
<body>
  <img
    src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='80'%20height='80'%3E%3Crect%20width='80'%20height='80'%20fill='blue'/%3E%3C/svg%3E"
    alt="Blue square"
    width="80"
    height="80">
</body>
</html>

Wynik

An 80 × 80 CSS-pixel blue square.

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

Źródła