Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes