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

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

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

JavaScript

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 :

Spécifications

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

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari pour iOSSamsung Internet
Support simpleChrome Support complet OuiEdge Support complet 12Firefox Support complet OuiIE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet OuiOpera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui

Légende

Support complet  
Support complet

Voir aussi

Étiquettes et contributeurs liés au document

Dernière mise à jour par : a-mt,