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

CKTIS / CSS

stroke-dasharray — patrón de guiones del trazo

La propiedad CSS stroke-dasharray define el patrón repetitivo de guiones y espacios a lo largo de un trazo SVG. Controla sus longitudes, mientras que none restaura un trazo continuo.

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

Sintaxis

/* 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 el trazado discontinuo de las formas y el texto SVG, no los bordes CSS. Se hereda; su valor inicial, none, significa que el trazo es continuo. Para ver el efecto, establece un stroke visible y un stroke-width positivo.

La lista empieza con la longitud de un guion, seguida de la longitud de un espacio, y repite esa secuencia. 12px 8px significa un guion de longitud 12 y un espacio de longitud 8. Una lista con un número impar de elementos se duplica: 5 3 2 se comporta como 5 3 2 5 3 2. El patrón vuelve a empezar en cada subtrazado.

SVG acepta números sin unidad, longitudes y porcentajes, separados por espacios o comas. Los números sin unidad representan unidades de usuario SVG. Los porcentajes se refieren a la diagonal normalizada del área de visualización SVG, no a la longitud del trazado. Los valores negativos no son válidos; una lista formada solo por ceros se comporta como none.

stroke-dashoffset desplaza la posición inicial del patrón, mientras que stroke-linecap cambia el aspecto de los extremos de los guiones. El ejemplo usa butt para que los extremos no alarguen los guiones visibles.

Ejemplos

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

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