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

CKTIS / CSS

stroke-linecap — forme des extrémités du trait

La propriété CSS stroke-linecap définit la forme des extrémités d’un trait : plate, arrondie ou carrée. En SVG, elle agit sur les extrémités des sous-tracés ouverts et des tirets individuels, mais ne contrôle pas la forme des angles.

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

Syntaxe

stroke-linecap: butt | round | square;

stroke-linecap contrôle les extrémités d’un trait, notamment celles des lignes SVG et des sous-tracés ouverts. Elle agit aussi sur les extrémités des tirets individuels. Cette propriété est héritée, sa valeur initiale est butt et son animation est discrète : les formes ne se transforment pas progressivement.

butt coupe le trait aux extrémités du tracé. round ajoute un demi-cercle dont le rayon correspond à la moitié de stroke-width. square ajoute un rectangle et prolonge le trait de la moitié de stroke-width à chaque extrémité. Ces deux dernières valeurs augmentent la longueur visible sans modifier les coordonnées du tracé.

Pour un sous-tracé de longueur nulle, comme M 40 40 L 40 40, butt ne dessine rien, round produit un cercle et square produit un carré dont le côté est égal à la largeur du trait. Une commande moveto seule, sans commande de dessin, ne produit aucun trait.

Ne confondez pas cette propriété avec stroke-linejoin, qui contrôle les angles. Un tracé fermé et continu de longueur non nulle n’a pas d’extrémités libres. Pour observer l’effet, définissez un stroke visible et une valeur positive pour stroke-width ; l’exemple compare les trois extrémités.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>stroke-linecap</title>
<style>
  line { stroke: #1565c0; stroke-width: 20px; }
  #butt { stroke-linecap: butt; }
  #round { stroke-linecap: round; }
  #square { stroke-linecap: square; }
</style>
<svg xmlns="http://www.w3.org/2000/svg" width="240" height="150" viewBox="0 0 240 150" role="img" aria-label="stroke-linecap: butt, round, square">
  <line id="butt" x1="40" y1="30" x2="200" y2="30" />
  <line id="round" x1="40" y1="75" x2="200" y2="75" />
  <line id="square" x1="40" y1="120" x2="200" y2="120" />
</svg>

Résultat

Top to bottom: three blue horizontal strokes with butt, round, and square caps. The butt stroke spans x=40–200; the round and square strokes span x=30–210. All strokes are 20 units 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