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

CKTIS / HTML

ontimeupdate — обработване на актуализациите на времето на медията

Атрибутът ontimeupdate съдържа JavaScript за обработване на събитието timeupdate, което се използва при актуализиране на позицията на възпроизвеждане на аудио или видео. Той може да обновява индикатор за време, но не осигурява прецизно измерване на времето.

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

Синтаксис

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

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

В обработчика this обозначава елемента, а this.currentTime предоставя позицията на възпроизвеждане в секунди. Браузърът излъчва timeupdate по време на възпроизвеждане и в други ситуации, при които позицията се променя, например при преместване към друга част. Честотата не е фиксирана: събитието не е часовник и не е известие за всеки кадър.

HTML атрибутът ontimeupdate съдържа текст на изходния код, докато JavaScript свойството element.ontimeupdate приема функция или null. Алтернатива е element.addEventListener('timeupdate', handler). Политиката Content Security Policy може да блокира код в атрибути.

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

Примери

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ontimeupdate demo</title>
<audio id="player" ontimeupdate="document.getElementById('result').textContent = this.currentTime.toFixed(1) + ' s';"></audio>
<output id="result">Waiting</output>
<script>
  const player = document.getElementById('player');
  player.dispatchEvent(new Event('timeupdate'));
</script>
</html>

Резултат

0.0 s

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

Източници