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

CKTIS / HTML

loop — repetição da reprodução multimédia

O atributo booleano loop em audio e video ativa a repetição: quando o conteúdo multimédia chega ao fim, regressa ao início. Não inicia a reprodução por si só.

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

Sintaxe

<audio loop></audio>
<video loop></video>

loop aplica-se aos elementos audio e video. Durante a reprodução para a frente, faz com que o conteúdo multimédia regresse ao início do recurso quando chega ao fim. Não substitui autoplay nem um comando para iniciar a reprodução.

É um atributo booleano: a sua presença ativa-o e a sua ausência desativa-o. As formas válidas são loop, loop="" e loop="loop". Escrever loop="false" não está em conformidade e, ainda assim, ativa a repetição, porque o atributo está presente.

Em JavaScript, a propriedade media.loop reflete o atributo. Atribuir-lhe true adiciona-o e atribuir-lhe false remove-o. Durante a reprodução para a frente com repetição, não se deve esperar um evento ended no fim de cada repetição.

O exemplo verifica esta propriedade sem um ficheiro multimédia. O texto esperado é true, false, false, cada um numa linha separada; não testa a repetição efetiva da reprodução.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>loop</title>
<audio id="media" loop></audio>
<pre id="output"></pre>
<script>
  const media = document.getElementById('media');
  const results = [String(media.loop)];
  media.loop = false;
  results.push(String(media.loop));
  results.push(String(media.hasAttribute('loop')));
  document.getElementById('output').textContent = results.join('\n');
</script>

Resultado

true
false
false

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