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

CKTIS / HTML

onseeking — gérer le début d’une opération de positionnement dans un média

`onseeking` définit le code qui gère l’événement `seeking`. Cet événement signale le début d’une opération de positionnement dans un contenu audio ou vidéo, même si la position de lecture ne change pas. Il n’en signale pas la fin.

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

Syntaxe

HTML: onseeking="JavaScript code"
JavaScript: media.onseeking = handler;

onseeking est un attribut de gestion de l’événement seeking. Sur les éléments audio et video, le navigateur déclenche cet événement au début d’une opération de positionnement. L’événement peut se produire même si la position visée est la position de lecture actuelle et que celle-ci ne change pas. L’utilisation de la barre de progression ou la modification de la valeur de currentTime par un script peut lancer cette opération.

La valeur de l’attribut HTML est du code JavaScript, et non un nom d’événement ou une adresse de fichier. La propriété JavaScript correspondante, media.onseeking, accepte une fonction de gestion ; l’affectation d’une autre fonction remplace la précédente. Pour ajouter des écouteurs indépendants, utilisez addEventListener('seeking', handler).

Distinguez seeking de seeked : le premier signale le début de l’opération de positionnement, tandis que le second en signale la fin. La propriété media.seeking décrit l’état de l’opération ; une affectation à onseeking ne modifie pas à elle seule la position de lecture.

L’exemple déclenche volontairement un événement synthétique sans fichier multimédia. Il vérifie que le gestionnaire défini par l’attribut est bien associé à l’événement, sans effectuer de véritable opération de positionnement. La politique de sécurité d’une page peut bloquer les scripts intégrés et les gestionnaires d’événements écrits directement dans le HTML.

Exemples

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

Résultat

seeking

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