HTMLCanvasElement: width 屬性

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

HTMLCanvasElement.width 屬性是一個正整數,反映了 width HTML 屬性在 CSS 畫素中解釋的 <canvas> 元素。當未指定該屬性,或者其值無效(例如負數)時,將使用預設值 300

設定 width 屬性會重置整個渲染上下文為其預設狀態。這包括清除畫布(後端緩衝區)、重置當前路徑,以及重置所有屬性,如 fillStyleglobalCompositeOperation。這種重置對所有上下文型別都會發生,即使設定 width 為其當前值時也會發生。要在更改寬度後恢復之前的畫布內容,請使用 CanvasRenderingContext2D.getImageData()CanvasRenderingContext2D.putImageData()。上下文屬性必須單獨跟蹤和恢復。

這是兩個控制畫布尺寸的屬性之一,另一個是 HTMLCanvasElement.height

一個數字。

示例

給定此 <canvas> 元素

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

您可以使用以下程式碼獲取畫布的寬度

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

規範

規範
HTML
# dom-canvas-height

瀏覽器相容性

另見