База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

onended — обработване на края на възпроизвеждането

Атрибутът onended съдържа JavaScript, който се изпълнява при получаване на събитие ended. При елементите audio и video той реагира, когато медийното съдържание достигне края си, а не когато възпроизвеждането просто бъде поставено на пауза.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

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

onended е съдържателен атрибут за обработчик на събитието ended. Стойността му е тялото на JavaScript функция, а не URL на файл или само име на функция. Може да се използва event, за да се разгледа събитието.

При audio и video браузърът задейства ended, когато възпроизвеждането напред достигне края на медийното съдържание. Самото извикване на pause() не означава, че възпроизвеждането е приключило. Ако е зададен loop, при достигане на края по време на възпроизвеждане напред възпроизвеждането се връща в началото, вместо да задейства това събитие.

Разграничавайте HTML атрибута onended, JavaScript свойството media.onended, което съдържа функция обработчик, и булевото свойство за състояние media.ended. Алтернатива на атрибута е media.addEventListener('ended', handler); името на събитието няма префикс on.

Примерът умишлено задейства синтетично събитие, затова не се нуждае от медиен файл. Той проверява свързването на обработчика, а не действителното приключване на възпроизвеждането. Политиката за сигурност на страницата може да блокира вградения в атрибута код за обработка на събития.

Примери

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

Резултат

ended

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници