CKTIS / HTML
oncuechange — обработване на промените в активните текстови маркери
Атрибутът oncuechange задава кода, който се изпълнява при събития cuechange, когато времевите маркери на текстова писта станат активни или престанат да бъдат активни. Обектите TextTrack разполагат и със свойство JavaScript със същото име.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
oncuechange="JavaScript statements"
trackElement.oncuechange = handler;
textTrack.oncuechange = handler;oncuechange е глобален атрибут за обработчик на събитието cuechange. Стойността му съдържа инструкции на JavaScript, а не URL към файл. Обичайна цел е елемент track във video или audio; глобалната наличност не означава, че браузърът генерира това събитие върху всеки елемент.
Събитието указва, че един или повече маркери на текстова писта са станали активни или са престанали да бъдат активни. Браузърът го изпраща към обекта TextTrack и, ако има такъв, към съответния елемент track. То не е уведомление, че изтеглянето на файл със субтитри е завършило.
В обработчик на елемент прочетете this.track.activeCues, за да получите текущо активните маркери; в обработчик на TextTrack използвайте this.activeCues. Съобразете се със стойността null, особено когато mode е "disabled". Режимът "hidden" позволява да следите активните маркери, без да показвате субтитри.
Задаването на функция на oncuechange заменя предишния обработчик на това свойство; addEventListener("cuechange", handler) регистрира независими слушатели. Политика CSP може да блокира код в атрибути. Примерът умишлено изпраща синтетично събитие: проверява обработването на атрибута без медийни файлове, но не активира маркери на пистата.
Примери
<!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>Резултат
cuechange: captions
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.