CKTIS / HTML
onseeking — gestire l’inizio di un’operazione di posizionamento nei media
`onseeking` specifica il codice che gestisce l’evento `seeking`. L’evento segnala l’inizio di un’operazione di posizionamento in un contenuto audio o video, anche se la posizione di riproduzione non cambia. Non segnala la fine dell’operazione.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
HTML: onseeking="JavaScript code"
JavaScript: media.onseeking = handler;onseeking è un attributo gestore dell’evento seeking. Sugli elementi audio e video, il browser genera questo evento quando inizia un’operazione di posizionamento. L’evento può verificarsi anche se la posizione di destinazione coincide con quella di riproduzione corrente e quindi non cambia. L’operazione può iniziare usando la barra di avanzamento o impostando currentTime in uno script.
Il valore dell’attributo HTML è codice JavaScript, non il nome di un evento né l’indirizzo di un file. La proprietà JavaScript corrispondente, media.onseeking, accetta una funzione gestore; assegnarne un’altra sostituisce quella precedente. Per aggiungere listener indipendenti, usa addEventListener('seeking', handler).
Distingui seeking da seeked: il primo segnala l’inizio dell’operazione di posizionamento, mentre il secondo ne segnala il completamento. La proprietà media.seeking descrive lo stato dell’operazione; la sola assegnazione a onseeking non cambia la posizione di riproduzione.
L’esempio genera intenzionalmente un evento sintetico senza un file multimediale. Verifica che il gestore definito dall’attributo sia associato all’evento, senza eseguire una vera operazione di posizionamento. La politica di sicurezza di una pagina può bloccare gli script inline e i gestori di eventi scritti direttamente nell’HTML.
Esempi
<!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>Risultato
seeking
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.