CKTIS / JavaScript
HTMLCanvasElement: largura e altura do mapa de bits
`canvas.width` e `canvas.height` definem o tamanho do mapa de bits, não o tamanho de apresentação em CSS. Em 2D, até atribuir novamente o valor atual apaga o desenho e repõe o estado de desenho.
Versão: Current web platform; runtime support varies
Sintaxe
canvas.width
canvas.height
canvas.width = widthInPixels;
canvas.height = heightInPixels;canvas.width e canvas.height são propriedades de leitura e escrita de um elemento canvas. Refletem os atributos HTML com os mesmos nomes e definem a largura e a altura do mapa de bits em píxeis. Usa inteiros não negativos nos atributos HTML. Se um atributo estiver ausente ou não puder ser interpretado como tal, o valor predefinido é 300 para a largura ou 150 para a altura. Estas propriedades pertencem à plataforma Web, não ao ECMAScript.
canvas.style.width e canvas.style.height definem o tamanho do elemento na disposição da página, não as dimensões do mapa de bits. Alterar apenas o CSS mantém os píxeis e o desenho intactos. A imagem apresentada pode ficar desfocada ao ser ampliada ou deformada se for esticada para outras proporções.
Num contexto 2d, atribuir qualquer uma das dimensões do mapa de bits apaga o desenho e repõe o estado predefinido do mesmo contexto, mesmo quando atribuis o valor atual. Isto inclui o traçado atual, a transformação e os estilos. Define as dimensões antes de desenhar; se as mudares depois, volta a configurar o estado necessário e desenha novamente.
Não partas do princípio de que WebGL ou WebGPU se comportam como 2d. Depois de transferControlToOffscreen(), o elemento serve de ponto de apresentação: atribuir um valor a width ou height lança InvalidStateError. Define as dimensões no objeto OffscreenCanvas.
Exemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Canvas bitmap dimensions</title>
</head>
<body>
<script>
(() => {
const canvas = document.createElement('canvas');
console.log(`Default: ${canvas.width} × ${canvas.height}`);
canvas.width = 4;
canvas.height = 2;
const ctx = canvas.getContext('2d');
if (!ctx) throw new Error('Canvas 2D is unavailable.');
ctx.fillRect(0, 0, 1, 1);
ctx.globalAlpha = 0.5;
const pixelAlpha = () => ctx.getImageData(0, 0, 1, 1).data[3];
canvas.style.width = '40px';
canvas.style.height = '20px';
console.log(`After CSS: ${canvas.width} × ${canvas.height}; pixel alpha ${pixelAlpha()}; globalAlpha ${ctx.globalAlpha}`);
canvas.width = canvas.width;
console.log(`After assignment: ${canvas.width} × ${canvas.height}; pixel alpha ${pixelAlpha()}; globalAlpha ${ctx.globalAlpha}`);
})();
</script>
</body>
</html>Resultado
Default: 300 × 150 After CSS: 4 × 2; pixel alpha 255; globalAlpha 0.5 After assignment: 4 × 2; pixel alpha 0; globalAlpha 1
Abre o ficheiro HTML num navegador e consulta o resultado na consola. O canvas não é adicionado à página. A alteração do CSS deixa o píxel opaco (`255`); atribuir novamente a mesma largura apaga-o (`0`) e repõe `globalAlpha` em `1`.
Lições relacionadas
- JavaScript · Lição 26 · Intermédio · Versão: 3
- JavaScript · Lição 27 · Intermédio · Versão: 3