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

CKTIS / HTML

onplay — обработване на събитието play

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

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

Синтаксис

onplay="JavaScript statements"

onplay е съдържателен атрибут за обработчик на събитието play. Стойността му е тяло на функция в JavaScript, а не адрес на файл или булев атрибут. Обикновено се използва върху елементи audio и video; добавянето на атрибута не стартира възпроизвеждането.

Браузърът задейства play, когато paused се промени от true на false, например чрез play() или autoplay. Това все още не означава, че действително има възпроизвеждане: данните може да не са налични. Събитието playing, обработвано чрез onplaying, се отнася до започването или подновяването на възпроизвеждането след спиране поради недостатъчно данни.

В JavaScript задайте функция на media.onplay или използвайте media.addEventListener('play', handler). Задаването на свойството заменя предишната функция за този слот на обработчика на събитието. Content Security Policy може да блокира код, записан директно в атрибута.

Примерът задейства синтетично play, затова не се нуждае от медиен файл. Очакваният текст е play; така се проверява свързването на обработчика, а не възпроизвеждането.

Примери

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onplay test</title>
<audio id="media" onplay="document.getElementById('result').textContent = event.type;"></audio>
<p id="result">pending</p>
<script>
  document.getElementById('media').dispatchEvent(new Event('play'));
</script>
</html>

Резултат

play

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

Източници