Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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 units

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

Fontes