CanvasRenderingContext2D.getLineDash()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Метод CanvasRenderingContect2D.getLineDash(), предоставляемый Canvas 2D API который возвращает текущий паттерн штриховки линии.

Синтаксис

ctx.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]

// Нарисовать штрихованную линию
ctx.beginPath();
ctx.moveTo(0, 50);
ctx.lineTo(300, 50);
ctx.stroke();

Результат

Спецификации

Specification
HTML Standard
# dom-context-2d-getlinedash-dev

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также