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

CKTIS / CSS

stroke-opacity — opacité du contour

La propriété CSS `stroke-opacity` contrôle l’opacité du tracé du contour indépendamment du remplissage. Elle accepte un nombre ou un pourcentage, est héritée et a pour valeur initiale `1`.

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

Syntaxe

stroke-opacity: <number> | <percentage>;
stroke-opacity: inherit | initial | unset | revert | revert-layer;

stroke-opacity définit l’opacité de l’opération qui peint le contour des formes et du texte SVG. Elle ne crée pas de contour : pour que celui-ci soit tracé, stroke doit définir une peinture visible et la largeur effective du contour doit être non nulle. Il n’est pas nécessaire de déclarer stroke-width séparément : sa valeur initiale est déjà non nulle, et une valeur non nulle peut aussi être héritée. stroke-opacity ne remplace pas les propriétés CSS de bordure.

Les valeurs 0 et 0% signifient que l’opération est totalement transparente, tandis que 1 et 100% la rendent totalement opaque. 0.25 équivaut à 25%. La valeur calculée est un nombre limité à [0, 1] ; les valeurs hors de cette plage sont limitées, et non rejetées. La valeur initiale est 1, la propriété est héritée et elle peut être animée selon sa valeur calculée.

Contrairement à opacity, qui agit sur le résultat rendu d’un élément ou d’un groupe entier, stroke-opacity ne modifie pas directement le remplissage. Il ne faut pas non plus la confondre avec fill-opacity. Dans l’exemple, seul le contour de droite a une opacité de 0.25 ; les deux remplissages dorés restent opaques.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>stroke-opacity</title>
<style>
  svg { background: white; }
  rect { fill: gold; stroke: black; stroke-width: 12; }
  .faded { stroke-opacity: 0.25; }
</style>
<svg xmlns="http://www.w3.org/2000/svg" width="240" height="120" viewBox="0 0 240 120">
  <rect x="20" y="20" width="80" height="80" />
  <rect class="faded" x="140" y="20" width="80" height="80" />
</svg>

Résultat

Two gold squares. The left stroke is opaque black; the right stroke has 25% opacity. Both fills remain opaque.

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