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

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.

Zdroje