KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

oncontextlost — omgaan met verlies van de canvas-context

Het oncontextlost-attribuut geeft de code op die het contextlost-event afhandelt. Dit event wordt verzonden wanneer de 2D-renderingcontext van een canvas-element verloren gaat. Zo kan een toepassing op verloren resources reageren, maar de tekening wordt niet vanzelf hersteld.

Versie: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<canvas oncontextlost="handler(event)"></canvas>
canvas.oncontextlost = handler;

oncontextlost is een globaal event-handlerattribuut voor contextlost. In de praktijk wordt het gebruikt op een canvas-element waarvan de 2D-context de opslag voor de afbeelding is kwijtgeraakt. De attribuutwaarde is JavaScript-code, geen booleaanse waarde; de code ontvangt het object event.

In JavaScript kun je een functie toewijzen aan de eigenschap canvas.oncontextlost. Je kunt ook canvas.addEventListener('contextlost', handler) gebruiken. OffscreenCanvas biedt eveneens een eigenschap oncontextlost, maar is geen HTML-element en heeft geen markup-attributen. Verwar dit event niet met het WebGL-event webglcontextlost.

Bij werkelijk contextverlies reset de browser de renderstatus. Het event contextlost kan worden geannuleerd: event.preventDefault() stopt de in de standaard beschreven poging om de context te herstellen; roep deze methode niet aan als je die poging wilt toestaan. Herstel is niet gegarandeerd. Na contextrestored moet de toepassing de benodigde status opnieuw instellen en de inhoud opnieuw tekenen.

Het voorbeeld verstuurt een synthetisch event en werkt dus zonder een grafische storing te veroorzaken. De uitvoer contextlost: false toont het eventtype en de waarde van event.isTrusted. Deze test controleert alleen de eventafhandeling, niet het verlies van resources of het herstel ervan.

Voorbeelden

<!doctype html>
<meta charset="utf-8">
<title>oncontextlost test</title>
<canvas id="surface" oncontextlost="document.getElementById('result').textContent = event.type + ': ' + event.isTrusted"></canvas>
<pre id="result">waiting</pre>
<script>
  document.getElementById('surface').dispatchEvent(
    new Event('contextlost', { cancelable: true })
  );
</script>

Resultaat

contextlost: 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.

Bronnen