CKTIS / CSS
stroke-dasharray — motif de tirets du contour
La propriété CSS stroke-dasharray définit le motif répétitif de tirets et d’intervalles le long d’un contour SVG. Elle en contrôle les longueurs, tandis que none rétablit un contour continu.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate; usage example verification passed
Syntaxe
/* 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 règle les tirets des formes et du texte SVG, pas les bordures CSS. La propriété est héritée ; sa valeur initiale, none, correspond à un contour continu. Pour voir l’effet, définissez un stroke visible et un stroke-width positif.
La liste commence par une longueur de tiret, suivie d’une longueur d’intervalle, puis répète cette séquence. 12px 8px signifie un tiret de longueur 12 et un intervalle de longueur 8. Une liste comportant un nombre impair d’éléments est doublée : 5 3 2 se comporte comme 5 3 2 5 3 2. Le motif reprend au début de chaque sous-chemin.
SVG accepte des nombres sans unité, des longueurs et des pourcentages, séparés par des espaces ou des virgules. Les nombres sans unité représentent des unités utilisateur SVG. Les pourcentages se rapportent à la diagonale normalisée de la zone d’affichage SVG, et non à la longueur du chemin. Les valeurs négatives ne sont pas valides ; une liste composée uniquement de zéros se comporte comme none.
stroke-dashoffset décale la position de départ du motif, tandis que stroke-linecap modifie l’apparence des extrémités des tirets. L’exemple utilise butt afin que les extrémités ne prolongent pas les tirets visibles.
Exemples
<!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>Résultat
A horizontal black line with 10 dashes, each 12 units long, separated by 8-unit gaps; the final 8 units are also a gap.
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.