[cssom] Hook into css-syntax for 'parse a CSS rule'

Author: Simon Pieters

cssom/Overview.html

@@ -38,7 +38,7 @@
  <h1>CSS Object Model (CSSOM)</h1>
 
 
- <h2 class="no-num no-toc" id="w3c-doctype">Editor's Draft 10 June 2013</h2>
+ <h2 class="no-num no-toc" id="w3c-doctype">Editor's Draft 11 June 2013</h2>
 
  <dl>
 
@@ -112,7 +112,7 @@ <h2 class="no-num no-toc" id="sotd">Status of This Document</h2>
 can be found in the
 <a href="http://www.w3.org/TR/">W3C technical reports index at http://www.w3.org/TR/.</a></em>
 
-<p class="dontpublish">This is the 10 June 2013 Editor's Draft of CSSOM. Please send comments to
+<p class="dontpublish">This is the 11 June 2013 Editor's Draft of CSSOM. Please send comments to
 <a href="mailto:www-style@w3.org?subject=%5Bcssom%5D%20">www-style@w3.org</a>
 (<a href="http://lists.w3.org/Archives/Public/www-style/">archived</a>)
 with <samp>[cssom]</samp> at the start of the subject line.
@@ -271,13 +271,15 @@ <h2 id="terminology"><span class="secno">3 </span>Terminology</h2>
 <p>This specification employs certain terminology from the following documents:
 <cite>DOM</cite>,
 <cite>HTML</cite>,
+<cite>CSS Syntax</cite>,
 <cite>URL</cite>,
 <cite>Fetch</cite>,
 <cite>Associating Style Sheets with XML documents</cite>
 and
 <cite>XML</cite>.
 <a href="#refsDOM">[DOM]</a>
 <a href="#refsHTML">[HTML]</a>
+<a href="#refsCSSSYNTAX">[CSSSYNTAX]</a>
 <a href="#refsURL">[URL]</a>
 <a href="#refsFETCH">[FETCH]</a>
 <a href="#refsXMLSS">[XMLSS]</a>
@@ -1750,7 +1752,8 @@ <h3 id="css-rules"><span class="secno">6.4 </span>CSS Rules</h3>
 <p>In addition to the above state, each <a href="#css-rule">CSS rule</a> may be associated
 with other state in accordance with its <a href="#concept-css-rule-type" title="concept-css-rule-type">type</a>.</p>
 
-<p>To <dfn id="parse-a-css-rule">parse a CSS rule</dfn> ...</p>
+<p>To <dfn id="parse-a-css-rule">parse a CSS rule</dfn> from a string <var>string</var>, invoke <a class="external" data-anolis-spec="csssyntax" href="http://dev.w3.org/csswg/css-syntax/#parse-a-rule0">parse a rule</a> with <var>string</var> and return
+the value returned.</p>
 
 <p>To <dfn id="serialize-a-css-rule">serialize a CSS rule</dfn>, perform one of the following in accordance with the <a href="#css-rule">CSS rule</a>'s
 <a href="#concept-css-rule-type" title="concept-css-rule-type">type</a>:</p>
@@ -1821,8 +1824,9 @@ <h3 id="css-rules"><span class="secno">6.4 </span>CSS Rules</h3>
 <p>To <dfn id="insert-a-css-rule">insert a CSS rule</dfn> <var>rule</var> in a CSS rule list <var>list</var> at index <var>index</var>, follow these steps:</p>
 <ol>
  <li><p>Set <var>new rule</var> to the results of performing <a href="#parse-a-css-rule">parse a CSS rule</a>
- on argument <var>rule</var>, <a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#concept-throw" title="concept-throw">throwing</a>
- a <code class="external" data-anolis-spec="dom"><a href="http://dom.spec.whatwg.org/#syntaxerror">SyntaxError</a></code> exception if a parse error occurs.</li>
+ on argument <var>rule</var>.
+ <li><p>If <var>new rule</var> is a syntax error, <a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#concept-throw" title="concept-throw">throw</a>
+ a <code class="external" data-anolis-spec="dom"><a href="http://dom.spec.whatwg.org/#syntaxerror">SyntaxError</a></code> exception.</li>
  <li><p>If <var>new rule</var> is an <code title="">@charset</code> at-rule, <a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#concept-throw" title="concept-throw">throw</a> a
  <code class="external" data-anolis-spec="dom"><a href="http://dom.spec.whatwg.org/#syntaxerror">SyntaxError</a></code> exception.
  <li><p>Set <var>length</var> to the number of items in <var>list</var>.</li>
@@ -1930,14 +1934,13 @@ <h4 id="the-cssrule-interface"><span class="secno">6.4.2 </span>The <code title=
 <a href="#css-rule">CSS rule</a>.</p>
 <p>On setting the <code title="dom-CSSRule-cssText"><a href="#dom-cssrule-csstext">cssText</a></code> attribute these steps must be run:</p>
 <ol>
- <li><p><a href="#parse-a-css-rule" title="Parse a CSS rule">Parse</a> the value.</li>
- <li><p>If parsing failed terminate this algorithm.</li>
- <li><p>If the <code title="dom-CSSRule-type"><a href="#dom-cssrule-type">type</a></code> of the new
- object does not match the <code title="dom-CSSRule-type"><a href="#dom-cssrule-type">type</a></code> of
+ <li><p>Let <var>new rule</var> be the returned value of <a href="#parse-a-css-rule" title="parse a CSS rule">parsing</a> the value.</li>
+ <li><p>If <var>new rule</var> is a syntax error, terminate this algorithm.</li>
+ <li><p>If the <a href="#concept-css-rule-type" title="concept-css-rule-type">type</a> of <var>new rule</var> does not match the <a href="#concept-css-rule-type" title="concept-css-rule-type">type</a> of
  the current object
  <a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#concept-throw" title="concept-throw">throw</a> an
  <code class="external" data-anolis-spec="dom"><a href="http://dom.spec.whatwg.org/#invalidmodificationerror">InvalidModificationError</a></code> exception.</li>
