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