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

CKTIS / HTML

onpause — gestionnaire de l’événement de mise en pause des médias

L’attribut onpause contient du JavaScript qui gère l’événement pause, généralement sur un élément audio ou video. Il réagit à la mise en pause de la lecture, mais ne met pas lui-même la lecture en pause.

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

Syntaxe

<audio onpause="handlerCode"></audio>
<video onpause="handlerCode"></video>
media.onpause = handler;
media.addEventListener("pause", handler);

onpause est un attribut global de gestion de l’événement pause. Bien qu’il soit disponible sur tous les éléments HTML, il sert généralement à gérer les mises en pause des éléments audio et video. Sa valeur est du code JavaScript, et non une valeur booléenne.

Lors d’une mise en pause normale d’un média, paused passe à true et l’événement est déclenché dans une tâche mise en file d’attente. Appeler pause() sur un élément déjà en pause ne déclenche pas un nouvel événement pause. L’événement ne remonte pas dans l’arborescence et ne peut pas être annulé ; return false n’empêche pas la mise en pause.

Dans le code de l’attribut, event représente l’événement et this désigne l’élément. La propriété JavaScript media.onpause accepte une fonction ou null ; une nouvelle affectation remplace la fonction précédente. media.addEventListener("pause", handler) permet d’enregistrer des gestionnaires indépendants. Une politique CSP peut bloquer le code des attributs.

L’exemple déclenche un événement pause synthétique afin de vérifier le raccordement de l’attribut sans fichier média. Le texte attendu est pause. Ce test ne démarre ni ne met en pause la lecture et ne vérifie pas une véritable transition d’état du média.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>onpause test</title>
<audio id="media" onpause="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('pause'));
</script>

Résultat

pause

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