CanvasGradient: addColorStop() 方法

基线 广泛可用

此功能已非常成熟，并在许多设备和浏览器版本上运行。它自 2015 年 7 月.

报告反馈

注意：此功能在 Web Workers 中可用。

语法

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);

结果

规范

规范
HTML 标准
# dom-canvasgradient-addcolorstop-dev

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载

另请参见