WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

stroke-opacity — Deckkraft der Kontur

Die CSS-Eigenschaft `stroke-opacity` steuert die Deckkraft der Kontur unabhängig von der Füllung. Sie akzeptiert eine Zahl oder einen Prozentwert, wird vererbt und hat den Anfangswert `1`.

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

Syntax

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

stroke-opacity legt die Deckkraft des Malvorgangs fest, der die Umrisse von SVG-Formen und -Text zeichnet. Die Eigenschaft erzeugt keine Kontur: Zum Zeichnen der Kontur müssen stroke eine sichtbare Bemalung vorgeben und die wirksame Konturbreite größer als null sein. Eine eigene Deklaration für stroke-width ist nicht nötig: Der Anfangswert ist bereits größer als null, und ein solcher Wert kann auch vererbt werden. stroke-opacity ersetzt keine CSS-Rahmeneigenschaften.

Die Werte 0 und 0% bedeuten vollständig transparent, während 1 und 100% diesen Malvorgang vollständig deckend machen. 0.25 entspricht 25%. Der berechnete Wert ist eine Zahl, die auf den Bereich [0, 1] begrenzt wird; Werte außerhalb dieses Bereichs werden begrenzt, nicht zurückgewiesen. Der Anfangswert ist 1; die Eigenschaft wird vererbt und kann anhand des berechneten Werts animiert werden.

Anders als opacity, das sich auf das gerenderte Ergebnis eines ganzen Elements oder einer Gruppe auswirkt, verändert stroke-opacity die Füllung nicht direkt. Auch mit fill-opacity sollte sie nicht verwechselt werden. Im Beispiel hat nur die rechte Kontur eine Deckkraft von 0.25; beide goldenen Füllungen bleiben deckend.

Beispiele

<!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>

Ergebnis

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

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen