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
- HTML Standard — The img element
- HTML Standard — The source element
- HTML Standard — The embed element
- HTML Standard — The iframe element
- HTML Standard — Image Button state
- HTML Standard — Location of the media resource
- HTML Standard — The track element
- HTML Standard — The audio element
- HTML Standard — The video element
- HTML Standard — The script element