CKTIS / JavaScript
Canvas 2D: estilo de preenchimento, estilo do contorno e espessura da linha
`fillStyle` define o preenchimento, `strokeStyle` o aspeto do contorno e `lineWidth` a sua espessura. São três propriedades distintas do estado de desenho do Canvas 2D.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
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 são propriedades de instância de um contexto Canvas 2D, como ctx, obtido com canvas.getContext("2d"). Pertencem a uma API da plataforma Web, não ao ECMAScript, pelo que não estão disponíveis em todos os ambientes JavaScript. Uma atribuição, por si só, não desenha nada.
fillStyle define o preenchimento para fill(), fillRect() e fillText(). strokeStyle define o estilo do contorno para stroke(), strokeRect() e strokeText(). Ambos começam a preto e aceitam uma cadeia de caracteres que representa uma cor CSS, um CanvasGradient ou um CanvasPattern. Uma cadeia de cor inválida deixa o valor anterior inalterado. A leitura devolve a cor serializada (não necessariamente a cadeia original) ou o objeto atribuído. Alterações a esse objeto afetam as operações de desenho seguintes.
lineWidth indica a espessura total do traço em unidades do sistema de coordenadas, não necessariamente em píxeis do ecrã. O traço fica centrado sobre o caminho e uma mudança de escala do contexto pode alterar a sua espessura visível. O valor inicial é 1. Usa um número finito superior a zero: 0, números negativos, Infinity, -Infinity e NaN são ignorados.
Estas propriedades aplicam-se às operações de desenho seguintes até serem alteradas ou até o estado ser restaurado ou reposto. save() e restore() guardam e restauram o estado de desenho, mas não o caminho atual nem os píxeis. Atribuir um padrão obtido de uma imagem de outra origem sem autorização CORS pode bloquear a leitura dos píxeis: nesse caso, getImageData() lança SecurityError.
Exemplos
<!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>Resultado
width: 6 fill: 255, 0, 0, 255 stroke: 0, 0, 255, 255 outside: 0, 0, 0, 0
Guarda o exemplo como ficheiro HTML e abre-o num navegador. O código não insere o canvas na página: mostra na consola do navegador a espessura e os valores RGBA no interior do preenchimento, no contorno e fora do desenho. Atribuir `0` mantém a espessura em `6`.
Lições relacionadas
- JavaScript · Lição 12 · Avançado · Versão: 4