Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje