This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Note: This feature is available in Web Workers.
The CanvasGradient interface represents an opaque object describing a gradient. It is returned by the methods CanvasRenderingContext2D.createLinearGradient(), CanvasRenderingContext2D.createConicGradient() or CanvasRenderingContext2D.createRadialGradient().
It can be used as a fillStyle or strokeStyle.
As an opaque object, there is no exposed property.
CanvasGradient.addColorStop()Adds a new stop, defined by an offset and a color, to the gradient.
| Specification |
|---|
| HTML> # canvasgradient> |
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | WebView Android | WebView on iOS | |
CanvasGradient |
1 | 12 | 1.5Before Firefox 5.0, specifying non-finite values when adding color stops through a call toaddColorStop() incorrectly throws SYNTAX_ERR instead of INDEX_SIZE_ERR. |
9 | 2 | 18 | 4 | 10.1 | 1 | 1.0 | 4.4 | 1 |
addColorStop |
1 | 12 | 1.5 | 9 | 2 | 18 | 4 | 10.1 | 1 | 1.0 | 4.4 | 1 |
CanvasRenderingContext2D.<canvas> element and its associated interface, HTMLCanvasElement.
© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/CanvasGradient