CanvasRenderingContext2D: beginPath()-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 Methode CanvasRenderingContext2D.beginPath() der Canvas 2D API startet einen neuen Pfad, indem die Liste der Unterpfade geleert wird. Rufen Sie diese Methode auf, wenn Sie einen neuen Pfad erstellen möchten.

Hinweis: Um einen neuen Unterpfad zu erstellen, der dem aktuellen Canvas-Zustand entspricht, können Sie CanvasRenderingContext2D.moveTo() verwenden.

Syntax

js
beginPath()

Parameter

Keine.

Rückgabewert

Kein Wert (undefined).

Beispiele

Erstellen von getrennten Pfaden

Dieses Beispiel erstellt zwei Pfade, die jeweils eine einzelne Linie enthalten.

HTML

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

JavaScript

Die Methode beginPath() wird vor Beginn jeder Linie aufgerufen, damit diese mit unterschiedlichen Farben gezeichnet werden können.

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

// First path
ctx.beginPath();
ctx.strokeStyle = "blue";
ctx.moveTo(20, 20);
ctx.lineTo(200, 20);
ctx.stroke();

// Second path
ctx.beginPath();
ctx.strokeStyle = "green";
ctx.moveTo(20, 20);
ctx.lineTo(120, 120);
ctx.stroke();

Ergebnis

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch