CKTIS / HTML
img — incorporar uma imagem
O elemento img incorpora uma imagem num documento HTML. Os atributos src e srcset indicam os recursos, enquanto alt fornece um texto que substitui a informação transmitida pela imagem.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<img src="image-url" alt="text alternative" width="160" height="100">img representa uma imagem. É um elemento vazio: não tem conteúdo filho nem etiqueta de fecho. É obrigatório indicar pelo menos um dos atributos src ou srcset; src tem de conter um URL de imagem não vazio.
Normalmente, indica alt para transmitir o significado da imagem no respetivo contexto, em vez do nome do ficheiro. Para uma imagem puramente decorativa, utiliza alt="". A ausência de alt não equivale a um texto alternativo vazio; a omissão só é permitida nos casos limitados definidos pela norma.
width e height ajudam o navegador a reservar espaço antes de a imagem ser carregada. srcset disponibiliza alternativas para o navegador escolher. Com descritores de largura w, o atributo sizes é obrigatório, a menos que o elemento img permita determinar automaticamente o tamanho. Por exemplo, com loading="lazy", que permite adiar o carregamento da imagem, pode omitir-se sizes.
O exemplo incorpora uma imagem SVG num URL data:, pelo que não necessita de um ficheiro separado nem de ligação à rede. O resultado esperado é um retângulo azul com 160 × 100 píxeis CSS.
Exemplos
<!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>Resultado
A blue rectangle, 160 CSS pixels wide and 100 CSS pixels high.
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.