Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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 units

fillStyle, 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

Fonti