CKTIS / CSS
stroke-dashoffset — een streeppatroon verschuiven
De eigenschap stroke-dashoffset bepaalt op welk punt in een herhalend patroon van strepen en tussenruimten een SVG-contour begint. De eigenschap verandert de fase van het patroon, niet de positie of lengte van het pad.
Versie: 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 geeft aan hoe ver in het herhalende patroon dat met stroke-dasharray is gedefinieerd de streepweergave van een pad begint. De beginwaarde is 0; de eigenschap wordt overgeërfd en geldt voor contouren van SVG-vormen en tekst. Zonder streeppatroon heeft een wijziging van de verschuiving geen zichtbaar effect. De eigenschap is geen equivalent van transform of de border-eigenschappen.
Positieve en negatieve waarden zijn toegestaan. Een positieve verschuiving slaat het begin van het patroon over; een negatieve verschuiving verplaatst de fase in de tegenovergestelde richting. CSS Fill and Stroke specificeert de syntaxis <length-percentage>, terwijl SVG 2 daarnaast <number> in gebruikerseenheden toestaat. Percentages verwijzen naar de genormaliseerde diagonaal van het SVG-weergavegebied, niet naar de padlengte: sqrt((width² + height²) / 2). In SVG 2 beïnvloedt het attribuut pathLength de interpretatie van streepafstanden.
In het voorbeeld maakt stroke-dasharray: 20px 10px strepen van 20 eenheden en tussenruimten van 10 eenheden. De onderste contour heeft stroke-dashoffset: 10px, waardoor de eerste zichtbare streep 10 eenheden lang is. De geometrie blijft ongewijzigd.
Voorbeelden
<!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>Resultaat
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.
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.