CKTIS / JavaScript
Canvas 2D: contorno, riempimento, font e linea di base
Imposta lo spessore e lo stile del contorno, il riempimento, il font e il riferimento verticale del testo in un contesto Canvas 2D.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
const ctx = canvas.getContext("2d");
// After checking that ctx is not null:
ctx.lineWidth = 4;
ctx.strokeStyle = "#1d4ed8";
ctx.fillStyle = "#dbeafe";
ctx.font = "20px sans-serif";
ctx.textBaseline = "top";
// Read any of these properties with ctx.propertyName.lineWidth, strokeStyle, fillStyle, font e textBaseline sono proprietà del contesto restituito da canvas.getContext("2d"), non dell’elemento canvas stesso. Fanno parte delle API Web, non di ECMAScript. La disponibilità dipende dall’ambiente di esecuzione e getContext() può restituire null. Le assegnazioni cambiano lo stato per le operazioni di disegno successive, non i pixel già disegnati. save() salva lo stato e restore() lo ripristina senza annullare il disegno o le modifiche al tracciato corrente.
lineWidth determina lo spessore del contorno in unità del sistema di coordinate del canvas; una trasformazione di scala può cambiarne lo spessore visibile. Il contorno è centrato sul tracciato. Il valore iniziale è 1. Zero, i numeri negativi, Infinity, -Infinity e NaN vengono ignorati.
strokeStyle imposta lo stile dei contorni, per esempio con strokeRect() e strokeText(). fillStyle imposta lo stile del riempimento, per esempio con fillRect() e fillText(). Entrambe le proprietà accettano una stringa di colore CSS, un oggetto CanvasGradient o un oggetto CanvasPattern. Il valore iniziale di entrambe è il nero. Una stringa di colore non valida lascia invariato il valore precedente.
font accetta una stringa con la sintassi abbreviata della proprietà CSS font, ad esempio "bold 20px sans-serif". Il valore iniziale è "10px sans-serif". Le stringhe non valide vengono ignorate e line-height non ha effetto qui. Se il font non è disponibile o non è ancora caricato, il browser ne usa un altro; l’aspetto dei glifi può variare tra ambienti.
textBaseline sceglie il riferimento verticale che fillText() e strokeText() posizionano a y. "top", "middle" e "bottom" indicano il margine superiore, il centro e il margine inferiore del quadrato em del font, non i bordi dei glifi visibili. Le altre opzioni sono "hanging" (linea di base sospesa), "alphabetic" (linea di base alfabetica, predefinita) e "ideographic" (linea di base ideografica inferiore). Le altre stringhe vengono ignorate. L’allineamento orizzontale si controlla separatamente con textAlign.
Esempi
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Canvas 2D drawing styles</title>
</head>
<body>
<canvas id="demo" width="240" height="80"></canvas>
<script>
const canvas = document.getElementById("demo");
const ctx = canvas.getContext("2d");
if (!ctx) throw new Error("Canvas 2D is unavailable");
const readStyles = () => [
ctx.lineWidth, ctx.strokeStyle, ctx.fillStyle, ctx.font, ctx.textBaseline
].join(" | ");
ctx.save();
ctx.lineWidth = 4;
ctx.lineWidth = 0;
ctx.strokeStyle = "#1d4ed8";
ctx.fillStyle = "#dbeafe";
ctx.fillRect(10, 10, 220, 60);
ctx.strokeRect(10, 10, 220, 60);
ctx.fillStyle = "#172554";
ctx.font = "20px sans-serif";
ctx.textBaseline = "top";
ctx.fillText("Canvas 2D", 22, 20);
console.log(readStyles());
ctx.restore();
console.log(readStyles());
</script>
</body>
</html>Risultato
4 | #1d4ed8 | #172554 | 20px sans-serif | top 1 | #000000 | #000000 | 10px sans-serif | alphabetic
Salva l’esempio come file HTML, aprilo in un browser e controlla la console di sviluppo. La prima riga mostra i valori di cinque proprietà del contesto prima di `restore()`. Lo spessore resta `4` nonostante l’assegnazione di `0`. Tra le cinque proprietà mostrate, `strokeRect()` usa `lineWidth` e `strokeStyle` per il contorno del rettangolo, mentre `fillText()` usa `fillStyle`, `font` e `textBaseline`. La seconda riga mostra i valori iniziali ripristinati. Il rettangolo azzurro chiaro, il contorno blu e il testo scuro restano visibili.
Lezioni correlate
- JavaScript · Lezione 26 · Intermedio · Versione: 3