CKTIS / CSS
stroke-dasharray — padrão de traços do contorno
A propriedade CSS stroke-dasharray define o padrão repetido de traços e intervalos ao longo de um contorno SVG. Controla os respetivos comprimentos, enquanto none repõe um contorno contínuo.
Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate; usage example verification passed
Sintaxe
/* CSS Fill and Stroke Level 3: # denotes a comma-separated list. */
stroke-dasharray: none | <length-percentage>#;
/* SVG 2: none or a list of lengths, percentages, or unitless numbers. List items may be separated by commas, whitespace, or both. */
stroke-dasharray: 12px 8px;stroke-dasharray controla o tracejado de formas e texto SVG, não os contornos CSS. É herdada; o seu valor inicial, none, significa um contorno contínuo. Para ver o efeito, define um stroke visível e um stroke-width positivo.
A lista começa com o comprimento de um traço, seguido do comprimento de um intervalo, e repete essa sequência. 12px 8px significa um traço com comprimento 12 e um intervalo com comprimento 8. Uma lista com um número ímpar de elementos é duplicada: 5 3 2 comporta-se como 5 3 2 5 3 2. O padrão recomeça em cada subcaminho.
SVG aceita números sem unidade, comprimentos e percentagens, separados por espaços ou vírgulas. Os números sem unidade representam unidades de utilizador SVG. As percentagens referem-se à diagonal normalizada da área de visualização SVG, não ao comprimento do caminho. Os valores negativos são inválidos; uma lista composta apenas por zeros comporta-se como none.
stroke-dashoffset desloca a posição inicial do padrão, enquanto stroke-linecap altera o aspeto das extremidades dos traços. O exemplo usa butt para que as extremidades não prolonguem os traços visíveis.
Exemplos
<!doctype html>
<meta charset="utf-8">
<title>stroke-dasharray</title>
<style>
line {
stroke: black;
stroke-width: 4px;
stroke-linecap: butt;
stroke-dasharray: 12px 8px;
}
</style>
<svg xmlns="http://www.w3.org/2000/svg" width="220" height="40" viewBox="0 0 220 40" role="img" aria-label="Dashed line">
<line x1="10" y1="20" x2="210" y2="20" />
</svg>Resultado
A horizontal black line with 10 dashes, each 12 units long, separated by 8-unit gaps; the final 8 units are also a gap.
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.