Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

oncontextlost – spracovanie straty kontextu canvas

Atribút oncontextlost určuje kód, ktorý spracuje udalosť contextlost. Tá sa odošle pri strate 2D vykresľovacieho kontextu prvku canvas. Aplikácia tak môže reagovať na stratu zdrojov, samotný obrázok však neobnoví.

Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<canvas oncontextlost="handler(event)"></canvas>
canvas.oncontextlost = handler;

oncontextlost je globálny atribút obsluhy udalosti contextlost. V praxi sa používa na prvku canvas, ktorého 2D kontext stratil úložisko obrazových údajov. Hodnotou atribútu je kód JavaScriptu, nie logická hodnota; kód dostane objekt event.

V JavaScripte možno priradiť funkciu k vlastnosti canvas.oncontextlost. Alternatívou je použiť canvas.addEventListener('contextlost', handler). Aj OffscreenCanvas sprístupňuje vlastnosť oncontextlost, ale nie je prvkom HTML a nemá značkové atribúty. Nezamieňajte si túto udalosť s udalosťou WebGL webglcontextlost.

Pri skutočnej strate kontextu prehliadač obnoví stav vykresľovania na predvolený. Udalosť contextlost možno zrušiť: event.preventDefault() zastaví pokus o obnovenie kontextu opísaný v štandarde; túto metódu nevolajte, ak chcete tento pokus umožniť. Obnovenie nie je zaručené. Po udalosti contextrestored by aplikácia mala znova nastaviť potrebný stav a obsah prekresliť.

Príklad odosiela syntetickú udalosť, takže funguje bez spôsobenia zlyhania grafiky. Výstup contextlost: false zobrazuje typ udalosti a hodnotu event.isTrusted. Test overuje iba spracovanie udalosti, nie stratu zdrojov ani ich obnovenie.

Prí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ýsledok

contextlost: false

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje