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.
O método CanvasRenderingContext2D.clearRect()
da API Canvas 2D limpa todos os pixels de um retângulo definido na posição (x, y) e tamanho (width (largura), height (altura)) para uma cor preta transparente, apagando algum conteúdo anterior.
Sintaxe
void ctx.clearRect(x, y, width, height);
Parâmetros
Notas de uso
Um problema comum com clearRect
que pode acontecer, é que pode não funcionar corretamente, caso não seja usada alguma propriedade de path. Não esqueça de usar beginPath()
antes de começar um novo frame depois de chamar clearRect
.
Exemplos
Usando o método clearRect
Isto é só um simples trecho de código que usa o método 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);
// clear the whole canvas
// ctx.clearRect(0, 0, canvas.width, canvas.height);
Edite o código abaixo e veja as alterações instantâneas no canvas:
Especificações
Specification |
---|
HTML Standard # dom-context-2d-clearrect-dev |
Compatibilidade com navegadores
BCD tables only load in the browser
Veja também
- A definição da interface
CanvasRenderingContext2D
CanvasRenderingContext2D.fillRect()
CanvasRenderingContext2D.strokeRect()