Autor publikacji: Virtual Patriot - Administrator

radial-gradient()

Data publikacji: Styczeń 02 2017
Ostatnio edytowano: Wrzesień 07 2020

Zobacz również: w3.org - the radial-gradient notation (LV3)

Przeznaczenie funkcji `radial-gradient()`

Za pomocą funkcji radial-gradient() możemy utworzyć obrazek w postaci gradientu promienistego.

Parametry funkcji `radial-gradient()`

            shape size position, color stop

Przykładowe zapisy

radial-gradient(red, gold)

radial-gradient(ellipse, red 0%, gold 100%)

radial-gradient(ellipse 100px 50px, red 0%, gold 100%)

radial-gradient(circle closest-corner, red 0%, gold 100%)

radial-gradient(circle 50px at left bottom, red 0%, gold 100%)

radial-gradient(ellipse 25% 10% at -25px 60px, red 0%, gold 100%)

shape

Parametr shape nie jest wymaganym parametrem funkcji radial-gradient(). Parametr shape określa kształt, jaki powinien posiadać nowo powstający gradient promienisty.

Dostępne wartości parametru `shape`

                  circle, ellipse

circle: Wartość circle parametru shape określa okrągły kształt dla nowo powstającego gradientu promienistego.
ellipse: Wartość ellipse parametru shape określa eliptyczny kształt dla nowo powstającego gradientu promienistego.

size

Parametr size nie jest wymaganym parametrem funkcji radial-gradient(). Parametr size określa rozmiar promienia lub promieni nowo powstającego gradientu promienistego.

Dostępne wartości: dowolna nieujemna liczba wraz z wybraną jednostką absolutną lub jednostką relatywną. Procenty, lecz tylko wtedy, gdy dla parametru shape zdecydowaliśmy się podać wartość ellipse.
Sposób podawania: gdy dla parametru shape zdecydowaliśmy się podać wartość circle, wtedy należy podać dokładnie jedną wybraną wartość (wartość ta określi rozmiar promienia nowo powstającego gradientu promienistego). Gdy dla parametru shape zdecydowaliśmy się podać wartość ellipse, wtedy należy podać dokładnie dwie wybrane wartości (pierwsza wartość określi rozmiar promienia na poziomej osi X nowo powstającego gradientu promienistego, a druga wartość określi rozmiar promienia na pionowej osi Y nowo powstającego gradientu promienistego).
Wartości procentowe: wartości procentowe liczone są względem aktualnego rozmiaru obszaru, w którym tworzy się nowo powstający gradient promienisty (pierwsza wartość liczona jest względem aktualnego rozmiaru szerokości wspomnianego obszaru, a druga wartość liczona jest względem aktualnego rozmiaru wysokości wspomnianego obszaru)
Wartość domyślna: farthest-corner

Dodatkowe dostępne wartości parametru `size`

                  closest-side, farthest-side, closest-corner, farthest-corner

Ważne

zawsze podajemy tylko jedną wartość (niezależnie od tego, jaką wartość zdecydowaliśmy się podać dla parametru shape)

gdy dla parametru shape zdecydowaliśmy się podać wartość ellipse, wtedy wybrana przez nas wartość parametru size określi zarówno rozmiar promienia na poziomej osi X, jak i rozmiar promienia na pionowej osi Y

closest-side: Wartość closest-side parametru size sprawia, że rozmiarem promienia lub promieni nowo powstającego gradientu promienistego będzie długość od środka nowo powstającego gradientu promienistego do najbliżej położonej krawędzi obszaru, w którym tworzy się nowo powstający gradient promienisty.
farthest-side: Wartość farthest-side parametru size sprawia, że rozmiarem promienia lub promieni nowo powstającego gradientu promienistego będzie długość od środka nowo powstającego gradientu promienistego do najdalej położonej krawędzi obszaru, w którym tworzy się nowo powstający gradient promienisty.
closest-corner: Wartość closest-corner parametru size sprawia, że rozmiar promienia lub promieni nowo powstającego gradientu promienistego będzie uzależniony od środka nowo powstającego gradientu promienistego oraz od najbliżej położonego rogu obszaru, w którym tworzy się nowo powstający gradient promienisty.
farthest-corner: Wartość farthest-corner parametru size sprawia, że rozmiar promienia lub promieni nowo powstającego gradientu promienistego będzie uzależniony od środka nowo powstającego gradientu promienistego oraz od najdalej położonego rogu obszaru, w którym tworzy się nowo powstający gradient promienisty.

position

Parametr position nie jest wymaganym parametrem funkcji radial-gradient(). Parametr position określa miejsce, gdzie powinien znaleźć się środek nowo powstającego gradientu promienistego.

Dostępne wartości: wartości pozycjonujące lub dowolna liczba wraz z wybraną jednostką absolutną lub jednostką relatywną lub procenty
Sposób podawania: po słowie kluczowym at należy podać dokładnie jedną wybraną lub dokładnie dwie wybrane wartości. Gdy podamy tylko jedną wartość, wtedy wartością domyślną drugiej wartości będzie wartość center. Pierwsza wartość odpowiada za przesunięcie środka nowo powstającego gradientu promienistego w poziomie względem lewej krawędzi obszaru, w którym tworzy się nowo powstający gradient promienisty (wartości dodatnie przesuwają w prawo, wartości ujemne przesuwają w lewo). Druga wartość odpowiada za przesunięcie środka nowo powstającego gradientu promienistego w pionie względem górnej krawędzi obszaru, w którym tworzy się nowo powstający gradient promienisty (wartości dodatnie przesuwają w dół, wartości ujemne przesuwają w górę).
Wartości procentowe: wartości procentowe liczone są względem aktualnego rozmiaru obszaru, w którym tworzy się nowo powstający gradient promienisty (pierwsza wartość liczona jest względem aktualnego rozmiaru szerokości wspomnianego obszaru, a druga wartość liczona jest względem aktualnego rozmiaru wysokości wspomnianego obszaru)
Wartość domyślna: center

color

Parametr color jest wymaganym parametrem funkcji radial-gradient(). Parametr color określa jeden z kolorów, który powinien tworzyć nowo powstający gradient promienisty.

stop

Parametr stop nie jest wymaganym parametrem funkcji radial-gradient(). Parametr stop określa miejsce, od którego lub do którego powinien zmieniać swoją barwę kolor, który podaliśmy przed danym parametrem stop.

Dostępne wartości: dowolna liczba wraz z wybraną jednostką absolutną lub jednostką relatywną lub procenty
Sposób podawania: wartości kolejnych ewentualnych parametrów stop należy podawać w kolejności rosnącej (jeżeli złamiemy tę zasadę przeglądarka internetowa wybierze wartość dla danego parametru stop na podstawie największej wartości któregoś z parametrów stop występującego przed danym parametrem stop). Gdy któryś z kolejnych parametrów stop będzie posiadał tą samą wartość, wtedy kolejnym kolorem tworzącym nowo powstający gradient promienisty będzie ten kolor, który występuje wraz z parametrem stop podanym przez nas najpóźniej.
Wartości ujemne: wartości ujemne umożliwiają rozpoczęcie tworzenia nowo powstającego gradientu promienistego od nieco innego koloru (bardziej jaśniejszego lub bardziej ciemniejszego)
Wartości procentowe: wartości procentowe liczone są względem aktualnego rozmiaru nowo powstającego gradientu promienistego
Wartość domyślna: wartość określona przez przeglądarkę internetową w celu równomiernego rozmieszczenia kolorów względem siebie w rozmiarze nowo powstającego gradientu promienistego

schemat tworzenia gradientu promienistego w języku CSS — `radial-gradient(circle 100px at center, red 0%, gold 100%)`

Występowanie funkcji `radial-gradient()`

Przykład funkcji `radial-gradient()`

  background-image:radial-gradient(ellipse 200px 150px at top, red 0%, orange 50%, yellow 100%);

do obszaru tła tego elementu "div" został dodany obrazek w postaci gradientu promienistego, ponieważ do tego elementu "div" została dodana właściwość "background-image" wraz z wartością w postaci funkcji "radial-gradient()", w której to funkcji zostały użyte następujące wartości: "ellipse 200px 150px at top, red 0%, orange 50%, yellow 100%"

Kod źródłowy przykładu

<!DOCTYPE HTML>
<html>
  <head>
    <meta charset="utf-8">
    <title>Darmowy Kurs CSS</title>

    <style>
      html {
        font-size:16px;
        font-family:Helvetica, sans-serif;
      }

      div {
        background-image:radial-gradient(ellipse 200px 150px at top, red 0%, orange 50%, yellow 100%);
        padding:1em;
        font-size:1.3em;
        background-color:#7DCDE8;
      }
    </style>
  </head>

  <body>

    <div>
      do obszaru tła tego elementu "div" został dodany obrazek w postaci gradientu promienistego, ponieważ do tego elementu "div" została dodana właściwość "background-image" wraz z wartością w postaci funkcji "radial-gradient()", w której to funkcji zostały użyte następujące wartości: "ellipse 200px 150px at top, red 0%, orange 50%, yellow 100%"
    </div>

  </body>
</html>

Interpretacja funkcji `radial-gradient()`

: tak
: tak
: tak
: tak
: tak, lecz od wersji 10
: tak

Zobacz więcej informacji o interpretacji funkcji radial-gradient().