The CanvasRenderingContext2D
.fillStyle
property of the Canvas 2D API specifies the color, gradient, or pattern to use inside shapes. The default style is #000
(black).
For more examples of fill and stroke styles, see Applying styles and color in the Canvas tutorial.
Syntax
ctx.fillStyle = color; ctx.fillStyle = gradient; ctx.fillStyle = pattern;
Options
color
- A
DOMString
parsed as CSS<color>
value. gradient
- A
CanvasGradient
object (a linear or radial gradient). pattern
- A
CanvasPattern
object (a repeating image).
Examples
Changing the fill color of a shape
This example applies a blue fill color to a rectangle.
HTML
<canvas id="canvas"></canvas>
JavaScript
const canvas = document.getElementById('canvas'); const ctx = canvas.getContext('2d'); ctx.fillStyle = 'blue'; ctx.fillRect(10, 10, 100, 100);
Result
Creating multiple fill colors using loops
In this example, we use two for
loops to draw a grid of rectangles, each having a different fill color. To achieve this, we use the two variables i
and j
to generate a unique RGB color for each square, and only modify the red and green values. (The blue channel has a fixed value.) By modifying the channels, you can generate all kinds of palettes.
<canvas id="canvas" width="150" height="150"></canvas>
const canvas = document.getElementById('canvas');
const ctx = canvas.getContext('2d');
for (let i = 0; i < 6; i++) {
for (let j = 0; j < 6; j++) {
ctx.fillStyle = `rgb(
${Math.floor(255 - 42.5 * i)},
${Math.floor(255 - 42.5 * j)},
0)`;
ctx.fillRect(j * 25, i * 25, 25, 25);
}
}
The result looks like this:
Screenshot | Live sample |
---|---|
[[File:../../../../../../media.prod.mdn.mozit.cloud/attachments/2013/06/24/5417/e352ec307d004a83b2df969b9f33539f/Canvas_fillstyle.png|class=internal]] |
Specifications
Specification | Status | Comment |
HTML Living StandardThe definition of 'CanvasRenderingContext2D.fillStyle' in that specification. | Living Standard |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
fillStyle
|
Chrome
Full support Yes |
Edge
Full support 12 |
Firefox
Full support 1.5 |
IE
Full support Yes |
Opera
Full support Yes |
Safari
Full support Yes |
WebView Android
Full support Yes |
Chrome Android
Full support Yes |
Firefox Android
Full support 4 |
Opera Android
Full support Yes |
Safari iOS
Full support Yes |
Samsung Internet Android
Full support Yes |
Legend
- Full support
- Full support
WebKit/Blink-specific note
In WebKit- and Blink-based browsers, the non-standard and deprecated method ctx.setFillColor()
is implemented in addition to this property.
setFillColor(color, optional alpha);
setFillColor(grayLevel, optional alpha);
setFillColor(r, g, b, a);
setFillColor(c, m, y, k, a);
See also
- Canvas API
- The interface defining this property:
CanvasRenderingContext2D
- Values used by this property:
<color>
CSS data typeCanvasGradient
objectCanvasPattern
object
CanvasRenderingContext2D.fillStyle by Mozilla Contributors is licensed under CC-BY-SA 2.5.