大网数据广告活动
Web 标准与前端开发

HTMLCanvasElement:width 属性

· 52CE 我爱测

`HTMLCanvasElement.width`** 属性是一个正整数(`integer`),表示以 CSS 像素为单位解析的 canvas 元素的 `width` HTML 属性。当未指定该属性,或者设置为无效值(例如负数)时,将使用默认值 `300`。

Canvas API

HTMLCanvasElement.width 属性是一个正整数(integer),表示以 CSS 像素为单位解析的 canvas 元素的 width HTML 属性。当未指定该属性,或者设置为无效值(例如负数)时,将使用默认值 300。

当设置 width 属性时,绘图缓冲区总是会被重置为空白状态——这对于所有上下文类型都适用,即使高度被设置为相同的值也是如此。如果需要恢复之前的内容,可以通过 CanvasRenderingContext2D.getImageData() 保存,并通过 CanvasRenderingContext2D.putImageData() 进行恢复。

这是控制画布大小的两个属性之一,另一个属性是 HTMLCanvasElement.height。

值

一个数字。

示例

给定以下 canvas 元素:

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

你可以通过以下代码获取画布的宽度:

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

规范

浏览器兼容性

参见

  • HTMLCanvasElement:用于定义 HTMLCanvasElement.width 属性的接口
  • HTMLCanvasElement.height:用于控制画布大小的另一个属性
  • HTMLEmbedElement.width
  • HTMLIFrameElement.width
  • HTMLImageElement.width
  • HTMLObjectElement.width
  • HTMLSourceElement.width
  • HTMLVideoElement.width

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。