CanvasRenderingContext2D .closePath() method of the Canvas 2D API attempts to add a straight line from the current point to the start of the current sub-path. If the shape has already been closed or has only one point, this function does nothing.

This method doesn't draw anything to the canvas directly. You can render the path using the stroke() or fill() 方法。

句法

void ctx.closePath();
					

范例

Closing a triangle

This example creates the first two (diagonal) sides of a triangle using the lineTo() method. After that, the triangle's base is created with the closePath() method, which automatically connects the shape's first and last points.

HTML

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

JavaScript

The triangle's corners are at (20, 150), (120, 20), and (220, 150).

const canvas = document.getElementById('canvas');
const ctx = canvas.getContext('2d');
ctx.beginPath();
ctx.moveTo(20, 140);   // Move pen to bottom-left corner
ctx.lineTo(120, 10);   // Line to top corner
ctx.lineTo(220, 140);  // Line to bottom-right corner
ctx.closePath();       // Line to bottom-left corner
ctx.stroke();
					

结果

Closing just one sub-path

This example draws a smiley face consisting of three disconnected sub-paths.

Note: Although closePath() is called after all the arcs have been created, only the last arc (sub-path) gets closed.

HTML

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

JavaScript

The first two arcs create the face's eyes. The last arc creates the mouth.

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();
					

结果

规范

规范 状态 注释
HTML 实时标准
The definition of 'CanvasRenderingContext2D.closePath' in that specification.
实时标准

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据
桌面 移动
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
closePath Chrome 1 Edge 12 Firefox 1.5 IE 9 Opera 11.6 Safari 2 WebView Android 1 Chrome Android 18 Firefox Android 4 Opera Android 12 Safari iOS 1 Samsung Internet Android 1.0

图例

完整支持

完整支持

另请参阅

元数据

  • 最后修改: