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.