CKTIS / HTML
onpause — обработчик на събитието за пауза на мултимедия
Атрибутът onpause съдържа JavaScript, който обработва събитието pause, обикновено върху елемент audio или video. Той реагира на пауза на възпроизвеждането, но сам не го спира.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
<audio onpause="handlerCode"></audio>
<video onpause="handlerCode"></video>
media.onpause = handler;
media.addEventListener("pause", handler);onpause е глобален атрибут за обработване на събитието pause. Макар да е наличен за всички HTML елементи, обикновено се използва за обработване на паузи при елементите audio и video. Стойността му е JavaScript код, а не булева стойност.
При нормално поставяне на мултимедия на пауза paused става true, а събитието се изпраща в задача, добавена към опашката. Извикването на pause() върху вече спрян на пауза елемент не поражда ново събитие pause. Събитието не се разпространява нагоре и не може да бъде отменено; return false няма да предотврати паузата.
В кода на атрибута event обозначава събитието, а this се отнася до елемента. JavaScript свойството media.onpause приема функция или null; повторното му задаване заменя предишната функция. media.addEventListener("pause", handler) позволява да се регистрират независими обработчици. CSP политика може да блокира кода в атрибутите.
Примерът изпраща синтетично събитие pause, за да провери свързването на атрибута без мултимедиен файл. Очакваният текст е pause. Този тест нито стартира, нито поставя възпроизвеждането на пауза и не проверява реална промяна на състоянието на мултимедията.
Примери
<!doctype html>
<meta charset="utf-8">
<title>onpause test</title>
<audio id="media" onpause="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('pause'));
</script>Резултат
pause
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.