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

CanvasRenderingContext2D:stroke() 方法

· 52CE 我爱测

Canvas 2D API 的 **`CanvasRenderingContext2D.stroke()`** 方法用于根据当前的描边样式,绘制当前或指定的路径。

Canvas 2D API 的 CanvasRenderingContext2D.stroke() 方法用于根据当前的描边样式,绘制当前或指定的路径。

描边与路径的中心对齐,也就是说,描边的一半位于路径的内侧,另一半位于外侧。

描边使用非零环绕规则进行绘制,这意味着路径交叉点仍会被填充。

语法

stroke()
stroke(path)

参数

  • path
    • : 要描边的 Path2D 路径。

返回值

无(undefined)。

示例

简单的矩形轮廓线

此示例使用 rect() 方法创建一个矩形,然后使用 stroke() 方法将其绘制到画布上。

HTML

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

JavaScript

const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");
ctx.rect(10, 10, 150, 100);
ctx.stroke();

结果

简单的矩形轮廓线

重新对路径进行描边

通常情况下,每当你想要描边新的内容时,应调用 CanvasRenderingContext2D.beginPath() 方法。如果不这样做,之前的子路径将保留在当前路径中,并且每次调用 stroke() 方法时都会被描边。然而,在某些情况下,这可能是期望的效果。

HTML

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

JavaScript

以下代码分别对第一个子路径描边三次,第二个子路径描边两次,第三个子路径描边一次。

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

// 第一个子路径
ctx.lineWidth = 26;
ctx.strokeStyle = "orange";
ctx.moveTo(20, 20);
ctx.lineTo(160, 20);
ctx.stroke();

// 第二个子路径
ctx.lineWidth = 14;
ctx.strokeStyle = "green";
ctx.moveTo(20, 80);
ctx.lineTo(220, 80);
ctx.stroke();

// 第三个子路径
ctx.lineWidth = 4;
ctx.strokeStyle = "pink";
ctx.moveTo(20, 140);
ctx.lineTo(280, 140);
ctx.stroke();

结果

重新对路径进行描边

描边和填充

如果你想要同时描边和填充一个路径,执行这些操作的顺序将决定最终的结果。在这个示例中,左侧的正方形先填充后描边,右侧的正方形先描边后填充。

HTML

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

JavaScript

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

ctx.lineWidth = 16;
ctx.strokeStyle = "red";

// 先填充后描边
ctx.beginPath();
ctx.rect(25, 25, 100, 100);
ctx.fill();
ctx.stroke();

// 先描边后填充
ctx.beginPath();
ctx.rect(175, 25, 100, 100);
ctx.stroke();
ctx.fill();

结果

描边和填充

规范

浏览器兼容性

参见

  • 定义此方法的接口:CanvasRenderingContext2D

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

资料来源与适用范围

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

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

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