CanvasRenderingContext2D:save() 方法
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.
Canvas 2D API 的 CanvasRenderingContext2D.save()
方法用于通过将当前状态放入栈中,以保存 canvas 的完整状态。
绘制状态
保存到栈中的绘制状态有下面部分组成:
- 当前的变换矩阵。
- 当前的剪切区域。
- 当前的虚线列表。
- 以下属性当前的值:
strokeStyle
、fillStyle
、globalAlpha
、lineWidth
、lineCap
、lineJoin
、miterLimit
、lineDashOffset
、shadowOffsetX
、shadowOffsetY
、shadowBlur
、shadowColor
、globalCompositeOperation
、font
、textAlign
、textBaseline
、direction
、imageSmoothingEnabled
。
语法
js
save()
参数
无。
返回值
无(undefined
)。
示例
保存绘图状态
这个示例使用 save()
方法保存当前状态,并在稍后使用 restore()
方法恢复它,这样你就能够使用当前状态绘制矩形。
HTML
html
<canvas id="canvas"></canvas>
JavaScript
js
const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");
// 保存当前状态
ctx.save();
ctx.fillStyle = "green";
ctx.fillRect(10, 10, 100, 100);
// 恢复到最近一次调用 save() 时保存的状态
ctx.restore();
ctx.fillRect(150, 40, 100, 100);
结果
规范
Specification |
---|
HTML Standard # dom-context-2d-save-dev |
浏览器兼容性
BCD tables only load in the browser