W3C home > Mailing lists > Public > public-fx@w3.org > October to December 2013

Re: [web-animations] Naming of timing groups in the API

From: Brian Birtles <bbirtles@mozilla.com>
Date: Wed, 06 Nov 2013 10:17:56 +0900
Message-ID: <527998C4.9020901@mozilla.com>
To: "public-fx@w3.org" <public-fx@w3.org>
Dear all,

I thought I'd open up this thread again.[1] Some people would like to 
write code samples for the Web Animations API and since we know ParGroup 
and SeqGroup are going to change names at some point, it would be good 
to try to fix them now or at least get them a little closer to their 
final naming before littering the Internet with incorrect naming like we 
did with flexbox.

Here's my latest suggestion:

   SyncGroup and SequenceGroup

Some explanation:

- SyncGroup is the old ParGroup. There was some concern about "Parallel" 
being unclear. Also, SyncGroup is four characters (~30%) shorter to type 
than "ParallelGroup".

- SequenceGroup is the old SeqGroup. It's longer, but the savings from 
SyncGroup go some way to compensating for this. It's more clear. 
'Sequence' alone is probably too generic since it already has other 
meanings (e.g. an array-like thing in WebIDL).

- I suggest when we map these to SVG we could use <sync> and <sequence> 
instead of <par> and <seq>. This is both to make life easier for authors 
working with markup and script and because 'par' and 'seq' are not 
obvious in meaning. Making the mapping to SVG straightforward is also 
why I've steered away from any name using 'set' or just 'group' since 
SVG already has <set> and <g> (=group).

- We *could* make SequenceGroup a subclass of SyncGroup but I think that 
can be a separate discussion and I'm not yet persuaded it's a good idea.

So in practice, code might look like:

document.timeline.play(
     new SyncGroup([
       new SequenceGroup([new Animation(...), new Animation(...)]),
       new Animation(...)
     ])
   );

And SVG code:

   <sync>
     <sequence>
       <animate ... />
       <animate ... />
     </sequence>
     <animate ... />
   </sync>

Thoughts?

Best regards,

Brian

[1] The original thread is here for anyone who lost it: 
http://lists.w3.org/Archives/Public/public-fx/2013JulSep/0115.html
Received on Wednesday, 6 November 2013 01:18:24 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 19:49:47 UTC