CKTIS / HTML
onloadeddata — gérer les données multimédias disponibles
L’attribut onloadeddata exécute du code lors de l’événement loadeddata, lorsque des données pour la position de lecture audio ou vidéo actuelle deviennent disponibles pour la première fois. Cela ne signifie pas que le fichier entier a été téléchargé ni que la lecture a commencé.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<video onloadeddata="handleData(event)"></video>
<audio onloadeddata="handleData(event)"></audio>
media.onloadeddata = handleData;onloadeddata est un attribut HTML de gestionnaire d’événement pour loadeddata. Il est disponible sur les éléments HTML, mais s’utilise principalement avec audio et video. Sa valeur est du code JavaScript, et non une valeur booléenne.
Le navigateur déclenche loadeddata lorsqu’il peut afficher pour la première fois des données à la position de lecture actuelle pendant le chargement : readyState atteint HAVE_CURRENT_DATA (2) ou un état supérieur. Pour une vidéo, cela signifie que l’image actuelle est disponible, et non le film entier. loadedmetadata concerne les métadonnées, tandis que canplay indique que la lecture peut se poursuivre au moins un peu. loadeddata ne démarre pas la lecture à lui seul.
En JavaScript, affectez une fonction à media.onloadeddata ; une affectation ultérieure remplace le gestionnaire précédent à cet emplacement. Vous pouvez aussi utiliser media.addEventListener('loadeddata', handler). Le nom de l’événement ne comporte pas de préfixe on. La politique de sécurité du contenu (Content Security Policy) peut bloquer les gestionnaires écrits directement dans les attributs.
L’exemple déclenche volontairement un événement synthétique. Il vérifie le lien entre l’attribut et le gestionnaire, ainsi que la mise à jour du texte, mais ne teste ni le décodage ni la disponibilité du média.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onloadeddata demo</title>
<audio id="media" onloadeddata="document.getElementById('result').textContent = event.type"></audio>
<p id="result">waiting</p>
<script>
// Synthetic event: tests the handler, not media loading.
document.getElementById('media').dispatchEvent(new Event('loadeddata'));
</script>
</html>Résultat
loadeddata
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.