CKTIS / JavaScript
Canvas 2D : style de remplissage, style de contour et épaisseur du trait
`fillStyle` définit le remplissage, `strokeStyle` l’aspect du contour et `lineWidth` son épaisseur. Ces trois propriétés distinctes font partie de l’état de dessin de Canvas 2D.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
ctx.fillStyle = paint;
ctx.strokeStyle = paint;
ctx.lineWidth = width;
// paint: CSS color string, CanvasGradient, or CanvasPattern
// width: finite number greater than 0, in canvas coordinate-space unitsfillStyle, strokeStyle et lineWidth sont des propriétés d’instance d’un contexte Canvas 2D, par exemple ctx obtenu avec canvas.getContext("2d"). Elles relèvent d’une API de la plateforme web, pas d’ECMAScript, et ne sont donc pas disponibles dans tous les environnements JavaScript. Une affectation ne dessine rien à elle seule.
fillStyle définit le remplissage utilisé par fill(), fillRect() et fillText(). strokeStyle définit le style du trait utilisé par stroke(), strokeRect() et strokeText(). Les deux styles sont noirs au départ et acceptent une chaîne de couleur CSS, un CanvasGradient ou un CanvasPattern. Une chaîne de couleur non valide laisse la valeur précédente intacte. La lecture renvoie la couleur sérialisée (pas nécessairement la chaîne d’origine) ou l’objet affecté. Les modifications de cet objet affectent les dessins suivants.
lineWidth fixe l’épaisseur totale du trait en unités du système de coordonnées, pas nécessairement en pixels d’écran. Le trait est centré sur le tracé et une mise à l’échelle du contexte peut modifier son épaisseur visible. La valeur initiale est 1. Utilisez un nombre fini strictement positif : 0, les nombres négatifs, Infinity, -Infinity et NaN sont ignorés.
Ces propriétés s’appliquent aux dessins suivants tant qu’elles ne changent pas ou que l’état n’est pas restauré ou réinitialisé. save() et restore() sauvegardent et restaurent l’état de dessin, mais pas le tracé courant ni les pixels. Affecter un motif issu d’une image d’une autre origine sans autorisation CORS peut bloquer la lecture des pixels : getImageData() lève alors SecurityError.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D fill and stroke</title>
<script>
(() => {
const canvas = document.createElement("canvas");
canvas.width = canvas.height = 32;
const ctx = canvas.getContext("2d");
if (!ctx) throw new Error("Canvas 2D is unavailable");
ctx.fillStyle = "#ff0000";
ctx.strokeStyle = "#0000ff";
ctx.lineWidth = 6;
ctx.lineWidth = 0;
ctx.fillRect(8, 8, 16, 16);
ctx.strokeRect(8, 8, 16, 16);
const rgba = (x, y) => ctx.getImageData(x, y, 1, 1).data.join(", ");
console.log(`width: ${ctx.lineWidth}`);
console.log(`fill: ${rgba(16, 16)}`);
console.log(`stroke: ${rgba(6, 16)}`);
console.log(`outside: ${rgba(2, 16)}`);
})();
</script>Résultat
width: 6 fill: 255, 0, 0, 255 stroke: 0, 0, 255, 255 outside: 0, 0, 0, 0
Enregistrez l’exemple dans un fichier HTML et ouvrez-le dans un navigateur. Le code n’ajoute pas le canvas à la page : il affiche dans la console du navigateur l’épaisseur et les valeurs RGBA dans le remplissage, sur le contour et hors du dessin. L’affectation de `0` laisse l’épaisseur à `6`.
Leçons associées
- JavaScript · Leçon 12 · Avancé · Version : 4