CKTIS / JavaScript
HTMLCanvasElement: Breite und Höhe der Bitmap
`canvas.width` und `canvas.height` bestimmen die Größe der Bitmap, nicht die Anzeigegröße in CSS. Im 2D-Kontext löscht auch die Zuweisung des bisherigen Werts die Zeichnung und setzt den Zeichenstatus zurück.
Version: Current web platform; runtime support varies
Syntax
canvas.width
canvas.height
canvas.width = widthInPixels;
canvas.height = heightInPixels;canvas.width und canvas.height sind les- und schreibbare Eigenschaften eines canvas-Elements. Sie spiegeln die gleichnamigen HTML-Attribute wider und bestimmen Breite und Höhe der Bitmap in Pixeln. Gib für die HTML-Attribute nichtnegative ganze Zahlen an. Fehlt ein Attribut oder lässt es sich nicht als solche Zahl lesen, gilt der Standardwert 300 für die Breite oder 150 für die Höhe. Die Eigenschaften gehören zur Webplattform, nicht zu ECMAScript.
canvas.style.width und canvas.style.height legen die Größe des Elements im Seitenlayout fest, nicht die Abmessungen der Bitmap. Eine reine CSS-Änderung lässt die Pixel und die Zeichnung unverändert. Vergrößert kann das Bild unscharf aussehen; bei einem anderen Seitenverhältnis kann es verzerrt werden.
Bei einem 2d-Kontext löscht eine Zuweisung an eine der beiden Bitmap-Abmessungen die Zeichnung und versetzt denselben Kontext in seinen Ausgangszustand, auch wenn du den bisherigen Wert zuweist. Das betrifft unter anderem den aktuellen Pfad, die Transformation und die Stile. Lege die Abmessungen vor dem Zeichnen fest. Wenn du sie später änderst, stelle den benötigten Zustand wieder her und zeichne erneut.
Gehe bei WebGL oder WebGPU nicht vom gleichen Verhalten wie bei 2d aus. Nach transferControlToOffscreen() ist das Element ein Platzhalter: Eine Zuweisung an sein width oder height löst InvalidStateError aus. Lege die Abmessungen stattdessen am OffscreenCanvas fest.
Beispiele
<!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>Ergebnis
Default: 300 × 150 After CSS: 4 × 2; pixel alpha 255; globalAlpha 0.5 After assignment: 4 × 2; pixel alpha 0; globalAlpha 1
Öffne die HTML-Datei im Browser und lies die Ausgabe in der Browserkonsole. Das Element wird nicht in die Seite eingefügt. Nach der CSS-Änderung bleibt das Pixel deckend (`255`); dieselbe Breite erneut zuzuweisen löscht es (`0`) und setzt `globalAlpha` auf `1` zurück.
Zugehörige Lektionen
- JavaScript · Lektion 26 · Mittlere Stufe · Version: 3
- JavaScript · Lektion 27 · Mittlere Stufe · Version: 3