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-Eigenschaft animation

Baseline
Weitgehend verfügbar
*

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

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

Die CSS-Kurzschreibweise animation wendet eine Animation zwischen Stilen an. Sie ist eine Kurzschreibweise für animation-name, animation-duration, animation-timing-function, animation-delay, animation-iteration-count, animation-direction, animation-fill-mode, animation-play-state und animation-timeline.

Probieren Sie es aus

animation: 3s ease-in 1s infinite reverse both running slide-in;
animation: 3s linear 1s infinite running slide-in;
animation: 3s linear 1s infinite alternate slide-in;
animation: 0.5s linear 1s infinite alternate slide-in;
<section class="flex-column" id="default-example">
  <div id="example-element"></div>
</section>
#example-element {
  background-color: #1766aa;
  margin: 20px;
  border: 5px solid #333333;
  width: 150px;
  height: 150px;
  border-radius: 50%;
}

@keyframes slide-in {
  from {
    margin-left: -20%;
  }
  to {
    margin-left: 100%;
  }
}

Zugehörige Eigenschaften

Diese Eigenschaft ist eine Kurzschreibweise für die folgenden CSS-Eigenschaften:

Nur zurückgesetzte Untereigenschaften

Diese Eigenschaft setzt die folgenden CSS-Eigenschaften auf ihre Anfangswerte zurück:

Syntax

css
/* Duration | easing-function | delay |
iteration-count | direction | fill-mode | play-state | name */
animation: 3s ease-in 1s 2 reverse both paused slide-in;

/* Duration | easing-function | delay | name */
animation: 3s linear 1s slide-in;

/* Duration | name */
animation: 3s slide-in;

/* Multiple animations */
animation:
  3s linear slide-in,
  3s ease-out 5s slide-out;

Werte

Diese Eigenschaft wird als durch Kommas getrennte Liste von <animation>-Werten angegeben. Jeder Wert ist eine durch Leerzeichen getrennte Liste der folgenden Werte:

<keyframes-name> oder none

Der Name einer @keyframes-At-Regel, die die auf ein Element anzuwendende Animation festlegt. Der Anfangswert von animation-name ist none.

<animation-duration>

Bestimmt, wie lange eine Animation für einen Durchlauf benötigt. Der Wert muss einer der für animation-duration verfügbaren Werte sein. Der Anfangswert ist 0s.

<easing-function>

Bestimmt die Art des Übergangs. Der Wert muss einer der für animation-timing-function verfügbaren Werte sein. Der Anfangswert ist ease.

<animation-delay>

Bestimmt, wie lange nach dem Anwenden der Animation auf ein Element gewartet wird, bevor die Animation beginnt. Der Wert muss einer der für animation-delay verfügbaren Werte sein. Der Anfangswert ist 0s.

<single-animation-direction>

Die Richtung, in der die Animation abgespielt wird. Der Wert muss einer der für animation-direction verfügbaren Werte sein. Der Anfangswert von animation-direction ist normal.

<single-animation-iteration-count>

Gibt an, wie oft die Animation abgespielt wird. Der Wert muss einer der für animation-iteration-count verfügbaren Werte sein. Der Anfangswert von animation-iteration-count ist 1.

<single-animation-fill-mode>

Bestimmt, wie Stile vor und nach der Ausführung der Animation auf deren Zielelement angewendet werden. Der Wert muss einer der für animation-fill-mode verfügbaren Werte sein. Der Anfangswert von animation-fill-mode ist none.

<single-animation-play-state>

Bestimmt, ob die Animation abgespielt wird. Der Wert muss einer der für animation-play-state verfügbaren Werte sein. Der Anfangswert von animation-play-state ist running.

<single-animation-timeline>

Bestimmt die Zeitleiste, mit der der Fortschritt der Animation gesteuert wird. Der Wert muss einer der für animation-timeline verfügbaren Werte sein. Der Anfangswert ist auto.

Beschreibung

Die Eigenschaft animation wird als eine oder mehrere einzelne Animationen angegeben, die durch Kommas getrennt sind. Jede animation in dieser Liste legt animation-name, animation-duration, animation-timing-function, animation-delay, animation-iteration-count, animation-direction, animation-fill-mode, animation-play-state und animation-timeline fest. Fehlt eine dieser Komponenten in einer animation-Deklaration, wird ihr Wert auf den jeweiligen Anfangswert gesetzt.

