8000 [web-animations-1][editorial] A few more double quotes and dfn fixes. · Nlicroshan/csswg-drafts@fb20b41 · GitHub
Skip to content

Commit fb20b41

Browse files
committed
[web-animations-1][editorial] A few more double quotes and dfn fixes.
1 parent bb9a504 commit fb20b41

File tree

1 file changed

+41
-42
lines changed

1 file changed

+41
-42
lines changed

web-animations-1/Overview.bs

Lines changed: 41 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -327,7 +327,7 @@ elem.animate({ transform: 'scale(0)', opacity: 0 }, 300);
327327
element arrived in its present state.
328328
The Web Animations programming interface may be used to inspect
329329
running animations to answer questions such as,
330-
“Why is the opacity of this element changing?”
330+
"Why is the opacity of this element changing?"
331331

332332
<div class='example'>
333333
<pre class='lang-javascript'>
@@ -412,7 +412,7 @@ the Web Animations model, the dependency between SVG and SMIL
412412
Animation can be removed.
413413

414414
As with <a>animation frame callbacks</a> (commonly referred
415-
to as &ldquo;requestAnimationFrame&rdquo;) [[HTML]],
415+
to as "requestAnimationFrame") [[HTML]],
416416
the programming interface component of this specification allows
417417
animations to be created from script.
418418
The animations created using the interface defined in this
@@ -452,8 +452,8 @@ updating these properties such as the procedure to [=set the playback rate=] or
452452
the procedure to [=set the start time=] of an animation.
453453

454454
Where this specification does not specifically link to a procedure, text
455-
that requires the user agent to update a property such as, &ldquo;make
456-
|animation|'s [=start time=] [=unresolved=]&rdquo;, should be understood to
455+
that requires the user agent to update a property such as, "make
456+
|animation|'s [=start time=] [=unresolved=]", should be understood to
457457
refer to updating the property directly <em>without</em> invoking any related
458458
procedure.
459459

@@ -630,7 +630,7 @@ A <dfn export>timeline</dfn> provides a source of <a>time values</a> for the
630630
purpose of synchronization.
631631

632632
At any given moment, a [=timeline=] has a single current [=time value=] known
633-
simply as the timeline's <dfn lt="timeline current time">current time</dfn>.
633+
simply as the timeline's <dfn export for=timeline lt="timeline current time|current time">current time</dfn>.
634634

635635
A <a>timeline</a> is <dfn export lt="monotonically increasing timeline"
636636
local-lt="monotonically increasing">monotonically increasing</dfn> if its
@@ -723,23 +723,22 @@ A [=timeline=] may be in one of four possible
723723
1. <dfn export for=timeline lt="timeline after phase|after phase">after</dfn>
724724

725725
A [=timeline=] in the [=timeline inactive phase|inactive phase=] can
726-
also be called an <dfn>inactive timeline</dfn>
726+
also be called an <dfn export>inactive timeline</dfn>
727727

728728
An [=inactive timeline=] has an [=unresolved=]
729729
[=timeline current time|current time=].
730730

731731
### Document timelines ### {#document-timelines}
732732

733-
A <dfn>document timeline</dfn> is a type of <a>timeline</a> that is <a
733+
A <dfn export>document timeline</dfn> is a type of <a>timeline</a> that is <a
734734
lt="timeline associated with a document">associated
735735
with a document</a> and whose <a lt="timeline current time">current time</a>
736736
is calculated as a fixed offset from the |now| timestamp provided each time the
737737
[=update animations and send events=] procedure is run.
738-
This fixed offset is referred to as the document timeline's <dfn>origin
739-
time</dfn>.
738+
This fixed offset is referred to as the document timeline's <dfn>origin time</dfn>.
740739

741-
Issue(2079): There must be a better term than &ldquo;origin time&rdquo;&mdash;
742-
it's too similar to &ldquo;time origin&rdquo;.
740+
Issue(2079): There must be a better term than "origin time"&mdash;
741+
it's too similar to "time origin".
743742

744743

