Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes