CKTIS / HTML
ondurationchange — обработване на промени в продължителността на медията
Атрибутът ondurationchange съдържа JavaScript, който се изпълнява при събитието durationchange. Обикновено се използва за актуализиране на информацията за продължителността в елементи audio и video; не отчита текущия напредък на възпроизвеждането.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
ondurationchange="JavaScript statements"ondurationchange е атрибут за обработчик на събитието durationchange, който обикновено се използва с елементи audio и video. Стойността му е JavaScript код, а не булева стойност или стойност за продължителност. В обработчика, зададен в атрибута, this препраща към елемента, а event предоставя обекта на събитието.
Браузърът задейства това събитие, когато установената продължителност на ресурса се промени, например когато стане известна или бъде коригирана. Прочетете this.duration: резултатът е в секунди, NaN означава, че няма налични данни, а Infinity показва неограничена продължителност. Това не е събитие за напредъка на възпроизвеждането; за тази цел използвайте timeupdate.
В JavaScript вместо това можете да присвоите функция на media.ondurationchange или да използвате media.addEventListener('durationchange', handler). Името на събитието няма префикс on. Присвояването на свойството заменя съществуващия обработчик в този слот; addEventListener позволява добавяне на независими слушатели. CSP политика може да блокира код, записан директно в атрибута.
Примерът задейства синтетично събитие, без да зарежда медия. Той проверява връзката между атрибута и обработчика, а не откриването на действителна промяна в продължителността. Не променя duration, затова очакваният текст е durationchange: NaN.
Примери
<!doctype html>
<meta charset="utf-8">
<title>ondurationchange</title>
<audio id="media" ondurationchange="document.getElementById('result').textContent = event.type + ': ' + String(this.duration)"></audio>
<output id="result"></output>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('durationchange'));
</script>Резултат
durationchange: NaN
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.