CKTIS / HTML
oncontextlost – obravnava izgube konteksta canvas
Atribut oncontextlost določa kodo, ki obravnava dogodek contextlost. Ta se sproži, ko se izgubi 2D-kontekst za izris elementa canvas. Aplikacija se tako lahko odzove na izgubo virov, vendar s tem sama ne obnovi risbe.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<canvas oncontextlost="handler(event)"></canvas>
canvas.oncontextlost = handler;oncontextlost je globalni atribut za obravnavo dogodka contextlost. V praksi se uporablja na elementu canvas, katerega 2D-kontekst je izgubil shranjene slikovne podatke. Vrednost atributa je koda JavaScript, ne logična vrednost; koda prejme objekt event.
V JavaScriptu lahko funkcijo dodeliš lastnosti canvas.oncontextlost. Namesto tega lahko uporabiš canvas.addEventListener('contextlost', handler). Tudi OffscreenCanvas ponuja lastnost oncontextlost, vendar ni element HTML in nima atributov za označevanje. Tega dogodka ne zamenjuj z dogodkom WebGL webglcontextlost.
Ob dejanski izgubi konteksta brskalnik ponastavi stanje izrisovanja. Dogodek contextlost je mogoče preklicati: event.preventDefault() ustavi poskus obnovitve konteksta, opisan v standardu; te metode ne pokliči, če želiš ta poskus omogočiti. Obnovitev ni zagotovljena. Po dogodku contextrestored mora aplikacija znova nastaviti potrebno stanje in ponovno izrisati vsebino.
Primer pošlje sintetični dogodek, zato deluje, ne da bi povzročil grafično napako. Izhod contextlost: false prikazuje vrsto dogodka in vrednost event.isTrusted. Preizkus preverja samo obravnavo dogodka, ne pa izgube virov ali njihove obnovitve.
Primeri
<!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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.