CKTIS / HTML
onwaiting – rukovanje čekanjem na medijske podatke
Atribut onwaiting određuje kod koji se izvršava za događaj waiting. Na elementima audio i video taj događaj signalizira da se reprodukcija ne može nastaviti jer nema dovoljno dostupnih podataka. Sam atribut ne pokreće preuzimanje ni reprodukciju.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
onwaiting="JavaScript statements"
media.onwaiting = (event) => { /* handle waiting */ };onwaiting je atribut za rukovanje događajem waiting. Njegova je HTML vrijednost JavaScriptov kod, a ne Booleova vrijednost. Dostupan je na svim HTML elementima, ali se obično upotrebljava s elementima audio i video. Njegov je JavaScriptov ekvivalent svojstvo onwaiting.
Događaj waiting označava da se reprodukcija ne može nastaviti jer nisu dostupni podaci potrebni za sljedeći korak. Može se pojaviti pri pokretanju reprodukcije ili nakon što se međuspremnik isprazni. Sam po sebi ne znači trajnu pogrešku ni gubitak mrežne veze. Nemojte ga zamijeniti s događajem stalled, koji se odnosi na izostanak podataka dok ih preglednik pokušava dohvatiti.
Rukovatelj može prikazati indikator čekanja; događaj playing omogućuje reakciju na početak ili nastavak reprodukcije. Prirodni događaj waiting ne propagira se i ne može se otkazati, pa return false neće nastaviti reprodukciju. Dodjela funkcije svojstvu media.onwaiting zamjenjuje prethodni rukovatelj tog svojstva; addEventListener('waiting', handler) omogućuje registraciju neovisnih slušatelja.
Primjer namjerno šalje sintetički događaj kako rezultat ne bi ovisio o medijskoj datoteci ili mreži. Tekst odlomka trebao bi se promijeniti iz idle u waiting. Time se provjerava samo povezivanje rukovatelja: ne dolazi do stvarnog međuspremanja i stanje reprodukcije se ne mijenja. Sigurnosna pravila stranice mogu blokirati umetnute skripte i umetnute rukovatelje događaja.
Primjeri
<!doctype html>
<meta charset="utf-8">
<title>onwaiting demo</title>
<video id="media" onwaiting="document.getElementById('status').textContent = event.type"></video>
<p id="status">idle</p>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('waiting'));
</script>Rezultat
waiting
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.