This page is Ready to Use

Notice: The WebPlatform project, supported by various stewards between 2012 and 2015, has been discontinued. This site is now available on github.

lineWidth

Summary

The current line width, in coordinate space units.

Property of apis/canvas/CanvasRenderingContext2Dapis/canvas/CanvasRenderingContext2D

Syntax

var result = CanvasRenderingContext2D.lineWidth;
CanvasRenderingContext2D.lineWidth = value;

Return Value

Returns an object of type NumberNumber

When setting, zero, negative, infinite, and NaN values are ignored. Default is 1.0.

Examples

The following example draws 10 lines in different widths

function draw() {
  var ctx = document.getElementById('canvas').getContext('2d');
  for (var i = 0; i < 10; i++){
    ctx.lineWidth = 1+i;
    ctx.beginPath();
    ctx.moveTo(5+i*14,5);
    ctx.lineTo(5+i*14,140);
    ctx.stroke();
  }
}

Related specifications

W3C HTML Canvas 2D Specification
W3C Candidate Recommendation

Attributions