- From: Tab Atkins Jr.. via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 10 Oct 2011 21:55:13 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-values
In directory hutz:/tmp/cvs-serv18473
Modified Files:
Overview.html Overview.src.html
Log Message:
Editorial fixup.
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-values/Overview.html,v
retrieving revision 1.100
retrieving revision 1.101
diff -u -d -r1.100 -r1.101
--- Overview.html 10 Oct 2011 21:28:23 -0000 1.100
+++ Overview.html 10 Oct 2011 21:55:10 -0000 1.101
@@ -12,6 +12,8 @@
pre.value { font: inherit; white-space: pre-wrap; margin: 0; padding: 0; }
#propvalues td { text-align: right; }
#propvalues td + td { text-align: left; }
+ dt + dt::before { content: ", "; }
+ dt { display: inline; }
</style>
<link href="../css-module/default.css" rel=stylesheet type="text/css">
<link href="http://www.w3.org/StyleSheets/TR/W3C-ED.css" rel=stylesheet
@@ -1498,64 +1500,65 @@
<pre>'attr(' <a
href="#wqname"><var>wqname</var></a> [ ',' <type> [ ',' <value> ]? ]? ')'</pre>
- <p>where <dfn id=wqname>wqname</dfn> is defined as:
+ <p>where <dfn id=wqname>wqname</dfn> is a <a
+ href="http://dev.w3.org/csswg/css3-namespace/#css-qnames">CSS qualified
+ name</a> [[!CSSNAMESPACE]] and whose syntax is defined as:
<pre>
wqname
- : [ [ namespace_prefix? | '*' ] '|' ident ]
- | ident
- ;</pre>
-
- <p>The first argument represents the attribute name. The value of the
- attribute with that name on the element whose computed values are being
- computed is used as the value of the expression, according to the rules
- given below.
+ : [ [ namespace_prefix? | '*' ] '|' ident ]
+ | ident
+ ;</pre>
+ <!-- TODO: Delete this syntax definition when Namespaces is updated to contain the wqname production -->
- <p>The first argument accepts an optional namespace prefix to identify the
- namespace of the attribute. The namespace prefix and the attribute name is
- separated by "|", with no whitespace before or after the separator <a
- href="#CSS3NAMESPACE"
- rel=biblioentry>[CSS3NAMESPACE]<!--{{CSS3NAMESPACE}}--></a>.
+ <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.
- <p>The second argument (which is optional but must be present if the third
- argument is present) is a ‘<code class=css><type></code>’
- and tells the UA how to interpret the attribute value. It may be one of
- the values from the list 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.
- <p>The third argument (which is optional) is a CSS value which must be
- valid where the ‘<code class=css>attr()</code>’ expression is
- placed. If it is not valid, then the whole ‘<code
- class=css>attr()</code>’ 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.
- <p>If the attribute named by the first argument is missing, cannot be
- parsed, or is invalid for the property, then the value returned by
- ‘<code class=css>attr()</code>’ will be the third argument,
- or, if the third argument is absent, will be the value given as the
- default for the relevant type in the list below.
+ <p>The ‘<code class=css><type></code>’ keywords are:
<dl>
- <dt>string
+ <dt>‘<code class=css>string</code>’
<dd>The attribute value will be interpreted as the contents of a CSS
‘<code class=css><string></code>’. The default is the
empty string.
- <dt>color
+ <dt>‘<code class=css>color</code>’
<dd>The attribute value will be interpreted as a CSS ‘<code
class=css><color></code>’ value. The default is ‘<code
class=css>currentColor</code>’.
- <dt>url
+ <dt>‘<a href="#url"><code class=css>url</code></a>’
- <dd>The attribute value will be interpreted as the URI part of a ‘<a
+ <dd>The attribute value will be interpreted as the argument of a ‘<a
href="#url"><code class=css>url()</code></a>’ expression. The
default is a UA-dependent URI defined to point to a non-existent document
with a generic error condition. (i.e. it shouldn't be an FTP URI that
causes a DNS error, or an HTTP URI that results in a 404, it should be a
nondescript error condition.)
- <dt>integer
+ <dt>‘<a href="#integer"><code class=css>integer</code></a>’
<dd>The attribute value will be interpreted as a CSS ‘<code
class=css><integer></code>’. The default is ‘<code
@@ -1563,7 +1566,7 @@
property in question only accepts integers within a certain range and the
attribute is out of range.
- <dt>number
+ <dt>‘<a href="#number"><code class=css>number</code></a>’
<dd>The attribute value will be interpreted as a CSS ‘<code
class=css><number></code>’. The default is ‘<code
@@ -1571,7 +1574,13 @@
property in question only accepts numbers within a certain range and the
attribute is out of range.
- <dt>length, angle, time, frequency
+ <dt>‘<code class=css>length</code>’
+
+ <dt>‘<code class=css>angle</code>’
+
+ <dt>‘<code class=css>time</code>’
+
+ <dt>‘<code class=css>frequency</code>’
<dd>The attribute value will be interpreted as a CSS ‘<code
class=css><length></code>’, ‘<code
@@ -1584,8 +1593,47 @@
within a certain range (e.g. positive lengths or angles from 0 to 90deg)
and the attribute is out of range (e.g. a negative length or 180deg).
- <dt>em, ex, px, gr, rem, vw, vh, vm, mm, cm, in, pt, pc, deg, grad, rad,
- ms, s, Hz, kHz, %
+ <dt>‘<a href="#em-unit"><code class=css>em</code></a>’
+
+ <dt>‘<a href="#ex-unit"><code class=css>ex</code></a>’
+
+ <dt>‘<code class=css>px</code>’
+
+ <dt>‘<a href="#gr-unit"><code class=css>gr</code></a>’
+
+ <dt>‘<a href="#rem-unit"><code class=css>rem</code></a>’
+
+ <dt>‘<a href="#vw-unit"><code class=css>vw</code></a>’
+
+ <dt>‘<a href="#vh-unit"><code class=css>vh</code></a>’
+
+ <dt>‘<a href="#vm-unit"><code class=css>vm</code></a>’
+
+ <dt>‘<code class=css>mm</code>’
+
+ <dt>‘<code class=css>cm</code>’
+
+ <dt>‘<code class=css>in</code>’
+
+ <dt>‘<code class=css>pt</code>’
+
+ <dt>‘<code class=css>pc</code>’
+
+ <dt>‘<a href="#deg"><code class=css>deg</code></a>’
+
+ <dt>‘<a href="#grad"><code class=css>grad</code></a>’
+
+ <dt>‘<a href="#rad"><code class=css>rad</code></a>’
+
+ <dt>‘<a href="#ms"><code class=css>ms</code></a>’
+
+ <dt>‘<a href="#s"><code class=css>s</code></a>’
+
+ <dt>‘<a href="#hz"><code class=css>Hz</code></a>’
+
+ <dt>‘<a href="#khz"><code class=css>kHz</code></a>’
+
+ <dt>‘<code class=css>%</code>’
<dd>The attribute value will be interpreted as a CSS ‘<code
class=css><number></code>’, with the given type suffixed as a
@@ -1596,9 +1644,6 @@
<p class=issue>Should there also be a "keyword" type to, e.g., support
‘<code class=css>float: attr(align)</code>’
- <p>If the ‘<code class=css><type></code>’ is missing,
- ‘<code class=css>string</code>’ is implied.
-
<p class=issue>Ideally, it shouldn't be necessary to specify the type if it
is obvious. For example, this should be valid: ‘<code
class=css>background-image: attr(href);</code>’. This could be
@@ -2166,16 +2211,6 @@
</dd>
<!---->
- <dt id=CSS3NAMESPACE>[CSS3NAMESPACE]
-
- <dd>Elika J. Etemad; Anne van Kesteren. <a
- href="http://www.w3.org/TR/2008/CR-css3-namespace-20080523/"><cite>CSS
- Namespaces Module.</cite></a> 23 May 2008. W3C Candidate Recommendation.
- (Work in progress.) URL: <a
- href="http://www.w3.org/TR/2008/CR-css3-namespace-20080523/">http://www.w3.org/TR/2008/CR-css3-namespace-20080523/</a>
- </dd>
- <!---->
-
<dt id=URI>[URI]
<dd>T. Berners-Lee; R. Fielding; L. Masinter. <a
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-values/Overview.src.html,v
retrieving revision 1.103
retrieving revision 1.104
diff -u -d -r1.103 -r1.104
--- Overview.src.html 10 Oct 2011 21:28:23 -0000 1.103
+++ Overview.src.html 10 Oct 2011 21:55:11 -0000 1.104
@@ -11,6 +11,8 @@
pre.value { font: inherit; white-space: pre-wrap; margin: 0; padding: 0; }
#propvalues td { text-align: right; }
#propvalues td + td { text-align: left; }
+ dt + dt::before { content: ", "; }
+ dt { display: inline; }
</style>
<link rel="stylesheet" type="text/css" href="../css-module/default.css">
<link rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/TR/W3C-[STATUS].css">
@@ -1047,79 +1049,99 @@
<pre>'attr(' <var>wqname</var> [ ',' <type> [ ',' <value> ]? ]? ')'</pre>
- <p>where <dfn>wqname</dfn> is defined as:</p>
+ <p>where <dfn>wqname</dfn> is a
+ <a href="http://dev.w3.org/csswg/css3-namespace/#css-qnames">CSS qualified name</a>
+ [[!CSSNAMESPACE]] and whose syntax is defined as:</p>
<pre>
wqname
- : [ [ namespace_prefix? | '*' ] '|' ident ]
- | ident
- ;</pre>
-
- <p>The first argument represents the attribute name. The value of the
- attribute with that name on the element whose computed values are
- being computed is used as the value of the expression, according to
- the rules given below.</p>
-
- <p>The first argument accepts an optional namespace prefix to identify
- the namespace of the attribute. The namespace prefix and the attribute
- name is separated by "|", with no whitespace before or after the
- separator [[CSS3NAMESPACE]].</p>
+ : [ [ namespace_prefix? | '*' ] '|' ident ]
+ | ident
+ ;</pre>
+ <!-- TODO: Delete this syntax definition when Namespaces is updated to contain the wqname production -->
- <p>The second argument (which is optional but must be present if the
- third argument is present) is a ''<type>'' and tells the UA how to
- interpret the attribute value. It may be one of the values from the
- list below.</p>
+ <p>The <i>wqname</i> argument represents an attribute name. The computed
+ value of the ''attr()'' expression is the value of the attribute with that
+ name on the element, according to the rules given below.</p>
- <p>The third argument (which is optional) is a CSS value which must be
- valid where the ''attr()'' expression is placed. If it is not valid, then
- the whole ''attr()'' expression is invalid.</p>
+ <p>The ''<type>'' 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, ''string'' is
+ implied.</p>
- <p>If the attribute named by the first argument is missing, cannot be
- parsed, or is invalid for the property, then the value returned by
- ''attr()'' will be the third argument, or, if the third argument is
- absent, will be the value given as the default for the relevant type
- in the list below.</p>
+ <p>The ''<value>'' argument (which is optional) is a CSS value which must
+ be valid where the ''attr()'' 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 ''<value>'' argument is not valid for the property where the ''attr()''
+ expression is placed, the whole ''attr()'' expression is invalid. If the
+ fallback ''<value>'' is absent, the default value for the given
+ type (from the list below) is implied.</p>
+ <p>The ''<type>'' keywords are:</p>
<dl>
- <dt>string
+ <dt>''string''
<dd>The attribute value will be interpreted as the contents of a CSS
''<string>''. The default is the empty string.
- <dt>color
- <dd>The attribute value will be interpreted as a CSS ''<color>'' value. The
- default is ''currentColor''.
+ <dt>''color''
+ <dd>The attribute value will be interpreted as a CSS ''<color>'' value.
+ The default is ''currentColor''.
- <dt>url
- <dd>The attribute value will be interpreted as the URI part of a
+ <dt>''url''
+ <dd>The attribute value will be interpreted as the argument of a
''url()'' expression. The default is a UA-dependent URI defined
to point to a non-existent document with a generic error
condition. (i.e. it shouldn't be an FTP URI that causes a DNS
error, or an HTTP URI that results in a 404, it should be a
nondescript error condition.)
- <dt>integer
- <dd>The attribute value will be interpreted as a CSS ''<integer>''. The
- default is ''0''. The default should also be used if the property
+ <dt>''integer''
+ <dd>The attribute value will be interpreted as a CSS ''<integer>''.
+ The default is ''0''. The default should also be used if the property
in question only accepts integers within a certain range and
the attribute is out of range.
- <dt>number
- <dd>The attribute value will be interpreted as a CSS ''<number>''. The
- default is ''0.0''. The default should also be used if the
+ <dt>''number''
+ <dd>The attribute value will be interpreted as a CSS ''<number>''.
+ The default is ''0.0''. The default should also be used if the
property in question only accepts numbers within a certain
range and the attribute is out of range.
- <dt>length, angle, time, frequency
- <dd>The attribute value will be interpreted as a CSS ''<length>'', ''<angle>'',
- ''<time>'' or ''<frequency>'' (respectively), and the unit identifier (if any)
- will appear in the attribute value. The default is ''0'' in the relevant units. The default
- should also be used if the property in question only accepts values
- within a certain range (e.g. positive lengths or angles from 0 to
- 90deg) and the attribute is out of range (e.g. a negative length or
- 180deg).
+ <dt>''length''
+ <dt>''angle''
+ <dt>''time''
+ <dt>''frequency''
+ <dd>The attribute value will be interpreted as a CSS ''<length>'',
+ ''<angle>'', ''<time>'' or ''<frequency>'' (respectively), and
+ the unit identifier (if any) will appear in the attribute value.
+ The default is ''0'' in the relevant units. The default should also be
+ used if the property in question only accepts values within a certain
+ range (e.g. positive lengths or angles from 0 to 90deg) and the
+ attribute is out of range (e.g. a negative length or 180deg).
- <dt>em, ex, px, gr, rem, vw, vh, vm, mm, cm, in, pt, pc, deg, grad, rad, ms, s, Hz, kHz, %
+ <dt>''em''
+ <dt>''ex''
+ <dt>''px''
+ <dt>''gr''
+ <dt>''rem''
+ <dt>''vw''
+ <dt>''vh''
+ <dt>''vm''
+ <dt>''mm''
+ <dt>''cm''
+ <dt>''in''
+ <dt>''pt''
+ <dt>''pc''
+ <dt>''deg''
+ <dt>''grad''
+ <dt>''rad''
+ <dt>''ms''
+ <dt>''s''
+ <dt>''Hz''
+ <dt>''kHz''
+ <dt>''%''
<dd>The attribute value will be interpreted as a CSS ''<number>'', with the given
type suffixed as a unit. The default is ''0'' in the relevant
units.
@@ -1127,9 +1149,6 @@
<p class="issue">Should there also be a "keyword" type to, e.g., support ''float: attr(align)''</p>
-
- <p>If the ''<type>'' is missing, ''string'' is implied.</p>
-
<p class="issue">Ideally, it shouldn't be necessary to specify the
type if it is obvious. For example, this should be valid:
''background-image: attr(href);''. This could be described as:
Received on Monday, 10 October 2011 21:55:20 UTC