- From: Tab Atkins Jr.. via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 11 Oct 2011 00:35:11 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-values In directory hutz:/tmp/cvs-serv11635 Modified Files: Overview.html Overview.src.html Log Message: Formatting tweaks. Editorial. Index: Overview.html =================================================================== RCS file: /sources/public/csswg/css3-values/Overview.html,v retrieving revision 1.117 retrieving revision 1.118 diff -u -d -r1.117 -r1.118 --- Overview.html 11 Oct 2011 00:30:59 -0000 1.117 +++ Overview.html 11 Oct 2011 00:35:09 -0000 1.118 @@ -139,9 +139,9 @@ ‘<a href="#vw-unit"><code class=css>vw</code></a>’, ‘<a href="#vm-unit"><code class=css>vm</code></a>’, ‘<a href="#fr-unit"><code class=css>fr</code></a>’, ‘<a - href="#gr-unit"><code class=css>gr</code></a>’, ‘<code - class=css>cycle()</code>’, ‘<code - class=css>attr()</code>’. + href="#gr-unit"><code class=css>gr</code></a>’, ‘<a + href="#cycle-value"><code class=css>cycle()</code></a>’, ‘<a + href="#attr-value"><code class=css>attr()</code></a>’. <h2 class="no-num no-toc" id=contents>Table of contents</h2> <!--begin-toc--> @@ -1452,37 +1452,38 @@ treated as if ‘<code class=property>auto</code>’ had been specified. - <h3 id=cycle><span class=secno>9.2. </span> Cycling Values: ‘<code - class=css>cycle()</code>’</h3> + <h3 id=cycle><span class=secno>9.2. </span> Cycling Values: ‘<a + href="#cycle-value"><code class=css>cycle()</code></a>’</h3> - <p>The <dfn id=cycle0>‘<code class=css>cycle()</code>’</dfn> - expression allows descendant elements to cycle over a list of values - instead of inheriting the same value. The syntax of the ‘<code - class=css>cycle()</code>’ expression is: + <p>The <dfn id=cycle-value>cycle()</dfn> expression allows descendant + elements to cycle over a list of values instead of inheriting the same + value. The syntax of the ‘<a href="#cycle-value"><code + class=css>cycle()</code></a>’ expression is: <pre>cycle( <value># )</pre> <p>where <code><value></code> is a CSS value that is valid where the expression is placed. If any of the values inside are not valid, then the - entire ‘<code class=css>cycle()</code>’ expression is invalid. - + entire ‘<a href="#cycle-value"><code + class=css>cycle()</code></a>’ expression is invalid. - <p>The value returned by ‘<code class=css>cycle()</code>’ must - be determined by comparing the inherited value <var>I</var> (the computed - value on the parent, or, for the root, the initial value) to the computed - values <var>C<sub>n</sub></var> returned by the <var>n</var>-th argument - to ‘<code class=css>cycle()</code>’. For the earliest - <var>C<sub>n</sub></var> such that <var>C<sub>n</sub></var> = - <var>I</var>, the value returned by cycle is <var>C<sub>n+1</sub></var>. - However, if this <var>C<sub>n</sub></var> is the last value, or if there - are no <var>C<sub>n</sub></var> that equal <var>I</var>, the computed - value of the first value is returned instead. + <p>The value returned by ‘<a href="#cycle-value"><code + class=css>cycle()</code></a>’ must be determined by comparing the + inherited value <var>I</var> (the computed value on the parent, or, for + the root, the initial value) to the computed values + <var>C<sub>n</sub></var> returned by the <var>n</var>-th argument to + ‘<a href="#cycle-value"><code class=css>cycle()</code></a>’. + For the earliest <var>C<sub>n</sub></var> such that + <var>C<sub>n</sub></var> = <var>I</var>, the value returned by cycle is + <var>C<sub>n+1</sub></var>. However, if this <var>C<sub>n</sub></var> is + the last value, or if there are no <var>C<sub>n</sub></var> that equal + <var>I</var>, the computed value of the first value is returned instead. - <p class=note>Note that ‘<code class=css>cycle()</code>’ - explicitly looks at the computed value of the parent, so it is useful even - for non-inherited properties. This is similar to the ‘<code - class=css>inherit</code>’ keyword, which is useful even for - non-inherited properties. + <p class=note>Note that ‘<a href="#cycle-value"><code + class=css>cycle()</code></a>’ explicitly looks at the computed value + of the parent, so it is useful even for non-inherited properties. This is + similar to the ‘<code class=css>inherit</code>’ keyword, which + is useful even for non-inherited properties. <div class=example> <pre> @@ -1500,37 +1501,40 @@ li > ul { list-style-type: cycle(disk, circle, square, box); }</pre> </div> - <p>The ‘<code class=css>cycle()</code>’ notation is not allowed - to be nested; nor may it contain ‘<code - class=css>attr()</code>’, ‘<a href="#calc0"><code + <p>The ‘<a href="#cycle-value"><code + class=css>cycle()</code></a>’ notation is not allowed to be nested; + nor may it contain ‘<a href="#attr-value"><code + class=css>attr()</code></a>’, ‘<a href="#calc0"><code class=css>calc()</code></a>’, ‘<a href="#min"><code class=css>min()</code></a>’, or ‘<a href="#max"><code class=css>max()</code></a>’ notations. Declarations containing such constructs are invalid. - <h3 id=attr><span class=secno>9.3. </span> Attribute References: - ‘<code class=css>attr()</code>’</h3> + <h3 id=attr><span class=secno>9.3. </span> Attribute References: ‘<a + href="#attr-value"><code class=css>attr()</code></a>’</h3> - <p>The ‘<code class=css>attr()</code>’ function returns the - value of an attribute on the element for use as a value in a property. If - used on a pseudo-element, it returns the value of the attribute on the + <p>The <dfn id=attr-value>attr()</dfn> function returns the value of an + attribute on the element for use as a value in a property. If used on a + pseudo-element, it returns the value of the attribute on the pseudo-element's originating element. <p>In CSS2.1 <a href="#CSS21" rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a>, - the ‘<code class=css>attr()</code>’ expression always returns - a string. In CSS3, the ‘<code class=css>attr()</code>’ - expression can return many different types. The ‘<code - class=css>attr()</code>’ expression cannot return everything, for - example it cannot do counters, named strings, quotes, or values such as - ‘<code class=css>auto</code>’, ‘<code + the ‘<a href="#attr-value"><code class=css>attr()</code></a>’ + expression always returns a string. In CSS3, the ‘<a + href="#attr-value"><code class=css>attr()</code></a>’ expression can + return many different types. The ‘<a href="#attr-value"><code + class=css>attr()</code></a>’ expression cannot return everything, + for example it cannot do counters, named strings, quotes, or values such + as ‘<code class=css>auto</code>’, ‘<code class=css>nowrap</code>’, or ‘<code class=css>baseline</code>’. This is intentional, as the intent of - the ‘<code class=css>attr()</code>’ expression is not to make - it possible to describe a presentational language's formatting using CSS, - but to enable CSS to take semantic data into account. + the ‘<a href="#attr-value"><code class=css>attr()</code></a>’ + expression is not to make it possible to describe a presentational + language's formatting using CSS, but to enable CSS to take semantic data + into account. - <p>The new syntax for the ‘<code class=css>attr()</code>’ - expression is: + <p>The new syntax for the ‘<a href="#attr-value"><code + class=css>attr()</code></a>’ expression is: <pre>'attr(' <a href="#wqname"><var>wqname</var></a> [ ',' <type> [ ',' <value> ]? ]? ')'</pre> @@ -1547,29 +1551,33 @@ <!-- TODO: Delete this syntax definition when Namespaces is updated to contain the wqname production --> <p>The <a href="#wqname"><i>wqname</i></a> argument represents an attribute - name. The computed value of the ‘<code - class=css>attr()</code>’ expression is the value of the attribute - with that name on the element, according to the rules given below. + name. The computed value of the ‘<a href="#attr-value"><code + class=css>attr()</code></a>’ expression is the value of the + attribute with that name on the element, according to the rules given + below. <p>The ‘<code class=css><type></code>’ argument (which is optional but must be present if the third argument is present) is a keyword drawn from the list below that tells the UA how to interpret the attribute value. If omitted, ‘<code class=css>string</code>’ - is implied. If the type is not valid for where the ‘<code - class=css>attr()</code>’ expression is placed, the whole - ‘<code class=css>attr()</code>’ expression is invalid. + is implied. If the type is not valid for where the ‘<a + href="#attr-value"><code class=css>attr()</code></a>’ expression is + placed, the whole ‘<a href="#attr-value"><code + class=css>attr()</code></a>’ expression is invalid. <p>The ‘<code class=css><value></code>’ argument (which is - optional) is a CSS value which must be valid where the ‘<code - class=css>attr()</code>’ expression is placed. It represents a - fallback value to be used if the named attribute is missing, or its value - cannot be parsed into the given type or is invalid/out-of-range for the - property. If the ‘<code class=css><value></code>’ argument - is not valid for the property where the ‘<code - class=css>attr()</code>’ expression is placed, the whole - ‘<code class=css>attr()</code>’ expression is invalid. If the - fallback ‘<code class=css><value></code>’ is absent, the - default value for the given type (from the list below) is implied. + optional) is a CSS value which must be valid where the ‘<a + href="#attr-value"><code class=css>attr()</code></a>’ expression is + placed. It represents a fallback value to be used if the named attribute + is missing, or its value cannot be parsed into the given type or is + invalid/out-of-range for the property. If the ‘<code + class=css><value></code>’ argument is not valid for the property + where the ‘<a href="#attr-value"><code + class=css>attr()</code></a>’ expression is placed, the whole + ‘<a href="#attr-value"><code class=css>attr()</code></a>’ + expression is invalid. If the fallback ‘<code + class=css><value></code>’ is absent, the default value for the + given type (from the list below) is implied. <p class=note>Note that the default value need not be of the type given. For instance, if the type required of the attribute by the author is @@ -1752,9 +1760,11 @@ color: attr(color); /* 'color' doesn't accept strings */</pre> </div> - <p class=note>The ‘<code class=css>attr()</code>’ expression - cannot currently fall back onto another attribute. Future versions of CSS - may extend ‘<code class=css>attr()</code>’ in this direction.</p> + <p class=note>The ‘<a href="#attr-value"><code + class=css>attr()</code></a>’ expression cannot currently fall back + onto another attribute. Future versions of CSS may extend ‘<a + href="#attr-value"><code class=css>attr()</code></a>’ in this + direction.</p> <!-- <h4>The 'counter' function</h4> @@ -2264,6 +2274,9 @@ <li><angle>, <a href="#angle-value" title="<angle>"><strong>6.1.</strong></a> + <li>attr(), <a href="#attr-value" title="attr()"><strong>9.3.</strong></a> + + <li>calc(), <a href="#calc0" title="calc()"><strong>9.1.</strong></a> <li>ch, <a href="#ch-unit" title=ch><strong>5.1.1.</strong></a> @@ -2274,8 +2287,8 @@ <li>computed value, <a href="#computed-value" title="computed value"><strong>10.2.</strong></a> - <li>‘<code class=css>cycle()</code>’, <a href="#cycle0" - title="''cycle()''"><strong>9.2.</strong></a> + <li>cycle(), <a href="#cycle-value" + title="cycle()"><strong>9.2.</strong></a> <li>deg, <a href="#deg" title=deg><strong>6.1.</strong></a> Index: Overview.src.html =================================================================== RCS file: /sources/public/csswg/css3-values/Overview.src.html,v retrieving revision 1.120 retrieving revision 1.121 diff -u -d -r1.120 -r1.121 --- Overview.src.html 11 Oct 2011 00:30:59 -0000 1.120 +++ Overview.src.html 11 Oct 2011 00:35:09 -0000 1.121 @@ -999,7 +999,7 @@ <h3 id="cycle"> Cycling Values: ''cycle()''</h3> - <p>The <dfn>''cycle()''</dfn> expression allows descendant elements + <p>The <dfn id='cycle-value'>cycle()</dfn> expression allows descendant elements to cycle over a list of values instead of inheriting the same value. The syntax of the ''cycle()'' expression is: @@ -1049,7 +1049,7 @@ <h3 id="attr"> Attribute References: ''attr()''</h3> - <p>The ''attr()'' function returns the value of an attribute on the element + <p>The <dfn id='attr-value'>attr()</dfn> function returns the value of an attribute on the element for use as a value in a property. If used on a pseudo-element, it returns the value of the attribute on the pseudo-element's originating element.</p>
Received on Tuesday, 11 October 2011 00:35:13 UTC