Método createLinearGradient() do Canvas

Definição e uso

createLinearGradient() O método cria um objeto de gradiente linear.

A gradiente pode ser usada para preencher retângulos, círculos, linhas, texto e muito mais.

Dica:Use esse objeto como strokeStyle ou fillStyle valor da propriedade.

Dica:Use addColorStop() O método especifica diferentes cores e onde localizar essas cores no objeto gradient.

Exemplo

Veja também:

Defina uma gradiente de preto para branco (de esquerda para direita) como estilo de preenchimento do retângulo:

Seu navegador não suporta a tag canvas do HTML5.

JavaScript:

var c=document.getElementById("myCanvas");
var ctx=c.getContext("2d");
var grd=ctx.createLinearGradient(0,0,170,0);
grd.addColorStop(0,"black");
grd.addColorStop(1,"white");
ctx.fillStyle=grd;
ctx.fillRect(20,20,150,100);

Experimente pessoalmente

Sintaxe

context.createLinearGradient(x0,y0,x1,y1);

Valor do parâmetro

Parâmetro Descrição
x0 Coordenada x do ponto inicial da gradiente.
y0 Coordenada y do ponto inicial da gradiente.
x1 Coordenada x do ponto final da gradiente.
y1 Coordenada y do ponto final da gradiente.

Mais exemplos

Exemplo 2

Defina um gradiente (de cima para baixo) como estilo de preenchimento do retângulo:

Seu navegador não suporta a tag canvas.

JavaScript:

var c=document.getElementById("myCanvas");
var ctx=c.getContext("2d");
var my_gradient=ctx.createLinearGradient(0,0,0,170);
my_gradient.addColorStop(0,"black");
my_gradient.addColorStop(1,"white");
ctx.fillStyle=my_gradient;
ctx.fillRect(20,20,150,100);

Experimente pessoalmente

Exemplo 3

Defina uma gradiente de preto para vermelho e branco, como estilo de preenchimento do retângulo:

Seu navegador não suporta a tag canvas.

JavaScript:

var c=document.getElementById("myCanvas");
var ctx=c.getContext("2d");
var my_gradient=ctx.createLinearGradient(0,0,170,0);
my_gradient.addColorStop(0,"black");
my_gradient.addColorStop(0.5,"red");
my_gradient.addColorStop(1,"white");
ctx.fillStyle=my_gradient;
ctx.fillRect(20,20,150,100);

Experimente pessoalmente

Suporte do navegador

Os números na tabela indicam a versão do navegador que suporta completamente essa propriedade.

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
4.0 9.0 3.6 4.0 10.1

Notas:Os navegadores Internet Explorer 8 e anteriores não suportam o elemento <canvas>.