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

CanvasRenderingContext2D:closePath() 方法

· 52CE 我爱测

Canvas 2D API 的 **`CanvasRenderingContext2D.closePath()`** 方法用于从当前点添加一条直线到当前子路径的起点。如果形状已经闭合或只有一个点,此函数将不执行任何操作。

Canvas 2D API 的 CanvasRenderingContext2D.closePath() 方法用于从当前点添加一条直线到当前子路径的起点。如果形状已经闭合或只有一个点,此函数将不执行任何操作。

该方法并不直接在画布上绘制任何内容。你可以使用 CanvasRenderingContext2D.stroke() 或 CanvasRenderingContext2D.fill() 方法来渲染路径。

语法

closePath()

参数

无。

返回值

无(undefined)。

示例

闭合三角形

这个例子使用 lineTo() 方法创建三角形的前两条(对角线)边。然后使用 closePath() 方法创建三角形的底边,该方法会自动连接形状的第一个点和最后一个点。

HTML

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

JavaScript

三角形的三个角分别位于 (20, 140)、(120, 10) 和 (220, 140)。

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

ctx.beginPath();
ctx.moveTo(20, 140); // 将笔移到左下角
ctx.lineTo(120, 10); // 连线到顶角
ctx.lineTo(220, 140); // 连线到右下角
ctx.closePath(); // 连线到左下角
ctx.stroke();

结果

闭合三角形

只闭合一个子路径

这个例子绘制了一个笑脸,由三个不相连的子路径组成。

HTML

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

JavaScript

前两个圆弧创建了脸部的眼睛,最后一个圆弧创建了嘴巴。

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

ctx.beginPath();
ctx.arc(240, 20, 40, 0, Math.PI);
ctx.moveTo(100, 20);
ctx.arc(60, 20, 40, 0, Math.PI);
ctx.moveTo(215, 80);
ctx.arc(150, 80, 65, 0, Math.PI);
ctx.closePath();
ctx.lineWidth = 6;
ctx.stroke();

结果

只闭合一个子路径

规范

浏览器兼容性

参见

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

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

资料来源与适用范围

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

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

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