CanvasRenderingContext2D:getLineDash() 方法

基线 广泛可用

此功能已得到良好建立,并在许多设备和浏览器版本中都能正常工作。它自以下时间起在各浏览器中均可用 2015 年 7 月.

Canvas 2D API 的 CanvasRenderingContext2D 接口的 getLineDash() 方法获取当前的线段虚线图案。

语法

js
getLineDash()

参数

无。

返回值

一个 Array,其中包含指定交替绘制线段和间隙的距离(以坐标空间单位为单位)的数字。如果在设置元素时数字为奇数,则数组的元素将被复制并连接。例如,将虚线设置为 [5, 15, 25] 将导致返回 [5, 15, 25, 5, 15, 25]

示例

获取当前虚线设置

此示例演示了 getLineDash() 方法。

HTML

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

JavaScript

setLineDash() 所设置,笔触由宽度为 10 个单位的线段组成,每条线段之间间隔 20 个单位。

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

ctx.setLineDash([10, 20]);
console.log(ctx.getLineDash()); // [10, 20]

// Draw a dashed line
ctx.beginPath();
ctx.moveTo(0, 50);
ctx.lineTo(300, 50);
ctx.stroke();

结果

规范

规范
HTML 标准
# dom-context-2d-getlinedash-dev

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