Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

@keyframes — klatki animacji CSS

Reguła @keyframes nadaje nazwę zestawowi wartości właściwości w kolejnych punktach przebiegu animacji CSS.

Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Składnia

@keyframes <keyframes-name> {
  <qualified-rule-list>
}

@keyframes <name> { <keyframe-block-list> } zawiera bloki oznaczone from, to albo procentami. from odpowiada 0%, a to — 100%. W każdym bloku deklaracje opisują wartości w danym przesunięciu; przeglądarka interpoluje je zgodnie z typem animacji właściwości i funkcją czasową. Nazwę łączy z elementem animation-name.

Brak klatki 0% lub 100% nie zatrzymuje animacji: na brakującym końcu używana jest wartość bazowa elementu. Powtórzone przesunięcia łączą deklaracje kaskadowo wewnątrz reguły. Jeśli kilka reguł @keyframes ma tę samą nazwę, reguły nie łączą się — używana jest ostatnia odpowiednia definicja. !important w klatce jest ignorowane.

Nie każda para wartości interpoluje się liczbowo; właściwości dyskretne przełączają stan, a nieobsługiwane deklaracje nie dają oczekiwanego efektu. Funkcja czasowa zadana w klatce steruje odcinkiem zaczynającym się w tej klatce. Przykład pauzuje animację z ujemnym opóźnieniem dokładnie w połowie i potwierdza przez Web Animations API nazwę, stan oraz obliczone opacity 0.6.

Przykłady

const style = document.createElement('style');
style.textContent = `@keyframes fade { from { opacity: 0.2; } 50% { opacity: 0.6; } to { opacity: 1; } }
.probe { animation: fade 1000ms linear -500ms both paused; }`;
document.head.append(style);
const probe = document.createElement('div');
probe.className = 'probe';
probe.textContent = 'CKTIS';
document.body.append(probe);
await new Promise(requestAnimationFrame);
const animation = probe.getAnimations()[0];
console.log('name=' + animation.animationName + '; play=' + animation.playState + '; opacity=' + getComputedStyle(probe).opacity);

Wynik

name=fade; play=paused; opacity=0.6

Reguła @keyframes nadaje nazwę zestawowi wartości właściwości w kolejnych punktach przebiegu animacji CSS.

Źródła