HTMLCanvasElement: width-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die HTMLCanvasElement.width-Eigenschaft ist eine positive integer, die das width HTML-Attribut des <canvas>-Elements widerspiegelt und in CSS-Pixel interpretiert wird. Wenn das Attribut nicht angegeben ist oder auf einen ungültigen Wert, wie einen negativen, gesetzt ist, wird der Standardwert von 300 verwendet.

Wenn die width-Eigenschaft gesetzt wird, wird der Zeichenpuffer immer auf leer zurückgesetzt – dies gilt für alle Kontexttypen und sogar, wenn die Breite auf denselben Wert gesetzt wird. Wenn Sie den vorherigen Inhalt wiederherstellen müssen, können Sie ihn über CanvasRenderingContext2D.getImageData() speichern und über CanvasRenderingContext2D.putImageData() wiederherstellen.

Dies ist eine von zwei Eigenschaften, die andere ist HTMLCanvasElement.height, die die Größe des Canvas steuern.

Wert

Eine Zahl.

Beispiele

Angenommen, dieses <canvas>-Element:

html
<canvas id="canvas" width="300" height="300"></canvas>

Sie können die Breite des Canvas mit dem folgenden Code abrufen:

js
const canvas = document.getElementById("canvas");
console.log(canvas.width); // 300

Spezifikationen

Specification
HTML Standard
# dom-canvas-height

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch