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

CKTIS / CSS

stroke-width — espessura do traço SVG

A propriedade CSS stroke-width define a espessura dos traços das formas e do texto SVG. É herdada e aceita um comprimento não negativo, uma percentagem ou um número em unidades de utilizador SVG. Definir apenas a espessura não dá cor ao traço.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

stroke-width: <length-percentage> | <number>; /* SVG 2; nonnegative values */

stroke-width define a espessura do traço pintado das formas e do texto SVG, não a da borda de uma caixa CSS retangular. O valor inicial é 1px e a propriedade é herdada. Para que o traço fique visível, é também necessário um valor adequado para stroke, como stroke: black; o valor inicial stroke: none não pinta qualquer traço.

SVG 2 aceita um comprimento como 2px, uma percentagem ou um número sem unidade como 2, que representa unidades de utilizador SVG. O valor 0 desativa a pintura do traço, enquanto um valor negativo é inválido. As percentagens referem-se à diagonal normalizada da área de visualização SVG atual, não à largura do objeto nem ao comprimento do caminho.

As fontes descrevem âmbitos diferentes: o rascunho CSS Fill and Stroke Level 3 propõe a sintaxe [ <length-percentage> | <line-width> ]#, camadas de traço e uma base diferente para as percentagens. Não confundas estas extensões do rascunho com o comportamento de SVG 2 nem pressuponhas que os browsers as suportam. Esta entrada e o exemplo usam valores de comprimento individuais para SVG; não demonstram compatibilidade com Chromium 152.

No exemplo, o elemento line superior herda stroke-width: 2px de svg, enquanto .thick define a espessura da linha inferior como 8px. As dimensões de viewBox e da área de visualização coincidem, pelo que não há escala adicional. O resultado esperado são duas linhas horizontais pretas, com espessuras de 2 e 8 píxeis CSS, respetivamente.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>stroke-width</title>
<style>
  svg { stroke: black; stroke-width: 2px; }
  .thick { stroke-width: 8px; }
</style>
<svg xmlns="http://www.w3.org/2000/svg" width="200" height="100" viewBox="0 0 200 100" role="img" aria-label="Two horizontal lines with different stroke widths">
  <line x1="20" y1="30" x2="180" y2="30" />
  <line class="thick" x1="20" y1="70" x2="180" y2="70" />
</svg>
</html>

Resultado

Two black horizontal lines: the upper line is 2 CSS pixels thick and the lower line is 8 CSS pixels thick.

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes