CanvasRenderingContext2D.clearRect()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

La méthode CanvasRenderingContext2D.clearRect() de l'API 2D des Canvas met en noir transparent tous les pixels dans le rectangle défini par le point de départ de coordonnées (x, y) et par les tailles (largeur, hauteur), supprimant tout contenu précédemment dessiné.

Syntaxe

js
void ctx.clearRect(x, y, largeur, hauteur);

Paramètres

x

La coordonnée sur l'axe des x du point de départ du rectangle.

y

La coordonnée sur l'axe des y du point de départ du rectangle.

largeur

La largeur du rectangle.

hauteur

La hauteur de rectangle.

Notes d'utilisation

Un problème classique avec clearRect est qu'il peut apparaître comme ne fonctionnant pas si l'on n'utilise pas les trajets de façon appropriée. N'oubliez pas d'appeler beginPath() avant de commencer à dessiner une nouvelle image après avoir appelé clearRect.

Exemples

Utilisation de la méthode clearRect

Ceci est seulement un fragment de code simple qui utilise la méthode clearRect.

HTML

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

JavaScript

js
var canevas = document.getElementById("canvas");
var ctx = canevas.getContext("2d");

ctx.beginPath();
ctx.moveTo(20, 20);
ctx.lineTo(200, 20);
ctx.lineTo(120, 120);
ctx.closePath(); // dessine la dernière ligne du triangle
ctx.stroke();

ctx.clearRect(10, 10, 100, 100);

// effacer le canevas entièrement
// ctx.clearRect(0, 0, canvas.width, canvas.height);

Modifiez le code suivant et voyez vos changements en direct dans le canevas :

Code jouable

Spécifications

Specification
HTML Standard
# dom-context-2d-clearrect-dev

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi