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() (en-US) задано, что штрихи состоят из отрезков в 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();

Результат

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

Спецификация Статус Комментарий
HTML Living Standard
Определение 'CanvasRenderingContext2D.getLineDash' в этой спецификации.
Живой стандарт

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

BCD tables only load in the browser

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