Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

oncontextlost — obsługa utraty kontekstu canvas

Atrybut oncontextlost określa kod obsługujący zdarzenie contextlost, zgłaszane po utracie kontekstu renderowania 2D elementu canvas. Pozwala zareagować na utratę zasobów, ale nie przywraca samodzielnie rysunku.

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

Składnia

<canvas oncontextlost="handler(event)"></canvas>
canvas.oncontextlost = handler;

oncontextlost jest globalnym atrybutem obsługi zdarzenia contextlost. W praktyce używa się go na elemencie canvas, którego kontekst 2D utracił pamięć przechowującą obraz. Wartością atrybutu jest kod JavaScript, a nie wartość logiczna; kod otrzymuje obiekt event.

W JavaScript można przypisać funkcję do właściwości canvas.oncontextlost. Alternatywą jest canvas.addEventListener('contextlost', handler). OffscreenCanvas także udostępnia właściwość oncontextlost, ale nie jest elementem HTML i nie ma atrybutów znacznikowych. Nie należy mylić tego zdarzenia ze zdarzeniem WebGL webglcontextlost.

Przy rzeczywistej utracie kontekstu przeglądarka resetuje stan renderowania. Zdarzenie contextlost można anulować: event.preventDefault() zatrzymuje opisaną w standardzie próbę przywrócenia kontekstu; nie wywołuj tej metody, jeśli chcesz umożliwić tę próbę. Przywrócenie nie jest gwarantowane. Po zdarzeniu contextrestored aplikacja powinna ponownie ustawić potrzebny stan i narysować zawartość.

Przykład wysyła zdarzenie syntetyczne, więc działa bez wywoływania awarii grafiki. Wynik contextlost: false oznacza typ zdarzenia i wartość event.isTrusted. Test sprawdza wyłącznie obsługę zdarzenia — nie utratę zasobów ani ich przywracanie.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>oncontextlost test</title>
<canvas id="surface" oncontextlost="document.getElementById('result').textContent = event.type + ': ' + event.isTrusted"></canvas>
<pre id="result">waiting</pre>
<script>
  document.getElementById('surface').dispatchEvent(
    new Event('contextlost', { cancelable: true })
  );
</script>

Wynik

contextlost: false

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

Źródła