Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
CanvasRenderingContext2D.clearRect()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 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
void ctx.clearRect(x, y, largeur, hauteur);
Paramètres
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 :
Code jouable
<canvas id="canvas" width="400" height="200" class="playable-canvas"></canvas>
<div class="playable-buttons">
<input id="edit" type="button" value="Edit" />
<input id="reset" type="button" value="Reset" />
</div>
<textarea id="code" class="playable-code" style="height:140px;">
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);</textarea
>
var canvas = document.getElementById("canvas");
var ctx = canvas.getContext("2d");
var textarea = document.getElementById("code");
var reset = document.getElementById("reset");
var edit = document.getElementById("edit");
var code = textarea.value;
function drawCanvas() {
ctx.clearRect(0, 0, canvas.width, canvas.height);
eval(textarea.value);
}
reset.addEventListener("click", function () {
textarea.value = code;
drawCanvas();
});
edit.addEventListener("click", function () {
textarea.focus();
});
textarea.addEventListener("input", drawCanvas);
window.addEventListener("load", drawCanvas);
Spécifications
| Specification |
|---|
| HTML # dom-context-2d-clearrect-dev |
Compatibilité des navigateurs
Enable JavaScript to view this browser compatibility table.
Voir aussi
- L'interface la définissant,
CanvasRenderingContext2D CanvasRenderingContext2D.fillRect()CanvasRenderingContext2D.strokeRect()