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