CanvasRenderingContext2D.lineWidth

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

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

语法

ctx.lineWidth = value;

选项

value

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

示例

改变线宽

此示例使用 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 为负数不再抛出异常,所有非正数值都会被忽略。

参见