Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / HTML

oncontextrestored — obrada obnove konteksta canvas elementa

Atribut oncontextrestored određuje kod za obradu događaja contextrestored. Za canvas s 2D kontekstom događaj označava obnovu nakon gubitka konteksta; aplikacija bi zatim trebala ponovno uspostaviti postavke crtanja i sadržaj.

Verzija: 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 HTML atribut za obradu događaja i odgovarajuće JavaScript svojstvo iz GlobalEventHandlers. Naziv događaja je contextrestored, bez prefiksa on. U HTML-u je vrijednost atributa JavaScript kod kojem je dostupan parametar event; JavaScript svojstvu dodjeljuje se funkcija ili null. addEventListener("contextrestored", handler) alternativa je koja omogućuje registraciju više slušatelja.

Preglednik šalje ovaj događaj elementu canvas nakon uspješne obnove izgubljenog 2D konteksta. Gubitak konteksta vraća stanje crtanja na početno, pa bi obrađivač trebao ponovno postaviti potrebne stilove i transformacije te ponovno nacrtati scenu na temelju podataka aplikacije. Nemojte pretpostaviti da se prethodni pikseli automatski vraćaju. Dodjela obrađivača sama po sebi ne obnavlja kontekst i ne jamči uspješnu obnovu.

Primjer provjerava samo povezivanje atributa slanjem sintetičkog događaja. Vrijednost event.isTrusted jest false; time se ne testira stvarni gubitak ni obnova konteksta. Pokrenite ga u pregledniku koji podržava to svojstvo i dopušta umetnute skripte.

Primjeri

<!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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori