CKTIS / HTML
oncanplay — gérer la disponibilité des médias pour la lecture
L’attribut oncanplay contient du JavaScript exécuté lors de l’événement canplay. Pour l’audio et la vidéo, cet événement indique que la lecture peut commencer ou reprendre, mais ne garantit pas que la ressource entière pourra être lue sans interruption due à la mise en mémoire tampon.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<audio oncanplay="handler(event)"></audio>
<video oncanplay="handler(event)"></video>oncanplay est un attribut de contenu gestionnaire d’événement pour canplay. Sa valeur est du code JavaScript ; le gestionnaire peut accéder à l’objet event. L’attribut est autorisé sur tous les éléments HTML, mais il sert généralement à réagir à la disponibilité des éléments audio et video.
Le navigateur déclenche canplay lorsque l’état de disponibilité du média passe d’un niveau inférieur à HAVE_FUTURE_DATA ou à un niveau supérieur. Des données permettent alors de poursuivre la lecture, sans qu’il y en ait nécessairement assez pour lire toute la ressource sans mise en mémoire tampon. En revanche, canplaythrough indique qu’il est estimé possible de lire la ressource jusqu’à la fin sans interruption pour mise en mémoire tampon. À lui seul, canplay ne signifie pas que la lecture est déjà en cours.
En HTML, utilisez oncanplay="handler(event)" ; en JavaScript, affectez une fonction à media.oncanplay ou appelez media.addEventListener('canplay', handler). Le nom de l’événement ne comporte pas le préfixe on. L’exemple déclenche un événement synthétique : il vérifie le lien entre l’attribut et son gestionnaire, et non la disponibilité réelle du média.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>oncanplay demo</title>
<audio id="media" oncanplay="document.getElementById('result').textContent = event.type"></audio>
<pre id="result">waiting</pre>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('canplay'));
</script>Résultat
canplay
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.