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

CKTIS / HTML

onplay — gérer l’événement play

L’attribut onplay contient du JavaScript exécuté lors de l’événement play, généralement sur un élément audio ou video. Cet événement signale la sortie de l’état de pause, mais ne garantit pas que le son ou la vidéo soit déjà en cours de lecture.

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

Syntaxe

onplay="JavaScript statements"

onplay est un attribut de contenu gestionnaire d’événement pour play. Sa valeur est le corps d’une fonction JavaScript, et non une adresse de fichier ou un attribut booléen. Il est généralement utilisé sur les éléments audio et video ; l’ajout de l’attribut ne lance pas la lecture.

Le navigateur déclenche play lorsque paused passe de true à false, par exemple à la suite de play() ou de autoplay. Cela ne signifie pas encore qu’une lecture effective a lieu : les données peuvent ne pas être disponibles. L’événement playing, géré avec onplaying, concerne le début ou la reprise de la lecture après une interruption due à un manque de données.

En JavaScript, affectez une fonction à media.onplay ou utilisez media.addEventListener('play', handler). Affecter la propriété remplace la fonction précédente dans cet emplacement de gestionnaire d’événement. La Content Security Policy peut bloquer le code écrit directement dans l’attribut.

L’exemple déclenche un play synthétique et n’a donc pas besoin de fichier multimédia. Le texte attendu est play ; ce test vérifie le branchement du gestionnaire, pas la lecture.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onplay test</title>
<audio id="media" onplay="document.getElementById('result').textContent = event.type;"></audio>
<p id="result">pending</p>
<script>
  document.getElementById('media').dispatchEvent(new Event('play'));
</script>
</html>

Résultat

play

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