CKTIS / HTML
oncontextrestored — gestire il ripristino del contesto canvas
L’attributo oncontextrestored specifica il codice che gestisce l’evento contextrestored. Per un canvas con contesto 2D, l’evento segnala il ripristino dopo la perdita del contesto; a quel punto l’applicazione dovrebbe ricostruire le impostazioni di disegno e il contenuto.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<canvas oncontextrestored="/* JavaScript using event */"></canvas>
canvas.oncontextrestored = (event) => { /* handle restoration */ };
canvas.addEventListener("contextrestored", handler);oncontextrestored è un attributo HTML per la gestione degli eventi e la corrispondente proprietà JavaScript di GlobalEventHandlers. Il nome dell’evento è contextrestored, senza il prefisso on. In HTML, il valore dell’attributo è codice JavaScript che ha a disposizione il parametro event; alla proprietà JavaScript si assegna una funzione oppure null. addEventListener("contextrestored", handler) è un’alternativa che consente di registrare più listener.
Il browser invia questo evento al canvas dopo aver ripristinato correttamente un contesto 2D perso. La perdita del contesto azzera lo stato di disegno, quindi il gestore dovrebbe applicare di nuovo gli stili e le trasformazioni necessari e ridisegnare la scena usando i dati dell’applicazione. Non dare per scontato che i pixel precedenti vengano recuperati automaticamente. Assegnare un gestore non ripristina il contesto e non garantisce che il ripristino riesca.
L’esempio verifica solo il collegamento dell’attributo inviando un evento sintetico. Il valore di event.isTrusted è false; non si tratta di un test di perdita o ripristino effettivi del contesto. Eseguilo in un browser che supporta la proprietà e consente gli script inline.
Esempi
<!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>Risultato
contextrestored false
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.