- 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