(1) mark nullable attributes as such;

(2) update style sheet;

Author: skynavga

cssom-view/cssom.css

@@ -52,14 +52,14 @@ code {
 
 
 /* --- EXAMPLES --- */
-pre.example {
+.example {
     border-top: 1px solid #ff4500;
     border-bottom: 1px solid #ff4500;
     padding:    1em;
-    margin-top: 1em;
+    margin: 2em 0;
 }
 
-pre.example::before {
+.example::before {
     content:    "Example";
     display:    block;
     width:      150px;
@@ -74,7 +74,6 @@ pre.example::before {
 /* --- EDITORIAL NOTES --- */
 .issue {
     padding:    1em;
-    margin: 1em 0em 0em;
     border: 1px solid #f00;
     background: #ffc;
 }
@@ -91,7 +90,6 @@ pre.example::before {
 }
 
 .note {
-    margin: 1em 0em 0em;
     padding:    1em;
     border: 2px solid #cff6d9;
     background: #e2fff0;

cssom/Overview.html

@@ -18,7 +18,7 @@ <h1 id="cssom">CSS Object Model (CSSOM)</h1>
 
    <!-- ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
 
-   <h2 class="no-num no-toc" id="w3c-doctype">Editor's Draft 3 August 2012</h2>
+   <h2 class="no-num no-toc" id="w3c-doctype">Editor's Draft 11 August 2012</h2>
 
    <dl>
 
@@ -83,7 +83,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 3 August 2012 Editor's Draft of CSSOM. Please send comments to
+  <p class="dontpublish">This is the 11 August 2012 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.
@@ -885,10 +885,10 @@ <h4 id="the-stylesheet-interface"><span class="secno">6.1.1 </span>The <code>Sty
   <p>The <code>StyleSheet</code> interface represents an abstract, base style sheet.</p>
 <pre class="idl"><span class="idlInterface" id="widl-def-StyleSheet">interface <span class="idlInterfaceID">StyleSheet</span> {
 <span class="idlAttribute">    readonly attribute <span class="idlAttrType"><a>DOMString</a></span> <span class="idlAttrName"><a href="#widl-StyleSheet-type">type</a></span>;</span>
-<span class="idlAttribute">    readonly attribute <span class="idlAttrType"><a>DOMString</a></span> <span class="idlAttrName"><a href="#widl-StyleSheet-href">href</a></span>;</span>
+<span class="idlAttribute">    readonly attribute <span class="idlAttrType"><a>DOMString</a>?</span> <span class="idlAttrName"><a href="#widl-StyleSheet-href">href</a></span>;</span>
 <span class="idlAttribute">    readonly attribute <span class="idlAttrType"><a>Node</a></span> <span class="idlAttrName"><a href="#widl-StyleSheet-ownerNode">ownerNode</a></span>;</span>
-<span class="idlAttribute">    readonly attribute <span class="idlAttrType"><a>StyleSheet</a></span> <span class="idlAttrName"><a href="#widl-StyleSheet-parentStyleSheet">parentStyleSheet</a></span>;</span>
-<span class="idlAttribute">    readonly attribute <span class="idlAttrType"><a>DOMString</a></span> <span class="idlAttrName"><a href="#widl-StyleSheet-title">title</a></span>;</span>
+<span class="idlAttribute">    readonly attribute <span class="idlAttrType"><a>StyleSheet</a>?</span> <span class="idlAttrName"><a href="#widl-StyleSheet-parentStyleSheet">parentStyleSheet</a></span>;</span>
+<span class="idlAttribute">    readonly attribute <span class="idlAttrType"><a>DOMString</a>?</span> <span class="idlAttrName"><a href="#widl-StyleSheet-title">title</a></span>;</span>
 <span class="idlAttribute">    readonly attribute <span class="idlAttrType"><a>MediaList</a></span> <span class="idlAttrName"><a href="#widl-StyleSheet-media">media</a></span>;</span>
 <span class="idlAttribute">    attribute <span class="idlAttrType"><a>boolean</a></span> <span class="idlAttrName"><a href="#widl-StyleSheet-disabled">disabled</a></span>;</span>
 };</span></pre>
@@ -900,23 +900,23 @@ <h4 id="the-stylesheet-interface"><span class="secno">6.1.1 </span>The <code>Sty
 <dt class="attribute" id="widl-StyleSheet-href">
 <code>href</code> of type <span class="idlAttrType"><a>DOMString</a></span>, readonly</dt>
 <dd>
-<p>The <code>href</code> attribute must return the <a href="#style-sheet-location">style sheet location</a>.</dd>
+<p>The <code>href</code> attribute must return the <a href="#style-sheet-location">style sheet location</a> or null if none.</p>    <p class="issue">What should the default value be if not known or specified upon creation? an empty string or null?</dd>
 <dt class="attribute" id="widl-StyleSheet-ownerNode">
 <code>ownerNode</code> of type <span class="idlAttrType"><a>Node</a></span>, readonly</dt>
 <dd>
-<p>The <code>ownerNode</code> attribute must return the <a href="#style-sheet-owner-node">style sheet owner node</a>.</dd>
+<p>The <code>ownerNode</code> attribute must return the <a href="#style-sheet-owner-node">style sheet owner node</a>.</p>    <p class="issue">Should <code>ownerNode</code> be nullable?</dd>
 <dt class="attribute" id="widl-StyleSheet-parentStyleSheet">
 <code>parentStyleSheet</code> of type <span class="idlAttrType"><a>StyleSheet</a></span>, readonly</dt>
 <dd>
-<p>The <code>parentStyleSheet</code> attribute must return the <a href="#style-sheet-parent">style sheet parent</a>.</dd>
+<p>The <code>parentStyleSheet</code> attribute must return the <a href="#style-sheet-parent">style sheet parent</a> or null if there is none.</dd>
 <dt class="attribute" id="widl-StyleSheet-title">
 <code>title</code> of type <span class="idlAttrType"><a>DOMString</a></span>, readonly</dt>
 <dd>
-<p>The <code>title</code> attribute must return the <a href="#style-sheet-title">style sheet title</a>.</dd>
+<p>The <code>title</code> attribute must return the <a href="#style-sheet-title">style sheet title</a> or null if none.</p>    <p class="issue">What should the default value be if not known or specified upon creation? an empty string or null?</dd>
 <dt class="attribute" id="widl-StyleSheet-media">
 <code>media</code> of type <span class="idlAttrType"><a>MediaList</a></span>, readonly</dt>
 <dd>
-<p>The <code>media</code> attribute must return the <a href="#style-sheet-media">style sheet media</a>.</dd>
+<p>The <code>media</code> attribute must return the <a href="#style-sheet-media">style sheet media</a>.</p>    <p class="issue">Should <code>media</code> be nullable?</p>    <p class="issue">Need to define a setter that implements the semantics of setting this attribute to a string representing a MediaList.</dd>
 <dt class="attribute" id="widl-StyleSheet-disabled">
 <code>disabled</code> of type <span class="idlAttrType"><a>boolean</a></span></dt>
 <dd>
@@ -930,7 +930,7 @@ <h4 id="the-cssstylesheet-interface"><span class="secno">6.1.2 </span>The <code>
 
   <p>The <code>CSSStyleSheet</code> interface represents a CSS <a href="#style-sheet">style sheet</a> rule.</p>
 <pre class="idl"><span class="idlInterface" id="widl-def-CSSStyleSheet">interface <span class="idlInterfaceID">CSSStyleSheet</span> {
-<span class="idlAttribute">    readonly attribute <span class="idlAttrType"><a>CSSRule</a></span> <span class="idlAttrName"><a href="#widl-CSSStyleSheet-ownerRule">ownerRule</a></span>;</span>
+<span class="idlAttribute">    readonly attribute <span class="idlAttrType"><a>CSSRule</a>?</span> <span class="idlAttrName"><a href="#widl-CSSStyleSheet-ownerRule">ownerRule</a></span>;</span>
 <span class="idlAttribute">    readonly attribute <span class="idlAttrType"><a>CSSRuleList</a></span> <span class="idlAttrName"><a href="#widl-CSSStyleSheet-cssRules">cssRules</a></span>;</span>
 <span class="idlMethod">    <span class="idlMethType"><a>unsigned long</a></span> <span class="idlMethName"><a href="#widl-CSSStyleSheet-insertRule-unsigned-long-DOMString-rule-unsigned-long-index">insertRule</a></span> (<span class="idlParam"><span class="idlParamType"><a>DOMString</a></span> <span class="idlParamName">rule</span></span>, <span class="idlParam"><span class="idlParamType"><a>unsigned long</a></span> <span class="idlParamName">index</span></span>);</span>
 <span class="idlMethod">    <span class="idlMethType"><a>void</a></span> <span class="idlMethName"><a href="#widl-CSSStyleSheet-deleteRule-void-unsigned-long-index">deleteRule</a></span> (<span class="idlParam"><span class="idlParamType"><a>unsigned long</a></span> <span class="idlParamName">index</span></span>);</span>
@@ -939,7 +939,7 @@ <h4 id="the-cssstylesheet-interface"><span class="secno">6.1.2 </span>The <code>
 <dt class="attribute" id="widl-CSSStyleSheet-ownerRule">
 <code>ownerRule</code> of type <span class="idlAttrType"><a>CSSRule</a></span>, readonly</dt>
 <dd>
-<p>The <code>ownerRule</code> attribute must return the <a href="#style-sheet-owner-css-rule">style sheet owner CSS rule</a>.</dd>
+<p>The <code>ownerRule</code> attribute must return the <a href="#style-sheet-owner-css-rule">style sheet owner CSS rule</a> or null if none.</dd>
 <dt class="attribute" id="widl-CSSStyleSheet-cssRules">
 <code>cssRules</code> of type <span class="idlAttrType"><a>CSSRuleList</a></span>, readonly</dt>
 <dd>
@@ -1856,7 +1856,7 @@ <h4 id="the-cssstyledeclaration-interface"><span class="secno">6.5.1 </span>The
 <span class="idlMethod">    <span class="idlMethType"><a>DOMString</a></span> <span class="idlMethName"><a href="#widl-CSSStyleDeclaration-getPropertyPriority-DOMString-DOMString-property">getPropertyPriority</a></span> (<span class="idlParam"><span class="idlParamType"><a>DOMString</a></span> <span class="idlParamName">property</span></span>);</span>
 <span class="idlMethod">    <span class="idlMethType"><a>void</a></span> <span class="idlMethName"><a href="#widl-CSSStyleDeclaration-setProperty-void-DOMString-property-DOMString-value-DOMString-priority">setProperty</a></span> (<span class="idlParam"><span class="idlParamType"><a>DOMString</a></span> <span class="idlParamName">property</span></span>, <span class="idlParam"><span class="idlParamType"><a>DOMString</a></span> <span class="idlParamName">value</span></span>, <span class="idlParam">optional <span class="idlParamType"><a>DOMString</a></span> <span class="idlParamName">priority</span></span>);</span>
 <span class="idlMethod">    <span class="idlMethType"><a>DOMString</a></span> <span class="idlMethName"><a href="#widl-CSSStyleDeclaration-removeProperty-DOMString-DOMString-property">removeProperty</a></span> (<span class="idlParam"><span class="idlParamType"><a>DOMString</a></span> <span class="idlParamName">property</span></span>);</span>
-<span class="idlAttribute">    readonly attribute <span class="idlAttrType"><a>CSSRule</a></span> <span class="idlAttrName"><a href="#widl-CSSStyleDeclaration-parentRule">parentRule</a></span>;</span>
+<span class="idlAttribute">    readonly attribute <span class="idlAttrType"><a>CSSRule</a>?</span> <span class="idlAttrName"><a href="#widl-CSSStyleDeclaration-parentRule">parentRule</a></span>;</span>
 };</span></pre>
 <dl class="attributes">
 <dt class="attribute" id="widl-CSSStyleDeclaration-cssText">

cssom/cssom.css

@@ -74,7 +74,6 @@ code {
 /* --- EDITORIAL NOTES --- */
 .issue {
     padding:    1em;
-    margin: 1em 0em 0em;
     border: 1px solid #f00;
     background: #ffc;
 }
@@ -91,7 +90,6 @@ code {
 }
 
 .note {
-    margin: 1em 0em 0em;
     padding:    1em;
     border: 2px solid #cff6d9;
     background: #e2fff0;

cssom/idl/CSSStyleDeclaration.idl

@@ -85,6 +85,6 @@ interface CSSStyleDeclaration {
    "<p>The {@name} {@type} must return the <code>CSSrule</code> object the <code>CSSStyleDeclaration</code> is object is associated with\
     or null if it is not associated with a <code>CSSrule</code> object.</p>"
   ]
-  readonly attribute CSSRule parentRule;
+  readonly attribute CSSRule? parentRule;
 
 };

cssom/idl/CSSStyleSheet.idl

@@ -10,9 +10,9 @@
 interface CSSStyleSheet : StyleSheet {
 
   [Documentation=
-   "<p>The {@name} {@type} must return the <span>style sheet owner CSS rule</span>.</p>"
+   "<p>The {@name} {@type} must return the <span>style sheet owner CSS rule</span> or null if none.</p>"
   ]
-  readonly attribute CSSRule ownerRule;
+  readonly attribute CSSRule? ownerRule;
 
   [Documentation=
    "<p>The {@name} {@type} must return a <code>CSSRuleList</code> object representing the <span>style\

cssom/idl/StyleSheet.idl

@@ -15,28 +15,32 @@ interface StyleSheet {
   readonly attribute DOMString type;
 
   [Documentation=
-   "<p>The {@name} {@type} must return the <span>style sheet location</span>.</p>"
+   "<p>The {@name} {@type} must return the <span>style sheet location</span> or null if none.</p>\
+    <p class='issue'>What should the default value be if not known or specified upon creation? an empty string or null?</p>"
   ]
-  readonly attribute DOMString href;
+  readonly attribute DOMString? href;
 
   [Documentation=
-   "<p>The {@name} {@type} must return the <span>style sheet owner node</span>.</p>"
+   "<p>The {@name} {@type} must return the <span>style sheet owner node</span>.</p>\
+    <p class='issue'>Should {@name} be nullable?</p>"
   ]
   readonly attribute Node ownerNode;
 
   [Documentation=
-   "<p>The {@name} {@type} must return the <span>style sheet parent</span>.</p>"
+   "<p>The {@name} {@type} must return the <span>style sheet parent</span> or null if there is none.</p>"
   ]
-  readonly attribute StyleSheet parentStyleSheet;
+  readonly attribute StyleSheet? parentStyleSheet;
 
   [Documentation=
-   "<p>The {@name} {@type} must return the <span>style sheet title</span>.</p>"
+   "<p>The {@name} {@type} must return the <span>style sheet title</span> or null if none.</p>\
+    <p class='issue'>What should the default value be if not known or specified upon creation? an empty string or null?</p>"
   ]
-  readonly attribute DOMString title;
+  readonly attribute DOMString? title;
 
-  [PutForwards=mediaText,       // [GA] there is no mediaText attribute!
-   Documentation=
-   "<p>The {@name} {@type} must return the <span>style sheet media</span>.</p>"
+  [Documentation=
+   "<p>The {@name} {@type} must return the <span>style sheet media</span>.</p>\
+    <p class='issue'>Should {@name} be nullable?</p>\
+    <p class='issue'>Need to define a setter that implements the semantics of setting this attribute to a string representing a MediaList.</p>"
   ]
   readonly attribute MediaList media;