Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

HTMLCanvasElement: larghezza e altezza della bitmap

`canvas.width` e `canvas.height` impostano le dimensioni della bitmap, non quelle di visualizzazione in CSS. In 2D, anche riassegnare il valore corrente cancella il disegno e ripristina lo stato iniziale.

Versione: Current web platform; runtime support varies

Sintassi

canvas.width
canvas.height
canvas.width = widthInPixels;
canvas.height = heightInPixels;

canvas.width e canvas.height sono proprietà di lettura e scrittura di un elemento canvas. Riflettono gli attributi HTML omonimi e impostano la larghezza e l’altezza della bitmap in pixel. Negli attributi HTML usa numeri interi non negativi. Se un attributo manca o non può essere interpretato come tale, il valore predefinito è 300 per la larghezza o 150 per la altezza. Sono proprietà della piattaforma web, non di ECMAScript.

canvas.style.width e canvas.style.height impostano le dimensioni dell’elemento nel layout della pagina, non quelle della bitmap. Modificare soltanto il CSS lascia intatti i pixel e il disegno. L’immagine visualizzata può apparire sfocata se ingrandita o deformata se le proporzioni cambiano.

Con un contesto 2d, assegnare una delle due dimensioni della bitmap cancella il disegno e riporta lo stesso contesto allo stato predefinito, anche se assegni il valore corrente. Vengono ripristinati anche il tracciato corrente, la trasformazione e gli stili. Imposta le dimensioni prima di disegnare; se le cambi dopo, reimposta lo stato che ti serve e disegna di nuovo.

Non dare per scontato che WebGL o WebGPU si comportino come 2d. Dopo transferControlToOffscreen(), l’elemento funge da segnaposto: assegnare un valore a width o height genera InvalidStateError. Imposta invece le dimensioni sull’oggetto OffscreenCanvas.

Esempi

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

Risultato

Default: 300 × 150
After CSS: 4 × 2; pixel alpha 255; globalAlpha 0.5
After assignment: 4 × 2; pixel alpha 0; globalAlpha 1

Apri il file HTML nel browser e leggi l’output nella console. Il canvas non viene aggiunto alla pagina. La modifica del CSS lascia il pixel opaco (`255`); riassegnare la stessa larghezza lo cancella (`0`) e riporta `globalAlpha` a `1`.

Lezioni correlate

  • JavaScript · Lezione 26 · Intermedio · Versione: 3
  • JavaScript · Lezione 27 · Intermedio · Versione: 3

Fonti