Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

loop — répétition de la lecture des médias

L’attribut booléen loop sur audio et video active la répétition : lorsque le média atteint la fin, il revient au début. Il ne lance pas la lecture à lui seul.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

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

loop s’applique aux éléments audio et video. Lors d’une lecture vers l’avant, il fait revenir le média au début de la ressource lorsqu’il en atteint la fin. Il ne remplace ni autoplay ni une commande de démarrage de la lecture.

Il s’agit d’un attribut booléen : sa présence l’active et son absence le désactive. Les formes valides sont loop, loop="" et loop="loop". Écrire loop="false" n’est pas conforme et active tout de même la répétition, car l’attribut est présent.

En JavaScript, la propriété media.loop reflète l’attribut. Lui affecter true ajoute l’attribut, tandis que false le supprime. Lors d’une lecture en boucle vers l’avant, ne vous attendez pas à recevoir un événement ended à la fin de chaque répétition.

L’exemple vérifie cette propriété sans fichier média. Le texte attendu est true, false, false, chacun sur une ligne distincte ; il ne teste pas la répétition réelle de la lecture.

Exemples

<!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>

Résultat

true
false
false

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources