CKTIS / JavaScript
Canvas 2D: stile di riempimento, stile del contorno e spessore della linea
`fillStyle` controlla il riempimento, `strokeStyle` l’aspetto del contorno e `lineWidth` il suo spessore. Sono tre proprietà distinte dello stato di disegno di Canvas 2D.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
ctx.fillStyle = paint;
ctx.strokeStyle = paint;
ctx.lineWidth = width;
// paint: CSS color string, CanvasGradient, or CanvasPattern
// width: finite number greater than 0, in canvas coordinate-space unitsfillStyle, strokeStyle e lineWidth sono proprietà di un’istanza del contesto Canvas 2D, ad esempio ctx ottenuto da canvas.getContext("2d"). Appartengono a un’API della piattaforma web, non a ECMAScript, quindi non sono disponibili in tutti gli ambienti JavaScript. Una semplice assegnazione non disegna nulla.
fillStyle definisce il riempimento per fill(), fillRect() e fillText(). strokeStyle definisce lo stile del contorno per stroke(), strokeRect() e strokeText(). Entrambi partono dal nero e accettano una stringa di colore CSS, un CanvasGradient o un CanvasPattern. Una stringa di colore non valida lascia invariato il valore precedente. La lettura restituisce il colore serializzato (non necessariamente la stringa originale) oppure l’oggetto assegnato. Le modifiche a quell’oggetto influiscono sulle operazioni di disegno successive.
lineWidth indica lo spessore totale del tratto in unità del sistema di coordinate, non necessariamente in pixel dello schermo. Il tratto è centrato sul tracciato e una trasformazione di scala del contesto può cambiarne lo spessore visibile. Il valore iniziale è 1. Usa un numero finito maggiore di zero: 0, i numeri negativi, Infinity, -Infinity e NaN vengono ignorati.
Queste proprietà si applicano al disegno successivo finché non cambiano o finché lo stato non viene ripristinato o reimpostato. save() e restore() salvano e ripristinano lo stato di disegno, non il tracciato corrente né i pixel. Assegnare un motivo ricavato da un’immagine di un’altra origine senza autorizzazione CORS può bloccare la lettura dei pixel: in quel caso getImageData() genera SecurityError.
Esempi
<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D fill and stroke</title>
<script>
(() => {
const canvas = document.createElement("canvas");
canvas.width = canvas.height = 32;
const ctx = canvas.getContext("2d");
if (!ctx) throw new Error("Canvas 2D is unavailable");
ctx.fillStyle = "#ff0000";
ctx.strokeStyle = "#0000ff";
ctx.lineWidth = 6;
ctx.lineWidth = 0;
ctx.fillRect(8, 8, 16, 16);
ctx.strokeRect(8, 8, 16, 16);
const rgba = (x, y) => ctx.getImageData(x, y, 1, 1).data.join(", ");
console.log(`width: ${ctx.lineWidth}`);
console.log(`fill: ${rgba(16, 16)}`);
console.log(`stroke: ${rgba(6, 16)}`);
console.log(`outside: ${rgba(2, 16)}`);
})();
</script>Risultato
width: 6 fill: 255, 0, 0, 255 stroke: 0, 0, 255, 255 outside: 0, 0, 0, 0
Salva l’esempio come file HTML e aprilo in un browser. Il codice non aggiunge il canvas alla pagina: stampa nella console del browser lo spessore e i valori RGBA all’interno del riempimento, sul contorno e fuori dal disegno. Assegnare `0` lascia lo spessore a `6`.
Lezioni correlate
- JavaScript · Lezione 12 · Avanzato · Versione: 4