CKTIS / HTML
oncontextlost — обработване на загуба на контекста на canvas
Атрибутът oncontextlost задава кода, който обработва събитието contextlost. То се изпраща при загуба на 2D контекста за изобразяване на елемент canvas. Така приложението може да реагира на загуба на ресурси, но самият атрибут не възстановява рисунката.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
<canvas oncontextlost="handler(event)"></canvas>
canvas.oncontextlost = handler;oncontextlost е глобален атрибут за обработване на събитието contextlost. На практика се използва върху елемент canvas, чийто 2D контекст е загубил хранилището на изображението. Стойността на атрибута е JavaScript код, а не булева стойност; кодът получава обекта event.
В JavaScript можете да присвоите функция на свойството canvas.oncontextlost. Като алтернатива използвайте canvas.addEventListener('contextlost', handler). OffscreenCanvas също предоставя свойство oncontextlost, но не е HTML елемент и няма атрибути за маркиране. Не бъркайте това събитие със събитието на WebGL webglcontextlost.
При действителна загуба на контекста браузърът нулира състоянието на изобразяване. Събитието contextlost може да бъде отменено: event.preventDefault() спира описания в стандарта опит за възстановяване на контекста; не извиквайте този метод, ако искате да позволите опита. Възстановяването не е гарантирано. След contextrestored приложението трябва отново да зададе необходимото състояние и да изобрази съдържанието си наново.
Примерът изпраща синтетично събитие и затова работи, без да причинява графична повреда. Изходът contextlost: false показва типа на събитието и стойността на event.isTrusted. Тестът проверява само обработването на събитието, а не загубата на ресурси или възстановяването им.
Примери
<!doctype html>
<meta charset="utf-8">
<title>oncontextlost test</title>
<canvas id="surface" oncontextlost="document.getElementById('result').textContent = event.type + ': ' + event.isTrusted"></canvas>
<pre id="result">waiting</pre>
<script>
document.getElementById('surface').dispatchEvent(
new Event('contextlost', { cancelable: true })
);
</script>Резултат
contextlost: false
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.