CanvasRenderingContext2D.clearRect()
El método CanvasRenderingContext2D.clearRect()
del API Canvas 2D convierte todos los pixeles en el rectangulo definido por el punto de inicio (x, y) y tamaño (width, height) a negro transparente, borrando cualquier contenido dibujado anteriormente.
Syntaxis
HTML Content
html
void ctx.clearRect(x, y, width, height);
Parametros
- x
-
El eje x de la coordenada para el punto de inicio del rectangulo.
- y
-
El eje y de la coordenada para el punto de inicio del rectangulo.
- width
-
El ancho del rectangulo.
- heigth
-
el alto del rectangulo.
Notas de uso
Un problema común con clearRect
es que puede parecer que no funciona cuando no se usan las trayectorias de dibujo (paths) de forma adecuada. No olvide llamar beginPath()
antes de comenzar a dibujar el nuevo cuadro después de llamar clearRect
.
Ejemplos
Usando el método clearRect
Este es un simple fragmento (snippet) de código que usa el método clearRect
.
HTML
html
<canvas id="canvas"></canvas>
JavaScript
js
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);
// clear the whole canvas
// ctx.clearRect(0, 0, canvas.width, canvas.height);
Edite el código de abajo y vea sus cambios actualizados en vivo en el canvas:
Especificaciones
Specification |
---|
HTML Standard # dom-context-2d-clearrect-dev |
Compatibilidad con navegadores
BCD tables only load in the browser
Vea También
- The interface defining it,
CanvasRenderingContext2D
CanvasRenderingContext2D.fillRect()
CanvasRenderingContext2D.strokeRect()
(en-US)