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

CKTIS / HTML

source — recursos alternativos de imagem e multimédia

O elemento `source` declara recursos alternativos para `picture`, `audio` ou `video`. Não apresenta nada por si só. Dentro de `picture`, requer `srcset`; dentro de `audio` e `video`, requer `src`. Estes usos não devem ser confundidos.

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

Sintaxe

<picture>
  <source srcset="image.svg" type="image/svg+xml">
  <img src="fallback.png" alt="Description">
</picture>

source é um elemento vazio: não tem conteúdo nem etiqueta de fecho. Dentro de picture, coloque-o antes do img obrigatório. Dentro de audio e video, os elementos filhos source só são permitidos se o elemento pai não tiver o atributo src e têm de preceder os elementos track e o conteúdo alternativo. Se o elemento pai tiver o atributo src, é esse atributo que se utiliza na seleção do recurso, em vez dos elementos filhos source.

Dentro de picture, srcset é obrigatório e src é proibido. img apresenta a imagem e também fornece o texto alt e uma fonte alternativa. sizes descreve o tamanho da imagem para candidatos com descritores de largura; é obrigatório, a menos que img permita tamanhos automáticos. width e height podem definir as dimensões e a proporção da variante selecionada.

Dentro de audio e video, cada source requer um URL src não vazio. O atributo opcional type indica um tipo MIME e ajuda a ignorar um formato não suportado sem o transferir. media contém media queries: em picture, a seleção reage a alterações do ambiente; nos elementos multimédia, a condição é avaliada apenas uma vez durante a seleção do recurso.

Alterar apenas src ou type de uma fonte existente dentro de audio ou video não altera a reprodução; defina o src do elemento pai. No exemplo, as imagens incorporadas eliminam dependências da rede: com uma janela de visualização com pelo menos 600 píxeis CSS de largura, é selecionada a variante azul; abaixo desse valor, é selecionada a variante laranja.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>source demo</title>
<picture>
  <source media="(min-width: 600px)" type="image/svg+xml"
    srcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='120'%20height='80'%3E%3Cpath%20fill='blue'%20d='M0,0H120V80H0Z'/%3E%3C/svg%3E">
  <img width="120" height="80" alt="Color sample"
    src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='120'%20height='80'%3E%3Cpath%20fill='orange'%20d='M0,0H120V80H0Z'/%3E%3C/svg%3E">
</picture>
</html>

Resultado

Viewport >= 600 CSS px: blue rectangle, 120 × 80 CSS px.
Viewport < 600 CSS px: orange rectangle, 120 × 80 CSS px.

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