Skip to content

Commit 4eaebbd

Browse files
committed
[web-animations-1] Factor out relevant animation definitions
Fixes w3c#8001.
1 parent 3a22e00 commit 4eaebbd

File tree

1 file changed

+37
-20
lines changed

1 file changed

+37
-20
lines changed

web-animations-1/Overview.bs

Lines changed: 37 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -2402,6 +2402,39 @@ An animation effect is <dfn>in effect</dfn> if its <a>active time</a>, as
24022402
calculated according to the procedure in [[#calculating-the-active-time]],
24032403
is <em>not</em> <a>unresolved</a>.
24042404

2405+
### Relevant animations ### {#relevant-animations-section}
2406+
2407+
We may define an [=animation=] as being [=relevant=]
2408+
based on the [=animation effect=] [=associated effect|associated=] with it.
2409+
2410+
An [=animation=] is <dfn for=animation export>relevant</dfn> if:
2411+
2412+
* Its [=associated effect=] is [=current=] <em>or</em> [=in effect=],
2413+
<em>and</em>
2414+
* Its [=replace state=] is <em>not</em> [=removed replace state|removed=].
2415+
2416+
<div algorithm="get relevant animations">
2417+
2418+
The <dfn export>relevant animations</dfn>
2419+
for an element or pseudo-element, |target|,
2420+
is the set of all [=animations=] that contain at least one [=animation effect=]
2421+
whose [=effect target=] is |target|.
2422+
2423+
</div>
2424+
2425+
<div algorithm="get relevant animations for a subtree">
2426+
2427+
The <dfn export>relevant animations for a subtree</dfn>
2428+
of an element, pseudo-element, [=document=], or [=shadow root=]—|target|—is
2429+
the set of all [=animations=] that contain at least one [=animation effect=]
2430+
whose [=effect target=] is an [=inclusive descendant=]
2431+
(or [=descendant=] if |target| is a [=document=] or [=shadow root=])
2432+
of |target|
2433+
or a [=pseudo-element=] of such a descendant.
2434+
2435+
</div>
2436+
2437+
24052438
Fill behavior {#fill-behavior}
24062439
----------------------------------------
24072440

@@ -5934,24 +5967,10 @@ animation.play();</pre>
59345967

59355968
: <dfn method for=Animatable lt="getAnimations(options)">
59365969
sequence&lt;Animation&gt; getAnimations(options)</dfn>
5937-
:: Returns the set of [=relevant=] {{Animation}} objects
5938-
that contain at least one <a>animation effect</a> whose
5939-
[=effect target=] is this object, or,
5970+
:: Returns the set of [=relevant animations=] for this object, or,
59405971
if an {{Animatable/getAnimations(options)/options}} parameter
59415972
is passed with {{GetAnimationsOptions/subtree}} set to true,
5942-
an [=inclusive descendant=] of this object or a [=pseudo-element=]
5943-
of such a descendant.
5944-
5945-
An [=animation=] is
5946-
<dfn lt="relevant animation" local-lt="relevant" export>relevant</dfn> if:
5947-
5948-
* Its [=associated effect=] is [=current=] <em>or</em> [=in effect=],
5949-
<em>and</em>
5950-
* Its [=replace state=] is <em>not</em> [=removed replace state|removed=].
5951-
5952-
For the purposes of this method
5953-
a [=pseudo-element=] is considered to be
5954-
a [=child=] of its [=originating element=].
5973+
returns the set of [=relevant animations for a subtree=] for this object.
59555974

59565975
The returned list is sorted using the composite order described
59575976
for the associated <a>animations</a> of effects in [[#the-effect-stack]].
@@ -6027,10 +6046,8 @@ partial interface mixin DocumentOrShadowRoot {
60276046

60286047
: <dfn method for=DocumentOrShadowRoot lt='getAnimations()'>
60296048
sequence&lt;Animation&gt; getAnimations()</dfn>
6030-
:: Returns the set of [=relevant=] {{Animation}} objects
6031-
that have an associated <a>associated effect</a>
6032-
whose <a>target element</a> is a <a>descendant</a> of
6033-
the [=document=] or [=shadow root=]
6049+
:: Returns the set of [=relevant animations for a subtree=]
6050+
for the [=document=] or [=shadow root=]
60346051
on which this method is called.
60356052

60366053
The returned list is sorted using the composite order described

0 commit comments

Comments
 (0)