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

CKTIS / CSS

stroke-dashoffset — deslocar um padrão de traços

A propriedade stroke-dashoffset determina em que ponto de um padrão repetido de traços e intervalos começa um contorno SVG. Altera a fase do padrão, não a posição nem o comprimento do caminho.

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

Sintaxe

stroke-dashoffset: <length-percentage>;
/* SVG 2 also permits <number>. */
stroke-dashoffset: 0;
stroke-dashoffset: 10px;
stroke-dashoffset: -10px;
stroke-dashoffset: 5%;

stroke-dashoffset especifica a distância, dentro do padrão repetido definido por stroke-dasharray, a partir da qual começa o traçado descontínuo do caminho. O valor inicial é 0; a propriedade é herdada e aplica-se aos contornos de formas SVG e ao texto. Sem um padrão de traços, alterar o deslocamento não produz qualquer efeito visível. Não equivale a transform nem às propriedades border.

São permitidos valores positivos e negativos. Um deslocamento positivo salta o início do padrão; um negativo desloca a sua fase na direção oposta. CSS Fill and Stroke especifica a sintaxe <length-percentage>, enquanto SVG 2 também permite <number> em unidades do utilizador. As percentagens referem-se à diagonal normalizada da área de visualização SVG, e não ao comprimento do caminho: sqrt((width² + height²) / 2). Em SVG 2, o atributo pathLength afeta a interpretação das distâncias dos traços.

No exemplo, stroke-dasharray: 20px 10px cria traços com 20 unidades e intervalos com 10. O contorno inferior tem stroke-dashoffset: 10px, pelo que o primeiro traço visível mede 10 unidades. A geometria mantém-se inalterada.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>stroke-dashoffset</title>
<style>
  path {
    fill: none;
    stroke: black;
    stroke-width: 4px;
    stroke-linecap: butt;
    stroke-dasharray: 20px 10px;
  }
  .shifted { stroke-dashoffset: 10px; }
</style>
<svg xmlns="http://www.w3.org/2000/svg" width="160" height="70" viewBox="0 0 160 70">
  <path d="M 20 20 H 140" />
  <path class="shifted" d="M 20 50 H 140" />
</svg>

Resultado

Two horizontal black dashed strokes. The upper stroke begins with a 20-unit dash; the lower stroke begins with a 10-unit dash, followed by a 10-unit gap. Neither path moves.

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