Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

stroke-dashoffset — desplazar un patrón de trazos

La propiedad stroke-dashoffset determina en qué punto de un patrón repetitivo de trazos y espacios comienza un contorno SVG. Cambia la fase del patrón, no la posición ni la longitud del trazado.

Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate; usage example verification passed

Sintaxis

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

stroke-dashoffset indica la distancia dentro del patrón repetitivo definido por stroke-dasharray a la que empieza el trazado discontinuo de un camino. Su valor inicial es 0; se hereda y se aplica a los contornos de formas SVG y texto. Sin un patrón de trazos, cambiar el desplazamiento no tiene ningún efecto visible. No equivale a transform ni a las propiedades border.

Se permiten valores positivos y negativos. Un desplazamiento positivo omite el inicio del patrón; uno negativo desplaza su fase en la dirección opuesta. CSS Fill and Stroke especifica la sintaxis <length-percentage>, mientras que SVG 2 también permite <number> en unidades de usuario. Los porcentajes se refieren a la diagonal normalizada del área de visualización SVG, no a la longitud del trazado: sqrt((width² + height²) / 2). En SVG 2, el atributo pathLength afecta a la interpretación de las distancias de los trazos.

En el ejemplo, stroke-dasharray: 20px 10px crea trazos de 20 unidades y espacios de 10. El contorno inferior tiene stroke-dashoffset: 10px, así que su primer trazo visible mide 10 unidades. La geometría no cambia.

Ejemplos

<!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.

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes