CKTIS / HTML
onprogress — обработване на събития за напредъка на изтеглянето
Атрибутът onprogress съдържа JavaScript код за обработване на събитието progress. При елементите audio и video то се отнася до изтеглянето на мултимедийни данни, а не до изминалото време на възпроизвеждане.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
onprogress="JavaScript statements"
element.onprogress = handler;
element.addEventListener("progress", handler);onprogress е атрибут за обработване на събитието progress. Той е наличен върху всички HTML елементи, но самото му наличие не започва изтегляне и не генерира събития. Съответното свойство на JavaScript е налично и върху обектите Document и Window.
При audio и video събитието progress сигнализира за изтегляне на мултимедийни данни. То не означава напредък на възпроизвеждането и не предоставя автоматично процент на изтеглените байтове. Мултимедийното събитие използва интерфейса Event, а не ProgressEvent; не приемайте, че loaded и total са налични.
Стойността на атрибута е JavaScript код, в който event обозначава събитието. Като алтернатива задайте функция на element.onprogress или използвайте element.addEventListener("progress", handler). Задаването на свойството заменя предишния обработчик за този механизъм; addEventListener() позволява да се регистрират независими слушатели.
Примерът изрично изпраща синтетично събитие progress, затова резултатът не зависи от мрежата. Той проверява обработването на атрибута, а не действителния напредък на изтегляне. Content Security Policy може да блокира вградени обработчици на събития и вградени скриптове.
Примери
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onprogress demo</title>
<body>
<audio id="media" onprogress="document.getElementById('result').textContent = event.type"></audio>
<p id="result">waiting</p>
<script>
document.getElementById('media').dispatchEvent(new Event('progress'));
</script>
</body>
</html>Резултат
progress
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.