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
# dom-canvas-height

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
width

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch