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

CanvasRenderingContext2D:lineDashOffset 属性

· 52CE 我爱测

Canvas 2D API 的 **`CanvasRenderingContext2D.lineDashOffset`** 属性用于设置虚线偏移量或者称为“相位”。

Canvas 2D API 的 CanvasRenderingContext2D.lineDashOffset 属性用于设置虚线偏移量或者称为“相位”。

[!NOTE] 要绘制线条,需调用 CanvasRenderingContext2D.stroke() 方法。

值

一个浮点数,指定线条虚线的偏移量。默认值为 0.0。

示例

偏移虚线

此示例绘制了两条虚线。第一条没有虚线偏移量。第二条虚线的偏移量为 4。

HTML

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

JavaScript

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

ctx.setLineDash([4, 16]);

// 无偏移量的虚线
ctx.beginPath();
ctx.moveTo(0, 50);
ctx.lineTo(300, 50);
ctx.stroke();

// 偏移量为 4 的虚线
ctx.beginPath();
ctx.strokeStyle = "red";
ctx.lineDashOffset = 4;
ctx.moveTo(0, 100);
ctx.lineTo(300, 100);
ctx.stroke();

结果

带有偏移的虚线用红色绘制。

偏移虚线

蚂蚁线

“蚂蚁线”效果是一种动画技巧,经常出现在计算机绘图程序的套索工具中。它能帮助用户根据图片背景动态变化的边界来区分选择的边界。

<canvas id="canvas"></canvas>
const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");
let offset = 0;

function draw() {
  ctx.clearRect(0, 0, canvas.width, canvas.height);
  ctx.setLineDash([4, 2]);
  ctx.lineDashOffset = offset;
  ctx.strokeRect(10, 10, 100, 100);
}

function march() {
  offset++;
  if (offset > 5) {
    offset = 0;
  }
  draw();
  setTimeout(march, 20);
}

march();

蚂蚁线

规范

浏览器兼容性

参见

  • 定义此属性的接口:CanvasRenderingContext2D
  • CanvasRenderingContext2D.getLineDash()
  • CanvasRenderingContext2D.setLineDash()
  • 应用样式和色彩

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

资料来源与适用范围

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

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

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