Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

oncontextrestored — obsluha obnovení kontextu canvas

Atribut oncontextrestored určuje kód pro obsluhu události contextrestored. U prvku canvas s 2D kontextem tato událost signalizuje obnovení po ztrátě kontextu; aplikace by pak měla znovu vytvořit nastavení kreslení a obsah.

Verze: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<canvas oncontextrestored="/* JavaScript using event */"></canvas>
canvas.oncontextrestored = (event) => { /* handle restoration */ };
canvas.addEventListener("contextrestored", handler);

oncontextrestored je atribut HTML pro obsluhu událostí a odpovídající vlastnost JavaScriptu z GlobalEventHandlers. Název události je contextrestored, bez předpony on. V HTML je hodnota atributu kód JavaScriptu s dostupným parametrem event; vlastnosti JavaScriptu se přiřazuje funkce nebo null. addEventListener("contextrestored", handler) je alternativou, která umožňuje registrovat více posluchačů.

Prohlížeč odešle tuto událost prvku canvas po úspěšném obnovení ztraceného 2D kontextu. Při ztrátě kontextu se obnoví výchozí stav kreslení, takže obsluha by měla znovu nastavit potřebné styly a transformace a překreslit scénu z dat aplikace. Nepředpokládejte, že se předchozí pixely obnoví automaticky. Přiřazení obsluhy samo kontext neobnoví a nezaručuje úspěšné obnovení.

Příklad ověřuje pouze napojení atributu tím, že odešle syntetickou událost. Hodnota event.isTrusted je false; nejde o test skutečné ztráty ani obnovení kontextu. Spusťte jej v prohlížeči, který tuto vlastnost podporuje a povoluje vložené skripty.

Pří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ýsledek

contextrestored false

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje