Skip to content

Commit 37129a9

Browse files
committed
[web-animations-1][web-animations-2] Tidy up effect stack definitions
Fixes w3c#8497.
1 parent 5f7361a commit 37129a9

File tree

2 files changed

+40
-35
lines changed

2 files changed

+40
-35
lines changed

web-animations-1/Overview.bs

Lines changed: 33 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -3777,38 +3777,40 @@ amongst other factors.
37773777

37783778
### The effect stack ### {#the-effect-stack}
37793779

3780-
Associated with each property <a lt="target property">targeted</a>
3781-
by one or more <a>keyframe effects</a> is an <dfn>effect
3782-
stack</dfn> that establishes the relative composite order of the <a>keyframe
3783-
effects</a>.
3780+
An <dfn>effect stack</dfn> is associated with each property
3781+
[=target property|targeted=] by one or more [=keyframe effects=].
3782+
The [=effect stack=] establishes the relative composite order of
3783+
[=keyframe effects=].
37843784

37853785
The relative
37863786
<dfn lt="animation composite order" local-lt="composite order" export>composite order</dfn>
3787-
of any two <a>keyframe effects</a>, <var>A</var> and <var>B</var>,
3788-
within an <a>effect stack</a> is
3787+
of any two [=keyframe effects=], |A| and |B|,
3788+
within an [=effect stack=] is
37893789
established by comparing their properties as follows:
37903790

3791-
1. Let the <dfn>associated animation of an animation effect</dfn>
3792-
be the <a>animation</a> <a
3793-
lt="associated with an animation">associated</a> with the
3794-
<a>animation effect</a> that affecting the property with which this
3795-
<a>effect stack</a> is associated.
3796-
2. Sort <var>A</var> and <var>B</var> by applying the following
3797-
conditions in turn until the order is resolved,
3798-
3799-
1. If <var>A</var> and <var>B</var>'s associated animations differ by
3800-
<a lt="animation class">class</a>, sort by any inter-class composite
3801-
order defined for the corresponding classes.
3802-
1. If <var>A</var> and <var>B</var> are still not sorted,
3803-
sort by any <a lt="animation class">class</a>-specific composite order
3804-
defined by the common class of <var>A</var> and <var>B</var>'s
3805-
associated animations.
3806-
1. If <var>A</var> and <var>B</var> are still not sorted,
3807-
sort by their corresponding position in the <a>global animation
3808-
list</a>.
3809-
3810-
<a>Animation effects</a> that sort earlier have <em>lower</em>
3811-
composite order.
3791+
1. Let the <dfn for="animation effect"
3792+
lt="associated animation">associated animation of an animation effect</dfn>
3793+
be the [=animation=] [=associated with an animation|associated=]
3794+
with the [=animation effect=].
3795+
3796+
1. Sort |A| and |B| by applying the following conditions in turn until the
3797+
order is resolved,
3798+
3799+
1. If |A| and |B|'s [=animation effect/associated animations=] differ
3800+
by [=animation class|class=],
3801+
sort by any inter-class composite order defined
3802+
for the corresponding classes.
3803+
3804+
1. If |A| and |B| are still not sorted,
3805+
sort by any [=animation class|class=]-specific composite order
3806+
defined by the common class of |A| and |B|'s
3807+
[=animation effect/associated animations=].
3808+
3809+
1. If |A| and |B| are still not sorted,
3810+
sort by the position of their [=animation effect/associated animations=]
3811+
in the [=global animation list=].
3812+
3813+
[=Animation effects=] that sort earlier have <em>lower</em> composite order.
38123814

38133815
### Calculating the result of an effect stack ### {#calculating-the-result-of-an-effect-stack}
38143816

@@ -3867,8 +3869,8 @@ Applying a <a>composited value</a> to a <a>target property</a>
38673869
is achieved by adding a specified value to the CSS cascade.
38683870

38693871
The level of the cascade to which this specified value is added
3870-
depends on the <a lt="animation class">class</a> of the <a>animation</a> <a
3871-
lt="associated animation of an animation effect">associated with</a> the
3872+
depends on the <a lt="animation class">class</a> of the <a>animation</a>
3873+
[=animation effect/associated animation|associated with=] the
38723874
effect with the highest composite order in the <a>effect stack</a> for a given
38733875
property.
38743876
By default, the specified value is added to the "Animation
@@ -3896,8 +3898,8 @@ property</a> is applied using the following process.
38963898
[[#calculating-the-result-of-an-effect-stack]]).
38973899
4. Insert the <a>composited value</a> into the CSS cascade at the
38983900
level defined for the <a lt="animation class">class</a> of the
3899-
<a>animation</a> <a
3900-
lt="associated animation of an animation effect">associated with</a> the
3901+
<a>animation</a>
3902+
[=animation effect/associated animation|associated with=] the
39013903
effect at the top of the <a>effect stack</a> established for the target
39023904
property.
39033905

web-animations-2/Overview.bs

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -53,15 +53,13 @@ dl.switch > dt > ul > li {
5353

5454
<pre class='metadata'>
5555
Title: Web Animations Level 2
56-
Status: FPWD
57-
Prepare for TR: yes
58-
Date: 2023-02-21
56+
Status: ED
5957
Warning: not ready
6058
Work Status: Exploring
6159
Shortname: web-animations
6260
ED: https://drafts.csswg.org/web-animations-2/
6361
TR: https://www.w3.org/TR/web-animations-2/
64-
Version history: https://github.com/w3c/csswg-drafts/commits/master/web-animations-1
62+
Version history: https://github.com/w3c/csswg-drafts/commits/master/web-animations-2
6563
Level: 2
6664
6765
Group: csswg
@@ -2000,6 +1998,11 @@ The procedure for sorting effects appends the following step:
20001998
> same <a>animation</a> since otherwise the order would have been
20011999
> resolved in the previous step.)
20022000

2001+
Issue: The "associated animation of an animation effect" definition used when
2002+
sorting animation effects needs to be revised to use the [=associated with an
2003+
animation=] definition introduced in this level of the specification so that it
2004+
correctly handles group effects.
2005+
20032006
<h3 id="effect-accumulation-section">Effect accumulation</h3>
20042007

20052008
Similar to the compositing performed between <a>effect values</a>

0 commit comments

Comments
 (0)