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

View in English Always switch to English

CSS-Funktion radial-gradient()

Baseline
Weitgehend verfügbar
*

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

* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.

Die radial-gradient()-Funktion in CSS erzeugt ein Bild mit einem stufenlosen Übergang zwischen zwei oder mehr Farben, der von einem Ursprung ausgeht. Der Verlauf kann kreisförmig oder elliptisch sein. Das Ergebnis der Funktion ist ein Wert des Datentyps <gradient>, einer speziellen Art von <image>.

Probieren Sie es aus

background: radial-gradient(#e66465, #9198e5);
background: radial-gradient(closest-side, #3f87a6, #ebf8e1, #f69d3c);
background: radial-gradient(ellipse 75% 50% at 15% 85%, #ffff00, transparent);
background: radial-gradient(
  circle at 100%,
  #333333,
  #333333 50%,
  #eeeeee 75%,
  #333333 75%
);
background:
  radial-gradient(ellipse at top, #e66465, transparent),
  radial-gradient(ellipse at bottom, #4d9f0c, transparent);
<section class="display-block" id="default-example">
  <div id="example-element"></div>
</section>
#example-element {
  min-height: 100%;
}

Syntax

css
/* A gradient with a single color of red */
radial-gradient(red)

/* A gradient at the center of its container,
   starting red, changing to blue, and finishing green */
radial-gradient(circle at center, red 0, blue, green 100%)

/* hsl color space with longer hue interpolation */
radial-gradient(circle at center in hsl longer hue, red 0, blue, green 100%)

/* A gradient with a specific ellipse size and center */
radial-gradient(ellipse 100% 25% at 0% 50%, red, blue)

Ein radialer Verlauf wird durch die Angabe seines Mittelpunkts (an dem die 0-%-Ellipse liegt) sowie der Größe und Form der Endform (der 100-%-Ellipse) festgelegt.

Werte

<position>

Die Position des Verlaufs. Sie wird genauso interpretiert wie background-position oder transform-origin. Ohne Angabe gilt center.

<ending-shape>

Die Endform des Verlaufs. Der Wert kann circle sein (ein Kreis mit konstantem Radius) oder ellipse (eine an den Achsen ausgerichtete Ellipse). Ohne Angabe gilt ellipse.

<size>

Bestimmt die Größe der Endform des Verlaufs. Ohne Angabe gilt farthest-corner. Die Größe kann ausdrücklich oder durch ein Schlüsselwort angegeben werden. Bei der Definition der Schlüsselwörter werden die Kanten der Verlaufsbox als Geraden betrachtet, die sich in beide Richtungen unendlich erstrecken, nicht als begrenzte Strecken.

Sowohl kreisförmige als auch elliptische Verläufe unterstützen die folgenden Schlüsselwörter für <size>:

Schlüsselwort Beschreibung
closest-side Die Endform des Verlaufs berührt die dem Mittelpunkt nächstgelegene Seite der Box (bei Kreisen) beziehungsweise die nächstgelegene vertikale und horizontale Seite (bei Ellipsen).
closest-corner Die Endform des Verlaufs wird so bemessen, dass sie die dem Mittelpunkt nächstgelegene Ecke der Box genau berührt.
farthest-side Ähnlich wie closest-side, aber die Endform wird so bemessen, dass sie die vom Mittelpunkt am weitesten entfernte Seite der Box beziehungsweise die am weitesten entfernte vertikale und horizontale Seite berührt.
farthest-corner Der Standardwert. Die Endform des Verlaufs wird so bemessen, dass sie die vom Mittelpunkt am weitesten entfernte Ecke der Box genau berührt.

Wenn <ending-shape> als circle angegeben ist, kann die Größe ausdrücklich als <length> angegeben werden. Dieser Wert legt den Kreisradius fest. Negative Werte sind ungültig.

Wenn <ending-shape> als ellipse angegeben ist, kann die Größe mit zwei <length-percentage>-Werten festgelegt werden. Der erste Wert bezeichnet den horizontalen Radius, der zweite den vertikalen Radius. Prozentwerte beziehen sich auf die jeweilige Abmessung der Verlaufsbox. Negative Werte sind ungültig.

Wenn das Schlüsselwort <ending-shape> weggelassen wird, bestimmt die angegebene Größe die Form des Verlaufs. Ein einzelner <length>-Wert ergibt einen Kreis, zwei Werte in <length-percentage>-Einheiten ergeben eine Ellipse. Ein einzelner <percentage>-Wert ist ungültig.

<linear-color-stop>

Der <color>-Wert eines Farbstopps, gefolgt von einer oder zwei optionalen Stopppositionen (jeweils ein <percentage>- oder <length>-Wert entlang der Verlaufsachse). Ein Prozentwert von 0% oder ein Längenwert von 0 bezeichnet den Mittelpunkt des Verlaufs; 100% bezeichnet den Schnittpunkt der Endform mit dem virtuellen Verlaufsstrahl. Dazwischenliegende Prozentwerte werden linear auf dem Verlaufsstrahl positioniert. Zwei Stopppositionen anzugeben ist gleichbedeutend damit, zwei Farbstopps derselben Farbe an diesen Positionen festzulegen.

<color-hint>

Ein Interpolationshinweis, der bestimmt, wie der Verlauf zwischen benachbarten Farbstopps fortschreitet. Der Längenwert legt fest, an welchem Punkt zwischen zwei Farbstopps die Verlaufsfarbe die Mitte des Farbübergangs erreichen soll. Ohne Angabe liegt diese Mitte genau zwischen den beiden Farbstopps.

Beschreibung

Wie jeder Verlauf hat auch ein radialer Verlauf keine intrinsischen Abmessungen: Er hat weder eine natürliche oder bevorzugte Größe noch ein bevorzugtes Seitenverhältnis. Seine konkrete Größe entspricht der Größe des Elements, auf das er angewendet wird.

Um einen radialen Verlauf zu erzeugen, der sich wiederholt und so seinen Container ausfüllt, verwenden Sie stattdessen die Funktion repeating-radial-gradient().

Da <gradient>-Werte zum Datentyp <image> gehören, können sie nur dort verwendet werden, wo auch <image>-Werte zulässig sind. Deshalb funktioniert radial-gradient() nicht mit background-color und anderen Eigenschaften, die den Datentyp <color> verwenden.

Aufbau eines radialen Verlaufs

Diagramm eines radialen Verlaufs: Der virtuelle Verlaufsstrahl verläuft vom Mittelpunkt aus horizontal nach rechts. Der elliptische Verlauf und damit die Endform haben dasselbe Seitenverhältnis wie die Box, für die der Verlauf definiert ist.

Ein radialer Verlauf wird durch einen Mittelpunkt, eine Endform und mindestens zwei Farbstopppunkte definiert.

Um einen gleichmäßigen Verlauf zu erzeugen, zeichnet die Funktion radial-gradient() eine Reihe konzentrischer Formen, die sich vom Mittelpunkt bis zur Endform (und gegebenenfalls darüber hinaus) ausbreiten. Die Endform kann ein Kreis oder eine Ellipse sein.

Farbstopppunkte liegen auf einem virtuellen Verlaufsstrahl, der vom Mittelpunkt aus horizontal nach rechts verläuft. Prozentuale Farbstopppositionen beziehen sich auf den Schnittpunkt der Endform mit diesem Verlaufsstrahl; dieser Schnittpunkt entspricht 100%. Jede konzentrische Form hat genau eine Farbe, die sich aus der Farbe an ihrem Schnittpunkt mit dem Verlaufsstrahl ergibt.

Formale Syntax

<radial-gradient()> = 
radial-gradient( [ <radial-gradient-syntax> ] )

<radial-gradient-syntax> =
[ [ [ <radial-shape> || <radial-size> ]? [ at <position> ]? ] || <color-interpolation-method> ]? , <color-stop-list>

<radial-shape> =
circle |
ellipse

<radial-size> =
<radial-extent> |
<length [0,∞]> |
<length-percentage [0,∞]>{2}

<position> =
<position-one> |
<position-two> |
<position-four>

<color-interpolation-method> =
in [ <rectangular-color-space> | <polar-color-space> <hue-interpolation-method>? | <custom-color-space> ]

<color-stop-list> =
<linear-color-stop> , [ <linear-color-hint>? , <linear-color-stop> ]#?

<radial-extent> =
closest-corner |
closest-side |
farthest-corner |
farthest-side

<length-percentage> =
<length> |
<percentage>

<position-one> =
left |
center |
right |
top |
bottom |
x-start |
x-end |
y-start |
y-end |
block-start |
block-end |
inline-start |
inline-end |
<length-percentage>

<position-two> =
[ left | center | right | x-start | x-end ] && [ top | center | bottom | y-start | y-end ] |
[ left | center | right | x-start | x-end | <length-percentage> ] [ top | center | bottom | y-start | y-end | <length-percentage> ] |
[ block-start | center | block-end ] && [ inline-start | center | inline-end ] |
[ start | center | end ]{2}

<position-four> =
[ [ left | right | x-start | x-end ] <length-percentage> ] && [ [ top | bottom | y-start | y-end ] <length-percentage> ] |
[ [ block-start | block-end ] <length-percentage> ] && [ [ inline-start | inline-end ] <length-percentage> ] |
[ [ start | end ] <length-percentage> ]{2}

<rectangular-color-space> =
srgb |
srgb-linear |
display-p3 |
display-p3-linear |
a98-rgb |
prophoto-rgb |
rec2020 |
lab |
oklab |
<xyz-space>

<polar-color-space> =
hsl |
hwb |
lch |
oklch

<hue-interpolation-method> =
[ shorter | longer | increasing | decreasing ] hue

<custom-color-space> =
<dashed-ident>

<linear-color-stop> =
<color> <color-stop-length>?

<linear-color-hint> =
<length-percentage>

<xyz-space> =
xyz |
xyz-d50 |
xyz-d65

<color-stop-length> =
<length-percentage>{1,2}

Beispiele

Einfacher Verlauf

css
.radial-gradient {
  background-image: radial-gradient(cyan 0%, transparent 20%, salmon 40%);
}

Verlauf mit versetztem Mittelpunkt

css
.radial-gradient {
  background-image: radial-gradient(
    farthest-corner at 40px 40px,
    #ff3355 0%,
    #4433ee 100%
  );
}

Interpolation des Farbtons

In diesem Interpolationsbeispiel wird das Farbsystem hsl verwendet und der Farbton interpoliert.

css
.shorter {
  background-image: radial-gradient(
    circle at center in hsl shorter hue,
    red,
    blue
  );
}

.longer {
  background-image: radial-gradient(
    circle at center in hsl longer hue,
    red,
    blue
  );
}

Die linke Box verwendet die Interpolation über den kürzeren Weg: Die Farbe wechselt auf dem Farbkreis über den kürzeren Bogen direkt von Rot zu Blau. Die rechte Box verwendet die Interpolation über den längeren Weg: Die Farbe wechselt über den längeren Bogen von Rot zu Blau und durchläuft dabei Grün-, Gelb- und Orangetöne.

Weitere Beispiele für radiale Verläufe

Weitere Beispiele finden Sie unter CSS-Verläufe verwenden.

Spezifikationen

Spezifikation
CSS Images Module Level 3
# radial-gradients

Browser-Kompatibilität

Siehe auch