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

CKTIS / HTML

srcset — lista de candidatos de imagem

O atributo `srcset` fornece recursos de imagem alternativos ao navegador. Os descritores `x` indicam a densidade de píxeis, enquanto os descritores `w` indicam a largura do recurso, usada em conjunto com `sizes` para selecionar a imagem.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

srcset="image.png 1x, image@2x.png 2x" | srcset="image-400.png 400w, image-800.png 800w" sizes="100vw"

srcset é uma lista de URLs de imagens separadas por vírgulas, com descritores opcionais. Aplica-se a img e a source dentro de picture; neste último caso, é obrigatório, e o elemento img seguinte apresenta a imagem selecionada. Não substitui src em source dentro de audio ou video.

O descritor 2x indica a densidade, enquanto 800w indica a largura natural do recurso. Os valores têm de ser positivos e não podem repetir-se. A ausência de descritor significa 1x. Não misture w com x nem com candidatos sem descritor.

Com candidatos w, img requer sizes; este descreve a largura para a seleção, não a largura do esquema CSS. Neste caso, source também requer sizes, a menos que o elemento img seguinte permita tamanhos automáticos. Com w, o navegador ignora src na seleção; com x, pode fornecer um candidato 1x se a lista não incluir nenhum.

O navegador seleciona um recurso de acordo com as condições de visualização; não parta do princípio de que existe uma correspondência fixa com a densidade do ecrã. O exemplo inclui duas imagens e mantém o mesmo aspeto, independentemente da seleção.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>srcset example</title>
<img
  src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='40'%20height='40'%3E%3Cpath%20fill='royalblue'%20d='M0,0H40V40H0Z'/%3E%3C/svg%3E"
  srcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='40'%20height='40'%3E%3Cpath%20fill='royalblue'%20d='M0,0H40V40H0Z'/%3E%3C/svg%3E 1x, data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='80'%20height='80'%3E%3Cpath%20fill='royalblue'%20d='M0,0H80V80H0Z'/%3E%3C/svg%3E 2x"
  width="40" height="40" alt="Blue square">
</html>

Resultado

A royal-blue square displayed at 40 × 40 CSS pixels.

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