База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

oncontextrestored — обработване на възстановяването на контекста на canvas

Атрибутът oncontextrestored задава код за обработване на събитието contextrestored. При canvas с 2D контекст събитието сигнализира за възстановяване след загуба на контекста; след това приложението трябва да изгради отново настройките за рисуване и съдържанието.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

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

oncontextrestored е HTML атрибут за обработване на събития и съответстващо JavaScript свойство от GlobalEventHandlers. Името на събитието е contextrestored, без префикса on. В HTML стойността на атрибута е JavaScript код с достъпен параметър event; на JavaScript свойството се присвоява функция или null. addEventListener("contextrestored", handler) е алтернатива, която позволява регистриране на няколко слушателя.

Браузърът изпраща това събитие до canvas след успешно възстановяване на загубен 2D контекст. Загубата на контекста нулира състоянието на рисуване, затова обработчикът трябва отново да приложи необходимите стилове и трансформации и да прерисува сцената въз основа на данните на приложението. Не приемайте, че предишните пиксели се възстановяват автоматично. Задаването на обработчик само по себе си не възстановява контекста и не гарантира успешно възстановяване.

Примерът проверява само свързването на атрибута, като изпраща синтетично събитие. Стойността на event.isTrusted е false; това не проверява действителна загуба или възстановяване на контекста. Изпълнете го в браузър, който поддържа свойството и позволява вградени скриптове.

Примери

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

Резултат

contextrestored false

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници