Kurs HTML i CSS · Moduł 9: Nowoczesny CSS
@property - typowane właściwości CSS
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)
| Syntax | Opis | Przykład |
|---|---|---|
"<color>" | Dowolny kolor CSS | gold, #d4af37, rgb(212,175,55) |
"<length>" | Długość z jednostką | 10px, 2rem, 50vh |
"<number>" | Liczba bez jednostki | 0, 1.5, 360 |
"<percentage>" | Procent | 50%, 100% |
"<angle>" | Kąt | 45deg, 0.5turn |
"<integer>" | Liczba całkowita | 0, 3, 100 |
"<length-percentage>" | Długość lub procent | 10px, 50% |
"<custom-ident>" | Niestandardowy identyfikator | ease-in, forwards |
inherits
true- potomkowie dziedziczą wartość (tak jak zwykłe Custom Properties)false- potomkowie NIE dziedziczą; każdy element używainitial-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
| Cecha | Custom Properties | @property |
|---|---|---|
| Deklaracja | --name: value | @property --name { ... } |
| Typ | Brak (tekst) | Określony (color, length...) |
| Animacja | Niemożliwa | Możliwa! |
| Dziedziczenie | Zawsze | Konfigurowalne |
| Wartość domyślna | Przez var(--name, fallback) | Przez initial-value |
| Walidacja | Brak | Przeglą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!