Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje