CKTIS / HTML
onprogress — gérer les événements de progression du téléchargement
L’attribut onprogress contient du JavaScript qui gère l’événement progress. Pour les éléments audio et video, il concerne le téléchargement des données multimédias, et non le temps de lecture écoulé.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onprogress="JavaScript statements"
element.onprogress = handler;
element.addEventListener("progress", handler);onprogress est un attribut de gestionnaire d’événement pour progress. Il est disponible sur tous les éléments HTML, mais sa seule présence ne lance aucun téléchargement et ne génère aucun événement. La propriété JavaScript correspondante est également disponible sur les objets Document et Window.
Pour audio et video, progress signale le téléchargement des données multimédias. Il ne signifie pas que la lecture progresse et ne fournit pas automatiquement un pourcentage des octets téléchargés. L’événement multimédia utilise l’interface Event, et non ProgressEvent ; ne supposez pas que loaded et total sont disponibles.
La valeur de l’attribut est du code JavaScript, dans lequel event désigne l’événement. Vous pouvez aussi affecter une fonction à element.onprogress ou utiliser element.addEventListener("progress", handler). L’affectation à la propriété remplace le gestionnaire précédent associé à ce mécanisme ; addEventListener() permet d’enregistrer des écouteurs indépendants.
L’exemple déclenche explicitement un événement progress synthétique ; son résultat ne dépend donc pas du réseau. Il teste la gestion de l’attribut, et non la progression réelle d’un téléchargement. La Content Security Policy peut bloquer les gestionnaires d’événements et les scripts intégrés.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onprogress demo</title>
<body>
<audio id="media" onprogress="document.getElementById('result').textContent = event.type"></audio>
<p id="result">waiting</p>
<script>
document.getElementById('media').dispatchEvent(new Event('progress'));
</script>
</body>
</html>Résultat
progress
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.