CanvasRenderingContext2D: метод setLineDash()

Метод setLineDash() API холста 2D CanvasRenderingContext2D интерфейса устанавливает шаблон штриховки для линий. Он использует массив значений, которые определяют чередующиеся длины линий и пробелов, описывающих шаблон.

segments

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

None (undefined).

В этом примере используется метод setLineDash() для рисования пунктирной линии над сплошной.

HTML

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

JavaScript

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

// Dashed line
ctx.beginPath();
ctx.setLineDash([5, 15]);
ctx.moveTo(0, 50);
ctx.lineTo(300, 50);
ctx.stroke();

// Solid line
ctx.beginPath();
ctx.setLineDash([]);
ctx.moveTo(0, 100);
ctx.lineTo(300, 100);
ctx.stroke();

Результат

Этот пример демонстрирует различные распространённые шаблоны штриховки линий.

HTML

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

JavaScript

Функция drawDashedLine() созданная ниже, упрощает рисование нескольких пунктирных линий. Она принимает массив шаблона в качестве единственного параметра.

function drawDashedLine(pattern) {
  ctx.beginPath();
  ctx.setLineDash(pattern);
  ctx.moveTo(0, y);
  ctx.lineTo(300, y);
  ctx.stroke();
  y += 20;
}

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

drawDashedLine([]);
drawDashedLine([1, 1]);
drawDashedLine([10, 10]);
drawDashedLine([20, 5]);
drawDashedLine([15, 3, 3, 3]);
drawDashedLine([20, 3, 3, 3, 3, 3, 3, 3]);
drawDashedLine([12, 3, 3]); // Equals [12, 3, 3, 12, 3, 3]

Результат

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