CKTIS / HTML
onwaiting – zpracování čekání na mediální data
Atribut onwaiting určuje kód, který se spustí při události waiting. U prvků audio a video tato událost signalizuje, že přehrávání nemůže pokračovat, protože nejsou k dispozici dostatečná data. Samotný atribut nespouští stahování ani přehrávání.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onwaiting="JavaScript statements"
media.onwaiting = (event) => { /* handle waiting */ };onwaiting je atribut obsluhy události waiting. Jeho hodnota v HTML je kód JavaScriptu, nikoli booleovská hodnota. Je dostupný u všech prvků HTML, běžně se však používá u prvků audio a video. Odpovídající vlastností v JavaScriptu je onwaiting.
Událost waiting signalizuje, že přehrávání nemůže pokračovat, protože nejsou dostupná data potřebná pro další krok. Může nastat při zahájení přehrávání nebo po vyčerpání vyrovnávací paměti. Sama o sobě neznamená trvalou chybu ani ztrátu síťového připojení. Nezaměňujte ji s událostí stalled, která označuje, že během pokusu prohlížeče o načtení data nepřicházejí.
Obsluha může zobrazit indikátor čekání; událost playing umožňuje reagovat na zahájení nebo obnovení přehrávání. Přirozená událost waiting se nešíří vzhůru a nelze ji zrušit, takže return false přehrávání neobnoví. Přiřazení funkce k media.onwaiting nahradí předchozí obsluhu této vlastnosti; addEventListener('waiting', handler) umožňuje zaregistrovat nezávislé posluchače.
Příklad záměrně odešle syntetickou událost, aby výsledek nezávisel na mediálním souboru ani síti. Text odstavce by se měl změnit z idle na waiting. Test ověřuje pouze zapojení obsluhy: nezpůsobuje skutečné ukládání do vyrovnávací paměti ani nemění stav přehrávání. Bezpečnostní zásady stránky mohou blokovat vložené skripty a obsluhy událostí v HTML.
Pří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ýsledek
waiting
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.