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

CanvasRenderingContext2D:strokeRect() 方法

· 52CE 我爱测

Canvas 2D API 的 **`CanvasRenderingContext2D.strokeRect()`** 方法根据当前的 CanvasRenderingContext2D.strokeStyle 和其它设置描绘一个矩形的描边(轮廓)。

Canvas 2D API 的 CanvasRenderingContext2D.strokeRect() 方法根据当前的 CanvasRenderingContext2D.strokeStyle 和其它设置描绘一个矩形的描边(轮廓)。

此方法直接绘制到画布而不修改当前路径,因此任何后续 CanvasRenderingContext2D.fill() 或 CanvasRenderingContext2D.stroke() 调用对它没有影响。

语法

strokeRect(x, y, width, height)

strokeRect() 方法绘制一个描边矩形,其起点为 (x, y),其大小由 width 和 height 指定。

参数

  • x
    • : 矩形起点的 x 轴坐标。
  • y
    • : 矩形起点的 y 轴坐标。
  • width
    • : 矩形的宽度。正值在右侧,负值在左侧。
  • height
    • : 矩形的高度。正值在下,负值在上。

返回值

无(undefined)。

示例

简单的描边矩形

此示例使用 strokeRect() 方法绘制了一个带有绿色轮廓的矩形。

HTML

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

JavaScript

矩形的左上角是(20,10)。它的宽度为 160,高度为 100。

const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");
ctx.strokeStyle = "green";
ctx.strokeRect(20, 10, 160, 100);

结果

一个简单的填充矩形

应用多种上下文设置

此示例绘制一个带有阴影和粗斜面轮廓的矩形。

HTML

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

JavaScript

const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");
ctx.shadowColor = "#d53";
ctx.shadowBlur = 20;
ctx.lineJoin = "bevel";
ctx.lineWidth = 15;
ctx.strokeStyle = "#38f";
ctx.strokeRect(30, 30, 160, 90);

结果

应用多种上下文设置

规范

浏览器兼容性

参见

  • 定义此方法的接口:CanvasRenderingContext2D
  • CanvasRenderingContext2D.strokeStyle
  • CanvasRenderingContext2D.clearRect()
  • CanvasRenderingContext2D.fillRect()

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

资料来源与适用范围

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

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

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