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

CKTIS / HTML

poster — imagem de pré-visualização do vídeo

O atributo poster de video indica uma imagem de pré-visualização que o navegador pode apresentar antes da reprodução do vídeo.

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

Sintaxe

<video poster="image-url"></video>

O atributo poster de video identifica uma imagem que representa o vídeo. O seu valor tem de ser um URL válido e não vazio; os endereços relativos são resolvidos em relação ao documento. Não é um atributo booleano nem o endereço do vídeo — essa função pertence a src.

Quando os dados de imagem do vídeo não estão disponíveis, é apresentado um poster disponível. Se o atributo for omitido, tiver um valor vazio ou a obtenção da imagem falhar, não é apresentado nenhum poster. Pausar simplesmente a reprodução não garante que o poster volte a aparecer.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>poster</title>
<video width="320" height="180" controls
  poster="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='320' height='180'%3E%3Cpath fill='red' d='M0 0H320V180H0Z'/%3E%3C/svg%3E">
</video>
</html>

Resultado

A red 320 × 180 poster image; browser controls may overlay it. No playable video.

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