CKTIS / HTML
oncuechange — obrada promjena aktivnih titlova tekstnog zapisa
Atribut oncuechange određuje kôd koji se izvršava pri događajima cuechange, kada vremenski određeni titlovi tekstnog zapisa postanu aktivni ili prestanu biti aktivni. Objekti TextTrack imaju i JavaScriptovo svojstvo istog naziva.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
oncuechange="JavaScript statements"
trackElement.oncuechange = handler;
textTrack.oncuechange = handler;oncuechange je globalni atribut za obradu događaja cuechange. Njegova vrijednost sadrži JavaScript naredbe, a ne URL datoteke. Uobičajeni je cilj element track unutar elementa video ili audio; globalna dostupnost ne znači da preglednik generira taj događaj na svakom elementu.
Događaj označava da je jedan ili više titlova tekstnog zapisa postalo aktivno ili je prestalo biti aktivno. Preglednik ga šalje objektu TextTrack i, ako postoji, odgovarajućem elementu track. To nije obavijest da je preuzimanje datoteke s titlovima završeno.
U rukovatelju elementa pročitajte this.track.activeCues kako biste dobili trenutačno aktivne titlove; u rukovatelju TextTrack upotrijebite this.activeCues. Uzmite u obzir vrijednost null, osobito kada je mode "disabled". Način "hidden" omogućuje praćenje aktivnih titlova bez njihova prikazivanja.
Dodjela funkcije svojstvu oncuechange zamjenjuje prethodni rukovatelj tog svojstva; addEventListener("cuechange", handler) registrira neovisne osluškivače. Pravila CSP-a mogu blokirati kôd u atributima. Primjer namjerno šalje sintetički događaj: provjerava obradu atributa bez medijskih datoteka, ali ne aktivira nijedan titl zapisa.
Primjeri
<!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>Rezultat
cuechange: captions
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.