CKTIS / HTML
onseeking — het begin van een spoelactie afhandelen
`onseeking` geeft de code op die het `seeking`-event afhandelt. Dit event geeft aan dat een spoelactie in audio of video begint, ook als de afspeelpositie gelijk blijft. Het geeft niet aan dat de actie is voltooid.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
HTML: onseeking="JavaScript code"
JavaScript: media.onseeking = handler;onseeking is een event-handlerattribuut voor seeking. Bij audio- en video-elementen verstuurt de browser dit event zodra een spoelactie begint. Dat kan ook gebeuren als de doelpositie gelijk is aan de huidige afspeelpositie en de positie dus niet verandert. Een spoelactie kan beginnen wanneer je de afspeelbalk gebruikt of currentTime in een script instelt.
De waarde van het HTML-attribuut is JavaScript-code, geen eventnaam of bestandsadres. De bijbehorende JavaScript-eigenschap media.onseeking accepteert een handlerfunctie; als je een andere functie toewijst, vervangt die de vorige. Gebruik addEventListener('seeking', handler) om onafhankelijke listeners toe te voegen.
Maak onderscheid tussen seeking en seeked: het eerste geeft het begin van de spoelactie aan, het tweede de voltooiing ervan. De eigenschap media.seeking beschrijft de status van de bewerking; een toewijzing aan onseeking verandert op zichzelf de afspeelpositie niet.
Het voorbeeld verstuurt bewust een synthetisch event zonder mediabestand. Het controleert of de handler van het attribuut is gekoppeld, niet of er daadwerkelijk wordt gespoeld. Het beveiligingsbeleid van een pagina kan inline scripts en event-handlers die rechtstreeks in HTML staan blokkeren.
Voorbeelden
<!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>Resultaat
seeking
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.