CanvasRenderingContext2D: lineTo() method
The CanvasRenderingContext2D
method lineTo()
, part of the Canvas 2D API, adds a straight line to the current sub-path by connecting the sub-path's last point to the specified (x, y)
coordinates.
Like other methods that modify the current path, this method does not directly render anything. To draw the path onto a canvas, you can use the fill()
or stroke()
methods.
Syntax
Parameters
-
x
-
The x-axis coordinate of the line's end point.
-
y
-
The y-axis coordinate of the line's end point.
Return value
Examples
Drawing a straight line
This example draws a straight line using the lineTo()
method.
HTML
<canvas id="canvas"></canvas>
JavaScript
The line begins at (30, 50) and ends at (150, 100).
const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");
ctx.beginPath();
ctx.moveTo(30, 50);
ctx.lineTo(150, 100);
ctx.stroke();
Result
Drawing connected lines
Each call of lineTo()
(and similar methods) automatically adds to the current sub-path, which means that all the lines will all be stroked or filled together. This example draws a letter 'M' with a single contiguous line.
HTML
<canvas id="canvas"></canvas>
JavaScript
const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");
ctx.moveTo(90, 130);
ctx.lineTo(95, 25);
ctx.lineTo(150, 80);
ctx.lineTo(205, 25);
ctx.lineTo(210, 130);
ctx.lineWidth = 15;
ctx.stroke();
Result
Specifications
Browser compatibility
|
Desktop |
Mobile |
|
Chrome |
Edge |
Firefox |
Internet Explorer |
Opera |
Safari |
WebView Android |
Chrome Android |
Firefox for Android |
Opera Android |
Safari on IOS |
Samsung Internet |
lineTo |
1 |
12 |
1.5 |
9 |
11.6 |
2 |
4.4 |
18 |
4 |
12 |
1 |
1.0 |
See also