CKTIS / HTML
oncontextrestored — herstel van de canvas-context afhandelen
Het attribuut oncontextrestored geeft de code op die de gebeurtenis contextrestored afhandelt. Bij een canvas met een 2D-context geeft de gebeurtenis aan dat de context na verlies is hersteld; de toepassing moet dan de tekeninstellingen en inhoud opnieuw opbouwen.
Versie: 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 is een HTML-attribuut voor gebeurtenisafhandeling en een overeenkomstige JavaScript-eigenschap uit GlobalEventHandlers. De gebeurtenisnaam is contextrestored, zonder het voorvoegsel on. In HTML is de attribuutwaarde JavaScript-code met de parameter event beschikbaar; aan de JavaScript-eigenschap wijs je een functie of null toe. addEventListener("contextrestored", handler) is een alternatief waarmee je meerdere luisteraars kunt registreren.
De browser verstuurt deze gebeurtenis naar het canvas nadat een verloren 2D-context met succes is hersteld. Bij contextverlies wordt de tekenstatus teruggezet. De handler moet daarom de benodigde stijlen en transformaties opnieuw toepassen en de scène opnieuw tekenen op basis van toepassingsgegevens. Ga er niet van uit dat eerdere pixels automatisch worden teruggehaald. Een handler toewijzen herstelt de context niet zelf en garandeert niet dat herstel zal slagen.
Het voorbeeld test alleen of het attribuut is gekoppeld, door een synthetische gebeurtenis te versturen. De waarde van event.isTrusted is false; dit test geen daadwerkelijk contextverlies of herstel. Voer het uit in een browser die de eigenschap ondersteunt en inline scripts toestaat.
Voorbeelden
<!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>Resultaat
contextrestored false
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.