CKTIS / HTML
onwaiting – spracovanie čakania na mediálne údaje
Atribút onwaiting určuje kód, ktorý sa vykoná pri udalosti waiting. V prvkoch audio a video táto udalosť signalizuje, že prehrávanie nemôže pokračovať, pretože nie sú k dispozícii dostatočné údaje. Samotný atribút nespúšťa sťahovanie ani prehrávanie.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onwaiting="JavaScript statements"
media.onwaiting = (event) => { /* handle waiting */ };onwaiting je atribút obsluhy udalosti waiting. Jeho hodnota v HTML je kód JavaScriptu, nie boolovská hodnota. Je dostupný na všetkých prvkoch HTML, zvyčajne sa však používa pri prvkoch audio a video. Zodpovedajúcou vlastnosťou v JavaScripte je onwaiting.
Udalosť waiting signalizuje, že prehrávanie nemôže pokračovať, pretože nie sú k dispozícii údaje potrebné na ďalší krok. Môže nastať pri spustení prehrávania alebo po vyčerpaní vyrovnávacej pamäte. Sama osebe neznamená trvalú chybu ani stratu sieťového pripojenia. Nezamieňajte si ju s udalosťou stalled, ktorá sa týka neprichádzajúcich údajov počas pokusu prehliadača o ich načítanie.
Obsluha môže zobraziť indikátor čakania; udalosť playing umožňuje reagovať na začiatok alebo obnovenie prehrávania. Prirodzená udalosť waiting sa nešíri nahor a nemožno ju zrušiť, takže return false prehrávanie neobnoví. Priradenie funkcie k media.onwaiting nahradí predchádzajúcu obsluhu tejto vlastnosti; addEventListener('waiting', handler) umožňuje zaregistrovať nezávislých poslucháčov.
Príklad zámerne odošle syntetickú udalosť, aby výsledok nezávisel od mediálneho súboru ani od siete. Text odseku by sa mal zmeniť z idle na waiting. Test overuje iba zapojenie obsluhy: nespôsobuje skutočné ukladanie do vyrovnávacej pamäte ani nemení stav prehrávania. Bezpečnostná politika stránky môže blokovať vložené skripty a obsluhy udalostí v HTML.
Príklady
<!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>Výsledok
waiting
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.