CKTIS / HTML
oncontextlost – zpracování ztráty kontextu canvas
Atribut oncontextlost určuje kód, který zpracuje událost contextlost. Ta se odešle při ztrátě 2D vykreslovacího kontextu prvku canvas. Aplikace tak může reagovat na ztrátu prostředků, samotný obrázek však neobnoví.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<canvas oncontextlost="handler(event)"></canvas>
canvas.oncontextlost = handler;oncontextlost je globální atribut obsluhy události contextlost. V praxi se používá u prvku canvas, jehož 2D kontext přišel o úložiště obrazových dat. Hodnotou atributu je kód JavaScriptu, nikoli logická hodnota; kód obdrží objekt event.
V JavaScriptu lze přiřadit funkci k vlastnosti canvas.oncontextlost. Alternativou je použít canvas.addEventListener('contextlost', handler). Také OffscreenCanvas zpřístupňuje vlastnost oncontextlost, ale není prvkem HTML a nemá atributy značek. Nezaměňujte tuto událost s událostí WebGL webglcontextlost.
Při skutečné ztrátě kontextu prohlížeč resetuje stav vykreslování. Událost contextlost lze zrušit: event.preventDefault() zastaví pokus o obnovení kontextu popsaný standardem; tuto metodu nevolejte, pokud chcete tento pokus umožnit. Obnovení není zaručeno. Po události contextrestored by aplikace měla znovu nastavit potřebný stav a obsah překreslit.
Příklad odesílá syntetickou událost, takže funguje, aniž by způsobil selhání grafiky. Výstup contextlost: false ukazuje typ události a hodnotu event.isTrusted. Test ověřuje pouze zpracování události, nikoli ztrátu prostředků ani jejich obnovení.
Příklady
<!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>Výsledek
contextlost: false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.