745744
The [=timeline phase|phase=] of a <a>document timeline</a> at a given moment is
@@ -805,37 +804,37 @@ The relationship between an animation and an <a>animation effect</a> is
805804
analogous to that of a DVD player and a DVD.
806805
</div>
807806

808-
An <dfn id="concept-animation">animation</dfn> connects a single <a>animation
809-
effect</a>, called its <dfn>associated effect</dfn>, to a <a>timeline</a> and
807+
An <dfn export id="concept-animation">animation</dfn> connects a single <a>animation
808+
effect</a>, called its <dfn export for=animation>associated effect</dfn>, to a <a>timeline</a> and
810809
provides playback control.
811810
Both of these associations are optional and configurable such that
812811
an <a>animation</a> may have no <a>associated effect</a> or
813812
<a>timeline</a> at a given moment.
814813

815-
An [=animation's=] <dfn>document for timing</dfn> is the {{Document}} with which
814+
An [=animation's=] <dfn export for=animation>document for timing</dfn> is the {{Document}} with which
816815
its [=timeline=] is <a lt="timeline associated with a document">associated</a>.
817816
If an animation is not associated with a timeline, or its timeline is not
818817
associated with a document, then it has no [=document for timing=].
819818

820-
An <a>animation</a>'s <dfn>start time</dfn> is the
819+
An <a>animation</a>'s <dfn export for=animation>start time</dfn> is the
821820
<a>time value</a> of its <a>timeline</a> when its <a>associated effect</a>
822821
is scheduled to begin playback.
823822
An animation's start time is initially <a>unresolved</a>.
824823

825-
An <a>animation</a> also maintains a <dfn>hold time</dfn> <a>time value</a>
824+
An <a>animation</a> also maintains a <dfn export for=animation>hold time</dfn> <a>time value</a>
826825
which is used to fix the animation's output <a>time value</a>, called its
827826
<a>current time</a>, in circumstances such as pausing.
828827
The <a>hold time</a> is initially <a>unresolved</a>.
829828

830829
In order to establish the relative ordering of conflicting <a>animations</a>,
831-
animations are appended to a <dfn>global animation list</dfn> in the order
830+
animations are appended to a <dfn export>global animation list</dfn> in the order
832831
in which they are created. Certain <a lt="animation class">classes of
833832
animations</a>, however, may provide alternative means of ordering animations
834833
(see [[#animation-classes]]).
835834

836835
### Setting the timeline of an animation ### {#setting-the-timeline}
837836

838-
The procedure to <dfn>set the timeline of an animation</dfn>,
837+
The procedure to <dfn export for=animation>set the timeline of an animation</dfn>,
839838
<var>animation</var>, to <var>new timeline</var> which may be null, is as
840839
follows:
841840

@@ -849,7 +848,7 @@ follows:
849848
<a>unresolved</a>.
850849

851850
Note: This step ensures that the <a>finished play state</a> of
852-
<var>animation</var> is not &ldquo;sticky&rdquo; but is re-evaluated
851+
<var>animation</var> is not "sticky" but is re-evaluated
853852
based on its updated <a>current time</a>.
854853

855854
1. Run the procedure to <a>update an animation's finished state</a> for
@@ -858,7 +857,7 @@ follows:
858857

859858
<h4 id="setting-the-associated-effect" oldids="setting-the-target-effect">Setting the associated effect of an animation</h4>
860859

861-
The procedure to <dfn>set the associated effect of an animation</dfn>,
860+
The procedure to <dfn export for=animation>set the associated effect of an animation</dfn>,
862861
<var>animation</var>, to <var>new effect</var> which may be null, is as
863862
follows:
864863

@@ -882,7 +881,7 @@ follows:
882881
<var>animation</var> with the <var>did seek</var> flag set to false, and
883882
the <var>synchronously notify</var> flag set to false.
884883

885-
The procedure to <dfn>reset an animation's pending tasks</dfn> for
884+
The procedure to <dfn export for=animation>reset an animation's pending tasks</dfn> for
886885
<var>animation</var> is as follows:
887886

888887
1. If <var>animation</var> does not have a <a>pending play task</a> or a
@@ -902,7 +901,7 @@ The procedure to <dfn>reset an animation's pending tasks</dfn> for
902901
### The current time of an animation ### {#the-current-time-of-an-animation}
903902

904903
<a>Animations</a> provide a <a>time value</a> to their <a>associated
905-
effect</a> called the animation's <dfn>current time</dfn>.
904+
effect</a> called the animation's <dfn export for=animation>current time</dfn>.
906905

907906
The <a>current time</a> is calculated from the first
908907
matching condition from below:
@@ -941,7 +940,7 @@ The <a>current time</a> of an animation can be set to a new value to
941940
<em>seek</em> the animation.
942941
The procedure for setting the current time is defined in two parts.
943942

944-
The procedure to <dfn>silently set the current time</dfn> of
943+
The procedure to <dfn export for=animation>silently set the current time</dfn> of
945944
an animation, <var>animation</var>, to <var>seek time</var> is as follows:
946945

947946
1. If <var>seek time</var> is an <a>unresolved</a> time value,
@@ -990,7 +989,7 @@ an animation, <var>animation</var>, to <var>seek time</var> is as follows:
990989

991990
4. Make <var>animation</var>'s <a>previous current time</a> <a>unresolved</a>.
992991

993-
The procedure to <dfn>set the current time</dfn> of an animation,
992+
The procedure to <dfn export for=animation>set the current time</dfn> of an animation,
994993
<var>animation</var>, to <var>seek time</var> is as follows:
995994

996995
1. Run the steps to <a>silently set the current time</a> of
@@ -2037,7 +2036,7 @@ condition from the following:
20372036
<div class="note">
20382037

20392038
Note that the <a>paused play state</a> effectively
2040-
&ldquo;wins&rdquo; over the <a>finished play state</a>.
2039+
"wins" over the <a>finished play state</a>.
20412040

20422041
However, an animation that is paused outside of its natural playback range can
20432042
be converted from a <a lt="paused play state">paused</a>
@@ -5592,8 +5591,8 @@ keyframes using the following procedure:
55925591

55935592
1. Let <var>property name</var> be the key for <var>m</var>.
55945593

5595-
1. If <var>property name</var> is &ldquo;composite&rdquo;, or
5596-
&ldquo;easing&rdquo;, or &ldquo;offset&rdquo;, skip the
5594+
1. If <var>property name</var> is "composite", or
5595+
"easing", or "offset", skip the
55975596
remaining steps in this loop and continue from the next member
55985597
in <var>property-indexed keyframe</var> after <var>m</var>.
55995598

@@ -5627,16 +5626,16 @@ keyframes using the following procedure:
56275626

56285627
1. Let <var>offsets</var> be a sequence of <a>nullable</a>
56295628
<code>double</code> values assigned based on the type of the
5630-
&ldquo;offset&rdquo; member of the <var>property-indexed
5629+
"offset" member of the <var>property-indexed
56315630
keyframe</var> as follows:
56325631

56335632
<div class="switch">
56345633

56355634
: <code>sequence&lt;double?&gt;</code>,
5636-
:: The value of &ldquo;offset&rdquo; as-is.
5635+
:: The value of "offset" as-is.
56375636

56385637
: <code>double?</code>,
5639-
:: A sequence of length one with the value of &ldquo;offset&rdquo;
5638+
:: A sequence of length one with the value of "offset"
56405639
as its single item, i.e.
56415640
&laquo;&nbsp;<code>offset</code>&nbsp;&raquo;,
56425641

@@ -5648,23 +5647,23 @@ keyframes using the following procedure:
56485647
reached.
56495648

56505649
1. Let <var>easings</var> be a sequence of <code>DOMString</code>
5651-
values assigned based on the type of the &ldquo;easing&rdquo; member
5650+
values assigned based on the type of the "easing" member
56525651
of the <var>property-indexed keyframe</var> as follows:
56535652

56545653
<div class="switch">
56555654

56565655
: <code>sequence&lt;DOMString&gt;</code>,
5657-
:: The value of &ldquo;easing&rdquo; as-is.
5656+
:: The value of "easing" as-is.
56585657

56595658
: <code>DOMString</code>,
5660-
:: A sequence of length one with the value of &ldquo;easing&rdquo;
5659+
:: A sequence of length one with the value of "easing"
56615660
as its single item, i.e.
56625661
&laquo;&nbsp;<code>easing</code>&nbsp;&raquo;,
56635662

56645663
</div>
56655664

56665665
1. If <var>easings</var> is an empty sequence, let it be a sequence
5667-
of length one containing the single D576 value &ldquo;linear&rdquo;, i.e.
5666+
of length one containing the single value "linear", i.e.
56685667
&laquo;&nbsp;"linear"&nbsp;&raquo;.
56695668

56705669
1. If <var>easings</var> has fewer items than <var>processed
@@ -5687,20 +5686,20 @@ keyframes using the following procedure:
56875686
easings</var>.
56885687

56895688
1. Assign each value in <var>easings</var> to a property named
5690-
&ldquo;easing&rdquo; on the <a>keyframe</a> with the corresponding
5689+
"easing" on the <a>keyframe</a> with the corresponding
56915690
position in <var>processed keyframes</var> until the end of
56925691
<var>processed keyframes</var> is reached.
56935692

5694-
1. If the &ldquo;composite&rdquo; member of the <var>property-indexed
5693+
1. If the "composite" member of the <var>property-indexed
56955694
keyframe</var> is <em>not</em> an empty sequence:
56965695

56975696
1. Let <var>composite modes</var> be a sequence of
56985697
{{CompositeOperationOrAuto}} values assigned from the
5699-
&ldquo;composite&rdquo; member of <var>property-indexed
5698+
"composite" member of <var>property-indexed
57005699
keyframe</var>.
57015700
If that member is a single {{CompositeOperationOrAuto}} value
57025701
operation</a>, let <var>composite modes</var> be a sequence of
5703-
length one, with the value of the &ldquo;composite&rdquo; as its
5702+
length one, with the value of the "composite" as its
57045703
single item.
57055704

57065705
1. As with <var>easings</var>, if <var>composite modes</var>
@@ -5740,18 +5739,18 @@ keyframes using the following procedure:
57405739
property value.
57415740

57425741
1. Let the <a>timing function</a> of <var>frame</var> be the result of
5743-
parsing the &ldquo;easing&rdquo; property on <var>frame</var> using the
5742+
parsing the "easing" property on <var>frame</var> using the
57445743
CSS syntax defined for the {{EffectTiming/easing}} member of the
57455744
{{EffectTiming}} dictionary.
57465745

5747-
If parsing the &ldquo;easing&rdquo; property fails, <a>throw</a> a
5746+
If parsing the "easing" property fails, <a>throw</a> a
57485747
<span class=exceptionname>TypeError</span> and abort this procedure.
57495748

57505749
Note: Using the CSS parser in both of the above steps implies that CSS
57515750
comments and escaping are allowed but are not retained when the value
57525751
is successfully parsed.
57535752

5754-
Note: In the case where the &ldquo;easing&rdquo; property fails to
5753+
Note: In the case where the "easing" property fails to
57555754
parse, it is important that the <span
57565755
class=exceptionname>TypeError</span> is thrown <em>after</em> all
57575756
reading the properties from <var>object</var> since failing to do so
@@ -6353,7 +6352,7 @@ Acknowledgements {#acknowledgements}
63536352
Thank you to Steve Block, Michael Giuffrida, Ryan Seys, and Eric Willigers
63546353
for their contributions to this specification.
63556354

6356-
Thank you also to Michiel &ldquo;Pomax&rdquo; Kamermans for help with the
6355+
Thank you also to Michiel "Pomax" Kamermans for help with the
63576356
equations for a proposed smooth timing function although this feature
63586357
has been deferred to a subsequent specification.
63596358

0 commit comments

Comments
 (0)