Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

stroke-width — épaisseur du contour SVG

La propriété CSS stroke-width définit l’épaisseur des contours des formes et du texte SVG. Elle est héritée et accepte une longueur non négative, un pourcentage ou un nombre exprimé en unités utilisateur SVG. Définir l’épaisseur seule ne donne pas de couleur au contour.

Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntaxe

stroke-width: <length-percentage> | <number>; /* SVG 2; nonnegative values */

stroke-width définit l’épaisseur du contour peint des formes et du texte SVG, et non celle de la bordure d’un bloc CSS rectangulaire. Sa valeur initiale est 1px et la propriété est héritée. Pour qu’un contour soit visible, il faut également une valeur adaptée pour stroke, par exemple stroke: black ; la valeur initiale stroke: none ne peint aucun contour.

SVG 2 accepte une longueur comme 2px, un pourcentage ou un nombre sans unité comme 2, qui représente des unités utilisateur SVG. La valeur 0 désactive le dessin du contour, tandis qu’une valeur négative est invalide. Les pourcentages se rapportent à la diagonale normalisée de la zone d’affichage SVG actuelle, et non à la largeur de l’objet ni à la longueur du tracé.

Les sources décrivent des périmètres différents : le brouillon CSS Fill and Stroke Level 3 propose la syntaxe [ <length-percentage> | <line-width> ]#, des couches de contour et une autre base de calcul des pourcentages. Ne confondez pas ces extensions du brouillon avec le comportement de SVG 2 et ne présumez pas de leur prise en charge par les navigateurs. Cette entrée et cet exemple utilisent des valeurs de longueur simples pour SVG ; ils ne démontrent pas la compatibilité avec Chromium 152.

Dans l’exemple, l’élément line du haut hérite stroke-width: 2px de svg, tandis que .thick fixe l’épaisseur de la ligne du bas à 8px. Les dimensions de viewBox et de la zone d’affichage correspondent, donc il n’y a pas de mise à l’échelle supplémentaire. Le résultat attendu est constitué de deux lignes horizontales noires, épaisses respectivement de 2 et 8 pixels CSS.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>stroke-width</title>
<style>
  svg { stroke: black; stroke-width: 2px; }
  .thick { stroke-width: 8px; }
</style>
<svg xmlns="http://www.w3.org/2000/svg" width="200" height="100" viewBox="0 0 200 100" role="img" aria-label="Two horizontal lines with different stroke widths">
  <line x1="20" y1="30" x2="180" y2="30" />
  <line class="thick" x1="20" y1="70" x2="180" y2="70" />
</svg>
</html>

Résultat

Two black horizontal lines: the upper line is 2 CSS pixels thick and the lower line is 8 CSS pixels thick.

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.

Sources