Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Canvas 2D : contour, remplissage, police et ligne de base

Réglez l’épaisseur et le style du contour, le remplissage, la police et le repère vertical du texte dans un contexte Canvas 2D.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

const ctx = canvas.getContext("2d");
// After checking that ctx is not null:
ctx.lineWidth = 4;
ctx.strokeStyle = "#1d4ed8";
ctx.fillStyle = "#dbeafe";
ctx.font = "20px sans-serif";
ctx.textBaseline = "top";
// Read any of these properties with ctx.propertyName.

lineWidth, strokeStyle, fillStyle, font et textBaseline sont des propriétés du contexte renvoyé par canvas.getContext("2d"), et non de l’élément canvas lui-même. Elles relèvent des API Web, pas d’ECMAScript. Leur disponibilité dépend de l’environnement d’exécution et getContext() peut renvoyer null. Les affectations modifient l’état des prochains dessins, pas les pixels déjà tracés. save() enregistre cet état et restore() le rétablit sans annuler le dessin ni les modifications du tracé courant.

lineWidth règle l’épaisseur du contour en unités du système de coordonnées du canvas ; une mise à l’échelle peut modifier son épaisseur apparente. Le trait est centré sur le tracé. La valeur initiale est 1. Zéro, les nombres négatifs, Infinity, -Infinity et NaN sont ignorés.

strokeStyle règle le style des contours, par exemple avec strokeRect() et strokeText(). fillStyle règle celui des surfaces remplies, par exemple avec fillRect() et fillText(). Les deux acceptent une chaîne de couleur CSS, un objet CanvasGradient ou un objet CanvasPattern. Leur valeur initiale est le noir. Une chaîne de couleur invalide laisse la valeur précédente inchangée.

font attend une chaîne suivant la syntaxe abrégée CSS font, par exemple "bold 20px sans-serif". La valeur initiale est "10px sans-serif". Les chaînes invalides sont ignorées et line-height n’a pas d’effet ici. Si une police est indisponible ou pas encore chargée, le navigateur utilise une police de remplacement ; l’aspect des glyphes peut varier selon l’environnement.

textBaseline choisit le repère vertical que fillText() et strokeText() placent à la coordonnée y. "top", "middle" et "bottom" désignent le haut, le milieu et le bas du carré em de la police, et non les limites des glyphes visibles. Les autres options sont "hanging" (ligne de base suspendue), "alphabetic" (ligne de base alphabétique, par défaut) et "ideographic" (ligne de base idéographique inférieure). Les autres chaînes sont ignorées. L’alignement horizontal se règle séparément avec textAlign.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Canvas 2D drawing styles</title>
</head>
<body>
  <canvas id="demo" width="240" height="80"></canvas>
  <script>
    const canvas = document.getElementById("demo");
    const ctx = canvas.getContext("2d");
    if (!ctx) throw new Error("Canvas 2D is unavailable");

    const readStyles = () => [
      ctx.lineWidth, ctx.strokeStyle, ctx.fillStyle, ctx.font, ctx.textBaseline
    ].join(" | ");

    ctx.save();
    ctx.lineWidth = 4;
    ctx.lineWidth = 0;
    ctx.strokeStyle = "#1d4ed8";
    ctx.fillStyle = "#dbeafe";
    ctx.fillRect(10, 10, 220, 60);
    ctx.strokeRect(10, 10, 220, 60);

    ctx.fillStyle = "#172554";
    ctx.font = "20px sans-serif";
    ctx.textBaseline = "top";
    ctx.fillText("Canvas 2D", 22, 20);
    console.log(readStyles());

    ctx.restore();
    console.log(readStyles());
  </script>
</body>
</html>

Résultat

4 | #1d4ed8 | #172554 | 20px sans-serif | top
1 | #000000 | #000000 | 10px sans-serif | alphabetic

Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur et consultez la console de développement. La première ligne affiche les valeurs de cinq propriétés du contexte avant `restore()`. L’épaisseur reste à `4` malgré l’affectation de `0`. Parmi les cinq propriétés affichées, `strokeRect()` utilise `lineWidth` et `strokeStyle` pour le contour du rectangle, tandis que `fillText()` utilise `fillStyle`, `font` et `textBaseline`. La seconde ligne affiche les valeurs initiales rétablies. Le rectangle bleu clair, son contour bleu et le texte foncé restent visibles.

Leçons associées

  • JavaScript · Leçon 26 · Intermédiaire · Version : 3

Sources