W3C home > Mailing lists > Public > public-css-commits@w3.org > October 2011

csswg/css3-values Overview.html,1.100,1.101 Overview.src.html,1.103,1.104

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
Message-Id: <E1RDNoX-0004oK-4A@lionel-hutz.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> [ ',' &lt;type> [ ',' &lt;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 &lsquo;<code
+   class=css>attr()</code>&rsquo; 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 &lsquo;<code class=css>&lt;type></code>&rsquo;
-   and tells the UA how to interpret the attribute value. It may be one of
-   the values from the list below.
+  <p>The &lsquo;<code class=css>&lt;type></code>&rsquo; 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, &lsquo;<code class=css>string</code>&rsquo;
+   is implied.
 
-  <p>The third argument (which is optional) is a CSS value which must be
-   valid where the &lsquo;<code class=css>attr()</code>&rsquo; expression is
-   placed. If it is not valid, then the whole &lsquo;<code
-   class=css>attr()</code>&rsquo; expression is invalid.
+  <p>The &lsquo;<code class=css>&lt;value></code>&rsquo; argument (which is
+   optional) is a CSS value which must be valid where the &lsquo;<code
+   class=css>attr()</code>&rsquo; 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 &lsquo;<code class=css>&lt;value></code>&rsquo; argument
+   is not valid for the property where the &lsquo;<code
+   class=css>attr()</code>&rsquo; expression is placed, the whole
+   &lsquo;<code class=css>attr()</code>&rsquo; expression is invalid. If the
+   fallback &lsquo;<code class=css>&lt;value></code>&rsquo; 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
-   &lsquo;<code class=css>attr()</code>&rsquo; 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 &lsquo;<code class=css>&lt;type></code>&rsquo; keywords are:
 
   <dl>
-   <dt>string
+   <dt>&lsquo;<code class=css>string</code>&rsquo;
 
    <dd>The attribute value will be interpreted as the contents of a CSS
     &lsquo;<code class=css>&lt;string></code>&rsquo;. The default is the
     empty string.
 
-   <dt>color
+   <dt>&lsquo;<code class=css>color</code>&rsquo;
 
    <dd>The attribute value will be interpreted as a CSS &lsquo;<code
     class=css>&lt;color></code>&rsquo; value. The default is &lsquo;<code
     class=css>currentColor</code>&rsquo;.
 
-   <dt>url
+   <dt>&lsquo;<a href="#url"><code class=css>url</code></a>&rsquo;
 
-   <dd>The attribute value will be interpreted as the URI part of a &lsquo;<a
+   <dd>The attribute value will be interpreted as the argument of a &lsquo;<a
     href="#url"><code class=css>url()</code></a>&rsquo; 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>&lsquo;<a href="#integer"><code class=css>integer</code></a>&rsquo;
 
    <dd>The attribute value will be interpreted as a CSS &lsquo;<code
     class=css>&lt;integer></code>&rsquo;. The default is &lsquo;<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>&lsquo;<a href="#number"><code class=css>number</code></a>&rsquo;
 
    <dd>The attribute value will be interpreted as a CSS &lsquo;<code
     class=css>&lt;number></code>&rsquo;. The default is &lsquo;<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>&lsquo;<code class=css>length</code>&rsquo;
+
+   <dt>&lsquo;<code class=css>angle</code>&rsquo;
+
+   <dt>&lsquo;<code class=css>time</code>&rsquo;
+
+   <dt>&lsquo;<code class=css>frequency</code>&rsquo;
 
    <dd>The attribute value will be interpreted as a CSS &lsquo;<code
     class=css>&lt;length></code>&rsquo;, &lsquo;<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>&lsquo;<a href="#em-unit"><code class=css>em</code></a>&rsquo;
+
+   <dt>&lsquo;<a href="#ex-unit"><code class=css>ex</code></a>&rsquo;
+
+   <dt>&lsquo;<code class=css>px</code>&rsquo;
+
+   <dt>&lsquo;<a href="#gr-unit"><code class=css>gr</code></a>&rsquo;
+
+   <dt>&lsquo;<a href="#rem-unit"><code class=css>rem</code></a>&rsquo;
+
+   <dt>&lsquo;<a href="#vw-unit"><code class=css>vw</code></a>&rsquo;
+
+   <dt>&lsquo;<a href="#vh-unit"><code class=css>vh</code></a>&rsquo;
+
+   <dt>&lsquo;<a href="#vm-unit"><code class=css>vm</code></a>&rsquo;
+
+   <dt>&lsquo;<code class=css>mm</code>&rsquo;
+
+   <dt>&lsquo;<code class=css>cm</code>&rsquo;
+
+   <dt>&lsquo;<code class=css>in</code>&rsquo;
+
+   <dt>&lsquo;<code class=css>pt</code>&rsquo;
+
+   <dt>&lsquo;<code class=css>pc</code>&rsquo;
+
+   <dt>&lsquo;<a href="#deg"><code class=css>deg</code></a>&rsquo;
+
+   <dt>&lsquo;<a href="#grad"><code class=css>grad</code></a>&rsquo;
+
+   <dt>&lsquo;<a href="#rad"><code class=css>rad</code></a>&rsquo;
+
+   <dt>&lsquo;<a href="#ms"><code class=css>ms</code></a>&rsquo;
+
+   <dt>&lsquo;<a href="#s"><code class=css>s</code></a>&rsquo;
+
+   <dt>&lsquo;<a href="#hz"><code class=css>Hz</code></a>&rsquo;
+
+   <dt>&lsquo;<a href="#khz"><code class=css>kHz</code></a>&rsquo;
+
+   <dt>&lsquo;<code class=css>%</code>&rsquo;
 
    <dd>The attribute value will be interpreted as a CSS &lsquo;<code
     class=css>&lt;number></code>&rsquo;, 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
    &lsquo;<code class=css>float: attr(align)</code>&rsquo;
 
-  <p>If the &lsquo;<code class=css>&lt;type></code>&rsquo; is missing,
-   &lsquo;<code class=css>string</code>&rsquo; 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: &lsquo;<code
    class=css>background-image: attr(href);</code>&rsquo;. 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> [ ',' &lt;type> [ ',' &lt;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 ''&lt;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 ''&lt;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 ''&lt;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 ''&lt;value>'' argument is not valid for the property where the ''attr()'' 
+	expression is placed, the whole ''attr()'' expression is invalid.  If the 
+	fallback ''&lt;value>'' is absent, the default value for the given
+	type (from the list below) is implied.</p>
 
+	<p>The ''&lt;type>'' keywords are:</p>
 
 	<dl>
-		<dt>string
+		<dt>''string''
 		<dd>The attribute value will be interpreted as the contents of a CSS
 		''&lt;string>''. The default is the empty string.
 
-		<dt>color
-		<dd>The attribute value will be interpreted as a CSS ''&lt;color>'' value. The
-		default is ''currentColor''.
+		<dt>''color''
+		<dd>The attribute value will be interpreted as a CSS ''&lt;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 ''&lt;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 ''&lt;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 ''&lt;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 ''&lt;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 ''&lt;length>'', ''&lt;angle>'',
-		''&lt;time>'' or ''&lt;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 ''&lt;length>'',
+		''&lt;angle>'', ''&lt;time>'' or ''&lt;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 ''&lt;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 ''&lt;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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 10 October 2011 21:55:21 GMT