WIP - Pinpoint - New Page.

third_party/polymer/components/web-animations-js/docs/experimental.md

Index: third_party/polymer/components/web-animations-js/docs/experimental.md
diff --git a/third_party/polymer/components/web-animations-js/docs/experimental.md b/third_party/polymer/components/web-animations-js/docs/experimental.md
new file mode 100644
index 0000000000000000000000000000000000000000..e3f228985c306e71868955e894c2a5169f8c03e5
--- /dev/null
+++ b/third_party/polymer/components/web-animations-js/docs/experimental.md
@@ -0,0 +1,58 @@
+
+Experimental build targets
+--------------------------
+
+Most people should use the basic polyfill in `web-animations.min.js`. This
+tracks the Web Animations features that are supported natively in browsers.
+However, we also provide two additional build targets that contain experimental
+features.
+
+### web-animations-next.min.js
+
+Contains all of web-animations.min.js plus features that are still undergoing
+discussion or have yet to be implemented natively.
+
+### web-animations-next-lite.min.js
+
+A cut down version of web-animations-next, it removes several lesser used
+property handlers and some of the larger and less used features such as matrix
+interpolation/decomposition.
+
+Build target comparison
+-----------------------
+
+|                        | web-animations | web-animations-next | web-animations-next-lite |
+|------------------------|:--------------:|:-------------------:|:------------------------:|
+|Size (gzipped)          | 15KB           | 19KB                | 15KB                     |
+|Element.animate         | ✔             | ✔                  | ✔                       |
+|Timing input (easings, duration, fillMode, etc.) for animation effects| ✔ | ✔ | ✔             | 
+|Playback control        | ✔             | ✔                  | ✔                       |
+|Support for animating lengths, transforms and opacity| ✔ | ✔ | ✔                       |
+|Support for animating other CSS properties| ✔ | ✔            | 🚫                       |
+|Matrix fallback for transform animations | ✔ | ✔             | 🚫                       |
+|KeyframeEffect constructor   | 🚫             | ✔                  | ✔                       |
+|Simple GroupEffects & SequenceEffects           | 🚫             | ✔                  | ✔                       |
+|Custom Effects          | 🚫             | ✔                  | ✔                       |
+|Timing input (easings, duration, fillMode, etc.) for groups</div>| 🚫 | 🚫\* | 🚫         |
+|Additive animation      | 🚫\*           | 🚫\*                | 🚫                       |
+|Motion path             | 🚫\*           | 🚫\*                | 🚫                       |
+|Modifiable keyframe effect timing| 🚫          | 🚫\*                | 🚫\*                     |
+|Modifiable group timing | 🚫             | 🚫\*                | 🚫\*                     |
+|Usable inline style\*\* | ✔             | ✔                  | 🚫                       |
+
+\* support is planned for these features.
+\*\* see inline style caveat below.
+
+Caveat: Inline style
+--------------------
+
+Inline style modification is the mechanism used by the polyfill to animate
+properties. Both web-animations and web-animations-next incorporate a module
+that emulates a vanilla inline style object, so that style modification from
+JavaScript can still work in the presence of animations. However, to keep the
+size of web-animations-next-lite as small as possible, the style emulation
+module is not included. When using this version of the polyfill, JavaScript
+inline style modification will be overwritten by animations.
+Due to browser constraints inline style modification is not supported on iOS 7
+or Safari 6 (or earlier versions).
+