CKTIS / HTML
oncanplay — обработване на готовността на мултимедията за възпроизвеждане
Атрибутът oncanplay съдържа JavaScript, който се изпълнява при събитието canplay. При аудио и видео то сигнализира, че възпроизвеждането може да започне или да продължи, но не гарантира, че целият ресурс ще се възпроизведе без прекъсвания за буфериране.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
<audio oncanplay="handler(event)"></audio>
<video oncanplay="handler(event)"></video>oncanplay е атрибут за обработчик на събитието canplay. Стойността му е JavaScript код; обработчикът има достъп до обекта event. Атрибутът е разрешен за всички HTML елементи, но обикновено се използва за реакция при готовност на елементи audio и video.
Браузърът задейства canplay, когато състоянието на готовност на мултимедията премине от по-ниско ниво към HAVE_FUTURE_DATA или по-високо. Тогава има налични данни, с които възпроизвеждането може да продължи, но те може да не са достатъчни за възпроизвеждане на целия ресурс без буфериране. За разлика от него, canplaythrough показва оценка, че ресурсът може да се възпроизведе докрай без спиране за буфериране. Само по себе си canplay не означава, че възпроизвеждането вече е започнало.
В HTML използвайте oncanplay="handler(event)"; в JavaScript задайте функция на media.oncanplay или извикайте media.addEventListener('canplay', handler). Името на събитието не включва префикса on. Примерът задейства синтетично събитие: проверява връзката между атрибута и обработчика му, а не действителната готовност на мултимедията.
Примери
<!doctype html>
<meta charset="utf-8">
<title>oncanplay demo</title>
<audio id="media" oncanplay="document.getElementById('result').textContent = event.type"></audio>
<pre id="result">waiting</pre>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('canplay'));
</script>Резултат
canplay
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.