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

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

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 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