Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onended — obsługa zakończenia odtwarzania

Atrybut onended zawiera kod JavaScript wykonywany po otrzymaniu zdarzenia ended. Na elementach audio i video służy do reagowania na osiągnięcie końca materiału, a nie na zwykłe wstrzymanie odtwarzania.

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

Składnia

<audio onended="JavaScript statements"></audio>
<video onended="JavaScript statements"></video>

onended jest atrybutem obsługi zdarzenia ended. Jego wartość to treść funkcji w JavaScript, a nie adres pliku ani sama nazwa funkcji. Można w niej użyć event, aby odczytać zdarzenie.

W przypadku audio i video przeglądarka wysyła ended po osiągnięciu końca materiału podczas odtwarzania do przodu. Samo wywołanie pause() nie oznacza zakończenia. Gdy ustawiono loop, osiągnięcie końca podczas odtwarzania do przodu powoduje powrót do początku zamiast tego zdarzenia.

Rozróżniaj atrybut HTML onended, właściwość JavaScript media.onended przechowującą funkcję obsługi oraz właściwość logiczną media.ended informującą o stanie. Alternatywą dla atrybutu jest media.addEventListener('ended', handler); nazwa zdarzenia nie ma przedrostka on.

Przykład celowo wysyła syntetyczne zdarzenie, więc nie wymaga pliku multimedialnego. Sprawdza podłączenie atrybutu, nie rzeczywiste zakończenie odtwarzania. Polityka bezpieczeństwa strony może blokować kod obsługi zapisany bezpośrednio w atrybucie.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>onended test</title>
<audio id="media" onended="document.getElementById('result').textContent = event.type"></audio>
<output id="result">waiting</output>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('ended'));
</script>

Wynik

ended

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

Źródła