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

CKTIS / HTML

ontimeupdate — obsluha aktualizací času médií

Atribut ontimeupdate obsahuje JavaScript pro obsluhu události timeupdate, která se používá při aktualizaci pozice přehrávání zvuku nebo videa. Umožňuje obnovovat ukazatel času, ale neposkytuje přesné měření času.

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

Syntaxe

<audio ontimeupdate="JavaScript statements"></audio>
<video ontimeupdate="JavaScript statements"></video>

ontimeupdate je globální atribut HTML pro obsluhu události timeupdate. Jeho hodnota je tělo funkce v JavaScriptu, nikoli URL ani pouhá deklarace funkce. Obvykle se používá u prvků audio a video; dostupnost atributu u jiných prvků neznamená, že tyto prvky událost automaticky vysílají.

Uvnitř obslužné rutiny označuje this daný prvek a this.currentTime poskytuje pozici přehrávání v sekundách. Prohlížeč vysílá timeupdate během přehrávání i v dalších situacích, kdy se pozice mění, například při přesunu na jiné místo. Frekvence není pevně daná: událost není časovač ani oznámení pro každý snímek.

Atribut HTML ontimeupdate obsahuje zdrojový text, zatímco vlastnost JavaScriptu element.ontimeupdate přijímá funkci nebo null. Alternativou je element.addEventListener('timeupdate', handler). Zásady Content Security Policy mohou blokovat kód v atributech.

Příklad záměrně vyvolá syntetickou událost bez mediálního souboru. Ukazuje obsluhu události a čtení počáteční hodnoty currentTime, nikoli skutečné přehrávání nebo přesun v médiu. Očekávaný text je 0.0 s.

Příklady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ontimeupdate demo</title>
<audio id="player" ontimeupdate="document.getElementById('result').textContent = this.currentTime.toFixed(1) + ' s';"></audio>
<output id="result">Waiting</output>
<script>
  const player = document.getElementById('player');
  player.dispatchEvent(new Event('timeupdate'));
</script>
</html>

Výsledek

0.0 s

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