CanvasRenderingContext2D.beginPath()

CanvasRenderingContext2D.beginPath() はキャンバス 2D API のメソッドで、サブパスのリストを空にすることにより新しいパスを開始します。新しいパスを作成したい場合は、このメソッドを呼び出してください。

**メモ:**しいサブパス (つまり、現在のキャンバスの状態に一致するサブパス) を作成する場合、CanvasRenderingContext2D.moveTo()を使用できます。

構文

js

void ctx.beginPath();

例

異なるパスの作成

この例では、それぞれが 1 本の直線を含む 2 つのパスを作成します。

HTML

html

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

JavaScript

beginPath() メソッドがそれぞれの線を引く前に呼び出されるため、それぞれの線は別々な色で描かれます。

js

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

// 第 1 のパス
ctx.beginPath();
ctx.strokeStyle = "blue";
ctx.moveTo(20, 20);
ctx.lineTo(200, 20);
ctx.stroke();

// 第 2 のパス
ctx.beginPath();
ctx.strokeStyle = "green";
ctx.moveTo(20, 20);
ctx.lineTo(120, 120);
ctx.stroke();

結果

仕様書

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

ブラウザーの互換性

BCD tables only load in the browser

関連情報