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

CKTIS / HTML

onloadedmetadata — gérer le chargement des métadonnées multimédias

L’attribut onloadedmetadata contient du JavaScript qui gère l’événement loadedmetadata, généralement sur audio ou video. Il signale que les métadonnées sont disponibles, et non que le téléchargement est terminé ou que la lecture peut se poursuivre sans interruption.

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

Syntaxe

onloadedmetadata="JavaScript statements"

onloadedmetadata est un attribut HTML de gestion de l’événement loadedmetadata. Sa valeur est du code JavaScript, et non un nom d’événement ou une valeur booléenne. Il est autorisé sur les éléments HTML, mais son usage courant concerne audio et video.

Le navigateur déclenche loadedmetadata lorsque les métadonnées de la ressource en cours de chargement deviennent disponibles pour la première fois : readyState atteint au moins HAVE_METADATA. Vous pouvez alors lire duration et, pour une vidéo, videoWidth et videoHeight. La durée peut valoir Infinity si la ressource n’a pas de fin connue. Cela ne signifie pas que le fichier entier a été téléchargé ; loadeddata concerne la disponibilité des données de l’image courante.

Dans le code de l’attribut, event désigne l’événement et this l’élément. En JavaScript, vous pouvez plutôt affecter une fonction à media.onloadedmetadata ou utiliser media.addEventListener('loadedmetadata', handler). Le nom de l’événement n’a pas de préfixe on. L’affectation à la propriété remplace sa fonction précédente ; addEventListener permet d’ajouter des gestionnaires indépendants. Une politique CSP peut bloquer le code des attributs.

L’exemple déclenche volontairement un événement synthétique pour tester l’attribut sans fichier multimédia. Il ne charge pas de métadonnées et ne modifie pas readyState. Pour un véritable chargement multimédia, enregistrez le gestionnaire avant de commencer à récupérer la ressource.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onloadedmetadata demo</title>
<audio id="media" onloadedmetadata="document.getElementById('result').textContent = event.type + ' handled'"></audio>
<p id="result">Waiting</p>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('loadedmetadata'));
</script>
</html>

Résultat

loadedmetadata handled

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