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

CKTIS / HTML

onemptied — обработване на изпразването на мултимедиен ресурс

Атрибутът onemptied задава JavaScript кода, който се изпълнява при настъпване на събитие emptied. При аудио и видео това събитие се отнася до нулиране на състоянието на мултимедийния ресурс, а не до обичайния край на възпроизвеждането.

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

Синтаксис

onemptied="JavaScript statements"

onemptied е HTML съдържателен атрибут за обработчик на събитието emptied. Стойността му съдържа JavaScript инструкции; в обработчика обектът на събитието е достъпен като event. Това е глобален атрибут за обработчик на събития, но естествените източници на това събитие са елементите audio и video.

Браузърът задейства emptied, когато състоянието на мултимедийния ресурс бъде нулирано. Например load() поставя това събитие на опашка, ако предишният networkState не е бил NETWORK_EMPTY. Следователно извикването на load() върху нов празен елемент не гарантира събитие. Не бъркайте emptied с ended, което указва достигане на края на възпроизвеждането, нито с временна липса на данни за продължаването му.

В JavaScript вместо атрибута можете да зададете функция на media.onemptied или да използвате media.addEventListener('emptied', handler). Името на събитието няма представка on. Повторното задаване на свойството заменя предишния обработчик; addEventListener позволява регистрирането на независими обработчици. CSP политика може да блокира код в атрибутите за обработка на събития.

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

Примери

<!doctype html>
<meta charset="utf-8">
<title>onemptied</title>
<audio onemptied="document.getElementById('result').textContent = event.type;"></audio>
<output id="result">pending</output>
<script>
  const media = document.querySelector('audio');
  media.dispatchEvent(new Event('emptied'));
</script>

Резултат

emptied

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

Източници