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

CKTIS / JavaScript

Canvas 2D: contorno, preenchimento, tipo de letra e linha de base

Define a espessura e o estilo do contorno, o preenchimento, o tipo de letra e a referência vertical do texto num contexto Canvas 2D.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

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 são propriedades do contexto devolvido por canvas.getContext("2d"), não do próprio elemento canvas. Fazem parte das APIs Web, não de ECMAScript. A sua disponibilidade depende do ambiente de execução, e getContext() pode devolver null. As atribuições alteram o estado para as operações de desenho seguintes, não os píxeis já desenhados. save() guarda o estado e restore() repõe-no sem desfazer o desenho nem as alterações ao caminho atual.

lineWidth define a espessura do contorno em unidades do sistema de coordenadas do canvas. Uma transformação de escala pode alterar a espessura visível. O traço fica centrado sobre o caminho. O valor inicial é 1. Zero, números negativos, Infinity, -Infinity e NaN são ignorados.

strokeStyle define o estilo dos contornos, por exemplo com strokeRect() e strokeText(). fillStyle define o estilo das áreas preenchidas, por exemplo com fillRect() e fillText(). Ambas as propriedades aceitam uma cadeia de cor CSS, um objeto CanvasGradient ou um objeto CanvasPattern. O valor inicial de ambas é preto. Uma cadeia de cor inválida deixa o valor anterior inalterado.

font aceita uma cadeia na sintaxe abreviada da propriedade CSS font, como "bold 20px sans-serif". O valor inicial é "10px sans-serif". As cadeias inválidas são ignoradas e line-height não tem efeito aqui. Se o tipo de letra não estiver disponível ou ainda não tiver sido carregado, o navegador usa outro; o aspeto dos glifos pode variar consoante o ambiente.

textBaseline escolhe a referência vertical que fillText() e strokeText() colocam em y. "top", "middle" e "bottom" correspondem ao topo, ao meio e à base do quadrado em do tipo de letra, não aos limites dos glifos visíveis. As restantes opções são "hanging" (linha de base suspensa), "alphabetic" (linha de base alfabética, a predefinição) e "ideographic" (linha de base ideográfica inferior). Outras cadeias são ignoradas. O alinhamento horizontal é controlado separadamente por textAlign.

Exemplos

<!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>

Resultado

4 | #1d4ed8 | #172554 | 20px sans-serif | top
1 | #000000 | #000000 | 10px sans-serif | alphabetic

Guarda o exemplo como ficheiro HTML, abre-o num navegador e consulta a consola de programação. A primeira linha mostra os valores de cinco propriedades do contexto antes de `restore()`. A espessura continua a ser `4` apesar da atribuição de `0`. Das cinco propriedades apresentadas, `strokeRect()` usa `lineWidth` e `strokeStyle` para o contorno do retângulo, enquanto `fillText()` usa `fillStyle`, `font` e `textBaseline`. A segunda linha mostra os valores iniciais repostos. O retângulo azul-claro, com contorno azul e texto escuro, continua visível.

Lições relacionadas

  • JavaScript · Lição 26 · Intermédio · Versão: 3

Fontes