CKTIS / HTML
oncontextrestored — gérer la restauration du contexte canvas
L’attribut oncontextrestored définit le code qui traite l’événement contextrestored. Pour un canvas doté d’un contexte 2D, cet événement signale la restauration après une perte du contexte ; l’application doit alors reconstituer ses paramètres de dessin et son contenu.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<canvas oncontextrestored="/* JavaScript using event */"></canvas>
canvas.oncontextrestored = (event) => { /* handle restoration */ };
canvas.addEventListener("contextrestored", handler);oncontextrestored est un attribut HTML de gestion d’événement ainsi qu’une propriété JavaScript correspondante issue de GlobalEventHandlers. Le nom de l’événement est contextrestored, sans le préfixe on. En HTML, la valeur de l’attribut est du code JavaScript qui dispose du paramètre event ; la propriété JavaScript reçoit une fonction ou null. addEventListener("contextrestored", handler) est une autre solution qui permet d’enregistrer plusieurs écouteurs.
Le navigateur déclenche cet événement sur le canvas après avoir restauré avec succès un contexte 2D perdu. La perte du contexte réinitialise l’état de dessin : le gestionnaire doit donc réappliquer les styles et transformations nécessaires, puis redessiner la scène à partir des données de l’application. Ne partez pas du principe que les pixels précédents sont automatiquement récupérés. L’affectation d’un gestionnaire ne restaure pas le contexte et ne garantit pas que la restauration réussira.
L’exemple vérifie uniquement le branchement de l’attribut en déclenchant un événement synthétique. La valeur de event.isTrusted est false ; cela ne teste ni une perte réelle du contexte ni sa récupération. Exécutez-le dans un navigateur qui prend en charge cette propriété et autorise les scripts inline.
Exemples
<!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>Résultat
contextrestored false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.