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

CKTIS / HTML

onplay — obsluha události play

Atribut onplay obsahuje JavaScript, který se spustí při události play, obvykle na prvku audio nebo video. Událost signalizuje opuštění pozastaveného stavu, ale nezaručuje, že se zvuk nebo video již přehrává.

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

Syntaxe

onplay="JavaScript statements"

onplay je obsahový atribut obsluhy události play. Jeho hodnotou je tělo funkce v JavaScriptu, nikoli adresa souboru nebo booleovský atribut. Obvykle se používá na prvcích audio a video; přidání atributu přehrávání nespustí.

Prohlížeč vyvolá play, když se paused změní z true na false, například pomocí play() nebo autoplay. To ještě neznamená, že skutečně probíhá přehrávání: data nemusí být dostupná. Událost playing, obsluhovaná pomocí onplaying, se týká zahájení nebo obnovení přehrávání po zastavení kvůli nedostatku dat.

V JavaScriptu přiřaďte funkci k media.onplay nebo použijte media.addEventListener('play', handler). Přiřazení k vlastnosti nahradí předchozí funkci v daném slotu obsluhy události. Content Security Policy může blokovat kód zapsaný přímo v atributu.

Příklad vyvolá syntetickou událost play, takže nepotřebuje mediální soubor. Očekávaný text je play; testuje se tím zapojení obsluhy, nikoli přehrávání.

Příklady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onplay test</title>
<audio id="media" onplay="document.getElementById('result').textContent = event.type;"></audio>
<p id="result">pending</p>
<script>
  document.getElementById('media').dispatchEvent(new Event('play'));
</script>
</html>

Výsledek

play

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