CKTIS / JavaScript
HTMLCanvasElement: contesto di disegno e dimensioni
HTMLCanvasElement fornisce una superficie di disegno nel browser. Scopri come usare getContext(), width e height. Con un contesto 2D, assegnare un valore a una delle due proprietà cancella il disegno e reimposta lo stato del contesto, anche se il valore non cambia.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
canvas.getContext(contextType, contextAttributes)
canvas.width = width;
canvas.height = height;HTMLCanvasElement rappresenta un elemento canvas del browser. L’elemento stesso contiene la superficie di disegno; un contesto fornisce le operazioni di disegno. È una Web API, non fa parte di ECMAScript. La presenza di Node 24 in un repository non dimostra la disponibilità di questa API.
Chiama HTMLCanvasElement.getContext su un’istanza come canvas.getContext("2d") per ottenere un CanvasRenderingContext2D. Un secondo argomento facoltativo specifica le impostazioni del contesto. Controlla il risultato: il metodo restituisce null se il tipo non è supportato, se l’elemento ha già un’altra modalità di contesto o se la creazione del contesto non riesce. Per esempio, anche se il tipo di contesto WebGL è supportato, una chiamata con l’opzione failIfMajorPerformanceCaveat attiva può restituire null, mentre un nuovo tentativo sullo stesso canvas con l’opzione disattivata può riuscire. Una volta creato il contesto, le chiamate successive sullo stesso canvas con lo stesso tipo di contesto restituiscono lo stesso oggetto. Dopo il trasferimento del controllo tramite transferControlToOffscreen(), il metodo genera InvalidStateError.
HTMLCanvasElement.width e HTMLCanvasElement.height riflettono gli attributi delle dimensioni e determinano la grandezza della superficie di disegno interna. I valori predefiniti sono rispettivamente 300 e 150. La dimensione di visualizzazione impostata tramite CSS è distinta: ridimensiona l’immagine e può renderla sfocata o distorta.
Con un contesto 2D, assegnare un valore a width o height cancella la superficie, elimina il tracciato corrente e ripristina i valori predefiniti delle impostazioni del contesto, tra cui fillStyle, anche quando si assegna il valore corrente. Imposta le dimensioni prima di configurare il contesto 2D e disegnare; dopo il ridimensionamento, ripristina lo stato e ridisegna. Ridimensionare il buffer di disegno di WebGL non reimposta lo stato del contesto WebGL. Una volta trasferito il controllo a un OffscreenCanvas tramite transferControlToOffscreen(), assegnare un valore a width o height sull’elemento originale genera InvalidStateError. L’API di base è ampiamente disponibile nei browser, ma il supporto per i singoli tipi di contesto e le opzioni varia.
Esempi
(() => {
const canvas = document.createElement("canvas");
console.log(canvas.width, canvas.height);
canvas.width = 4;
canvas.height = 2;
const ctx = canvas.getContext("2d");
if (ctx === null) {
throw new Error("2D context unavailable");
}
console.log(canvas.getContext("2d") === ctx);
ctx.fillStyle = "#ff0000";
ctx.fillRect(0, 0, canvas.width, canvas.height);
canvas.width = canvas.width;
console.log(canvas.width, canvas.height, ctx.fillStyle);
})();Risultato
300 150 true 4 2 #000000
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.