CanvasRenderingContext2D.clearRect()

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

Syntaxe

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

Paramètres

x
L'ordonnée x des coordonnées du point de départ du rectangle.
y
L'abscisse y des coordonnées du point de départ du rectangle.
largeur
La largeur du rectangle.
hauteur
La hauteur de rectangle.

Notes d'usage

Un problème récurrent avec clearRect est qu'il ne fonctionne pas si l'on n'utilise pas les méthodes de dessin. N'oubliez pas d'appeler beginPath() avant de débuter un dessin après avoir appellé clearRect.

Exemples

Utilisation de la méthode clearRect

Ceci est juste un extrait de code qui utilise la méthode clearRect.

HTML

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

JavaScript

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

ctx.beginPath();
ctx.moveTo(20,20);
ctx.lineTo(200,20);
ctx.lineTo(120,120);
ctx.closePath(); // draws last line of the triangle
ctx.stroke();

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

// nettoyer la canvas entièrement :
// ctx.clearRect(0, 0, canvas.width, canvas.height);

Éditez le code suivant pour voir les changements en direct dans la balise canvas: 

Spécifications

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

Compatibilité des navigateurs

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Oui) (Oui) (Oui) (Oui) (Oui)
Feature Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Oui) (Oui) (Oui) (Oui) (Oui) (Oui)

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : Hell_Carlito, JNa0
 Dernière mise à jour par : Hell_Carlito,