Hinweis: Die Kurzschreibweise animation setzt die Eigenschaften animation-range-start, animation-range-end und animation-trigger auf ihre jeweiligen Anfangswerte normal, normal und none zurück. Diese nur zurückgesetzten Untereigenschaften können nicht in der Kurzschreibweise animation festgelegt werden; werden sie dennoch aufgenommen, ist die gesamte Deklaration ungültig. Da die animation-Deklaration jede dieser Eigenschaften auf ihren Anfangswert setzt, müssen sie entweder nach allen animation-Kurzschreibweisen oder mit höherer Spezifität deklariert werden.

animation-name

Die Komponente <animation-name> jeder Animation bezeichnet deren Namen. Dieser kann none, ein <custom-ident> oder ein <string> sein. Der Anfangswert von animation-name ist none. Wird in der Kurzschreibweise animation kein Wert für animation-name angegeben, wird somit auf keine der Eigenschaften eine Animation angewendet.

Die Reihenfolge der übrigen Werte innerhalb einer Animationsdefinition ist wichtig, um einen Wert für animation-name von anderen Werten zu unterscheiden. Lässt sich ein Wert in der Kurzschreibweise animation als Wert einer anderen Animationseigenschaft als animation-name interpretieren, wird er zuerst dieser Eigenschaft zugewiesen und nicht animation-name. Daher empfiehlt es sich, bei Verwendung der Kurzschreibweise animation den Wert für animation-name als letzten Wert anzugeben. Das gilt auch, wenn Sie mit der Kurzschreibweise mehrere durch Kommas getrennte Animationen angeben.

Zeitwerte

Jede Animation kann den Wert <time> null-, ein- oder zweimal enthalten. Die Reihenfolge der Zeitwerte innerhalb einer Animationsdefinition ist wichtig: Der erste Wert, der als <time> interpretiert werden kann, wird animation-duration zugewiesen, der zweite animation-delay.

Wenn in der Kurzschreibweise animation kein Wert für animation-duration angegeben ist, beträgt die Dauer standardmäßig 0s. In diesem Fall findet die Animation dennoch statt – die Ereignisse animationStart und animationEnd werden ausgelöst –, ist für Benutzer jedoch nicht sichtbar.

animation-timeline

Ist in der Kurzschreibweise animation kein <animation-timeline> enthalten, setzt die Kurzschreibweise zuvor deklarierte animation-timeline-Werte auf auto zurück. Damit wird die Zeitleiste auf die standardmäßige documentTimeline gesetzt.

Ist ein <animation-timeline>-Wert enthalten, der User-Agent unterstützt solche Werte innerhalb der Kurzschreibweise jedoch nicht, ist die gesamte animation-Deklaration ungültig und wird ignoriert. Wenn Sie CSS-Animationen mit Scrollsteuerung erstellen, müssen Sie daher die Eigenschaft animation-timeline nach jeder animation-Kurzschreibweise deklarieren, damit sie wirksam wird.

Alternativ kann <animation-timeline> innerhalb der Kurzschreibweise animation in einem CSS-@supports-Block festgelegt werden, zum Beispiel:

css
@supports (animation: view()) {
  /* CSS for browsers supporting <animation-timeline> within `animation` shorthand */
}

animation-fill-mode und neue Stacking-Kontexte

Beim Wert forwards für animation-fill-mode verhalten sich animierte Eigenschaften so, als wären sie im Wert einer festgelegten will-change-Eigenschaft enthalten. Wird während der Animation ein neuer Stacking-Kontext erstellt, behält das Zielelement diesen nach Abschluss der Animation bei.

Barrierefreiheit

Blinkende und flackernde Animationen können für Menschen mit kognitiven Beeinträchtigungen wie einer Aufmerksamkeitsdefizit-/Hyperaktivitätsstörung (ADHS) problematisch sein. Bestimmte Arten von Bewegung können außerdem Beschwerden bei Gleichgewichtsstörungen, Epilepsie, Migräne und skotopischer Empfindlichkeit auslösen.

