[css-houdini-drafts] [css-animationworklet] Consider reworking 'Interaction with Animator Instances' section (#870)

• From: Stephen McGruer via GitHub <sysbot+gh@w3.org>
• Date: Thu, 28 Mar 2019 13:58:40 +0000
• To: public-houdini-archive@w3.org
• Message-ID: <issues.opened-426507567-1553781518-sysbot+gh@w3.org>

stephenmcgruer has just created a new issue for https://github.com/w3c/css-houdini-drafts:

== [css-animationworklet] Consider reworking 'Interaction with Animator Instances' section ==
It is quite hard to find the "override" behavior specified in the '[Interaction with Animator Instances](https://drafts.css-houdini.org/css-animationworklet/#worklet-animation-animator-instances)' section:

> When a given workletAnimation’s play state changes to pending, running, or paused, run the procedure to associate animator instance of worklet animation given workletAnimation.
> 
> When a given workletAnimation’s play state changes to idle or finished, run the procedure to disassociate animator instance of worklet animation given workletAnimation.
> 
> When the procedure to set the target effect of an animation for a given workletAnimation is called, then set animator instance of worklet animation given workletAnimation.
> 
> When the procedure to set the timeline of an animation for a given workletAnimation is called, then set animator instance of worklet animation given workletAnimation.

For example, when reading [Creating a Worklet Animation](https://drafts.css-houdini.org/css-animationworklet/#creating-worklet-animation), step 4:

> Run the procedure to [set the target effect of an animation](https://w3c.github.io/web-animations/#set-the-target-effect-of-an-animation) on workletAnimation passing effect as the new effect.

It is difficult-to-impossible for a naive reader to realize that this step actually *also* sets the animator instance, as it is not mentioned in either the text or the link.

My suggestions would be to:

- Clearly mark the area where we override Web Animations concepts as 'extensions to Web Animations APIs' or similar, and
- From the AnimationWorklet spec at least, link to **that** section rather than the Web Animations API where appropriate (e.g. in the WorkletAnimation creation steps).

Please view or discuss this issue at https://github.com/w3c/css-houdini-drafts/issues/870 using your GitHub account

Received on Thursday, 28 March 2019 13:58:41 UTC