CKTIS / HTML
onended — gérer la fin de la lecture
L’attribut onended contient du JavaScript exécuté lorsqu’un événement ended est reçu. Sur les éléments audio et video, il permet de réagir lorsque le média atteint sa fin, et non lorsque la lecture est simplement mise en pause.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<audio onended="JavaScript statements"></audio>
<video onended="JavaScript statements"></video>onended est un attribut de contenu de gestionnaire d’événement pour ended. Sa valeur est le corps d’une fonction JavaScript, et non une URL de fichier ni simplement un nom de fonction. Il est possible d’utiliser event pour examiner l’événement.
Pour audio et video, le navigateur déclenche ended lorsque la lecture vers l’avant atteint la fin du média. Appeler pause() ne signifie pas à lui seul que la lecture est terminée. Si loop est défini, atteindre la fin pendant la lecture vers l’avant ramène la lecture au début au lieu de déclencher cet événement.
Il faut distinguer l’attribut HTML onended, la propriété JavaScript media.onended qui contient une fonction de gestionnaire, et la propriété d’état booléenne media.ended. Une solution de remplacement de l’attribut est media.addEventListener('ended', handler) ; le nom de l’événement n’a pas de préfixe on.
L’exemple déclenche volontairement un événement synthétique et ne nécessite donc aucun fichier média. Il vérifie le raccordement du gestionnaire, pas la fin réelle de la lecture. La politique de sécurité d’une page peut bloquer le code de gestionnaire d’événement intégré dans l’attribut.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>onended test</title>
<audio id="media" onended="document.getElementById('result').textContent = event.type"></audio>
<output id="result">waiting</output>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('ended'));
</script>Résultat
ended
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.