CanvasGradient.addColorStop()

CanvasGradient.addColorStop() 方法添加一个由偏移值颜色值指定的断点到渐变。如果偏移值不在01之间,将抛出INDEX_SIZE_ERR错误,如果颜色值不能被解析为有效的 CSS 颜色值 <color>,将抛出SYNTAX_ERR错误。

语法

js
void gradient.addColorStop(offset, color);

参数

offset

01之间的值,超出范围将抛出INDEX_SIZE_ERR错误

color

CSS 颜色值 <color>。如果颜色值不能被解析为有效的 CSS 颜色值 <color>,将抛出SYNTAX_ERR错误。

示例

使用 addColorStop 方法

一个使用CanvasGradient对象的addColorStop 方法的简单例子

HTML

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

JavaScript

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

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

编辑以下代码可看到画布变化:

标准

Specification
HTML Standard
# dom-canvasgradient-addcolorstop-dev

浏览器兼容性

BCD tables only load in the browser

参见