CanvasRenderingContext2D: getLineDash() Methode

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.

Die getLineDash() Methode der Canvas 2D API's CanvasRenderingContext2D Schnittstelle erhält das aktuelle Strichmuster.

Syntax

js
getLineDash()

Parameter

Keine.

Rückgabewert

Ein Array von Zahlen, das die Abstände angibt, um abwechselnd eine Linie zu zeichnen und eine Lücke (in Koordinatenraumeinheiten). Wenn die Anzahl der Elemente ungerade ist, werden die Elemente des Arrays kopiert und verknüpft. Zum Beispiel führt das Festlegen des Strichmusters auf [5, 15, 25] dazu, dass man [5, 15, 25, 5, 15, 25] zurückbekommt.

Beispiele

Das aktuelle Strichmuster abfragen

Dieses Beispiel demonstriert die Nutzung der getLineDash() Methode.

HTML

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

JavaScript

Wie durch setLineDash() festgelegt, bestehen Striche aus Linien, die 10 Einheiten breit sind, mit Abständen von 20 Einheiten zwischen jeder Linie.

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

Ergebnis

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch