Kurs HTML i CSS · Moduł 9: Nowoczesny CSS

@property - typowane właściwości CSS

4 min czytania ·
W tej lekcji7

W starożytnym Egipcie kapłani posiadali tajemną wiedzę o magicznych formułach, które nadawały przedmiotom niezwykłe właściwości. Każda formuła miała ściśle określony typ - mogła działać na kolory, liczby lub wymiary, a jej nieprawidłowe użycie powodowało, że magia nie zadziałała. Reguła @property w CSS działa na podobnej zasadzie - pozwala formalnie zarejestrować własną właściwość CSS, nadając jej typ, wartość początkową i zasady dziedziczenia. Dzięki temu przeglądarka "rozumie" znaczenie twojej zmiennej i potrafi ją animować.

Problem ze zwykłymi Custom Properties

Zwykłe zmienne CSS (--nazwa: wartość) są traktowane przez przeglądarkę jako nieprzetworzony tekst. Przeglądarka nie wie, czy --my-color to kolor, liczba czy coś innego. Konsekwencja jest taka, że nie można ich płynnie animować:

:root {
  --gradient-start: gold;
  --gradient-end: purple;
}

.box {
  background: linear-gradient(var(--gradient-start), var(--gradient-end));
  transition: --gradient-start 1s, --gradient-end 1s;
}

/* To NIE zadziała\! Przeglądarka nie wie, że to kolory */
.box:hover {
  --gradient-start: crimson;
  --gradient-end: navy;
}

Przeglądarka widzi zmianę z jednego ciągu tekstowego na drugi i nie potrafi obliczyć wartości pośrednich. Zamiast płynnego przejścia, kolor przeskoczy natychmiast.

Rozwiązanie: @property

Reguła @property rejestruje właściwość z pełną definicją typu:

@property --gradient-start {
  syntax: "<color>";
  inherits: false;
  initial-value: gold;
}

@property --gradient-end {
  syntax: "<color>";
  inherits: false;
  initial-value: purple;
}

Teraz przeglądarka wie, że --gradient-start i --gradient-end to kolory. Potrafi obliczyć wartości pośrednie i wykonać płynną animację!

Składnia @property

Każda deklaracja @property wymaga trzech obowiązkowych deskryptorów:

@property --nazwa-wlasciwosci {
  syntax: "<typ>";         /* Jakiego typu jest wartość */
  inherits: true | false;  /* Czy potomkowie dziedzicza */
  initial-value: wartość;  /* Domyślna wartość */
}

Dostępne typy (syntax)

SyntaxOpisPrzykład
"<color>"Dowolny kolor CSSgold, #d4af37, rgb(212,175,55)
"<length>"Długość z jednostką10px, 2rem, 50vh
"<number>"Liczba bez jednostki0, 1.5, 360
"<percentage>"Procent50%, 100%
"<angle>"Kąt45deg, 0.5turn
"<integer>"Liczba całkowita0, 3, 100
"<length-percentage>"Długość lub procent10px, 50%
"<custom-ident>"Niestandardowy identyfikatorease-in, forwards

inherits

  • true - potomkowie dziedziczą wartość (tak jak zwykłe Custom Properties)
  • false - potomkowie NIE dziedziczą; każdy element używa initial-value

Animowanie gradientów z @property

To najbardziej spektakularne zastosowanie @property - animowanie właściwości, które normalnie nie mogą być animowane:

@property --hue {
  syntax: "<number>";
  inherits: false;
  initial-value: 45;
}

.egyptian-glow {
  --hue: 45;
  background: linear-gradient(
    135deg,
    hsl(var(--hue), 80%, 50%),
    hsl(calc(var(--hue) + 60), 70%, 40%)
  );
  transition: --hue 0.8s ease;
}

.egyptian-glow:hover {
  --hue: 200;
}

Dzięki @property, przeglądarka wie, że --hue to liczba i potrafi płynnie przejść z 45 do 200, animując cały gradient!

Animacja ciągła z @keyframes

@property --angle {
  syntax: "<angle>";
  inherits: false;
  initial-value: 0deg;
}

.rotating-border {
  --angle: 0deg;
  border: 3px solid transparent;
  border-image: linear-gradient(
    var(--angle),
    #d4af37,
    #1e3a5f,
    #d4af37
  ) 1;
  animation: rotate-gradient 3s linear infinite;
}

@keyframes rotate-gradient {
  to {
    --angle: 360deg;
  }
}

Praktyczne zastosowania

1. Animowany kolor tła

@property --bg-color {
  syntax: "<color>";
  inherits: false;
  initial-value: #d4af37;
}

.pharaoh-card {
  background: var(--bg-color);
  transition: --bg-color 0.5s ease;
}

.pharaoh-card:hover {
  --bg-color: #1e3a5f;
}

2. Animowany procent

@property --progress {
  syntax: "<percentage>";
  inherits: false;
  initial-value: 0%;
}

.pyramid-progress {
  background: linear-gradient(
    to right,
    #d4af37 var(--progress),
    #e8d7b0 var(--progress)
  );
  transition: --progress 1s ease;
}

.pyramid-progress.complete {
  --progress: 100%;
}

3. Wielokolorowy gradient z animacją

@property --color-a {
  syntax: "<color>";
  inherits: false;
  initial-value: #d4af37;
}

@property --color-b {
  syntax: "<color>";
  inherits: false;
  initial-value: #8b6914;
}

.magic-gradient {
  background: linear-gradient(135deg, var(--color-a), var(--color-b));
  transition: --color-a 0.6s ease, --color-b 0.6s ease;
}

.magic-gradient:hover {
  --color-a: #1e3a5f;
  --color-b: #30d5c8;
}

@property vs zwykłe Custom Properties

CechaCustom Properties@property
Deklaracja--name: value@property --name { ... }
TypBrak (tekst)Określony (color, length...)
AnimacjaNiemożliwaMożliwa!
DziedziczenieZawszeKonfigurowalne
Wartość domyślnaPrzez var(--name, fallback)Przez initial-value
WalidacjaBrakPrzeglądarka waliduje typ

Wsparcie przeglądarek

@property jest wspierane od Chrome 85 (2020), Edge 85, Safari 15.4 (2022) i Firefox 128 (2024). Możesz bezpiecznie używać go w nowoczesnych projektach. Dla starszych przeglądarek, właściwość po prostu zachowa się jak zwykła Custom Property - bez animacji, ale z poprawną wartością.

/* Fallback - zawsze dziala */
.element {
  --my-color: gold;
  background: var(--my-color);
}

/* @property - dodaje możliwość animacji */
@property --my-color {
  syntax: "<color>";
  inherits: false;
  initial-value: gold;
}

@property to jak magiczna formuła egipskich kapłanów - nadaje twoim zmiennym CSS prawdziwą moc, pozwalając przeglądarce rozumieć ich znaczenie i tworzyć płynne, spektakularne animacje tam, gdzie wcześniej było to niemożliwe.

Kod do tej lekcji: index.html
<!DOCTYPE html>
<html lang="pl">
<head>
    <meta charset="UTF-8">
    <title>@property - typowane wlasciwosci CSS</title>
    <link rel="stylesheet" href="style.css">
</head>
<body>
    <h1>@property - Magiczne Formuly Faraonow</h1>

    <section>
        <h2>Animowany gradient (niemozliwy bez @property!)</h2>
        <div class="gradient-box">Najedz na mnie</div>
    </section>

    <section>
        <h2>Obracajaca sie ramka</h2>
        <div class="rotating-border">
            <p>Animacja kata gradientu</p>
        </div>
    </section>

    <section>
        <h2>Pasek postepu z animacja</h2>
        <div class="progress-bar"></div>
        <p class="hint">Animacja uruchamia sie automatycznie</p>
    </section>
</body>
</html>

Hasła z dokumentacji w tej lekcji

Widzisz błąd w tej lekcji?

Zadania praktyczne w grze

  • Edytor kodu

    Zarejestruj @property --color-a i --color-b z syntax "<color>". Stwórz gradient background: linear-gradient(135deg, var(--color-a), var(--color-b)) i dodaj transition na --color-a i --color-b. Zmień kolory na :hover - zobaczysz płynną animację gradientu!

  1. Zadanie z kodemAnimowane gradienty z @property

Przydatne artykuły