Esta tradução está incompleta. Ajude atraduzir este artigo.
This article covers three tools you can use to visualize and edit animations:
Animation inspector
This page describes the Animation inspector as it appears in Firefox 48. Note that the example requires Firefox 47 or higher.
The Page Inspector's Animations view displays animations in the page synchronized along a timeline, with a draggable widget you can use to move to any point in the timeline and see the page at that point.
It displays animations created using CSS transitions, CSS @keyframes rules, or the Web Animations API. Starting in Firefox 48, it will show animations applied to the ::before
and ::after
pseudo-elements.
To see how it works, we'll walk through an example. The box below contains a grayscale icon, representing Firefox Developer Edition. If you click the icon, it enlarges and changes to color, and the name of the browser appears. Click the icon again to reverse the effect.
These animations are made using the Web Animations API.
Let's use the animation inspector to see what's going on in this example.
- Using Firefox 47 or later, right-click in the box and select "Inspect Element"
- Make sure the selected element is the
<div class="channel">
- Switch over to the "Animations" tab
- Play the animation
Let's take a closer look at the contents of the animation inspector here:
It shows a synchronized timeline for every animation applied to the selected element or its children. The timeline starts at the start of the first animation, ends at the end of the last animation, and is labeled with markers every 250 milliseconds (this depends on the time scale of the animations currently displayed).
Animation bars
Each animation or transition is shown as a horizontal bar laid across the timeline. The bar is:
- blue if a
transition
was used to animate a property - orange if a
@keyframes
animation was used - green if the Web Animations API was used
The bar contains a lightning bolt icon if the property was animated using the compositor thread (see more about the cost of animating different CSS properties).
If the animation used CSS transitions, there is one bar for each property transitioned, and it is labeled with the name of the property being transitioned. If the animation used CSS @keyframes
, there is one bar for each animation, labeled with its name.
If the animation or transition had a delay, this is shown as a cross-hatched portion of the bar. delay
and endDelay
are both represented.
If you hover over the bar, a tooltip appears, giving you more detailed information about the animation or transition, including:
- the type of animation: CSS transition, CSS animation, or Web Animations API
- the duration of the animation
- the animation's start and end delay
Information about the animated element
To the left of each bar is a selector for the element that the animation applies to. If you hover over this selector, the element is highlighted in the page. Click the selector to select the element in the inspector.
To the left of the selector is a "target" icon (). Clicking this icon will lock the highlighter on the element.
Animation details
If you click one of the bars, you'll see details of all the properties that were changed in the animation. For example, try clicking on the bar for img#icon
's animation:
This is telling us that two properties were modified: filter
and transform
. Each dot represents an entry for that property in the set of keyframes used for the animation. Both properties were initialized at 0ms and finalized at 750ms. filter
was given a value at 250ms and transform
at 500ms. If you hover over a dot, you'll see the value assigned to that property at that point in the timeline:
This is essentially a visual representation of the animation's keyframes:
var iconKeyframeSet = [
{ transform: 'scale(1)', filter: 'grayscale(100%)' },
{ filter: 'grayscale(100%)', offset: 0.333 },
{ transform: 'scale(1.5)', offset: 0.666 },
{ transform: 'scale(1.5)', filter: 'grayscale(0%)' }
];
Application to the example
Applying all this to our example, we can see that:
- The animation involved two elements,
span#note
andimg#icon
. Hovering over these selectors, we can see that those elements are, respectively, the browser name "Firefox Developer Edition" and the browser icon. - The
img#icon
animation: span#note
animation:
The
Further information about animation compositing
Firefox 49+ Only
In Firefox 49 and above, the information exposed by the Animation Inspector about animation performance/compositing has been improved. We've created a couple of examples to demonstrate this. If you open up animation-inspector-compositing.html and click the red rectangle, a simple opacity
animation will start. If you look at this in the Animation Inspector in Firefox 49+, you'll see that:
- The white lightning bolt icon now indicates whether all the animation properties have been optimized by running them through the compositor, where possible.
- The bar tooltip also includes this information, as a further reminder. You'll get a message of "All animation properties are optimized."
- The expanded animation information now includes a lightning bolt icon next to the properties whose animation has been optimized via the compositor.
Let's now look at animation-inspector-compositing-silly.html — this is the same example, except that now once the red rectangle is clicked we animate both the left
and transform
(with a translation) properties at the same time as opacity
. It doesn't make much sense to try to animate a geometric property and a translation at the same time — the two effects won't be synchronized — so the transform
property is deliberately not handed over to the compositor to handle. The Animation Inspector will rather helpfully tell you this in Firefox 49+ — look at it now and you'll see that:
- The white lightning bolt icon in the bar has been replaced with a grey lightning bolt icon, to indicate that only some of the relevant properties are being optimized by the compositor.
- The bar tooltip also includes this information, as a further reminder. You'll get a message of "Some animation properties are optimized."
- Properties whose animation is not being optimized, but could be if you improved your code, are now given a dotted underline — see transform in the screenshot below. Hovering over this gives you a tooltip that explains why. In this case, the message is "Animations of 'transform' cannot be run on the compositor when geometric properties are animated on the same element at the same time."
Animation playback
At the top of the animation inspector:
- there are buttons to play/pause and restart the animation
- there's a dropdown to change the animation playback rate
- the current time in the animation is displayed.
Finally, if you click inside the bar at the top of the timeline, you get a scrubber that you can drag left and right to move backwards and forwards through the animation, and pinpoint exactly what's happening when:
Edit @keyframes
Any @keyframes rules associated with the currently selected element are displayed in the Rules view and are editable:
Edit timing functions
When you create a CSS animation you can specify a timing function: this determines the rate at which the animation progresses. One way to specify the timing function is with a cubic Bézier curve.
Timing functions defined as cubic Bézier curves get an icon in the Rules view. If you click the icon you get a visual editor for the curve, enabling you to drag P1 and P2, and see the results in the page:
This feature uses open source code from Lea Verou’s cubic-bezier.com.
The cubic Bézier editor includes a number of presets, grouped under "Ease-in", "Ease-out", and "Ease-in-out":