CKTIS / HTML
oncontextlost — obrada gubitka konteksta elementa canvas
Atribut oncontextlost određuje kôd koji obrađuje događaj contextlost, koji se šalje kada se izgubi 2D kontekst iscrtavanja elementa canvas. Aplikaciji omogućuje da reagira na gubitak resursa, ali sam ne obnavlja crtež.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<canvas oncontextlost="handler(event)"></canvas>
canvas.oncontextlost = handler;oncontextlost je globalni atribut za obradu događaja contextlost. U praksi se upotrebljava na elementu canvas čiji je 2D kontekst izgubio pohranu slikovnih podataka. Vrijednost atributa je JavaScript kôd, a ne Booleova vrijednost; kôd prima objekt event.
U JavaScriptu funkciju možeš dodijeliti svojstvu canvas.oncontextlost. Druga je mogućnost upotrijebiti canvas.addEventListener('contextlost', handler). I OffscreenCanvas izlaže svojstvo oncontextlost, ali nije HTML element i nema atribute za označavanje. Nemoj miješati ovaj događaj s WebGL događajem webglcontextlost.
Pri stvarnom gubitku konteksta preglednik vraća stanje iscrtavanja na početno. Događaj contextlost može se otkazati: event.preventDefault() zaustavlja pokušaj obnove konteksta opisan u standardu; nemoj pozvati tu metodu ako želiš omogućiti taj pokušaj. Obnova nije zajamčena. Nakon događaja contextrestored aplikacija bi trebala ponovno postaviti potrebno stanje i ponovno iscrtati sadržaj.
Primjer šalje sintetički događaj pa radi bez izazivanja grafičkog kvara. Izlaz contextlost: false prikazuje vrstu događaja i vrijednost event.isTrusted. Test provjerava samo obradu događaja, a ne gubitak resursa ni njihovu obnovu.
Primjeri
<!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>Rezultat
contextlost: false
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.