CKTIS / HTML
oncuechange — obravnava spremembe aktivnih napisov besedilnega vira
Atribut oncuechange določa kodo, ki se izvede ob dogodkih cuechange, ko časovno določeni napisi besedilnega vira postanejo aktivni ali prenehajo biti aktivni. Objekti TextTrack imajo na voljo tudi istoimensko lastnost JavaScript.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
oncuechange="JavaScript statements"
trackElement.oncuechange = handler;
textTrack.oncuechange = handler;oncuechange je globalni atribut za obravnavo dogodka cuechange. Njegova vrednost vsebuje stavke JavaScript, ne URL-ja datoteke. Običajni cilj je element track znotraj elementa video ali audio; globalna razpoložljivost ne pomeni, da brskalnik ta dogodek sproži na vsakem elementu.
Dogodek sporoča, da je eden ali več napisov besedilnega vira postalo aktivnih ali prenehalo biti aktivnih. Brskalnik ga pošlje objektu TextTrack in, če obstaja, ustreznemu elementu track. To ni obvestilo, da se je prenos datoteke s podnapisi končal.
V obravnavalniku elementa preberite this.track.activeCues, da dobite trenutno aktivne napise; v obravnavalniku TextTrack uporabite this.activeCues. Upoštevajte vrednost null, zlasti kadar je mode nastavljen na "disabled". Način "hidden" omogoča spremljanje aktivnih napisov brez prikaza podnapisov.
Dodelitev funkcije lastnosti oncuechange nadomesti prejšnji obravnavalnik te lastnosti; addEventListener("cuechange", handler) registrira neodvisne poslušalnike. Pravilnik CSP lahko blokira kodo v atributih. Primer namenoma sproži sintetični dogodek: preveri obravnavo atributa brez predstavnostnih datotek, vendar ne aktivira nobenih napisov vira.
Primeri
<!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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.