CanvasGradient：addColorStop() 方法

备注： 此特性在 Web Worker 中可用。

CanvasGradient.addColorStop() 方法为给定的 canvas 渐变添加一个由偏移值（offset）和颜色值（color）指定的色标。

语法

js
addColorStop(offset, color)

参数

offset

一个在 0 到 1 之间（包含边界）的数字，表示色标的位置。0 表示渐变的起始位置，1 表示渐变的结束位置。

color

一个 CSS <color> 值，表示色标的颜色。

返回值

无（undefined）。

异常

IndexSizeError DOMException

如果 offset 不在 0 和 1 之间（包括边界），则抛出此异常。

SyntaxError DOMException

如果 color 无法解析为 CSS <color> 值，则抛出此异常。

示例

向渐变中添加色标

此示例使用 addColorStop 方法向线性 CanvasGradient 对象中添加色标。然后使用该渐变填充矩形。

HTML

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

JavaScript

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

let gradient = ctx.createLinearGradient(0, 0, 200, 0);
gradient.addColorStop(0, "green");
gradient.addColorStop(0.7, "white");
gradient.addColorStop(1, "pink");
ctx.fillStyle = gradient;
ctx.fillRect(10, 10, 200, 100);

结果

规范

Specification
HTML Standard
# dom-canvasgradient-addcolorstop-dev

浏览器兼容性

BCD tables only load in the browser

参见