[css-animations] Define the term "animation properties" and also cite the rules on list matching in the definition of the animation shorthand.

Wed, 22 Jan 2014 16:54:50 -0800

author
L. David Baron <dbaron@dbaron.org>
date
Wed, 22 Jan 2014 16:54:50 -0800
changeset 9776
deda8e62bf11
parent 9775
cf1ae0fbbaa5
child 9777
94b61951036a

[css-animations] Define the term "animation properties" and also cite the rules on list matching in the definition of the animation shorthand.

Fixes the remainder of http://lists.w3.org/Archives/Public/www-style/2011Oct/0408.html which was partly fixed by the previous commit.

css-animations/Overview.html file | annotate | diff | comparison | revisions
css-animations/Overview.src.html file | annotate | diff | comparison | revisions
     1.1 --- a/css-animations/Overview.html	Wed Jan 22 16:48:34 2014 -0800
     1.2 +++ b/css-animations/Overview.html	Wed Jan 22 16:54:50 2014 -0800
     1.3 @@ -389,14 +389,15 @@
     1.4     property. Once an animation has started it continues until it ends or the
     1.5     ‘<a href="#animation-name"><code
     1.6     class=property>animation-name</code></a>’ is removed. The values used
     1.7 -   for the keyframes and animation properties are snapshotted at the time the
     1.8 -   animation starts. Changing them during the execution of the animation has
     1.9 -   no effect. Note also that changing the value of ‘<a
    1.10 -   href="#animation-name"><code class=property>animation-name</code></a>’
    1.11 -   does not necessarily restart an animation (e.g., if a list of animations
    1.12 -   are applied and one is removed from the list, only that animation will
    1.13 -   stop; The other animations will continue). In order to restart an
    1.14 -   animation, it must be removed then reapplied.
    1.15 +   for the keyframes and <a href="#animation-properties">animation
    1.16 +   properties</a> are snapshotted at the time the animation starts. Changing
    1.17 +   them during the execution of the animation has no effect. Note also that
    1.18 +   changing the value of ‘<a href="#animation-name"><code
    1.19 +   class=property>animation-name</code></a>’ does not necessarily restart
    1.20 +   an animation (e.g., if a list of animations are applied and one is removed
    1.21 +   from the list, only that animation will stop; The other animations will
    1.22 +   continue). In order to restart an animation, it must be removed then
    1.23 +   reapplied.
    1.24  
    1.25    <p> The end of the animation is defined by the combination of the ‘<a
    1.26     href="#animation-duration"><code
    1.27 @@ -644,19 +645,20 @@
    1.28     the end of the list of names wins.
    1.29  
    1.30    <p id=list-matching> Each animation listed by name should have a
    1.31 -   corresponding value for the other animation properties listed below. If
    1.32 -   the lists of values for the other animation properties do not have the
    1.33 -   same length, the length of the ‘<a href="#animation-name"><code
    1.34 -   class=property>animation-name</code></a>’ list determines the number of
    1.35 -   items in each list examined when starting animations. The lists are
    1.36 -   matched up from the first value: excess values at the end are not used. If
    1.37 -   one of the other properties doesn't have enough comma-separated values to
    1.38 -   match the number of values of ‘<a href="#animation-name"><code
    1.39 -   class=property>animation-name</code></a>’, the UA must calculate its
    1.40 -   used value by repeating the list of values until there are enough. This
    1.41 -   truncation or repetition does not affect the computed value. <span
    1.42 -   class=note>Note: This is analogous to the behavior of the ‘<code
    1.43 -   class=css>background-*</code>’properties, with ‘<code
    1.44 +   corresponding value for the other <a
    1.45 +   href="#animation-properties">animation properties</a> listed below. If the
    1.46 +   lists of values for the other <a href="#animation-properties">animation
    1.47 +   properties</a> do not have the same length, the length of the ‘<a
    1.48 +   href="#animation-name"><code class=property>animation-name</code></a>’
    1.49 +   list determines the number of items in each list examined when starting
    1.50 +   animations. The lists are matched up from the first value: excess values
    1.51 +   at the end are not used. If one of the other properties doesn't have
    1.52 +   enough comma-separated values to match the number of values of ‘<a
    1.53 +   href="#animation-name"><code class=property>animation-name</code></a>’,
    1.54 +   the UA must calculate its used value by repeating the list of values until
    1.55 +   there are enough. This truncation or repetition does not affect the
    1.56 +   computed value. <span class=note>Note: This is analogous to the behavior
    1.57 +   of the ‘<code class=css>background-*</code>’properties, with ‘<code
    1.58     class=property>background-image</code>’ analogous to ‘<a
    1.59     href="#animation-name"><code
    1.60     class=property>animation-name</code></a>’.</span>
    1.61 @@ -1390,8 +1392,14 @@
    1.62  
    1.63    <p> The ‘<a href="#animation"><code
    1.64     class=property>animation</code></a>’ shorthand property is a
    1.65 -   comma-separated list of animation definitions, each of which combines
    1.66 -   seven of the animation properties into a single component value.
    1.67 +   comma-separated list of animation definitions. Each item in the list gives
    1.68 +   one item of the value for all of the subproperties of the shorthand, which
    1.69 +   are known as the <dfn id=animation-properties>animation properties</dfn>.
    1.70 +   (See the definition of ‘<a href="#animation-name"><code
    1.71 +   class=property>animation-name</code></a>’ for what happens when these
    1.72 +   properties have lists of different lengths, a problem that cannot occur
    1.73 +   when they are defined using only the ‘<a href="#animation"><code
    1.74 +   class=property>animation</code></a>’ shorthand.)
    1.75  
    1.76    <table class=propdef>
    1.77     <tbody>
    1.78 @@ -2075,6 +2083,9 @@
    1.79     <li>animation-play-state, <a href="#animation-play-state"
    1.80      title="section 4.7."><strong>4.7.</strong></a>
    1.81  
    1.82 +   <li>animation properties, <a href="#animation-properties"
    1.83 +    title="section 4.10."><strong>4.10.</strong></a>
    1.84 +
    1.85     <li>animationstart, <a href="#animationstart"
    1.86      title="section 5.2."><strong>5.2.</strong></a>
    1.87  
     2.1 --- a/css-animations/Overview.src.html	Wed Jan 22 16:48:34 2014 -0800
     2.2 +++ b/css-animations/Overview.src.html	Wed Jan 22 16:54:50 2014 -0800
     2.3 @@ -199,7 +199,7 @@
     2.4  		Once an animation has started 
     2.5  		it continues until it ends 
     2.6  		or the 'animation-name' is removed. 
     2.7 -		The values used for the keyframes and animation properties are snapshotted at the time the animation starts. 
     2.8 +		The values used for the keyframes and <span>animation properties</span> are snapshotted at the time the animation starts. 
     2.9  		Changing them during the execution of the animation has no effect. 
    2.10  		Note also that changing the value of 'animation-name' does not necessarily restart an animation 
    2.11  		(e.g., if a list of animations are applied and one is removed from the list, 
    2.12 @@ -476,8 +476,8 @@
    2.13  	
    2.14  	<p id="list-matching">
    2.15  		Each animation listed by name 
    2.16 -		should have a corresponding value for the other animation properties listed below. 
    2.17 -		If the lists of values for the other animation properties do not have the same length, 
    2.18 +		should have a corresponding value for the other <span>animation properties</span> listed below. 
    2.19 +		If the lists of values for the other <span>animation properties</span> do not have the same length, 
    2.20  		the length of the 'animation-name' list 
    2.21  		determines the number of items in each list examined when starting animations.  
    2.22  		The lists are matched up from the first value: 
    2.23 @@ -993,8 +993,14 @@
    2.24  
    2.25  	<p>
    2.26  		The 'animation' shorthand property is a comma-separated list of 
    2.27 -		animation definitions, each of which combines seven of the animation properties 
    2.28 -		into a single component value. 
    2.29 +		animation definitions.
    2.30 +		Each item in the list gives one item of the value
    2.31 +		for all of the subproperties of the shorthand,
    2.32 +		which are known as the <dfn>animation properties</dfn>.
    2.33 +		(See the definition of 'animation-name' for what happens
    2.34 +		when these properties have lists of different lengths,
    2.35 +		a problem that cannot occur when they are defined using only
    2.36 +		the 'animation' shorthand.)
    2.37  			
    2.38  	<table class=propdef>
    2.39  		<tr>

mercurial