CKTIS / HTML
onsuspend — práce s pozastavením načítání médií
Atribut onsuspend určuje JavaScript, který se spustí při události suspend. U zvuku a videa tato událost znamená, že prohlížeč právě záměrně nenačítá data, nikoli že bylo pozastaveno přehrávání.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onsuspend="JavaScript statements"onsuspend je globální obsahový atribut obsluhy události suspend. Jeho hodnotou je kód JavaScriptu, nikoli adresa zdroje nebo logická hodnota. Atribut je dostupný u prvků HTML, obvykle se však používá u prvků audio a video.
Prohlížeč vyvolá suspend, když záměrně pozastaví načítání mediálních dat, a nastaví přitom networkState na NETWORK_IDLE. Může například čekat na začátek přehrávání, než stáhne další data. Samo o sobě to neznamená chybu ani pozastavené přehrávání: pause se týká přehrávání, zatímco stalled označuje situaci, kdy se prohlížeč pokouší načítat data, ale žádná nepřijímá.
V kódu atributu zpřístupňuje event objekt události. V JavaScriptu můžete místo toho přiřadit funkci vlastnosti element.onsuspend nebo použít element.addEventListener('suspend', handler). Název události neobsahuje předponu on.
Příklad vyvolá syntetickou událost, aby výsledek nezávisel na síti ani na rozhodnutích prohlížeče o ukládání do vyrovnávací paměti. Ověřuje pouze spuštění kódu atributu; nepozastavuje načítání ani nemění networkState. Bezpečnostní zásady stránky mohou blokovat kód obsluhy události zapsaný přímo v atributech.
Příklady
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onsuspend demo</title>
<audio id="media" onsuspend="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
document.getElementById('media').dispatchEvent(new Event('suspend'));
</script>
</html>Výsledek
suspend
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.