CanvasGradient 接口表示描述渐变的不透明对象。通过 CanvasRenderingContext2D.createLinearGradient() 或 CanvasRenderingContext2D.createRadialGradient() 的返回值得到.
属性
不透明对象,没有暴露的属性.
方法
没有继承的方法
CanvasGradient.addColorStop()- 添加一个由
偏移(offset)和颜色(color)定义的断点到渐变中。如果偏移值不在0到1之间,将抛出INDEX_SIZE_ERR错误,如果颜色值不能被解析为有效的CSS颜色值<color>,将抛出SYNTAX_ERR错误。
标准
| 标准 | 状态 | 备注 |
|---|---|---|
| WHATWG HTML Living Standard CanvasGradient |
Living Standard | 同 Candidate Recommendation |
| HTML Canvas 2D Context (W3C) CanvasGradient |
Candidate Recommendation | 初始定义 |
浏览器兼容性
| 功能 | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| 基本支持 | 4.0 | Unknown (3.6) [1] | 9.0 | 9.0 | 3.1 |
| 功能 | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| 基本支持 | 2.1 | 3.0 (3.6) [1] | ? | 10.0 | 3.2 |
[1] 在Gecko 5.0 (Firefox 5.0 / Thunderbird 5.0 / SeaMonkey 2.2) 以前,通过调用addColorStop()添加颜色断点时给定非有限的值,会错误的抛出 SYNTAX_ERR 而不是INDEX_SIZE_ERR。
请参考
- 创建方法在
CanvasRenderingContext2D. <canvas>元素及其有关接口HTMLCanvasElement.