Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

oncuechange — obsługa zmian aktywnych fragmentów ścieżki tekstowej

Atrybut oncuechange określa kod wykonywany po zdarzeniu cuechange, gdy fragmenty czasowej ścieżki tekstowej stają się aktywne lub przestają być aktywne. Właściwość JavaScript o tej samej nazwie jest dostępna także na obiekcie TextTrack.

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

Składnia

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

oncuechange jest globalnym atrybutem obsługi zdarzenia cuechange. Jego wartość zawiera instrukcje JavaScript, a nie adres pliku. Typowym miejscem użycia jest element track wewnątrz video lub audio; globalna dostępność atrybutu nie oznacza, że przeglądarka generuje to zdarzenie na każdym elemencie.

Zdarzenie informuje, że co najmniej jeden fragment ścieżki tekstowej stał się aktywny albo przestał być aktywny. Przeglądarka wysyła je do obiektu TextTrack oraz do odpowiadającego mu elementu track, jeśli taki istnieje. Nie jest to powiadomienie o zakończeniu pobierania pliku napisów.

W procedurze obsługi elementu odczytaj this.track.activeCues, aby uzyskać aktualnie aktywne fragmenty; w procedurze obiektu TextTrack użyj this.activeCues. Uwzględnij wartość null, zwłaszcza gdy mode wynosi "disabled". Tryb "hidden" pozwala śledzić aktywne fragmenty bez wyświetlania napisów.

Przypisanie funkcji do oncuechange zastępuje poprzednią procedurę tej właściwości; addEventListener("cuechange", handler) pozwala rejestrować niezależne procedury. Polityka CSP może blokować kod w atrybutach. Przykład celowo wysyła zdarzenie syntetyczne: sprawdza obsługę atrybutu bez plików multimedialnych, ale nie aktywuje fragmentów ścieżki.

Przykłady

<!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>

Wynik

cuechange: captions

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła