- From: Tab Atkins Jr.. via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 29 Sep 2011 00:16:39 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css-variables In directory hutz:/tmp/cvs-serv12425 Modified Files: Overview.html Overview.src.html Log Message: Changed 'invalid variable use' to 'invalid at computed-value time' and rephrased a few bits to be more general, since attr() probably needs to do the same thing. Index: Overview.html =================================================================== RCS file: /sources/public/csswg/css-variables/Overview.html,v retrieving revision 1.3 retrieving revision 1.4 diff -u -d -r1.3 -r1.4 --- Overview.html 28 Sep 2011 23:03:05 -0000 1.3 +++ Overview.html 29 Sep 2011 00:16:37 -0000 1.4 @@ -36,14 +36,14 @@ <h1>CSS Variables Module Level 1</h1> - <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 28 September + <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 29 September 2011</h2> <dl> <dt>This version: <dd><a - href="http://www.w3.org/TR/2011/ED-css-variables-20110928/">http://dev.w3.org/csswg/css-variables/</a> + href="http://www.w3.org/TR/2011/ED-css-variables-20110929/">http://dev.w3.org/csswg/css-variables/</a> <!--<dt>Latest version: <dd><a href="http://www.w3.org/TR/css-variables/">http://www.w3.org/TR/css-variables/</a>--> @@ -353,9 +353,10 @@ value that nonetheless has no relation to the variable of that name. <p>A variable is substituted for its value in the property value at - computed-value time. If the property value, once all variables are - substituted in, is invalid for the property, that is an <a - href="#invalid-variable-use"><i>invalid variable use</i></a>. + computed-value time. If a declaration, once all variables are substituted + in, is invalid, the declaration is <a + href="#invalid-at-computed-value-time"><i>invalid at computed-value + time</i></a>. <div class=example> <p>For example, the following usage is fine from a syntax standpoint, but @@ -378,14 +379,17 @@ <p>An <dfn id=invalid-variable title="invalid variable|invalid variables">invalid variable</dfn> results from having variables directly or indirectly refer to themselves, or from using an undefined variable. - Using an <a href="#invalid-variable"><i>invalid variable</i></a> results - in an <a href="#invalid-variable-use"><i>invalid variable use</i></a>. + Using an <a href="#invalid-variable"><i>invalid variable</i></a> in a + property value makes the declaration <a + href="#invalid-at-computed-value-time"><i>invalid at computed-value + time</i></a>. - <p>An <dfn id=invalid-variable-use>invalid variable use</dfn> results from - either using an <a href="#invalid-variable"><i>invalid variable</i></a> in - a property value, or using a valid variable that produces an invalid - property value when it is substituted in. When this happens, the property - the variable is used in must compute to the property's initial value. + <p>A declaration that is <dfn id=invalid-at-computed-value-time>invalid at + computed-value time</dfn> results from either using an <a + href="#invalid-variable"><i>invalid variable</i></a> in a property value, + or using a valid variable that produces an invalid declaration when it is + substituted in. When this happens, the declaration must compute to the + property's initial value. <div class=example> <p>For example, in the following code:</p> @@ -397,13 +401,15 @@ <p>the <p> elements will have transparent backgrounds (the initial value for ‘<code class=property>background-color</code>’), - rather than red backgrounds.</p> + rather than red backgrounds. This is different from the second</p> </div> - <p class=note>The <a href="#invalid-variable-use"><i>invalid variable - use</i></a> concept exists because variables can't "fail early" like other - syntax errors can, so by the time the user agent realizes a property value - is invalid, it's already thrown away the other cascaded values. + <p class=note>The <a href="#invalid-at-computed-value-time"><i>invalid at + computed-value time</i></a> concept exists because variables can't "fail + early" like other syntax errors can, so by the time the user agent + realizes a property value is invalid, it's already thrown away the other + cascaded values. I think ‘<code class=css>attr()</code>’ needs + to rely on it as well, as its behavior is almost identical to variables. <h2 id=cssom><span class=secno>4. </span> APIs</h2> @@ -715,15 +721,16 @@ <li>inactive, <a href="#inactive-var-rule" title=inactive><strong>2.</strong></a> + <li>invalid at computed-value time, <a + href="#invalid-at-computed-value-time" title="invalid at computed-value + time"><strong>3.1.</strong></a> + <li>invalid variable, <a href="#invalid-variable" title="invalid variable"><strong>3.1.</strong></a> <li>invalid variables, <a href="#invalid-variable" title="invalid variables"><strong>3.1.</strong></a> - <li>invalid variable use, <a href="#invalid-variable-use" title="invalid - variable use"><strong>3.1.</strong></a> - <li>renderer, <a href="#renderer" title=renderer><strong>6.2.</strong></a> Index: Overview.src.html =================================================================== RCS file: /sources/public/csswg/css-variables/Overview.src.html,v retrieving revision 1.3 retrieving revision 1.4 diff -u -d -r1.3 -r1.4 --- Overview.src.html 28 Sep 2011 23:03:05 -0000 1.3 +++ Overview.src.html 29 Sep 2011 00:16:37 -0000 1.4 @@ -155,7 +155,7 @@ <p>A variable can be used anywhere a value is expected in CSS. Variables can not be used as property names, selectors, or anything else besides property values - doing so either produces an invalid value or, in some situations like the attribute value of an attribute selector, a valid value that nonetheless has no relation to the variable of that name.</p> - <p>A variable is substituted for its value in the property value at computed-value time. If the property value, once all variables are substituted in, is invalid for the property, that is an <i>invalid variable use</i>.</p> + <p>A variable is substituted for its value in the property value at computed-value time. If a declaration, once all variables are substituted in, is invalid, the declaration is <i>invalid at computed-value time</i>.</p> <div class='example'> <p>For example, the following usage is fine from a syntax standpoint, but results in nonsense when the variable is substituted in:</p> @@ -170,9 +170,9 @@ <h3 id='using-invalid-variables'> Using Invalid Variables</h3> - <p>An <dfn title="invalid variable|invalid variables">invalid variable</dfn> results from having variables directly or indirectly refer to themselves, or from using an undefined variable. Using an <i>invalid variable</i> results in an <i>invalid variable use</i>.</p> + <p>An <dfn title="invalid variable|invalid variables">invalid variable</dfn> results from having variables directly or indirectly refer to themselves, or from using an undefined variable. Using an <i>invalid variable</i> in a property value makes the declaration <i>invalid at computed-value time</i>.</p> - <p>An <dfn>invalid variable use</dfn> results from either using an <i>invalid variable</i> in a property value, or using a valid variable that produces an invalid property value when it is substituted in. When this happens, the property the variable is used in must compute to the property's initial value.</p> + <p>A declaration that is <dfn>invalid at computed-value time</dfn> results from either using an <i>invalid variable</i> in a property value, or using a valid variable that produces an invalid declaration when it is substituted in. When this happens, the declaration must compute to the property's initial value.</p> <div class='example'> <p>For example, in the following code:</p> @@ -182,10 +182,10 @@ p { background-color: red; } p { background-color: $invalid; }</pre> - <p>the <p> elements will have transparent backgrounds (the initial value for 'background-color'), rather than red backgrounds.</p> + <p>the <p> elements will have transparent backgrounds (the initial value for 'background-color'), rather than red backgrounds. This is different from the second</p> </div> - <p class='note'>The <i>invalid variable use</i> concept exists because variables can't "fail early" like other syntax errors can, so by the time the user agent realizes a property value is invalid, it's already thrown away the other cascaded values.</p> + <p class='note'>The <i>invalid at computed-value time</i> concept exists because variables can't "fail early" like other syntax errors can, so by the time the user agent realizes a property value is invalid, it's already thrown away the other cascaded values. I think ''attr()'' needs to rely on it as well, as its behavior is almost identical to variables.</p> <h2 id='cssom'> APIs</h2>
Received on Thursday, 29 September 2011 00:16:42 UTC