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

Author: Simon Pieters

cssom/Overview.html

@@ -2145,7 +2145,8 @@ <h3 id="css-declaration-blocks"><span class="secno">6.5 </span>CSS Declaration B
 ordered. This matters for the
 <code title="dom-CSSStyleDeclaration-item"><a href="#dom-cssstyledeclaration-item">item()</a></code> method.</p>
 
-<p>To <dfn id="parse-a-css-declaration-block">parse a CSS declaration block</dfn> ...</p>
+<p>To <dfn id="parse-a-css-declaration-block">parse a CSS declaration block</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-list-of-declarations0">parse a list of declarations</a> with
+<var>string</var> and return the value returned.</p>
 
 <p>To <dfn id="serialize-a-css-declaration-block">serialize a CSS declaration block</dfn>
 represented by a <code><a href="#cssstyledeclaration">CSSStyleDeclaration</a></code> instance named <var>d</var>,
@@ -2226,7 +2227,7 @@ <h4 id="the-cssstyledeclaration-interface"><span class="secno">6.5.1 </span>The
  <li><p>If the <a href="#concept-css-declaration-block-readonly-flag" title="concept-css-declaration-block-readonly-flag">readonly flag</a> is set, <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/#nomodificationallowederror">NoModificationAllowedError</a></code> exception and terminate these steps.</li>
  <li><p>Empty the <a href="#concept-css-declaration-block-declarations" title="concept-css-declaration-block-declarations">declarations</a>.</li>
- <li><p><a href="#parse-a-css-declaration-block" title="Parse a CSS declaration block">Parse</a> the given value and, if the return value is not null, insert it into the
+ <li><p><a href="#parse-a-css-declaration-block" title="Parse a CSS declaration block">Parse</a> the given value and, if the return value is not the empty list, insert it into the
  <a href="#concept-css-declaration-block-declarations" title="concept-css-declaration-block-declarations">declarations</a>.</li>
 </ol>
 
@@ -2708,10 +2709,10 @@ <h3 id="the-elementcssinlinestyle-interface"><span class="secno">7.1 </span>The
 };</pre>
 
 <p>The <dfn id="dom-elementcssinlinestyle-style" title="dom-ElementCSSInlineStyle-style"><code>style</code></dfn> attribute must return a <a href="#css-declaration-block">CSS declaration block</a> with the
-<a href="#concept-css-declaration-block-declarations" title="concept-css-declaration-block-declarations">declarations</a> being set to the declarations
-specified in the element's <code title="">style</code> content attribute. If the
-<code title="">style</code> content attribute is absent, the object represents an empty
-declaration. Mutating the <code><a href="#cssstyledeclaration">CSSStyleDeclaration</a></code> object must set the
+<a href="#concept-css-declaration-block-declarations" title="concept-css-declaration-block-declarations">declarations</a> being set to the result of <a href="#parse-a-css-declaration-block" title="Parse a CSS declaration block">parsing</a>
+the <code title="">style</code> content attribute. If the
+<code title="">style</code> content attribute is absent, the object represents an empty list of
+declarations. Mutating the <code><a href="#cssstyledeclaration">CSSStyleDeclaration</a></code> object must set the
 <code title="">style</code> content attribute on the element to the
 <a href="#serialize-a-css-declaration-block" title="serialize a CSS declaration block">serialization</a> of the
 <code><a href="#cssstyledeclaration">CSSStyleDeclaration</a></code>'s <a href="#concept-css-declaration-block-declarations" title="concept-css-declaration-block-declarations">declarations</a>.

cssom/Overview.src.html

@@ -2068,7 +2068,8 @@ <h3>CSS Declaration Blocks</h3>
 ordered. This matters for the
 <code title="dom-CSSStyleDeclaration-item">item()</code> method.</p>
 
-<p>To <dfn>parse a CSS declaration block</dfn> ...</p>
+<p>To <dfn>parse a CSS declaration block</dfn> from a string <var>string</var>, invoke <span data-anolis-spec=csssyntax>parse a list of declarations</span> with
+<var>string</var> and return the value returned.</p>
 
 <p>To <dfn>serialize a CSS declaration block</dfn>
 represented by a <code>CSSStyleDeclaration</code> instance named <var>d</var>,
@@ -2149,7 +2150,7 @@ <h4>The <code title>CSSStyleDeclaration</code> Interface</h4>
  <li><p>If the <span title=concept-css-declaration-block-readonly-flag>readonly flag</span> is set, <span data-anolis-spec=dom title=concept-throw>throw</span>
  a <code data-anolis-spec=dom>NoModificationAllowedError</code> exception and terminate these steps.</li>
  <li><p>Empty the <span title=concept-css-declaration-block-declarations>declarations</span>.</li>
- <li><p><span title='Parse a CSS declaration block'>Parse</span> the given value and, if the return value is not null, insert it into the
+ <li><p><span title='Parse a CSS declaration block'>Parse</span> the given value and, if the return value is not the empty list, insert it into the
  <span title=concept-css-declaration-block-declarations>declarations</span>.</p></li>
 </ol>
 
@@ -2631,10 +2632,10 @@ <h3>The <code>ElementCSSInlineStyle</code> Interface</h3>
 };</pre>
 
 <p>The <dfn title=dom-ElementCSSInlineStyle-style><code>style</code></dfn> attribute must return a <span>CSS declaration block</span> with the
-<span title=concept-css-declaration-block-declarations>declarations</span> being set to the declarations
-specified in the element's <code title>style</code> content attribute. If the
-<code title>style</code> content attribute is absent, the object represents an empty
-declaration. Mutating the <code>CSSStyleDeclaration</code> object must set the
+<span title=concept-css-declaration-block-declarations>declarations</span> being set to the result of <span title='Parse a CSS declaration block'>parsing</span>
+the <code title>style</code> content attribute. If the
+<code title>style</code> content attribute is absent, the object represents an empty list of
+declarations. Mutating the <code>CSSStyleDeclaration</code> object must set the
 <code title>style</code> content attribute on the element to the
 <span title='serialize a CSS declaration block'>serialization</span> of the
 <code>CSSStyleDeclaration</code>'s <span title=concept-css-declaration-block-declarations>declarations</span>.