Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

oncontextrestored — obsługa przywrócenia kontekstu canvas

Atrybut oncontextrestored określa kod obsługi zdarzenia contextrestored. Dla canvas z kontekstem 2D zdarzenie sygnalizuje przywrócenie kontekstu po jego utracie; aplikacja powinna wtedy odtworzyć ustawienia rysowania i zawartość.

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

Składnia

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

oncontextrestored to atrybut obsługi zdarzeń HTML oraz odpowiadająca mu właściwość JavaScript z GlobalEventHandlers. Nazwa zdarzenia to contextrestored, bez prefiksu on. W HTML wartością atrybutu jest kod JavaScript z dostępnym parametrem event; właściwości JavaScript przypisuje się funkcję lub null. addEventListener("contextrestored", handler) jest alternatywą umożliwiającą rejestrowanie wielu funkcji.

Przeglądarka wysyła to zdarzenie do canvas po udanym przywróceniu utraconego kontekstu 2D. Utrata resetuje stan rysowania, więc obsługa powinna ponownie ustawić potrzebne style i transformacje oraz przerysować scenę z danych aplikacji. Nie należy zakładać automatycznego odzyskania poprzednich pikseli. Samo przypisanie obsługi nie przywraca kontekstu i nie gwarantuje, że przywrócenie się powiedzie.

Przykład sprawdza wyłącznie podłączenie atrybutu, wysyłając syntetyczne zdarzenie. Wartość event.isTrusted wynosi false; nie jest to test rzeczywistej utraty ani odzyskania kontekstu. Uruchom go w przeglądarce obsługującej tę właściwość, z dozwolonym wykonywaniem skryptów inline.

Przykłady

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

Wynik

contextrestored false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła