clearRect 是 Canvas 2D API 中用于擦除指定矩形区域像素、使其完全透明的方法,参数为 x、y、width、height,清除范围自动截断不越界,不影响绘图状态和 CSS 背景。

clearRect 是 Canvas 2D 渲染上下文(CanvasRenderingContext2D)提供的方法,用于**擦除画布上指定矩形区域的内容,将其恢复为透明黑色(即完全透明)**。它不会影响其他区域,也不改变当前绘图状态(如颜色、线条宽度等)。
clearRect 的基本语法和参数
调用方式:
ctx.clearRect(x, y, width, height);四个参数含义:
- x:矩形左上角的横坐标(相对于 canvas 左上角,单位像素)
- y:矩形左上角的纵坐标
- width:矩形宽度(必须 ≥ 0)
- height:矩形高度(必须 ≥ 0)
清除指定区域的常见用法
比如你想只清除画布右下角一个 100×60 的区域:
ctx.clearRect(300, 200, 100, 60);注意:clearRect 清除的是「像素级」内容——包括之前用 fillRect、stroke、drawImage 等绘制的所有图形,但不会清除通过 CSS 设置的背景色(CSS 背景属于 canvas 元素样式,不在绘图层内)。
如果 canvas 本身设置了 background-color,清除后该区域会透出这个背景色(因为清空后是透明的)。
配合 save/restore 实现局部重绘更安全
清除区域后通常要重新绘制新内容。为避免影响全局状态,可结合 save() 和 restore():
ctx.clearRect(50, 50, 200, 100);
// 在此处绘制新图形
ctx.restore();
这样即使后续绘图修改了 fillStyle 或 globalAlpha,也不会干扰其他区域的绘制逻辑。
注意事项和易错点
- 清除区域超出 canvas 边界时,自动截断——只清除画布内部部分,不会报错
-
clearRect不受globalCompositeOperation影响(它总是执行“擦除”操作,等价于'destination-out') - 若 canvas 使用了
toDataURL()导出图片,被clearRect清除的区域在导出图中表现为透明(PNG 支持),而非白色 - 不要用
clearRect(0, 0, canvas.width, canvas.height)来“重置”画布——虽然可行,但频繁全清可能影响性能;动画中建议仅清需更新的局部
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











