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

CKTIS / HTML

preload — indicação de pré-carregamento de multimédia

O atributo preload dos elementos audio e video indica ao navegador que quantidade de dados multimédia poderá valer a pena obter antecipadamente. Os valores none, metadata e auto são indicações, não garantias.

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

Sintaxe

preload="none|metadata|auto"

preload é um atributo enumerado de audio e video, não um atributo booleano. Sugere uma estratégia de armazenamento em buffer para o recurso multimédia.

none sugere evitar a obtenção antecipada; não proíbe obter o recurso quando a reprodução começa. metadata sugere obter metadados, como a duração e as dimensões, possivelmente também as imagens iniciais; durante a reprodução, indica largura de banda limitada. auto permite descarregar até o recurso completo, mas não o exige.

Um valor vazio significa auto. Se o atributo estiver ausente ou tiver um valor inválido, o comportamento predefinido depende da implementação; a norma sugere metadata.

O navegador pode ignorar a indicação. autoplay pode sobrepor-se a ela e, com os scripts ativados, loading="lazy" pode adiar a sua aplicação. A propriedade DOM preload reflete o atributo e permite alterar a indicação mesmo durante o armazenamento em buffer ou a reprodução.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>preload</title>
<audio id="media" preload="none"></audio>
<pre id="result"></pre>
<script>
  const media = document.getElementById('media');
  const values = [media.preload];
  media.preload = 'metadata';
  values.push(media.preload);
  media.preload = 'auto';
  values.push(media.preload);
  document.getElementById('result').textContent = values.join('\n');
</script>

Resultado

none
metadata
auto

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