Nossos voluntários ainda não traduziram este artigo para o Português (do Brasil) . Junte-se a nós e ajude a fazer o trabalho!
This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.
Summary
The @keyframes
CSS at-rule lets authors control the intermediate steps in a CSS animation sequence by establishing keyframes (or waypoints) along the animation sequence that must be reached by certain points during the animation. This gives you more specific control over the intermediate steps of the animation sequence than you'd get when letting the browser handle everything automatically.
The @keyframes
at-rule can be accessed via the CSS object model interface CSSKeyframesRule
.
To use keyframes, you create a @keyframes
rule with a name that is then used by the animation-name
property to match an animation to its keyframe list. Each @keyframes
rule contains a style list of keyframe selectors, each of which comprises a percentage along the animation at which the keyframe occurs as well as a block containing the style information for that keyframe.
You can list the keyframes in any order; they will be handled in the order in which their specified percentages indicate they should occur.
Valid keyframe lists
In order for a keyframe list to be valid, it must include rules for at least the times 0%
(or from
) and 100%
(or to
) (that is, the starting and ending states of the animation). If both of these time offsets aren't specified, the keyframe declaration is invalid; as such, it will be ignored by the parser and can't be used for animation.
If you include properties that can't be animated in your keyframe rules they get ignored, but supported properties will still be animated.
Duplicate resolution
If multiple keyframe sets exist for a given name, the last one encountered by the parser is used. @keyframes
rules don't cascade, so animations never derive keyframes from more than one rule set.
If a given animation time offset is duplicated, the last keyframe in the @keyframes
rule for that percentage is used for that frame. There's no cascading within a @keyframes
rule if multiple keyframes specify the same percentage values.
When properties are left out of some keyframes
Properties that aren't specified in every keyframe are interpolated (excepting those that can't be interpolated, which are dropped from the animation entirely). For example:
@keyframes identifier { 0% { top: 0; left: 0; } 30% { top: 50px; } 68%, 72% { left: 50px; } 100% { top: 100px; left: 100%; } }
Here, the top
property animates using the 0%
, 30%
, and 100%
keyframes, and left
animates using the 0%
, 68%
, and 100%
keyframes.
Only properties that are specified in both the 0%
and 100%
keyframes will be animated; any property not included in both of those keyframes will retain their starting value for the duration of the animation sequence.
When a keyframe is defined multiple times
The specification defines that if a keyframe is defined multiple times but not all properties affected are specified in each keyframe, only the values specified in the latest keyframe are considered. For example:
@keyframes identifier { 0% { top: 0; } 50% { top: 30px; left: 20px; } 50% { top: 10px; } 100% { top: 0; } }
In this example, at the 50%
keyframe, the value used is top: 10px
and all other values at this keyframe are ignored.
Cascading keyframes are supported starting in Firefox 14. For the example above, it means that at the 50%
keyframe, the value left: 20px
will be considered. This is not defined in the specification yet, but it is being discussed.
!important in a keyframe
Declarations in a keyframe that are qualified with !important
are ignored
@keyframes important1 { from { margin-top: 50px; } 50% { margin-top: 150px !important; } /* ignored */ to { margin-top: 100px; } } @keyframes important2 { from { margin-top: 50px; margin-bottom: 100px; } to { margin-top: 150px !important; /* ignored */ margin-bottom: 50px; } }
Syntax
Values
<identifier>
- A name identifying the keyframe list. This must match the identifier production in CSS syntax.
from
- A starting offset of
0%
. to
- An ending offset of
100%
. <percentage>
- A percentage of the time through the animation sequence at which the specified keyframe should occur.
Formal syntax
@keyframes <keyframes-name> { <keyframe-block-list> }where
<keyframes-name> = <custom-ident> | <string>
<keyframe-block-list> = <keyframe-block>+where
<keyframe-block> = <keyframe-selector># { <declaration-list> }
where
<keyframe-selector> = from | to | <percentage>
Examples
See CSS animations for examples.
Specifications
Specification | Status | Comment |
---|---|---|
CSS Animations The definition of '@keyframes' in that specification. |
Working Draft |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support |
(Yes)-webkit |
5.0 (5.0)-moz 16.0 (16.0) |
10 | 12 -o 12.10 # |
4.0-webkit |
ignore !important declarations |
? | 19 (19) | ? | ? | ? |
Feature | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | (Yes)-webkit | 5.0 (5.0)-moz 16.0 (16.0) |
? | ? | ? |
ignore !important declarations |
? | 19.0 (19) | ? | ? | ? |
Notes
- @keyframes not supported in an inline or scoped stylesheet in Firefox (bug 830056).