1
2Experimental build targets
3--------------------------
4
5Most people should use the basic polyfill in `web-animations.min.js`. This
6tracks the Web Animations features that are supported natively in browsers.
7However, we also provide two additional build targets that contain experimental
8features.
9
10### web-animations-next.min.js
11
12Contains all of web-animations.min.js plus features that are still undergoing
13discussion or have yet to be implemented natively.
14
15### web-animations-next-lite.min.js
16
17A cut down version of web-animations-next, it removes several lesser used
18property handlers and some of the larger and less used features such as matrix
19interpolation/decomposition.
20
21Build target comparison
22-----------------------
23
24|                        | web-animations | web-animations-next | web-animations-next-lite |
25|------------------------|:--------------:|:-------------------:|:------------------------:|
26|Size (gzipped)          | 15KB           | 19KB                | 15KB                     |
27|Element.animate         | ✔             | ✔                  | ✔                       |
28|Timing input (easings, duration, fillMode, etc.) for animation effects| ✔ | ✔ | ✔             |
29|Playback control        | ✔             | ✔                  | ✔                       |
30|Support for animating lengths, transforms and opacity| ✔ | ✔ | ✔                       |
31|Support for animating other CSS properties| ✔ | ✔            | ��                       |
32|Matrix fallback for transform animations | ✔ | ✔             | ��                       |
33|KeyframeEffect constructor   | ��             | ✔                  | ✔                       |
34|Simple GroupEffects & SequenceEffects           | ��             | ✔                  | ✔                       |
35|Custom Effects          | ��             | ✔                  | ✔                       |
36|Timing input (easings, duration, fillMode, etc.) for groups</div>| �� | ��\* | ��         |
37|Additive animation      | ��\*           | ��\*                | ��                       |
38|Motion path             | ��\*           | ��\*                | ��                       |
39|Modifiable keyframe effect timing| ��          | ��\*                | ��\*                     |
40|Modifiable group timing | ��             | ��\*                | ��\*                     |
41|Usable inline style\*\* | ✔             | ✔                  | ��                       |
42
43\* support is planned for these features.
44\*\* see inline style caveat below.
45
46Caveat: Inline style
47--------------------
48
49Inline style modification is the mechanism used by the polyfill to animate
50properties. Both web-animations and web-animations-next incorporate a module
51that emulates a vanilla inline style object, so that style modification from
52JavaScript can still work in the presence of animations. However, to keep the
53size of web-animations-next-lite as small as possible, the style emulation
54module is not included. When using this version of the polyfill, JavaScript
55inline style modification will be overwritten by animations.
56Due to browser constraints inline style modification is not supported on iOS 7
57or Safari 6 (or earlier versions).
58
59