CKTIS / HTML
onsuspend — práca s pozastavením načítania médií
Atribút onsuspend určuje JavaScript, ktorý sa spustí pri udalosti suspend. Pri zvuku a videu táto udalosť znamená, že prehliadač práve zámerne nenačítava údaje, nie že sa pozastavilo prehrávanie.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onsuspend="JavaScript statements"onsuspend je globálny obsahový atribút obsluhy udalosti suspend. Jeho hodnotou je kód JavaScriptu, nie adresa zdroja ani logická hodnota. Atribút je dostupný na prvkoch HTML, zvyčajne sa však používa na prvkoch audio a video.
Prehliadač vyvolá suspend, keď zámerne pozastaví načítavanie mediálnych údajov, a nastaví pritom networkState na NETWORK_IDLE. Môže napríklad čakať na začiatok prehrávania, kým stiahne ďalšie údaje. Samo osebe to neznamená chybu ani pozastavené prehrávanie: pause sa týka prehrávania, zatiaľ čo stalled označuje situáciu, keď sa prehliadač pokúša načítať údaje, ale neprijíma ich.
V kóde atribútu poskytuje event objekt udalosti. V JavaScripte môžete namiesto toho priradiť funkciu vlastnosti element.onsuspend alebo použiť element.addEventListener('suspend', handler). Názov udalosti neobsahuje predponu on.
Príklad vyvolá syntetickú udalosť, aby výsledok nezávisel od siete ani od rozhodnutí prehliadača o ukladaní do vyrovnávacej pamäte. Testuje iba vykonanie kódu atribútu; nepozastaví načítavanie ani nezmení networkState. Bezpečnostná politika stránky môže blokovať kód obsluhy udalosti zapísaný priamo v atribútoch.
Prí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ýsledok
suspend
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.