CanvasRenderingContext2D.beginPath()

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

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

構文

void ctx.beginPath();

異なるパスの作成

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

HTML

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

JavaScript

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

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

関連情報