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

CanvasRenderingContext2D:clearRect() 方法

· 52CE 我爱测

Canvas 2D API 的 **`CanvasRenderingContext2D.clearRect()`** 方法用于通过把像素设置为透明黑色以达到擦除一个矩形区域的目的。

Canvas 2D API 的 CanvasRenderingContext2D.clearRect() 方法用于通过把像素设置为透明黑色以达到擦除一个矩形区域的目的。

[!NOTE] 如果没有正确使用路径,clearRect() 可能会导致意想之外的结果。请确保在调用 clearRect() 之后开始绘制新内容前调用 CanvasRenderingContext2D.beginPath 。

语法

clearRect(x, y, width, height)

clearRect() 方法在一个矩形区域内将所有像素都设置成透明黑色(rgba(0,0,0,0))。矩形区域的左上角在 (x, y),其大小由 width 和height 指定。

参数

  • x
    • : 矩形起点的 x 轴坐标。
  • y
    • : 矩形起点的 y 轴坐标。
  • width
    • : 矩形的宽度。正值向右,负值向左。
  • height
    • : 矩形的高度。正值向下,负值向上。

返回值

无(undefined)。

示例

擦除整个画布

这段代码片段用于擦除整个画布。这通常在动画的每一帧开始时需要执行。清除的区域尺寸设置为与 <canvas> 元素的 width 和 height 属性相等。

const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");
ctx.clearRect(0, 0, canvas.width, canvas.height);

擦除一部分画布

此示例在黄色背景上绘制了一个蓝色三角形,然后使用 clearRect() 方法擦除了画布的部分内容。

HTML

<canvas id="canvas"></canvas>

JavaScript

被清除的区域是一个矩形,它的左上点坐标在 (10, 10)。清除区域的宽度为 120,高度为 100。

const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");

// 绘制黄色背景
ctx.beginPath();
ctx.fillStyle = "#ff6";
ctx.fillRect(0, 0, canvas.width, canvas.height);

// 绘制蓝色三角形
ctx.beginPath();
ctx.fillStyle = "blue";
ctx.moveTo(20, 20);
ctx.lineTo(180, 20);
ctx.lineTo(130, 130);
ctx.closePath();
ctx.fill();

// 清除一部分画布
ctx.clearRect(10, 10, 120, 100);

结果

擦除一部分画布

规范

浏览器兼容性

参见

  • 定义此方法的接口:CanvasRenderingContext2D
  • CanvasRenderingContext2D.fillRect()
  • CanvasRenderingContext2D.strokeRect()

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

资料来源与适用范围

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

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

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