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

CKTIS / HTML

onloadedmetadata — обработване на зареждането на метаданни за медия

Атрибутът onloadedmetadata съдържа JavaScript за обработване на събитието loadedmetadata, обикновено при audio или video. Той показва, че метаданните са налични, а не че изтеглянето е завършило или че възпроизвеждането ще е непрекъснато.

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

Синтаксис

onloadedmetadata="JavaScript statements"

onloadedmetadata е HTML атрибут за обработване на събитието loadedmetadata. Стойността му е JavaScript код, а не име на събитие или булева стойност. Допустим е за HTML елементи, но обикновено се използва с audio и video.

Браузърът задейства loadedmetadata, когато метаданните на зареждания ресурс станат достъпни за първи път: readyState достига поне HAVE_METADATA. След това може да прочетете duration, а при видео — и videoWidth и videoHeight. Продължителността може да е Infinity, ако ресурсът няма известен край. Това не означава, че целият файл е изтеглен; loadeddata се отнася до наличността на данните за текущия кадър.

В кода на атрибута event обозначава събитието, а this — елемента. В JavaScript вместо това можете да зададете функция на media.onloadedmetadata или да използвате media.addEventListener('loadedmetadata', handler). Името на събитието няма префикс on. Задаването на свойството заменя предишната му функция; addEventListener позволява независими обработчици. CSP политика може да блокира код в атрибутите.

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

Примери

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onloadedmetadata demo</title>
<audio id="media" onloadedmetadata="document.getElementById('result').textContent = event.type + ' handled'"></audio>
<p id="result">Waiting</p>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('loadedmetadata'));
</script>
</html>

Резултат

loadedmetadata handled

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

Източници