CKTIS / HTML
img — incorporare un’immagine
L’elemento img incorpora un’immagine in un documento HTML. Gli attributi src e srcset indicano le risorse, mentre alt fornisce un testo che sostituisce le informazioni trasmesse dall’immagine.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<img src="image-url" alt="text alternative" width="160" height="100">img rappresenta un’immagine. È un elemento vuoto: non ha contenuto figlio né tag di chiusura. È richiesto almeno uno tra gli attributi src e srcset; src deve contenere un URL di immagine non vuoto.
Di norma, specifica alt in modo che comunichi il significato dell’immagine nel contesto, non il nome del file. Per un’immagine puramente decorativa, usa alt="". L’assenza di alt non equivale a un testo alternativo vuoto; ometterlo è consentito solo nei casi limitati definiti dallo standard.
width e height aiutano il browser a riservare spazio prima che l’immagine venga caricata. srcset offre alternative tra cui il browser può scegliere. Con i descrittori di larghezza w, sizes è obbligatorio, a meno che l’elemento img non consenta di determinare automaticamente la dimensione. Per esempio, con loading="lazy", che consente di rimandare il caricamento dell’immagine, si può omettere sizes.
L’esempio incorpora un’immagine SVG in un URL data:, quindi non richiede un file separato né una connessione di rete. Il risultato atteso è un rettangolo blu di 160 × 100 pixel CSS.
Esempi
<!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>Risultato
A blue rectangle, 160 CSS pixels wide and 100 CSS pixels high.
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.