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

CKTIS / CSS

stroke-linecap — forma das extremidades do traço

A propriedade CSS stroke-linecap define se as extremidades do traço são planas, arredondadas ou quadradas. Em SVG, afeta as extremidades dos subcaminhos abertos e dos traços individuais, mas não controla a forma dos cantos.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate; usage example verification passed

Sintaxe

stroke-linecap: butt | round | square;

stroke-linecap controla as extremidades de um traço, incluindo as de linhas SVG e subcaminhos abertos. Também afeta as extremidades dos traços individuais. A propriedade é herdada, o seu valor inicial é butt e a animação é discreta: as formas não se transformam gradualmente.

butt termina o traço nos pontos finais do caminho. round acrescenta um semicírculo com um raio igual a metade de stroke-width. square acrescenta um retângulo e prolonga o traço em metade de stroke-width em cada extremidade. Estes dois últimos valores aumentam o comprimento visível sem alterar as coordenadas do caminho.

Num subcaminho de comprimento zero, como M 40 40 L 40 40, butt não desenha nada, round produz um círculo e square produz um quadrado cujo lado é igual à largura do traço. Um comando moveto isolado, sem um comando de desenho, não produz qualquer traço.

Não confundas esta propriedade com stroke-linejoin, que controla os cantos. Um caminho fechado e contínuo com comprimento diferente de zero não tem extremidades livres. Para observar o efeito, define um stroke visível e um valor positivo de stroke-width; o exemplo compara as três extremidades.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>stroke-linecap</title>
<style>
  line { stroke: #1565c0; stroke-width: 20px; }
  #butt { stroke-linecap: butt; }
  #round { stroke-linecap: round; }
  #square { stroke-linecap: square; }
</style>
<svg xmlns="http://www.w3.org/2000/svg" width="240" height="150" viewBox="0 0 240 150" role="img" aria-label="stroke-linecap: butt, round, square">
  <line id="butt" x1="40" y1="30" x2="200" y2="30" />
  <line id="round" x1="40" y1="75" x2="200" y2="75" />
  <line id="square" x1="40" y1="120" x2="200" y2="120" />
</svg>

Resultado

Top to bottom: three blue horizontal strokes with butt, round, and square caps. The butt stroke spans x=40–200; the round and square strokes span x=30–210. All strokes are 20 units 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