WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

stroke-dashoffset — ein Strichmuster verschieben

Die Eigenschaft stroke-dashoffset legt fest, an welcher Stelle eines sich wiederholenden Musters aus Strichen und Lücken eine SVG-Kontur beginnt. Sie verändert die Phase des Musters, nicht die Position oder Länge des Pfads.

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

Syntax

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

stroke-dashoffset gibt an, wie weit in das mit stroke-dasharray festgelegte, sich wiederholende Muster hinein der Strichverlauf eines Pfads beginnt. Der Anfangswert ist 0; die Eigenschaft wird vererbt und gilt für Konturen von SVG-Formen und Text. Ohne Strichmuster hat eine Änderung des Versatzes keine sichtbare Wirkung. Die Eigenschaft ist kein Ersatz für transform oder die border-Eigenschaften.

Positive und negative Werte sind zulässig. Ein positiver Versatz überspringt den Anfang des Musters; ein negativer Versatz verschiebt dessen Phase in die entgegengesetzte Richtung. CSS Fill and Stroke gibt <length-percentage> als Syntax an, während SVG 2 zusätzlich <number> in Benutzereinheiten zulässt. Prozentwerte beziehen sich auf die normalisierte Diagonale des SVG-Ansichtsfensters, nicht auf die Pfadlänge: sqrt((width² + height²) / 2). In SVG 2 beeinflusst das Attribut pathLength, wie Strichabstände interpretiert werden.

Im Beispiel erzeugt stroke-dasharray: 20px 10px 20 Einheiten lange Striche und 10 Einheiten lange Lücken. Für die untere Kontur gilt stroke-dashoffset: 10px, daher ist ihr erster sichtbarer Strich 10 Einheiten lang. Die Geometrie bleibt unverändert.

Beispiele

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

Ergebnis

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.

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen