CKTIS / CSS
stroke-dashoffset — décaler un motif de tirets
La propriété stroke-dashoffset détermine à quel endroit d’un motif répétitif de tirets et d’intervalles commence un contour SVG. Elle modifie la phase du motif, et non la position ou la longueur du tracé.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate; usage example verification passed
Syntaxe
stroke-dashoffset: <length-percentage>;
/* SVG 2 also permits <number>. */
stroke-dashoffset: 0;
stroke-dashoffset: 10px;
stroke-dashoffset: -10px;
stroke-dashoffset: 5%;stroke-dashoffset indique à quelle distance dans le motif répétitif défini par stroke-dasharray commence le tracé en pointillés du chemin. Sa valeur initiale est 0 ; la propriété est héritée et s’applique aux contours des formes SVG et du texte. Sans motif de tirets, modifier le décalage n’a aucun effet visible. Cette propriété n’équivaut ni à transform ni aux propriétés border.
Les valeurs positives et négatives sont autorisées. Un décalage positif saute le début du motif ; un décalage négatif déplace sa phase dans la direction opposée. CSS Fill and Stroke indique la syntaxe <length-percentage>, tandis que SVG 2 autorise aussi <number> en unités utilisateur. Les pourcentages se rapportent à la diagonale normalisée de la zone d’affichage SVG, et non à la longueur du chemin : sqrt((width² + height²) / 2). En SVG 2, l’attribut pathLength influe sur l’interprétation des distances de tirets.
Dans l’exemple, stroke-dasharray: 20px 10px crée des tirets de 20 unités et des intervalles de 10 unités. Le contour inférieur a stroke-dashoffset: 10px : son premier tiret visible mesure donc 10 unités. La géométrie reste inchangée.
Exemples
<!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>Résultat
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.
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.