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

CKTIS / HTML

onplaying — obsluha připravenosti k přehrávání

Atribut onplaying obsahuje kód obsluhující událost playing, kterou používají audio a video, když je přehrávání připravené začít nebo pokračovat po přerušení. Přehrávání nespouští a není ekvivalentem onplay.

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

Syntaxe

onplaying="JavaScript statements"
media.onplaying = (event) => { /* handler */ };

onplaying je atribut obsluhy události playing. Jako atribut HTML je dostupný u všech prvků HTML, typicky se však používá u prvků audio a video. Jeho hodnotou je kód JavaScriptu, nikoli adresa souboru nebo logická hodnota.

Událost playing označuje připravenost zahájit přehrávání po pozastavení nebo zpoždění způsobeném nedostatkem dat. Naproti tomu play signalizuje, že se paused změnilo na false. Událost playing se může po načítání do vyrovnávací paměti objevit znovu; nezaručuje nepřerušované přehrávání ani slyšitelný zvuk.

V JavaScriptu lze přiřadit funkci k media.onplaying; další přiřazení nahradí předchozí funkci tohoto obslužného mechanismu. Alternativou je media.addEventListener('playing', handler). Samotné nastavení obsluhy přehrávání nespustí.

Příklad odešle syntetickou událost playing, aby otestoval atribut bez mediálního souboru. Očekávaný text je playing. Neověřuje skutečné přehrávání; vyžaduje povolené skripty a inline obsluhy událostí.

Příklady

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

Výsledek

playing

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