CKTIS / HTML
oncontextrestored — obravnava obnovitve konteksta canvas
Atribut oncontextrestored določa kodo za obravnavo dogodka contextrestored. Pri elementu canvas z 2D-kontekstom dogodek označuje obnovitev po izgubi konteksta; aplikacija naj nato znova vzpostavi nastavitve risanja in vsebino.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<canvas oncontextrestored="/* JavaScript using event */"></canvas>
canvas.oncontextrestored = (event) => { /* handle restoration */ };
canvas.addEventListener("contextrestored", handler);oncontextrestored je atribut HTML za obravnavo dogodkov in ustrezna lastnost JavaScripta iz GlobalEventHandlers. Ime dogodka je contextrestored, brez predpone on. V HTML je vrednost atributa koda JavaScript z dostopnim parametrom event; lastnosti JavaScript se dodeli funkcija ali null. addEventListener("contextrestored", handler) je alternativa, ki omogoča registracijo več poslušalcev.
Brskalnik po uspešni obnovitvi izgubljenega 2D-konteksta pošlje ta dogodek elementu canvas. Izguba konteksta ponastavi stanje risanja, zato naj obravnavalnik znova nastavi potrebne sloge in transformacije ter na podlagi podatkov aplikacije ponovno nariše prizor. Ne predpostavljajte, da se prejšnje slikovne točke samodejno povrnejo. Dodelitev obravnavalnika sama ne obnovi konteksta in ne zagotavlja, da bo obnovitev uspela.
Primer preveri samo povezavo atributa, tako da pošlje sintetični dogodek. Vrednost event.isTrusted je false; s tem ne preveri dejanske izgube ali obnovitve konteksta. Zaženite ga v brskalniku, ki podpira to lastnost in dovoljuje vstavljene skripte.
Primeri
<!doctype html>
<meta charset="utf-8">
<title>oncontextrestored test</title>
<canvas id="surface" width="80" height="40"
oncontextrestored="console.log(event.type, event.isTrusted)"></canvas>
<script>
const canvas = document.getElementById("surface");
if (!("oncontextrestored" in canvas)) {
throw new Error("oncontextrestored is not supported");
}
canvas.dispatchEvent(new Event("contextrestored"));
</script>Rezultat
contextrestored false
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.