KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

HTMLCanvasElement: rendercontext en bitmapafmetingen

Kies een rendercontext met `getContext()` en stel de bitmapafmetingen in met `width` en `height`. Anders dan CSS maakt zo’n toewijzing in 2D-modus de bitmap leeg en zet ze de tekenstatus terug.

Versie: Current web platform; runtime support varies

Syntax

canvas.getContext(contextId)
canvas.getContext(contextId, options)
canvas.width
canvas.height
canvas.width = bitmapWidth
canvas.height = bitmapHeight

HTMLCanvasElement is een browserinterface die door HTML wordt gedefinieerd, niet door ECMAScript 2024. canvas.getContext(contextId, options) verwacht een tekenreeks als ID en optionele instellingen per modus. "2d" kiest CanvasRenderingContext2D, "bitmaprenderer" kiest ImageBitmapRenderingContext, "webgl" kiest WebGLRenderingContext, "webgl2" kiest WebGL2RenderingContext en "webgpu" kiest GPUCanvasContext. Welke modi en opties beschikbaar zijn, hangt af van de uitvoeringsomgeving.

De eerste geslaagde aanroep legt de modus van het element vast. Een volgende aanroep met dezelfde ID geeft hetzelfde object terug zonder nieuwe instellingen toe te passen. Een niet-ondersteunde of onbeschikbare modus, of een verzoek om een andere modus, levert null op. Na een geslaagde aanroep van transferControlToOffscreen() is het element een plaatsaanduiding: getContext() aanroepen of een waarde aan width of height toewijzen leidt tot InvalidStateError.

canvas.width en canvas.height weerspiegelen de gelijknamige HTML-attributen. Ze geven de breedte en hoogte van de bitmap aan als niet-negatieve gehele getallen. Als een attribuut ontbreekt of niet kan worden verwerkt, geldt de bijbehorende standaardwaarde 300 of 150. Alleen canvas.style.width of canvas.style.height wijzigen verandert de weergavegrootte, niet de resolutie van de bitmap; schalen kan het beeld onscherp maken.

In 2D-modus wist een toewijzing aan een van beide afmetingen de bitmap, zelfs als de waarde gelijk blijft. De tekenstatus, waaronder het huidige pad, de transformatie en de stijlen, gaat terug naar de standaardwaarden, maar het contextobject blijft hetzelfde. Stel de afmetingen in vóór je tekent; herstel na een wijziging de benodigde status en teken opnieuw. Ga er niet van uit dat andere modi zich hetzelfde gedragen.

Als je een afbeelding van een andere origin tekent zonder passende CORS-toestemming, kan de bitmap zijn origin-clean-status verliezen. Dan geeft getImageData() een SecurityError; als je de 2D-bitmap een andere grootte geeft, gaat de inhoud verloren en komen de geblokkeerde pixels niet vrij.

Voorbeelden

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D resize reset</title>
<script>
(() => {
  const canvas = document.createElement("canvas");
  console.log(`${canvas.width}x${canvas.height}`);
  canvas.width = 4;
  canvas.height = 3;
  console.log(`${canvas.width}x${canvas.height}`);

  const ctx = canvas.getContext("2d");
  if (ctx === null) throw new Error("2D canvas context unavailable");

  ctx.fillRect(0, 0, 1, 1);
  ctx.globalAlpha = 0.5;
  const alphaAtOrigin = () => ctx.getImageData(0, 0, 1, 1).data[3];
  console.log(`${alphaAtOrigin()} ${ctx.globalAlpha}`);

  canvas.width = canvas.width;
  console.log(`${alphaAtOrigin()} ${ctx.globalAlpha}`);
  console.log(canvas.getContext("2d") === ctx);
  console.log(canvas.getContext("bitmaprenderer") === null);
})();
</script>

Resultaat

300x150
4x3
255 0.5
0 1
true
true

Sla het voorbeeld op als HTML-bestand, open het in een browser en bekijk de uitvoer in de ontwikkelaarsconsole. De eerste twee regels laten de afmetingen zien. Dezelfde breedte opnieuw toewijzen verandert de alfa van de pixel van `255` in `0` en zet `globalAlpha` terug van `0.5` naar `1`. De twee resultaten `true` laten zien dat dezelfde context behouden blijft en een andere modus wordt geweigerd.

Gerelateerde lessen

  • JavaScript · Les 12 · Gevorderd · Versie: 4
  • JavaScript · Les 33 · Gevorderd · Versie: 4
  • JavaScript · Les 34 · Gevorderd · Versie: 4

Bronnen