CanvasRenderingContext2D.getLineDash()

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

Синтаксис

ctx.getLineDash();

Возвращаемое значение

Array (массив) чисел которые обозначают расстояния рисования линий и разрывов (в еденицах пространства координат). Если число заданных элементов нечетное, то заданные элементы массива копируются и суммируются. Например, установив штрихи линии как [5, 15, 25] в результате мы получим [5, 15, 25, 5, 15, 25].

Примеры

Получение текущей настройки штриховки линии

Этот пример демонстрирует метод getLineDash().

HTML

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

JavaScript

Используя setLineDash() задано, что шрихи состоят из отрезков в 10 еденииц и разрывами между ними в 20 едениц.

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();

Результат

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

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

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

• Интерфейс, предоставляющий данный метод: CanvasRenderingContext2D
• CanvasRenderingContext2D.setLineDash()
• CanvasRenderingContext2D.lineDashOffset