CKTIS / JavaScript
HTMLCanvasElement: breedte en hoogte van de bitmap
`canvas.width` en `canvas.height` bepalen de bitmapgrootte, niet de weergavegrootte in CSS. In een 2D-context wist zelfs een toewijzing van dezelfde waarde de tekening en herstelt die de begininstellingen.
Versie: Current web platform; runtime support varies
Syntax
canvas.width
canvas.height
canvas.width = widthInPixels;
canvas.height = heightInPixels;canvas.width en canvas.height zijn lees- en schrijfbare eigenschappen van een canvas-element. Ze weerspiegelen de gelijknamige HTML-attributen en bepalen de breedte en hoogte van de bitmap in pixels. Gebruik niet-negatieve gehele getallen in de HTML-attributen. Ontbreekt een attribuut of kan het niet als zo’n getal worden gelezen, dan geldt de standaardwaarde 300 voor de breedte of 150 voor de hoogte. Deze eigenschappen horen bij het webplatform, niet bij ECMAScript.
canvas.style.width en canvas.style.height bepalen de grootte van het element in de pagina-indeling, niet die van de bitmap. Een wijziging van alleen CSS laat de pixels en de tekening intact. De weergegeven afbeelding kan wazig worden bij vergroting of vervormen als de beeldverhouding verandert.
Bij een 2d-context wist een toewijzing aan een van de bitmapafmetingen de tekening en zet die dezelfde context terug naar de standaardtoestand, ook als je de huidige waarde toewijst. Dit geldt onder meer voor het huidige pad, de transformatie en de stijlen. Stel de afmetingen in voordat je tekent. Wijzig je ze later, stel dan de benodigde toestand opnieuw in en teken opnieuw.
Ga er niet van uit dat WebGL of WebGPU zich hetzelfde gedraagt als 2d. Na transferControlToOffscreen() dient het element als plaatshouder: een toewijzing aan zijn width of height veroorzaakt InvalidStateError. Stel de afmetingen in op het OffscreenCanvas-object.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Canvas bitmap dimensions</title>
</head>
<body>
<script>
(() => {
const canvas = document.createElement('canvas');
console.log(`Default: ${canvas.width} × ${canvas.height}`);
canvas.width = 4;
canvas.height = 2;
const ctx = canvas.getContext('2d');
if (!ctx) throw new Error('Canvas 2D is unavailable.');
ctx.fillRect(0, 0, 1, 1);
ctx.globalAlpha = 0.5;
const pixelAlpha = () => ctx.getImageData(0, 0, 1, 1).data[3];
canvas.style.width = '40px';
canvas.style.height = '20px';
console.log(`After CSS: ${canvas.width} × ${canvas.height}; pixel alpha ${pixelAlpha()}; globalAlpha ${ctx.globalAlpha}`);
canvas.width = canvas.width;
console.log(`After assignment: ${canvas.width} × ${canvas.height}; pixel alpha ${pixelAlpha()}; globalAlpha ${ctx.globalAlpha}`);
})();
</script>
</body>
</html>Resultaat
Default: 300 × 150 After CSS: 4 × 2; pixel alpha 255; globalAlpha 0.5 After assignment: 4 × 2; pixel alpha 0; globalAlpha 1
Open het HTML-bestand in een browser en lees de uitvoer in de browserconsole. Het canvas wordt niet aan de pagina toegevoegd. Na de CSS-wijziging blijft de pixel ondoorzichtig (`255`); dezelfde breedte opnieuw toewijzen wist de pixel (`0`) en zet `globalAlpha` terug op `1`.
Gerelateerde lessen
- JavaScript · Les 26 · Gemiddeld · Versie: 3
- JavaScript · Les 27 · Gemiddeld · Versie: 3