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

CKTIS / HTML

imagesrcset — pré-carregamento adaptativo de imagens

O atributo imagesrcset permite ao navegador escolher uma variante de imagem para pré-carregar. Só é permitido num elemento link com rel="preload" e as="image", e corresponde ao atributo srcset de uma imagem apresentada posteriormente.

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

Sintaxe

<link rel="preload" as="image" imagesrcset="URL WIDTHw, URL WIDTHw" imagesizes="SOURCE_SIZE">

imagesrcset especifica candidatos para pré-carregar uma imagem, não a imagem apresentada na página. Só é permitido num elemento link com rel="preload" e as="image". Um elemento img separado apresenta a imagem.

O valor usa a sintaxe de srcset: uma lista de URLs separados por vírgulas, opcionalmente com descritores de largura, como 400w, ou de densidade, como 2x. Não misture w e x na mesma lista. w descreve a largura real do recurso em píxeis; x descreve a densidade de píxeis.

Se a lista incluir descritores w, também é obrigatório usar imagesizes, que descreve a largura prevista da imagem na disposição da página. Não define dimensões CSS. O navegador seleciona um candidato com base no tamanho da origem e nas condições do dispositivo; a lista não significa que todas as variantes sejam transferidas.

Faça corresponder imagesrcset e imagesizes a srcset e sizes do elemento img correspondente. Pode omitir href para evitar que um navegador sem suporte para imagesrcset pré-carregue uma variante inadequada. O exemplo tem um candidato e um recurso incorporado, pelo que o resultado visual não depende de ficheiros externos; no entanto, não mede os benefícios de rede.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>imagesrcset demo</title>
  <link rel="preload" as="image"
        imagesrcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='40'%20height='40'%3E%3Cpath%20fill='red'%20d='M0%200h40v40H0z'/%3E%3C/svg%3E 40w"
        imagesizes="40px">
</head>
<body>
  <img width="40" height="40" alt="Red square"
       srcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='40'%20height='40'%3E%3Cpath%20fill='red'%20d='M0%200h40v40H0z'/%3E%3C/svg%3E 40w"
       sizes="40px">
</body>
</html>

Resultado

A red square measuring 40 × 40 CSS pixels; no console output.

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