Erwägen Sie, eine Möglichkeit zum Pausieren oder Deaktivieren von Animationen bereitzustellen. Verwenden Sie außerdem die @media-Abfrage für reduzierte Bewegung, um Benutzern, die weniger Animationen bevorzugen, eine entsprechende Alternative zu bieten.

Formale Definition

Anfangswertwie die jeweiligen Kurzschreibweisen:
Anwendbar aufalle Elemente
VererbtNein
Berechneter Wertwie die jeweiligen Kurzschreibweisen:
AnimationstypNot animatable

Formale Syntax

animation = 
<single-animation>#

<single-animation> =
<'animation-duration'> ||
<easing-function> ||
<'animation-delay-start'> ||
<single-animation-iteration-count> ||
<single-animation-direction> ||
<single-animation-fill-mode> ||
<single-animation-play-state> ||
[ none | <keyframes-name> ] ||
<single-animation-timeline>

<animation-duration> =
[ auto | <time [0s,∞]> ]#

<easing-function> =
<linear-easing-function> |
<cubic-bezier-easing-function> |
<step-easing-function>

<animation-delay-start> =
<time>#

<single-animation-iteration-count> =
infinite |
<number [0,∞]>

<single-animation-direction> =
normal |
reverse |
alternate |
alternate-reverse

<single-animation-fill-mode> =
none |
forwards |
backwards |
both

<single-animation-play-state> =
running |
paused

<keyframes-name> =
<custom-ident> |
<string>

<single-animation-timeline> =
auto |
none |
<dashed-ident> |
<scroll()> |
<view()>

<linear-easing-function> =
linear |
<linear()>

<cubic-bezier-easing-function> =
ease |
ease-in |
ease-out |
ease-in-out |
<cubic-bezier()>

<step-easing-function> =
step-start |
step-end |
<steps()>

<scroll()> =
scroll( [ <scroller> || <axis> ]? )

<view()> =
view( [ <axis> || <'view-timeline-inset'> ]? )

