CKTIS / HTML
img — osadzanie obrazu
Element img osadza obraz w dokumencie HTML. Atrybuty src i srcset wskazują zasoby, a alt zapewnia tekst zastępujący informację przekazywaną przez obraz.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<img src="image-url" alt="text alternative" width="160" height="100">img reprezentuje obraz. Jest elementem pustym: nie zawiera elementów potomnych ani znacznika końcowego. Wymaga co najmniej jednego z atrybutów src lub srcset; wartość src musi być niepustym adresem URL obrazu.
Zwykle należy podać alt przekazujący znaczenie obrazu w danym kontekście, a nie nazwę pliku. Dla obrazu czysto dekoracyjnego użyj alt="". Brak alt nie oznacza tego samego co pusty tekst alternatywny; pominięcie jest dozwolone tylko w ograniczonych przypadkach określonych w standardzie.
width i height pomagają przeglądarce zarezerwować miejsce przed załadowaniem obrazu. srcset udostępnia warianty do wyboru przez przeglądarkę. Przy deskryptorach szerokości w atrybut sizes jest wymagany, chyba że element img dopuszcza automatyczne ustalanie rozmiaru. Na przykład przy loading="lazy", które pozwala odroczyć ładowanie obrazu, można pominąć sizes.
Przykład zawiera obraz SVG w adresie data:, więc nie wymaga osobnego pliku ani połączenia sieciowego. Oczekiwany wynik to niebieski prostokąt o wymiarach 160 × 100 pikseli CSS.
Przykłady
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Image example</title>
<img
src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='160'%20height='100'%3E%3Crect%20width='160'%20height='100'%20fill='blue'/%3E%3C/svg%3E"
alt="Blue rectangle"
width="160"
height="100">
</html>Wynik
A blue rectangle, 160 CSS pixels wide and 100 CSS pixels high.
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.