CKTIS / HTML
oncontextrestored — obsluha obnovenia kontextu canvas
Atribút oncontextrestored určuje kód na obsluhu udalosti contextrestored. Pri prvku canvas s 2D kontextom táto udalosť signalizuje obnovenie po strate kontextu; aplikácia by potom mala znovu vytvoriť nastavenia kreslenia a obsah.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<canvas oncontextrestored="/* JavaScript using event */"></canvas>
canvas.oncontextrestored = (event) => { /* handle restoration */ };
canvas.addEventListener("contextrestored", handler);oncontextrestored je atribút HTML na obsluhu udalostí a zodpovedajúca vlastnosť JavaScriptu z GlobalEventHandlers. Názov udalosti je contextrestored, bez predpony on. V HTML je hodnota atribútu kód JavaScriptu s dostupným parametrom event; vlastnosti JavaScriptu sa priraďuje funkcia alebo null. addEventListener("contextrestored", handler) je alternatíva, ktorá umožňuje zaregistrovať viacero poslucháčov.
Prehliadač odošle túto udalosť prvku canvas po úspešnom obnovení strateného 2D kontextu. Strata kontextu obnoví predvolený stav kreslenia, preto by obsluha mala znova nastaviť potrebné štýly a transformácie a prekresliť scénu z údajov aplikácie. Nepredpokladajte, že sa predchádzajúce pixely obnovia automaticky. Priradenie obsluhy samo osebe kontext neobnoví a nezaručuje úspešné obnovenie.
Príklad overuje iba pripojenie atribútu odoslaním syntetickej udalosti. Hodnota event.isTrusted je false; nejde o test skutočnej straty ani obnovenia kontextu. Spustite ho v prehliadači, ktorý túto vlastnosť podporuje a povoľuje vložené skripty.
Príklady
<!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>Výsledok
contextrestored false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.