<linear()> =
linear( [ <number> && <percentage>{0,2} ]# )

<cubic-bezier()> =
cubic-bezier( [ <number [0,1]> , <number> ]#{2} )

<steps()> =
steps( <integer> , <step-position>? )

<scroller> =
root |
nearest |
self

<axis> =
block |
inline |
x |
y

<view-timeline-inset> =
[ [ auto | <length-percentage> ]{1,2} ]#

<integer> =
<number-token>

<step-position> =
jump-start |
jump-end |
jump-none |
jump-both |
start |
end

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

Beispiele

Hinweis: Von der Animation von Eigenschaften des CSS-Boxmodells wird abgeraten, da sie eine Neuberechnung des Layouts und ein erneutes Zeichnen auslöst. Die Animation einer Boxmodell-Eigenschaft ist grundsätzlich CPU-intensiv. Erwägen Sie stattdessen, die Eigenschaft transform zu animieren.

Grundlegende Verwendung: ein Sonnenaufgang

In diesem Beispiel zeigen wir die grundlegende Verwendung der Kurzschreibweise animation, indem wir eine gelbe Sonne über einen hellblauen Himmel animieren. Die Sonne steigt bis zur Mitte des Viewports auf und verschwindet dann wieder aus dem Blickfeld.

HTML

Wir verwenden ein einzelnes <div>-Element, das die Sonne darstellt.

html
<div class="sun"></div>

CSS

Zunächst erstellen wir die Sonne und den Himmel. Der Himmel ist das :root des HTML-Dokuments. Mit overflow auf hidden blenden wir alle Inhalte außerhalb des Viewports aus – in diesem Fall den Teil der Sonne unterhalb des Horizonts. Außerdem zentrieren wir die Sonne mit der Eigenschaft justify-content vor dem Hintergrund. Wir färben die Sonne gelb, setzen ihre height auf die Höhe des Viewports (100vh) und machen ihre Breite gleich ihrer Höhe, indem wir aspect-ratio auf 1 setzen. Mit der Eigenschaft border-radius verwandeln wir das quadratische <div> in einen Kreis.

css
:root {
  overflow: hidden;
  background-color: lightblue;
  display: flex;
  justify-content: center;
}

.sun {
  background-color: yellow;
  border-radius: 50%;
  height: 100vh;
  aspect-ratio: 1;
  animation: 4s linear 0s infinite alternate sunrise;
}

Als Nächstes definieren wir Animations-@keyframes, die das Element, auf das sie angewendet werden, mithilfe von CSS-Transformationen nach unten über den Viewport hinaus verschieben und dann an seine Ausgangsposition zurückführen:

css
@keyframes sunrise {
  from {
    transform: translateY(110vh);
  }
  to {
    transform: translateY(0);
  }
}

Zum Schluss wenden wir die Animation an. Mit der Kurzschreibweise animation wenden wir die Keyframe-Animation sunrise auf das .sun-<div> an. Die Animation wird unendlich oft wiederholt, wobei jeder Durchlauf 4 Sekunden dauert. Bei jedem Durchlauf wechselt die Animationsrichtung:

css
.sun {
  animation: 4s linear 0s infinite alternate sunrise;
}

Ergebnis

Mehrere Animationen anwenden

Dieses Beispiel zeigt, wie mehrere Animationen auf ein einzelnes Element angewendet werden. Aufbauend auf dem vorherigen Beispiel mit einer Sonne, die vor einem hellblauen Hintergrund auf- und untergeht, lassen wir die Sonne hier nach und nach durch die Farben des Regenbogens wechseln. Der zeitliche Ablauf von Position und Farbe der Sonne ist voneinander unabhängig.

Wir verwenden dasselbe HTML und CSS wie im vorherigen Beispiel und ergänzen einen zweiten Satz Animations-@keyframes. Dieser wendet einen filter an, der den Farbton mithilfe der Filterfunktion hue-rotate() durch alle möglichen Werte rotieren lässt:

css
@keyframes psychedelic {
  from {
    filter: hue-rotate(0deg);
  }
  to {
    filter: hue-rotate(360deg);
  }
}

Anschließend wenden wir beide Animationen auf die Sonne an. Mehrere Animationen werden durch Kommas getrennt; die Parameter jeder Animation werden unabhängig voneinander festgelegt:

css
.sun {
  animation:
    4s linear 0s infinite alternate sunrise,
    24s linear 0s infinite psychedelic;
}

Ergebnis

Kaskadierung mehrerer Animationen

Dieses Beispiel zeigt, was geschieht, wenn mehrere Animationen Werte für dieselbe Eigenschaft definieren. Es erweitert das Beispiel zur grundlegenden Verwendung um zwei Animationen, die beide einen Wert für transform festlegen.

Wir verwenden dasselbe HTML und CSS wie im ersten Beispiel, einschließlich der ursprünglichen Animation sunrise, und fügen eine zweite Animation namens bounce hinzu. Beide Animationen deklarieren Werte für dieselbe Eigenschaft:

css
@keyframes sunrise {
  from {
    transform: translateY(110vh);
  }
  to {
    transform: translateY(0);
  }
}

@keyframes bounce {
  from {
    transform: translateX(-50vw);
  }
  to {
    transform: translateX(50vw);
  }
}

Wir wenden beide Animationen auf die Sonne an. Wenn zwei Animationen unterschiedliche Werte auf dieselbe Eigenschaft anwenden, überschreiben später in der Kaskade deklarierte Animationen die zuvor deklarierten. In diesem Fall setzt sich der transform-Wert der Animation bounce in der Kaskade durch und überschreibt die von sunrise festgelegte Transformation. Deshalb bewegt sich die Sonne nur horizontal.

css
.sun {
  animation:
    4s linear 0s infinite alternate sunrise,
    4s linear 0s infinite alternate bounce;
}

Ergebnis

Die Sonne bewegt sich zwischen der linken und der rechten Seite des Viewports hin und her. Sie bleibt im Viewport, obwohl die Animation sunrise definiert ist. Der Wert für transform aus sunrise wird durch die Animation bounce überschrieben.

Spezifikationen

Spezifikation
CSS Animations Level 1
# animation

Browser-Kompatibilität

Siehe auch