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

CKTIS / HTML

oncuechange — obsluha změn aktivních úseků textové stopy

Atribut `oncuechange` určuje kód, který se spustí při události `cuechange`, když se časované úseky textové stopy stanou aktivními nebo přestanou být aktivní. Objekty `TextTrack` mají v JavaScriptu také stejnojmennou vlastnost.

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

Syntaxe

oncuechange="JavaScript statements"
trackElement.oncuechange = handler;
textTrack.oncuechange = handler;

oncuechange je globální atribut obsluhy události cuechange. Jeho hodnota obsahuje příkazy JavaScriptu, nikoli adresu URL souboru. Typicky se používá na prvku track uvnitř prvku video nebo audio. To, že je atribut globální, neznamená, že prohlížeč tuto událost vyvolává na každém prvku.

Událost oznamuje, že alespoň jeden časovaný úsek textové stopy začal nebo přestal být aktivní. Prohlížeč ji odešle objektu TextTrack a také odpovídajícímu prvku track, pokud takový prvek existuje. Nejde o oznámení o dokončení stahování souboru s titulky.

V obsluze události na prvku získáte aktuálně aktivní úseky pomocí this.track.activeCues; v obsluze na objektu TextTrack použijte this.activeCues. Počítejte s hodnotou null, zejména když má mode hodnotu "disabled". Režim "hidden" umožňuje sledovat aktivní úseky, aniž by se zobrazovaly titulky.

Přiřazením funkce k oncuechange nahradíte dosavadní obsluhu nastavenou v této vlastnosti. Volání addEventListener("cuechange", handler) umožňuje registrovat nezávislé posluchače. Zásady CSP mohou blokovat kód v atributech. Příklad záměrně odešle syntetickou událost: ověřuje funkčnost obsluhy zadané atributem bez mediálních souborů, ale neaktivuje žádný úsek stopy.

Příklady

<!doctype html>
<meta charset="utf-8">
<title>oncuechange</title>
<video>
  <track id="captions" kind="captions" srclang="en" src="data:text/vtt,WEBVTT%0A%0A"
    oncuechange="document.getElementById('result').textContent = event.type + ': ' + this.kind">
</video>
<output id="result"></output>
<script>
  const trackElement = document.getElementById('captions');
  trackElement.dispatchEvent(new Event('cuechange'));
</script>

Výsledek

cuechange: captions

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