Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori