CanvasRenderingContext2D.lineWidth

The CanvasRenderingContext2D.lineWidth 是 Canvas 2D API 设置线段厚度的属性（即线段的宽度）。

备注： 线可以通过stroke(), strokeRect(), 和strokeText() 方法绘制。

语法

ctx.lineWidth = value;

选项

value

描述线段宽度的数字。0、负数、 Infinity 和 NaN 会被忽略。

示例

改变线宽

此示例使用 15 个单位的线宽绘制直线和矩形。

HTML

html

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

JavaScript

js

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

ctx.lineWidth = 15;

ctx.beginPath();
ctx.moveTo(20, 20);
ctx.lineTo(130, 130);
ctx.rect(40, 40, 70, 70);
ctx.stroke();

结果

更多示例

有关此属性的更多示例和说明，请参阅在“画布教程”中的使用样式和颜色。

规范描述

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

浏览器兼容性

BCD tables only load in the browser

  • 在基于 WebKit- 和 Blink- 的浏览器中，除了此属性外，实现了一个不标准的并且不赞成使用的方法 ctx.setLineWidth() 。

Gecko-specific 注解

  • 从 Gecko 2.0 版本开始，设置lineWidth 为负数不再抛出异常，所有非正数值都会被忽略。

参见