Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

oncuechange — spracovanie zmien aktívnych titulkov textovej stopy

Atribút oncuechange určuje kód, ktorý sa spustí pri udalostiach cuechange, keď sa časované titulky textovej stopy stanú aktívnymi alebo nimi prestanú byť. Objekty TextTrack majú k dispozícii aj JavaScriptovú vlastnosť s rovnakým názvom.

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

Syntax

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

oncuechange je globálny atribút obsluhy udalosti cuechange. Jeho hodnota obsahuje príkazy JavaScriptu, nie adresu URL súboru. Typickým cieľom je prvok track vo vnútri prvku video alebo audio; globálna dostupnosť neznamená, že prehliadač vytvára túto udalosť na každom prvku.

Udalosť oznamuje, že sa jeden alebo viac titulkov textovej stopy stalo aktívnymi alebo nimi prestalo byť. Prehliadač ju odošle objektu TextTrack a prípadne aj zodpovedajúcemu prvku track. Nejde o oznámenie, že sa dokončilo sťahovanie súboru s titulkami.

V obsluhe udalosti prvku čítajte this.track.activeCues, aby ste získali aktuálne aktívne titulky; v obsluhe TextTrack použite this.activeCues. Počítajte s hodnotou null, najmä keď má mode hodnotu "disabled". Režim "hidden" umožňuje sledovať aktívne titulky bez ich zobrazovania.

Priradením funkcie k oncuechange nahradíte predchádzajúcu obsluhu tejto vlastnosti; addEventListener("cuechange", handler) registruje nezávislých poslucháčov. Zásady CSP môžu blokovať kód v atribútoch. Príklad zámerne odošle syntetickú udalosť: overuje spracovanie atribútu bez mediálnych súborov, ale neaktivuje žiadne titulky stopy.

Prí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ýsledok

cuechange: captions

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje