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

CKTIS / JavaScript

Canvas 2D : effacer une zone et dessiner un disque

Distinguez l’effacement des pixels de la réinitialisation du tracé. Créez un cercle avec `arc()`, puis remplissez-le avec `fill()` en réglant `fillStyle`.

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

Syntaxe

const ctx = canvas.getContext("2d"); // CanvasRenderingContext2D or null

ctx.clearRect(x, y, width, height);
ctx.beginPath();
ctx.arc(x, y, radius, startAngle, endAngle);
ctx.arc(x, y, radius, startAngle, endAngle, counterclockwise);
ctx.fillStyle = style; // CSS color string, CanvasGradient, or CanvasPattern
ctx.fill();
ctx.fill(fillRule);
ctx.fill(path);
ctx.fill(path, fillRule); // path: Path2D; fillRule: "nonzero" or "evenodd"

clearRect(), beginPath(), arc() et fill() sont des méthodes de CanvasRenderingContext2D ; fillStyle en est une propriété. Ces API relèvent de la plateforme web, pas d’ECMAScript 2024. Sur un élément canvas, appelez canvas.getContext("2d") et vérifiez que le résultat n’est pas null ; la disponibilité dépend de l’environnement d’exécution.

clearRect(x, y, width, height) remplace les pixels d’un rectangle par du noir transparent lorsque le contexte a un canal alpha actif. La transformation courante et la zone de découpage s’appliquent, mais la méthode n’utilise pas fillStyle et ne supprime pas le tracé. Pour effacer toute la surface avec clearRect(0, 0, canvas.width, canvas.height), utilisez la transformation identité et vérifiez que le découpage n’exclut aucune partie de la surface.

beginPath() vide le tracé courant sans changer les pixels ni le style. Appelez cette méthode avant de définir une forme indépendante pour éviter que le prochain fill() ne remplisse aussi une ancienne forme.

arc(x, y, radius, startAngle, endAngle, counterclockwise) ajoute un arc de centre (x, y) sans le peindre. Les angles sont mesurés en radians à partir de l’axe horizontal positif. Le sens par défaut est celui des aiguilles d’une montre ; true l’inverse dans le repère par défaut. Avec les angles 0 et 2 * Math.PI dans le sens par défaut, l’arc forme un cercle complet. Si le tracé a déjà un point final, arc() le relie au départ de l’arc par un segment. Si l’un des arguments numériques vaut NaN, Infinity ou -Infinity, arc() se termine sans modifier le tracé. Si tous les arguments numériques sont finis, un rayon négatif déclenche IndexSizeError.

La propriété fillStyle accepte une chaîne de couleur CSS, un CanvasGradient ou un CanvasPattern. Le noir est la valeur par défaut ; une chaîne de couleur invalide conserve le style précédent. Modifier la propriété ne recolore pas les pixels déjà peints.

fill() et fill(fillRule) remplissent le tracé courant avec le style courant. fill(path) et fill(path, fillRule) remplissent plutôt l’objet Path2D fourni. La règle par défaut "nonzero" vérifie que la somme des intersections d’une demi-droite avec le tracé, comptées avec un signe selon le sens de franchissement, est non nulle ; "evenodd" vérifie que leur nombre est impair. Le remplissage traite les sous-tracés ouverts comme s’ils étaient fermés, sans les modifier ni vider le tracé.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D pixel samples</title>
<pre id="output"></pre>
<script>
  const canvas = document.createElement("canvas");
  canvas.width = 48;
  canvas.height = 24;
  const ctx = canvas.getContext("2d");
  if (!ctx) throw new Error("Canvas 2D is unavailable");

  const rgba = (x, y) => ctx.getImageData(x, y, 1, 1).data.join(",");

  ctx.beginPath();
  ctx.arc(12, 12, 8, 0, 2 * Math.PI);
  ctx.fillStyle = "#ff0000";
  ctx.fill();
  const samples = [rgba(12, 12)];

  ctx.clearRect(0, 0, canvas.width, canvas.height);
  ctx.beginPath();
  ctx.arc(36, 12, 8, 0, 2 * Math.PI);
  ctx.fillStyle = "#0000ff";
  ctx.fill();
  samples.push(rgba(12, 12), rgba(36, 12));

  document.getElementById("output").textContent = samples.join("\n");
</script>

Résultat

255,0,0,255
0,0,0,0
0,0,255,255

Enregistrez l’exemple dans un fichier HTML et ouvrez-le dans un navigateur. Les trois échantillons RGBA affichés correspondent au centre rouge du premier disque, au pixel transparent à la même position après le nouveau dessin et au centre bleu du nouveau disque. Le canvas n’est pas ajouté à la page. `getImageData()` déclenche `SecurityError` si le canvas n’est plus `origin-clean`, par exemple après le dessin d’une image d’une autre origine sans autorisation CORS ; `clearRect()` seul ne rétablit pas cet état.

Leçons associées

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

Sources