CKTIS / HTML
oncontextrestored – Wiederherstellung des Canvas-Kontexts behandeln
Das Attribut oncontextrestored legt Code zur Behandlung des Ereignisses contextrestored fest. Bei einem Canvas mit 2D-Kontext signalisiert das Ereignis die Wiederherstellung nach einem Kontextverlust; anschließend sollte die Anwendung Zeicheneinstellungen und Inhalt neu aufbauen.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<canvas oncontextrestored="/* JavaScript using event */"></canvas>
canvas.oncontextrestored = (event) => { /* handle restoration */ };
canvas.addEventListener("contextrestored", handler);oncontextrestored ist ein HTML-Ereignisbehandlungsattribut und eine entsprechende JavaScript-Eigenschaft aus GlobalEventHandlers. Der Ereignisname lautet contextrestored, ohne das Präfix on. In HTML ist der Attributwert JavaScript-Code, dem der Parameter event zur Verfügung steht; der JavaScript-Eigenschaft wird eine Funktion oder null zugewiesen. addEventListener("contextrestored", handler) ist eine Alternative, mit der sich mehrere Listener registrieren lassen.
Der Browser löst dieses Ereignis am canvas aus, nachdem ein verlorener 2D-Kontext erfolgreich wiederhergestellt wurde. Bei einem Kontextverlust wird der Zeichenzustand zurückgesetzt. Die Behandlung sollte daher die benötigten Stile und Transformationen erneut anwenden und die Szene anhand der Anwendungsdaten neu zeichnen. Gehen Sie nicht davon aus, dass die vorherigen Pixel automatisch wiederhergestellt werden. Das Zuweisen eines Handlers stellt den Kontext nicht selbst wieder her und garantiert auch nicht, dass die Wiederherstellung gelingt.
Das Beispiel prüft nur die Einbindung des Attributs, indem es ein synthetisches Ereignis auslöst. Der Wert von event.isTrusted ist false; damit wird weder ein tatsächlicher Kontextverlust noch eine Wiederherstellung getestet. Führen Sie das Beispiel in einem Browser aus, der die Eigenschaft unterstützt und Inline-Skripte erlaubt.
Beispiele
<!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>Ergebnis
contextrestored false
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.