CKTIS / HTML
onplaying — gérer la disponibilité de la lecture
L’attribut onplaying contient le code qui gère l’événement playing, utilisé par les éléments audio et vidéo lorsque la lecture est prête à commencer ou à reprendre après une interruption. Il ne démarre pas la lecture et n’est pas équivalent à onplay.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onplaying="JavaScript statements"
media.onplaying = (event) => { /* handler */ };onplaying est un attribut de gestion de l’événement playing. Il est disponible comme attribut HTML sur tous les éléments HTML, mais son usage typique concerne les éléments audio et video. Sa valeur est du code JavaScript, et non une adresse de fichier ou une valeur booléenne.
L’événement playing indique que la lecture est prête à commencer après une pause ou un délai dû à un manque de données. À l’inverse, play signale que paused est passé à false. playing peut se produire de nouveau après la mise en mémoire tampon ; il ne garantit ni une lecture ininterrompue ni un son audible.
En JavaScript, vous pouvez affecter une fonction à media.onplaying ; une affectation ultérieure remplace la fonction précédente pour ce gestionnaire. Une autre possibilité est media.addEventListener('playing', handler). La mise en place d’un gestionnaire ne démarre pas la lecture à elle seule.
L’exemple déclenche un événement playing synthétique pour tester l’attribut sans fichier multimédia. Le texte attendu est playing. Cela ne teste pas la lecture réelle ; les scripts doivent être activés et les gestionnaires d’événements intégrés autorisés.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>onplaying test</title>
<audio id="media" onplaying="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('playing'));
</script>Résultat
playing
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.