Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

stop-opacity CSS property

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2017 browserübergreifend verfügbar.

Die stop-opacity CSS Eigenschaft definiert die Deckkraft eines Farbverlaufsstopps im SVG-<stop>-Element innerhalb eines SVG-Verlaufs. Wenn vorhanden, überschreibt sie das stop-opacity-Attribut des Elements.

Der Wert der Eigenschaft wirkt sich auf den Alpha-Kanal des stop-color aus; sie kann die Transparenz der Farbe eines <stop> erhöhen, aber nicht die durch die stop-color-Eigenschaft definierte Farbe undurchsichtiger machen.

Hinweis: Die stop-opacity-Eigenschaft gilt nur für <stop>-Elemente, die in einem <svg> verschachtelt sind. Sie gilt nicht für andere SVG-, HTML- oder Pseudo-Elemente.

Syntax

css
/* numeric and percentage values */
stop-opacity: 0.2;
stop-opacity: 20%;

/* Global values */
stop-opacity: inherit;
stop-opacity: initial;
stop-opacity: revert;
stop-opacity: revert-layer;
stop-opacity: unset;

Werte

Der <opacity-value> ist eine <number> oder <percentage>, die die Deckkraft des SVG-Verlaufs-<stop>-Elements angibt.

<number>

Ein numerischer Wert zwischen 0 und 1, inklusive.

<percentage>

Ein Prozentwert zwischen 0% und 100%, inklusive.

Mit 0 oder 0% eingestellt, ist der Stopp vollständig transparent. Mit 1 oder 100% eingestellt, ist das Element die volle Deckkraft des stop-color-Wertes, der teilweise oder vollständig undurchsichtig sein kann.

Formale Definition

Anfangswertblack
Anwendbar auf<stop> elements in <svg>
VererbtNein
Berechneter Wertwie angegeben
Animationstypdiskret

Formale Syntax

stop-opacity = 
<number> |
<percentage>

Beispiele

Die Deckkraft eines SVG-Verlaufsfarbstopps definieren

Dieses Beispiel zeigt den grundlegenden Anwendungsfall von stop-opacity und wie die CSS stop-opacity Eigenschaft das stop-opacity Attribut überlagert.

HTML

Wir haben ein SVG mit einigen <polygon> Sternen und drei <linearGradient> Elementen: Jedes hat drei <stop> Elemente, die drei Farbunterbrechungen definieren, die einen Farbverlauf von Blau zu Weiß zu Pink erstellen; der einzige Unterschied zwischen ihnen ist der id Wert.

html
<svg viewBox="0 0 250 120" xmlns="http://www.w3.org/2000/svg">
  <defs>
    <linearGradient id="myGradient1">
      <stop offset="5%" stop-color="#66ccff" stop-opacity="1" />
      <stop offset="50%" stop-color="#fefefe" stop-opacity="1" />
      <stop offset="95%" stop-color="#f4aab9" stop-opacity="1" />
    </linearGradient>
    <linearGradient id="myGradient2">
      <stop offset="5%" stop-color="#66ccff" stop-opacity="1" />
      <stop offset="50%" stop-color="#fefefe" stop-opacity="1" />
      <stop offset="95%" stop-color="#f4aab9" stop-opacity="1" />
    </linearGradient>
    <linearGradient id="myGradient3">
      <stop offset="5%" stop-color="#66ccff" stop-opacity="1" />
      <stop offset="50%" stop-color="#fefefe" stop-opacity="1" />
      <stop offset="95%" stop-color="#f4aab9" stop-opacity="1" />
    </linearGradient>
  </defs>
  <polygon points="40,10 10,100 80,40 0,40 70,100" />
  <polygon points="125,10 95,100 165,40 85,40 155,100" />
  <polygon points="210,10 180,100 250,40 170,40 240,100" />
</svg>

CSS

Wir fügen einen stroke und stroke-width hinzu, um die Polygonpfadlinie sichtbar zu machen.

Jedes polygon hat einen Verlaufshintergrund, der mit der fill-Eigenschaft gesetzt wird; die id des Verlaufs ist der url()-Parameter. Wir setzen magenta als Ersatzfarbe fest.

Wir definieren die Deckkraft der Stopps jedes Verlaufs mit der stop-opacity Eigenschaft.

Das SVG hat einen gestreiften Hintergrund, um die Transparenzeinstellungen deutlicher zu machen.

css
polygon {
  stroke: #333333;
  stroke-width: 1px;
}
polygon:nth-of-type(1) {
  fill: url("#myGradient1") magenta;
}
polygon:nth-of-type(2) {
  fill: url("#myGradient2") magenta;
}
polygon:nth-of-type(3) {
  fill: url("#myGradient3") magenta;
}

#myGradient1 stop {
  stop-opacity: 1;
}
#myGradient2 stop {
  stop-opacity: 0.8;
}
#myGradient3 stop {
  stop-opacity: 25%;
}

Ergebnisse

Der erste Stern ist vollständig undurchsichtig. Der Füllbereich des zweiten Sterns ist zu 80% undurchsichtig, da die Farbunterbrechungen leicht transluzent sind; der stop-opacity: 0.8; überlagerte den stop-opacity="1" Attributwert des Elements. Der Füllbereich des letzten Sterns ist kaum sichtbar mit Farbunterbrechungen, die zu 25% undurchsichtig sind. Beachten Sie, dass der Rahmen in allen Fällen das gleiche undurchsichtige Dunkelgrau ist.

Hinweis: Da wir den gleichen stop-opacity-Wert für alle untergeordneten <stop>-Elemente im linearen Verlauf verwendet haben, hätten wir stattdessen einen einzelnen <linearGradient> mit vollständig undurchsichtigen Stopps verwenden und einen Wert für die fill-opacity-Eigenschaft jedes <polygon> setzen können.

Spezifikationen

Spezifikation
Scalable Vector Graphics (SVG) 2
# StopOpacityProperty

Browser-Kompatibilität

Siehe auch