Specify serialization algorithm for CSS style declaration block (i.e., for CSSStyleDeclarations).

Author: skynavga

cssom/Overview.html

@@ -1859,11 +1859,34 @@ <h3 id="css-declaration-blocks"><span class="secno">6.5 </span>CSS Declaration B
   <dfn id="parse-a-css-declaration-block">parse a CSS declaration block</dfn>
   ...</p>
 
-  <p class="issue">To
-  <dfn id="serialize-a-css-declaration-block">serialize a CSS declaration block</dfn>
-  ...</p>
+  <p>To <dfn id="serialize-a-css-declaration-block">serialize a CSS declaration block</dfn>
+  represented by a <code>CSSStyleDeclarations</code> instance named <var>d</var>,
+  let <var>s</var> be the empty string, then run the steps below:</p>
+
+  <ol>
+    <li><p>If <code><var>d</var>.length</code> is zero (0), then return <var>s</var>.</li>
+    <li><p>For each <var>i</var> from zero (0) through <code><var>d</var>.length</code> - 1 (inclusive), perform the following sub-steps:</p>
+    <ol>
+      <li><p>Let <var>n</var> be the value returned by <code><var>d</var>.item(<var>i</var>)</code>.</li>
+      <li><p>Let <var>v</var> be the value returned by <code><var>d</var>.getPropertyValue(<var>n</var>)</code>.</li>
+      <li><p>If <var>v</var> is the empty string, then continue.</li>
+      <li><p>Otherwise (<var>v</var> is non-empty), perform the following sub-steps:</p>
+          <ol>
+            <li><p>If <var>s</var> is not empty, then append a SPACE (U+0020) to <var>s</var>.</li>
+            <li><p>Append <var>n</var> to <var>s</var>.</li>
+            <li><p>Append COLON (U+003A) followed by SPACE (U+0020, i.e., "<code>: </code>", to <var>s</var>.</li>
+            <li><p>Append <var>v</var> to <var>s</var>.</li>
+            <li><p>Append SEMICOLON (U+003B), i.e., "<code>;</code>", to <var>s</var>.</li>
+          </ol>
+      </li>
+    </ol>
+    </li>
+  </ol>
 
+  <p class="note">The serialization of an empty CSS declaration block is the empty string.</p>
 
+  <p class="note">The serialization of an non-empty CSS declaration block does not including any surrounding whitespace, i.e., no whitepsace
+  before the first property name and no whitespace after the final semicolon delimiter that follows the last property value..</p>
 
   <!-- ........................................................................................................................ -->
 
@@ -1898,7 +1921,7 @@ <h4 id="the-cssstyledeclaration-interface"><span class="secno">6.5.1 </span>The
 <dt class="method" id="widl-CSSStyleDeclaration-item-DOMString-unsigned-long-index">
 <code>item</code> (<span class="idlParam"><span class="idlParamType"><a>unsigned long</a></span></span>), returns <span class="idlMethType"><a>DOMString</a></span></dt>
 <dd>
-<p>The <code>item</code> operation must return the property at position <var>index</var>.</dd>
+<p>The <code>item</code> operation must return the name of the property at position <var>index</var>.</dd>
 <dt class="method" id="widl-CSSStyleDeclaration-getPropertyValue-DOMString-DOMString-property">
 <code>getPropertyValue</code> (<span class="idlParam"><span class="idlParamType"><a>DOMString</a></span></span>), returns <span class="idlMethType"><a>DOMString</a></span></dt>
 <dd>

cssom/cssom-source

@@ -1463,11 +1463,34 @@
   <dfn id="parse-a-css-declaration-block">parse a CSS declaration block</dfn>
   ...</p>
 
-  <p class="issue">To
-  <dfn id="serialize-a-css-declaration-block">serialize a CSS declaration block</dfn>
-  ...</p>
+  <p>To <dfn id="serialize-a-css-declaration-block">serialize a CSS declaration block</dfn>
+  represented by a <code>CSSStyleDeclarations</code> instance named <var>d</var>,
+  let <var>s</var> be the empty string, then run the steps below:</p>
+
+  <ol>
+    <li><p>If <code><var>d</var>.length</code> is zero (0), then return <var>s</var>.</p></li>
+    <li><p>For each <var>i</var> from zero (0) through <code><var>d</var>.length</code> - 1 (inclusive), perform the following sub-steps:</p>
+    <ol>
+      <li><p>Let <var>n</var> be the value returned by <code><var>d</var>.item(<var>i</var>)</code>.</p></li>
+      <li><p>Let <var>v</var> be the value returned by <code><var>d</var>.getPropertyValue(<var>n</var>)</code>.</p></li>
+      <li><p>If <var>v</var> is the empty string, then continue.</p></li>
+      <li><p>Otherwise (<var>v</var> is non-empty), perform the following sub-steps:</p>
+          <ol>
+            <li><p>If <var>s</var> is not empty, then append a SPACE (U+0020) to <var>s</var>.</p></li>
+            <li><p>Append <var>n</var> to <var>s</var>.</p></li>
+            <li><p>Append COLON (U+003A) followed by SPACE (U+0020, i.e., "<code>: </code>", to <var>s</var>.</p></li>
+            <li><p>Append <var>v</var> to <var>s</var>.</p></li>
+            <li><p>Append SEMICOLON (U+003B), i.e., "<code>;</code>", to <var>s</var>.</p></li>
+          </ol>
+      </li>
+    </ol>
+    </li>
+  </ol>
 
+  <p class="note">The serialization of an empty CSS declaration block is the empty string.</p>
 
+  <p class="note">The serialization of an non-empty CSS declaration block does not including any surrounding whitespace, i.e., no whitepsace
+  before the first property name and no whitespace after the final semicolon delimiter that follows the last property value..</p>
 
   <!-- ........................................................................................................................ -->
 

cssom/idl/CSSStyleDeclaration.idl

@@ -32,7 +32,7 @@ interface CSSStyleDeclaration {
   readonly attribute unsigned long length;
 
   [Documentation=
-   "<p>The {@name} {@type} must return the property at position <var>index</var>.</p>"
+   "<p>The {@name} {@type} must return the name of the property at position <var>index</var>.</p>"
   ]
   DOMString item(unsigned long index);