CKTIS / HTML
onemptied — gérer la réinitialisation d’une ressource multimédia
L’attribut onemptied indique le code JavaScript à exécuter lorsqu’un événement emptied se produit. Pour l’audio et la vidéo, cet événement concerne la réinitialisation de l’état de la ressource multimédia, et non la fin normale de la lecture.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onemptied="JavaScript statements"onemptied est un attribut de contenu HTML de gestionnaire d’événement pour l’événement emptied. Sa valeur contient des instructions JavaScript ; dans le gestionnaire, l’objet événement est accessible sous le nom event. Il s’agit d’un attribut global de gestionnaire d’événement, mais les éléments audio et video sont les sources naturelles de cet événement.
Le navigateur déclenche emptied lorsque l’état de la ressource multimédia est réinitialisé. Par exemple, load() met cet événement en attente si le networkState précédent n’était pas NETWORK_EMPTY. Appeler load() sur un élément neuf et vide ne garantit donc pas qu’un événement se produise. Ne confondez pas emptied avec ended, qui indique que la lecture a atteint sa fin, ni avec un manque temporaire de données pour poursuivre la lecture.
En JavaScript, au lieu de l’attribut, vous pouvez affecter une fonction à media.onemptied ou utiliser media.addEventListener('emptied', handler). Le nom de l’événement ne comporte pas de préfixe on. Une nouvelle affectation de la propriété remplace le gestionnaire précédent ; addEventListener permet d’enregistrer des gestionnaires indépendants. Une politique CSP peut bloquer le code dans les attributs de gestionnaire d’événement.
L’exemple déclenche volontairement un événement emptied synthétique et ne nécessite donc ni fichier multimédia ni accès au réseau. Le résultat visible attendu est emptied. Cela teste le raccordement du gestionnaire, et non une véritable réinitialisation de la ressource ; déclencher l’événement ne modifie pas l’état du média.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>onemptied</title>
<audio onemptied="document.getElementById('result').textContent = event.type;"></audio>
<output id="result">pending</output>
<script>
const media = document.querySelector('audio');
media.dispatchEvent(new Event('emptied'));
</script>Résultat
emptied
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.