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

CKTIS / HTML

onpause — obsluha události pozastavení médií

Atribut onpause obsahuje JavaScript, který obsluhuje událost pause, obvykle na prvku audio nebo video. Reaguje na pozastavení přehrávání, ale sám přehrávání nepozastaví.

Verze: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<audio onpause="handlerCode"></audio>
<video onpause="handlerCode"></video>
media.onpause = handler;
media.addEventListener("pause", handler);

onpause je globální atribut pro obsluhu události pause. Je dostupný na všech prvcích HTML, ale obvykle se používá k obsluze pozastavení na prvcích audio a video. Jeho hodnotou je kód JavaScriptu, nikoli logická hodnota.

Při běžném pozastavení média se paused nastaví na true a událost se odešle v úloze zařazené do fronty. Volání pause() na již pozastaveném prvku nevyvolá další událost pause. Událost se nešíří vzhůru a nelze ji zrušit; return false pozastavení nezabrání.

V kódu atributu označuje event událost a this odkazuje na prvek. Vlastnost JavaScriptu media.onpause přijímá funkci nebo null; nové přiřazení nahradí předchozí funkci. Pomocí media.addEventListener("pause", handler) lze registrovat nezávislé obslužné funkce. Zásady CSP mohou kód atributů blokovat.

Příklad odešle syntetickou událost pause, aby ověřil zapojení atributu bez mediálního souboru. Očekávaný text je pause. Tento test nespouští ani nepozastavuje přehrávání a neověřuje skutečnou změnu stavu média.

Příklady

<!doctype html>
<meta charset="utf-8">
<title>onpause test</title>
<audio id="media" onpause="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('pause'));
</script>

Výsledek

pause

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