节点 | GM drawLine()函数

简介

GM.drawline()函数是由Greasemonkey脚本管理器提供的一个API，它可以在网页上绘制一条直线。这条直线可以是水平、竖直、斜线，也可以设置线条的颜色、宽度和透明度等属性。

用法

下面是GM.drawline()函数的语法和参数：

GM_drawLine(x1, y1, x2, y2[, color[, lineWidth[, lineCap[, alpha[, rotate]]]]])

参数说明

• x1：起点的x坐标。
• y1：起点的y坐标。
• x2：终点的x坐标。
• y2：终点的y坐标。
• color：线条颜色，支持字符串和RGBA格式的颜色值，默认为黑色。
• lineWidth：线条宽度，支持数值类型，单位为像素，默认为1。
• lineCap：线条端点样式，支持字符串类型，可选值为"butt"、"round"、"square"，默认为"butt"。
• alpha：线条透明度，支持数值类型，取值范围为0-1之间的浮点数，默认为1。
• rotate：线条旋转角度，支持数值类型，单位为角度，默认为0。

返回值

GM.drawline()函数不返回任何值。

示例

下面是一个简单的例子，通过GM.drawline()函数在网页上绘制一条红色的竖直直线：

// ==UserScript==
// @name         drawline demo
// @namespace    https://example.com/
// @version      1
// @description  draw a vertical red line on the webpage
// @match        https://*/*
// @match        http://*/*
// @grant        GM_drawLine
// ==/UserScript==

GM_drawLine(100, 0, 100, 500, "red", 1);

运行效果如下：

GM_drawLine(100, 0, 100, 500, "red", 1);

注意事项

1. GM.drawline()函数只能在通过Greasemonkey脚本管理器加载的网页上使用。
2. GM.drawline()函数的参数color和alpha支持的颜色格式不包括颜色名称，如"red"、"blue"等，只支持颜色的RGB或RGBA格式，如"rgb(255, 0, 0)"、"rgba(0, 0, 255, 0.5)"等。如果要使用颜色名称，可以使用CSS的颜色名称替换，如"red"可以使用"rgb(255, 0, 0)"代替。
3. GM.drawline()函数的参数rotate的取值范围为0-360之间的浮点数，如果超出此范围，则旋转角度不会生效。
4. GM.drawline()函数的线条宽度和透明度的取值范围取决于浏览器支持的最大值，所以在使用时要注意取值范围的限制。