CKTIS / JavaScript
HTMLCanvasElement: contesto di rendering e dimensioni della bitmap
Scegli il contesto con `getContext()` e imposta le dimensioni della bitmap con `width` e `height`. A differenza del dimensionamento con CSS, in modalità 2D l’assegnazione cancella la bitmap e azzera lo stato di disegno.
Versione: Current web platform; runtime support varies
Sintassi
canvas.getContext(contextId)
canvas.getContext(contextId, options)
canvas.width
canvas.height
canvas.width = bitmapWidth
canvas.height = bitmapHeightHTMLCanvasElement è un’interfaccia del browser definita da HTML, non da ECMAScript 2024. canvas.getContext(contextId, options) accetta un identificatore testuale e impostazioni facoltative specifiche della modalità. "2d" seleziona CanvasRenderingContext2D, "bitmaprenderer" seleziona ImageBitmapRenderingContext, "webgl" seleziona WebGLRenderingContext, "webgl2" seleziona WebGL2RenderingContext e "webgpu" seleziona GPUCanvasContext. La disponibilità di modalità e opzioni dipende dall’ambiente di esecuzione.
La prima chiamata riuscita fissa la modalità dell’elemento. Una chiamata successiva con lo stesso identificatore restituisce lo stesso oggetto senza applicare nuove impostazioni. Una modalità non supportata o non disponibile, oppure la richiesta di una modalità diversa, produce null. Dopo una chiamata riuscita a transferControlToOffscreen(), l’elemento funge da segnaposto: chiamare getContext() o assegnare width o height genera InvalidStateError.
canvas.width e canvas.height rispecchiano gli attributi HTML omonimi. Indicano larghezza e altezza della bitmap come numeri interi non negativi. Se un attributo manca o non può essere interpretato, si usa il rispettivo valore predefinito, 300 o 150. Modificare solo canvas.style.width o canvas.style.height cambia le dimensioni di visualizzazione, non la risoluzione della bitmap; il ridimensionamento visivo può sfocare l’immagine.
In modalità 2D, assegnare una delle dimensioni, anche con il valore corrente, cancella la bitmap e ripristina lo stato di disegno predefinito, inclusi il tracciato corrente, la trasformazione e gli stili, senza sostituire il contesto. Imposta le dimensioni prima di disegnare; dopo un ridimensionamento, ripristina lo stato necessario e ridisegna. Non dare per scontato lo stesso comportamento nelle altre modalità.
Disegnare un’immagine di un’altra origine senza l’autorizzazione CORS appropriata può far perdere alla bitmap lo stato origin-clean. In tal caso getImageData() genera SecurityError; ridimensionare la bitmap 2D ne elimina il contenuto senza rendere accessibili i pixel bloccati.
Esempi
<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D resize reset</title>
<script>
(() => {
const canvas = document.createElement("canvas");
console.log(`${canvas.width}x${canvas.height}`);
canvas.width = 4;
canvas.height = 3;
console.log(`${canvas.width}x${canvas.height}`);
const ctx = canvas.getContext("2d");
if (ctx === null) throw new Error("2D canvas context unavailable");
ctx.fillRect(0, 0, 1, 1);
ctx.globalAlpha = 0.5;
const alphaAtOrigin = () => ctx.getImageData(0, 0, 1, 1).data[3];
console.log(`${alphaAtOrigin()} ${ctx.globalAlpha}`);
canvas.width = canvas.width;
console.log(`${alphaAtOrigin()} ${ctx.globalAlpha}`);
console.log(canvas.getContext("2d") === ctx);
console.log(canvas.getContext("bitmaprenderer") === null);
})();
</script>Risultato
300x150 4x3 255 0.5 0 1 true true
Salva l’esempio come file HTML, aprilo in un browser e leggi i risultati nella console per sviluppatori. Le prime due righe mostrano le dimensioni. Riassegnare la stessa larghezza cambia l’alfa del pixel da `255` a `0` e riporta `globalAlpha` da `0.5` a `1`. I due risultati `true` mostrano che il contesto rimane lo stesso e che una modalità diversa viene rifiutata.
Lezioni correlate
- JavaScript · Lezione 12 · Avanzato · Versione: 4
- JavaScript · Lezione 33 · Avanzato · Versione: 4
- JavaScript · Lezione 34 · Avanzato · Versione: 4