CanvasRenderingContext2D.createLinearGradient()

La méthode CanvasRenderingContext2D.createLinearGradient() de l'API Canvas 2D crée un gradient le long de la ligne donnée par les coordonnées représentées par les paramètres.

Cette méthode retourne un CanvasGradient linéaire.

NOTE : les coordonnées sont globales, aussi soyez conscient du fait que, lors de l'utilisation "fillRect" (et de ses amis), les coordonnées NE sont PAS relatives aux coordonnées spécifiées dans les arguments de "fillRect".

Syntaxe

CanvasGradient ctx.createLinearGradient(x0, y0, x1, y1);

Paramètres

x0
La coordonnée sur l'axe des x du point de début.
y0
La coordonnée sur l'axe des y du point de début.
x1
La coordonnée sur l'axe des x du point de fin.
y1
La coordonnée sur l'axe des y du point de fin.

Valeur retournée

CanvasGradient
Un CanvasGradient linéaire initialisé avec la ligne spécifiée.

Exemples

Utilisation de la méthode createLinearGradient

Ceci est seulement un simple fragment de code qui utilise la méthode createLinearGradient pour créer un CanvasGradient avec les points de début et de fin spécifiés. Une fois créé, vous pouvez utiliser la méthode CanvasGradient.addColorStop() pour définir de nouveaux arrêts sur le gradient, avec des déplacements et des couleurs spécifiés. Le gradient est appliqué si vous le mettez comme fillStyle courant, et il est dessiné sur le canevas lors de l'utilisation de la méthode fillRect(), par exemple.

HTML

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

JavaScript

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);

Modifiez le code ci-dessous et voyez vos changements mis à jour en temps réel sur le canevas :

Playable code
<canvas id="canvas" width="400" height="200" class="playable-canvas"></canvas>
<div class="playable-buttons">
  <input id="edit" type="button" value="Edit" />
  <input id="reset" type="button" value="Reset" />
</div>
<textarea id="code" class="playable-code">
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);</textarea>
var canvas = document.getElementById("canvas");
var ctx = canvas.getContext("2d");
var textarea = document.getElementById("code");
var reset = document.getElementById("reset");
var edit = document.getElementById("edit");
var code = textarea.value;

function drawCanvas() {
  ctx.clearRect(0, 0, canvas.width, canvas.height);
  eval(textarea.value);
}

reset.addEventListener("click", function() {
  textarea.value = code;
  drawCanvas();
});

edit.addEventListener("click", function() {
  textarea.focus();
})

textarea.addEventListener("input", drawCanvas);
window.addEventListener("load", drawCanvas);

Spécifications

Spécification Statut Commentaire
HTML Living Standard
La définition de 'CanvasRenderingContext2D.createLinearGradient' dans cette spécification.
Standard évolutif  

Compatibilité navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari pour iOSSamsung Internet
Support simpleChrome Support complet OuiEdge Support complet 12Firefox Support complet OuiIE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet OuiOpera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui

Légende

Support complet  
Support complet

Notes spécifiques à Gecko

  • A partir de Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1), le fait de spécifier des valeurs non finies  déclenche maintenant NOT_SUPPORTED_ERR au lieu de SYNTAX_ERR.

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : SphinxKnight, NemoNobobyPersonne
Dernière mise à jour par : SphinxKnight,