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
x
- O valor da coordenada x para o ponto inicial do retângulo.
y
- O valor da coordenada y para o ponto inicial do retângulo.
width
- A largura do retângulo.
height
- A altura do retângulo.
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
Especificação | Estado | Comentário |
---|---|---|
HTML Living Standard The definition of 'CanvasRenderingContext2D.clearRect' in that specification. |
Padrão em tempo real |
Compatibilidade em Navegadores
Estamos convertendo nossos dados de compatibilidade para o formato JSON.
Esta tabela de compatibilidade ainda usa o formato antigo,
pois ainda não convertemos os dados que ela contém.
Descubra como você pode ajudar!
Característica | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Suporte básico | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Característica | Android | Chrome para Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|---|
Suporte básico | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Veja também
- A definição da interface
CanvasRenderingContext2D
CanvasRenderingContext2D.fillRect()
CanvasRenderingContext2D.strokeRect()