- <li><p>Replace the current object with the new object.</li>
+ <li><p>Replace the current object with <var>new rule</var>.</li>
 </ol>
 
 <p>The <dfn id="dom-cssrule-parentrule" title="dom-CSSRule-parentRule"><code>parentRule</code></dfn> attribute must return the nearest enclosing rule of the current rule or null if
@@ -2962,6 +2965,9 @@ <h2 class="no-num" id="references">References</h2>
 <dt id="refsCSSPAGE">[CSSPAGE]
 <dd><cite><a href="http://dev.w3.org/csswg/css-page/">CSS Paged Media Module</a></cite>, Melinda Grant, Håkon Wium Lie, Elika J. Etemad et al.. W3C.
 
+<dt id="refsCSSSYNTAX">[CSSSYNTAX]
+<dd><cite><a href="http://dev.w3.org/csswg/css-syntax/">CSS Syntax Module Level 3</a></cite>, Tab Atkins Jr. W3C.
+
 <dt id="refsDOM">[DOM]
 <dd><cite><a href="http://dom.spec.whatwg.org/">DOM</a></cite>, Anne van Kesteren, Aryeh Gregor and Ms2ger. WHATWG.
 

cssom/Overview.src.html

@@ -194,13 +194,15 @@ <h2>Terminology</h2>
 <p>This specification employs certain terminology from the following documents:
 <cite>DOM</cite>,
 <cite>HTML</cite>,
+<cite>CSS Syntax</cite>,
 <cite>URL</cite>,
 <cite>Fetch</cite>,
 <cite>Associating Style Sheets with XML documents</cite>
 and
 <cite>XML</cite>.
 <span data-anolis-ref>DOM</span>
 <span data-anolis-ref>HTML</span>
+<span data-anolis-ref>CSSSYNTAX</span>
 <span data-anolis-ref>URL</span>
 <span data-anolis-ref>FETCH</span>
 <span data-anolis-ref>XMLSS</span>
@@ -1673,7 +1675,8 @@ <h3>CSS Rules</h3>
 <p>In addition to the above state, each <span>CSS rule</span> may be associated
 with other state in accordance with its <span title=concept-css-rule-type>type</span>.</p>
 
-<p>To <dfn>parse a CSS rule</dfn> ...</p>
+<p>To <dfn>parse a CSS rule</dfn> from a string <var>string</var>, invoke <span data-anolis-spec=csssyntax>parse a rule</span> with <var>string</var> and return
+the value returned.</p>
 
 <p>To <dfn>serialize a CSS rule</dfn>, perform one of the following in accordance with the <span>CSS rule</span>'s
 <span title="concept-css-rule-type">type</span>:</p>
@@ -1744,8 +1747,9 @@ <h3>CSS Rules</h3>
 <p>To <dfn>insert a CSS rule</dfn> <var>rule</var> in a CSS rule list <var>list</var> at index <var>index</var>, follow these steps:</p>
 <ol>
  <li><p>Set <var>new rule</var> to the results of performing <span>parse a CSS rule</span>
- on argument <var>rule</var>, <span data-anolis-spec='dom' title='concept-throw'>throwing</span>
- a <code data-anolis-spec='dom'>SyntaxError</code> exception if a parse error occurs.</p></li>
+ on argument <var>rule</var>.
+ <li><p>If <var>new rule</var> is a syntax error, <span data-anolis-spec='dom' title='concept-throw'>throw</span>
+ a <code data-anolis-spec='dom'>SyntaxError</code> exception.</p></li>
  <li><p>If <var>new rule</var> is an <code title>@charset</code> at-rule, <span data-anolis-spec='dom' title='concept-throw'>throw</span> a
  <code data-anolis-spec='dom'>SyntaxError</code> exception.
  <li><p>Set <var>length</var> to the number of items in <var>list</var>.</p></li>
@@ -1853,14 +1857,13 @@ <h4>The <code title>CSSRule</code> Interface</h4>
 <span>CSS rule</span>.</p>
 <p>On setting the <code title=dom-CSSRule-cssText>cssText</code> attribute these steps must be run:</p>
 <ol>
- <li><p><span title='Parse a CSS rule'>Parse</span> the value.</p></li>
- <li><p>If parsing failed terminate this algorithm.</p></li>
- <li><p>If the <code title='dom-CSSRule-type'>type</code> of the new
- object does not match the <code title='dom-CSSRule-type'>type</code> of
+ <li><p>Let <var>new rule</var> be the returned value of <span title='parse a CSS rule'>parsing</span> the value.</p></li>
+ <li><p>If <var>new rule</var> is a syntax error, terminate this algorithm.</p></li>
+ <li><p>If the <span title=concept-css-rule-type>type</span> of <var>new rule</var> does not match the <span title=concept-css-rule-type>type</span> of
  the current object
  <span data-anolis-spec=dom title=concept-throw>throw</span> an
  <code data-anolis-spec=dom>InvalidModificationError</code> exception.</li>
- <li><p>Replace the current object with the new object.</p></li>
+ <li><p>Replace the current object with <var>new rule</var>.</p></li>
 </ol>
 
 <p>The <dfn title=dom-CSSRule-parentRule><code>parentRule</code></dfn> attribute must return the nearest enclosing rule of the current rule or null if