Fri, 07 Jun 2013 15:39:07 +0200
[cssom] Cleanup around the properties of CSS style sheet
cssom/Overview.html | file | annotate | diff | comparison | revisions | |
cssom/Overview.src.html | file | annotate | diff | comparison | revisions |
1.1 --- a/cssom/Overview.html Fri Jun 07 14:43:47 2013 +0200 1.2 +++ b/cssom/Overview.html Fri Jun 07 15:39:07 2013 +0200 1.3 @@ -864,39 +864,35 @@ 1.4 <dd><p>The literal string "<code title="">text/css</code>".</dd> 1.5 1.6 <dt><dfn id="concept-css-style-sheet-location" title="concept-css-style-sheet-location">location</dfn></dt> 1.7 - <dd><p>The <a class="external" href="http://url.spec.whatwg.org/#concept-absolute-url" title="concept-absolute-url">absolute URL</a> of the first request of the 1.8 + <dd><p>Specified when created. The <a class="external" href="http://url.spec.whatwg.org/#concept-absolute-url" title="concept-absolute-url">absolute URL</a> of the first request of the 1.9 <a href="#css-style-sheet">CSS style sheet</a> or null if the <a href="#css-style-sheet">CSS style sheet</a> was 1.10 - embedded.</dd> 1.11 + embedded. Does not change during the lifetime of the <a href="#css-style-sheet">CSS style sheet</a>.</dd> 1.12 1.13 <dt><dfn id="concept-css-style-sheet-parent" title="concept-css-style-sheet-parent">parent</dfn></dt> 1.14 - <dd><p>The <a href="#css-style-sheet">CSS style sheet</a> that is the parent of the 1.15 + <dd><p>Specified when created. The <a href="#css-style-sheet">CSS style sheet</a> that is the parent of the 1.16 <a href="#css-style-sheet">CSS style sheet</a> or null if there is no associated parent.</dd> 1.17 1.18 <dt><dfn id="concept-css-style-sheet-owner-node" title="concept-css-style-sheet-owner-node">owner node</dfn></dt> 1.19 - <dd><p>The DOM node associated with the <a href="#css-style-sheet">CSS style sheet</a> or 1.20 + <dd><p>Specified when created. The DOM node associated with the <a href="#css-style-sheet">CSS style sheet</a> or 1.21 null if there is no associated DOM node.</dd> 1.22 1.23 <dt><dfn id="concept-css-style-sheet-owner-css-rule" title="concept-css-style-sheet-owner-css-rule">owner CSS rule</dfn></dt> 1.24 - <dd><p>The <a href="#css-rule">CSS rule</a> in the <a href="#concept-css-style-sheet-parent" title="concept-css-style-sheet-parent">parent</a> 1.25 + <dd><p>Specified when created. The <a href="#css-rule">CSS rule</a> in the <a href="#concept-css-style-sheet-parent" title="concept-css-style-sheet-parent">parent</a> 1.26 that caused the inclusion of the <a href="#css-style-sheet">CSS style sheet</a> or null if 1.27 there is no associated rule.</dd> 1.28 1.29 <dt><dfn id="concept-css-style-sheet-media" title="concept-css-style-sheet-media">media</dfn></dt> 1.30 <dd> 1.31 - <p>The <code><a href="#medialist">MediaList</a></code> object associated with the 1.32 + <p>Specified when created. The <code><a href="#medialist">MediaList</a></code> object associated with the 1.33 <a href="#css-style-sheet">CSS style sheet</a>.</p> 1.34 1.35 - <p>If this property is set to a string run the 1.36 - <a href="#create-a-medialist-object">create a <code>MediaList</code> object</a> steps for that 1.37 - string and associate the returned object with the 1.38 - <a href="#css-style-sheet">CSS style sheet</a>.</p> 1.39 + <p>If this property is specified to a string, the <a href="#concept-css-style-sheet-media" title="concept-css-style-sheet-media">media</a> must be set to the return value of invoking 1.40 + <a href="#create-a-medialist-object">create a <code>MediaList</code> object</a> steps for that string.</p> 1.41 </dd> 1.42 1.43 <dt><dfn id="concept-css-style-sheet-title" title="concept-css-style-sheet-title">title</dfn></dt> 1.44 <dd> 1.45 - <p>The title of the <a href="#css-style-sheet">CSS style sheet</a> or null if no title 1.46 - is specified or is the empty string, in which case the title is referred to 1.47 - as an empty title.</p> 1.48 + <p>Specified when created. The title of the <a href="#css-style-sheet">CSS style sheet</a>, which can be the empty string.</p> 1.49 1.50 <div class="example"> 1.51 <p>In the following, the <a href="#concept-css-style-sheet-title" title="concept-css-style-sheet-title">title</a> is non-empty 1.52 @@ -915,7 +911,7 @@ 1.53 1.54 <dt><dfn id="concept-css-style-sheet-alternate-flag" title="concept-css-style-sheet-alternate-flag">alternate flag</dfn></dt> 1.55 <dd> 1.56 - <p>Either set or clear. Clear by default.</p> 1.57 + <p>Specified when created. Either set or clear. Clear by default.</p> 1.58 1.59 <div class="example"> 1.60 <p>The following <a href="#css-style-sheet" title="CSS style sheet">CSS style sheets</a> have 1.61 @@ -941,16 +937,10 @@ 1.62 <a href="#css-style-sheet">CSS style sheet</a>.</dd> 1.63 1.64 <dt><dfn id="concept-css-style-sheet-origin-clean-flag" title="concept-css-style-sheet-origin-clean-flag">origin-clean flag</dfn> 1.65 - <dd><p>Either set or clear. If it is set, the API allows reading and modifying of the <a href="#concept-css-style-sheet-css-rules" title="concept-css-style-sheet-css-rules">CSS rules</a>. 1.66 + <dd><p>Specified when created. Either set or clear. If it is set, the API allows reading and modifying of the <a href="#concept-css-style-sheet-css-rules" title="concept-css-style-sheet-css-rules">CSS 1.67 + rules</a>. 1.68 </dl> 1.69 1.70 -<p>When you are to <a href="#create-a-css-style-sheet">create a CSS style sheet</a> the above properties, 1.71 -with the exception of <a href="#concept-css-style-sheet-type" title="concept-css-style-sheet-type">type</a> and 1.72 -<a href="#concept-css-style-sheet-css-rules" title="concept-css-style-sheet-css-rules">CSS rules</a>, are to be set to 1.73 -their proper values.</p> 1.74 - 1.75 -<!-- same-origin restrictions --> 1.76 - 1.77 1.78 <h4 id="the-stylesheet-interface"><span class="secno">6.1.1 </span>The <code title="">StyleSheet</code> Interface</h4> 1.79 1.80 @@ -979,7 +969,6 @@ 1.81 1.82 <p>The <dfn id="dom-stylesheet-href" title="dom-StyleSheet-href"><code>href</code></dfn> attribute must return the <a href="#concept-css-style-sheet-location" title="concept-css-style-sheet-location">location</a> or null if 1.83 none.</p> 1.84 -<p class="XXX">What should the default value be if not known or specified upon creation? an empty string or null?</p> 1.85 1.86 <p>The <dfn id="dom-stylesheet-ownernode" title="dom-StyleSheet-ownerNode"><code>ownerNode</code></dfn> attribute must return the <a href="#concept-css-style-sheet-owner-node" title="concept-css-style-sheet-owner-node">owner 1.87 node</a> or null if there is none.</p> 1.88 @@ -988,12 +977,9 @@ 1.89 <a href="#concept-css-style-sheet-parent" title="concept-css-style-sheet-parent">parent</a> or null if there is none.</p> 1.90 1.91 <p>The <dfn id="dom-stylesheet-title" title="dom-StyleSheet-title"><code>title</code></dfn> attribute must return the <a href="#concept-css-style-sheet-title" title="concept-css-style-sheet-title">title</a> or null if 1.92 -none.</p> 1.93 -<p class="XXX">What should the default value be if not known or specified upon creation? an empty string or null?</p> 1.94 +<a href="#concept-css-style-sheet-title" title="concept-css-style-sheet-title">title</a> is the empty string.</p> 1.95 1.96 <p>The <dfn id="dom-stylesheet-media" title="dom-StyleSheet-media"><code>media</code></dfn> attribute must return the <a href="#concept-css-style-sheet-media" title="concept-css-style-sheet-media">media</a>.</p> 1.97 -<p class="XXX">Should it be nullable?</p> 1.98 -<p class="XXX">Need to define a setter that implements the semantics of setting this attribute to a string representing a MediaList.</p> 1.99 1.100 <p>The <dfn id="dom-stylesheet-disabled" title="dom-StyleSheet-disabled"><code>disabled</code></dfn> attribute, on getting, must return true if the 1.101 <a href="#concept-css-style-sheet-disabled-flag" title="concept-css-style-sheet-disabled-flag">disabled flag</a> 1.102 @@ -1092,7 +1078,7 @@ 1.103 <li><p>If the <a href="#concept-css-style-sheet-disabled-flag" title="concept-css-style-sheet-disabled-flag">disabled flag</a> is set, terminate 1.104 these steps.</li> 1.105 1.106 - <li><p>If the <a href="#concept-css-style-sheet-title" title="concept-css-style-sheet-title">title</a> is non-empty, the 1.107 + <li><p>If the <a href="#concept-css-style-sheet-title" title="concept-css-style-sheet-title">title</a> is not the empty string, the 1.108 <a href="#concept-css-style-sheet-alternate-flag" title="concept-css-style-sheet-alternate-flag">alternate flag</a> is clear, and 1.109 <a href="#preferred-css-style-sheet-set-name">preferred CSS style sheet set name</a> is the empty string 1.110 <a href="#change-the-preferred-css-style-sheet-set-name">change the preferred CSS style sheet set name</a> to the 1.111 @@ -1103,7 +1089,7 @@ 1.112 <a href="#concept-css-style-sheet-disabled-flag" title="concept-css-style-sheet-disabled-flag">disabled flag</a> and terminate these steps: 1.113 1.114 <ul> 1.115 - <li><p>The <a href="#concept-css-style-sheet-title" title="concept-css-style-sheet-title">title</a> is empty.</li> 1.116 + <li><p>The <a href="#concept-css-style-sheet-title" title="concept-css-style-sheet-title">title</a> is the empty string.</li> 1.117 <li><p>The <a href="#last-css-style-sheet-set-name">last CSS style sheet set name</a> is null and the 1.118 <a href="#concept-css-style-sheet-title" title="concept-css-style-sheet-title">title</a> is a 1.119 <a class="external" href="http://dom.spec.whatwg.org/#case-sensitive">case-sensitive</a> match 1.120 @@ -1302,8 +1288,8 @@ 1.121 <p>The <dfn id="dom-document-selectedstylesheetset" title="dom-Document-selectedStyleSheetSet"><code>selectedStyleSheetSet</code></dfn> attribute, on getting, must run these steps:</p> 1.122 <ol> 1.123 <li><p>If there is a single <a href="#enabled-css-style-sheet-set">enabled CSS style sheet set</a> and no 1.124 - other <a href="#document-css-style-sheets">document CSS style sheets</a> with a non-empty 1.125 - <a href="#concept-css-style-sheet-title" title="concept-css-style-sheet-title">title</a> have the 1.126 + other <a href="#document-css-style-sheets">document CSS style sheets</a> with a 1.127 + <a href="#concept-css-style-sheet-title" title="concept-css-style-sheet-title">title</a> that is not the empty string have the 1.128 <a href="#concept-css-style-sheet-disabled-flag" title="concept-css-style-sheet-disabled-flag">disabled flag</a> unset, return the 1.129 <a href="#css-style-sheet-set-name">CSS style sheet set name</a> of the 1.130 <a href="#enabled-css-style-sheet-set">enabled CSS style sheet set</a> and terminate these steps.</li> 1.131 @@ -1317,8 +1303,8 @@ 1.132 <p>Otherwise, return the empty string.</p> 1.133 1.134 <p class="note">At this point either all 1.135 - <a href="#css-style-sheet" title="CSS style sheet">CSS style sheets</a> with a non-empty 1.136 - <a href="#concept-css-style-sheet-title" title="concept-css-style-sheet-title">title</a> have the 1.137 + <a href="#css-style-sheet" title="CSS style sheet">CSS style sheets</a> with a 1.138 + <a href="#concept-css-style-sheet-title" title="concept-css-style-sheet-title">title</a> that is not the empty string have the 1.139 <a href="#concept-css-style-sheet-disabled-flag" title="concept-css-style-sheet-disabled-flag">disabled flag</a> set, or there are no such 1.140 <a href="#css-style-sheet" title="CSS style sheet">CSS style sheets</a>.</p> 1.141 </li> 1.142 @@ -1361,8 +1347,8 @@ 1.143 <li><p>If <var title="">name</var> is null terminate these steps.</li> 1.144 <li><p><a href="#enable-a-css-style-sheet-set">enable a CSS style sheet set</a> with name <var title="">name</var>.</li> 1.145 </ol> 1.146 -<p class="note"><a href="#css-style-sheet" title="CSS style sheet">CSS style sheets</a> with an 1.147 -empty <a href="#concept-css-style-sheet-title" title="concept-css-style-sheet-title">title</a> are never affected by this method. 1.148 +<p class="note"><a href="#css-style-sheet" title="CSS style sheet">CSS style sheets</a> with a 1.149 +<a href="#concept-css-style-sheet-title" title="concept-css-style-sheet-title">title</a> that is the empty string are never affected by this method. 1.150 This method does not change the values of the 1.151 <code title="dom-Document-lastStyleSheetSet"><a href="#dom-document-laststylesheetset">lastStyleSheetSet</a></code> or 1.152 <code title="dom-Document-preferredStyleSheetSet"><a href="#dom-document-preferredstylesheetset">preferredStyleSheetSet</a></code> attributes.</p> 1.153 @@ -1760,10 +1746,8 @@ 1.154 1.155 <p>To <dfn id="parse-a-css-rule">parse a CSS rule</dfn> ...</p> 1.156 1.157 -<p class="XXX">Should a rule be instantiated in OM if there is a parse error? To 1.158 -what extent should original (but non-valid) CSS text be captured in cssText?</p> 1.159 - 1.160 -<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> 1.161 +<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 1.162 +<a href="#concept-css-rule-type" title="concept-css-rule-type">type</a>:</p> 1.163 1.164 <dl class="switch"> 1.165 <dt><code><a href="#cssstylerule">CSSStyleRule</a></code></dt> 1.166 @@ -1848,8 +1832,6 @@ 1.167 <li><p>Insert <var title="">new rule</var> into <var title="">list</var> at the zero-indexed position <var title="">index</var>.<p></li> 1.168 <li><p>Return <var title="">index</var>. 1.169 </ol> 1.170 -<p class="XXX">DOM-2 CSS specifies that a <code>NO_MODIFICATION_ALLOWED_ERR</code> exception is thrown 1.171 -if the style sheet is read-only. Are there any read-only style sheets?</p> 1.172 1.173 <p>To <dfn id="remove-a-css-rule">remove a CSS rule</dfn> from a CSS rule list <var title="">list</var> at index <var title="">index</var>, follow these steps:</p> 1.174 <ol> 1.175 @@ -2154,9 +2136,6 @@ 1.176 1.177 <p>To <dfn id="parse-a-css-declaration-block">parse a CSS declaration block</dfn> ...</p> 1.178 1.179 -<p class="XXX">What should be captured in the cssText of a declaration block which fails 1.180 -to parse?</p> 1.181 - 1.182 <p>To <dfn id="serialize-a-css-declaration-block">serialize a CSS declaration block</dfn> 1.183 represented by a <code>CSSStyleDeclarations</code> instance named <var title="">d</var>, 1.184 let <var title="">s</var> be the empty string, then run the steps below:</p>
2.1 --- a/cssom/Overview.src.html Fri Jun 07 14:43:47 2013 +0200 2.2 +++ b/cssom/Overview.src.html Fri Jun 07 15:39:07 2013 +0200 2.3 @@ -795,39 +795,35 @@ 2.4 <dd><p>The literal string "<code title>text/css</code>".</p></dd> 2.5 2.6 <dt><dfn title=concept-css-style-sheet-location>location</dfn></dt> 2.7 - <dd><p>The <span data-anolis-spec=url title=concept-absolute-url>absolute URL</span> of the first request of the 2.8 + <dd><p>Specified when created. The <span data-anolis-spec=url title=concept-absolute-url>absolute URL</span> of the first request of the 2.9 <span>CSS style sheet</span> or null if the <span>CSS style sheet</span> was 2.10 - embedded.</p></dd> 2.11 + embedded. Does not change during the lifetime of the <span>CSS style sheet</span>.</p></dd> 2.12 2.13 <dt><dfn title=concept-css-style-sheet-parent>parent</dfn></dt> 2.14 - <dd><p>The <span>CSS style sheet</span> that is the parent of the 2.15 + <dd><p>Specified when created. The <span>CSS style sheet</span> that is the parent of the 2.16 <span>CSS style sheet</span> or null if there is no associated parent.</p></dd> 2.17 2.18 <dt><dfn title=concept-css-style-sheet-owner-node>owner node</dfn></dt> 2.19 - <dd><p>The DOM node associated with the <span>CSS style sheet</span> or 2.20 + <dd><p>Specified when created. The DOM node associated with the <span>CSS style sheet</span> or 2.21 null if there is no associated DOM node.</p></dd> 2.22 2.23 <dt><dfn title=concept-css-style-sheet-owner-css-rule>owner CSS rule</dfn></dt> 2.24 - <dd><p>The <span>CSS rule</span> in the <span title=concept-css-style-sheet-parent>parent</span> 2.25 + <dd><p>Specified when created. The <span>CSS rule</span> in the <span title=concept-css-style-sheet-parent>parent</span> 2.26 that caused the inclusion of the <span>CSS style sheet</span> or null if 2.27 there is no associated rule.</p></dd> 2.28 2.29 <dt><dfn title=concept-css-style-sheet-media>media</dfn></dt> 2.30 <dd> 2.31 - <p>The <code>MediaList</code> object associated with the 2.32 + <p>Specified when created. The <code>MediaList</code> object associated with the 2.33 <span>CSS style sheet</span>.</p> 2.34 2.35 - <p>If this property is set to a string run the 2.36 - <span>create a <code>MediaList</code> object</span> steps for that 2.37 - string and associate the returned object with the 2.38 - <span>CSS style sheet</span>.</p> 2.39 + <p>If this property is specified to a string, the <span title=concept-css-style-sheet-media>media</span> must be set to the return value of invoking 2.40 + <span>create a <code>MediaList</code> object</span> steps for that string.</p> 2.41 </dd> 2.42 2.43 <dt><dfn title=concept-css-style-sheet-title>title</dfn></dt> 2.44 <dd> 2.45 - <p>The title of the <span>CSS style sheet</span> or null if no title 2.46 - is specified or is the empty string, in which case the title is referred to 2.47 - as an empty title.</p> 2.48 + <p>Specified when created. The title of the <span>CSS style sheet</span>, which can be the empty string.</p> 2.49 2.50 <div class="example"> 2.51 <p>In the following, the <span title=concept-css-style-sheet-title>title</span> is non-empty 2.52 @@ -846,7 +842,7 @@ 2.53 2.54 <dt><dfn title=concept-css-style-sheet-alternate-flag>alternate flag</dfn></dt> 2.55 <dd> 2.56 - <p>Either set or clear. Clear by default.</p> 2.57 + <p>Specified when created. Either set or clear. Clear by default.</p> 2.58 2.59 <div class="example"> 2.60 <p>The following <span title="CSS style sheet">CSS style sheets</span> have 2.61 @@ -872,16 +868,10 @@ 2.62 <span>CSS style sheet</span>.</p></dd> 2.63 2.64 <dt><dfn title=concept-css-style-sheet-origin-clean-flag>origin-clean flag</dfn> 2.65 - <dd><p>Either set or clear. If it is set, the API allows reading and modifying of the <span title=concept-css-style-sheet-css-rules>CSS rules</span>. 2.66 + <dd><p>Specified when created. Either set or clear. If it is set, the API allows reading and modifying of the <span title=concept-css-style-sheet-css-rules>CSS 2.67 + rules</span>. 2.68 </dl> 2.69 2.70 -<p>When you are to <span>create a CSS style sheet</span> the above properties, 2.71 -with the exception of <span title=concept-css-style-sheet-type>type</span> and 2.72 -<span title=concept-css-style-sheet-css-rules>CSS rules</span>, are to be set to 2.73 -their proper values.</p> 2.74 - 2.75 -<!-- same-origin restrictions --> 2.76 - 2.77 2.78 <h4>The <code title>StyleSheet</code> Interface</h4> 2.79 2.80 @@ -910,7 +900,6 @@ 2.81 2.82 <p>The <dfn title=dom-StyleSheet-href><code>href</code></dfn> attribute must return the <span title=concept-css-style-sheet-location>location</span> or null if 2.83 none.</p> 2.84 -<p class='XXX'>What should the default value be if not known or specified upon creation? an empty string or null?</p> 2.85 2.86 <p>The <dfn title=dom-StyleSheet-ownerNode><code>ownerNode</code></dfn> attribute must return the <span title=concept-css-style-sheet-owner-node>owner 2.87 node</span> or null if there is none.</p> 2.88 @@ -919,12 +908,9 @@ 2.89 <span title=concept-css-style-sheet-parent>parent</span> or null if there is none.</p> 2.90 2.91 <p>The <dfn title=dom-StyleSheet-title><code>title</code></dfn> attribute must return the <span title=concept-css-style-sheet-title>title</span> or null if 2.92 -none.</p> 2.93 -<p class='XXX'>What should the default value be if not known or specified upon creation? an empty string or null?</p> 2.94 +<span title=concept-css-style-sheet-title>title</span> is the empty string.</p> 2.95 2.96 <p>The <dfn title=dom-StyleSheet-media><code>media</code></dfn> attribute must return the <span title=concept-css-style-sheet-media>media</span>.</p> 2.97 -<p class='XXX'>Should it be nullable?</p> 2.98 -<p class='XXX'>Need to define a setter that implements the semantics of setting this attribute to a string representing a MediaList.</p> 2.99 2.100 <p>The <dfn title=dom-StyleSheet-disabled><code>disabled</code></dfn> attribute, on getting, must return true if the 2.101 <span title=concept-css-style-sheet-disabled-flag>disabled flag</span> 2.102 @@ -1023,7 +1009,7 @@ 2.103 <li><p>If the <span title=concept-css-style-sheet-disabled-flag>disabled flag</span> is set, terminate 2.104 these steps.</p></li> 2.105 2.106 - <li><p>If the <span title=concept-css-style-sheet-title>title</span> is non-empty, the 2.107 + <li><p>If the <span title=concept-css-style-sheet-title>title</span> is not the empty string, the 2.108 <span title=concept-css-style-sheet-alternate-flag>alternate flag</span> is clear, and 2.109 <span>preferred CSS style sheet set name</span> is the empty string 2.110 <span>change the preferred CSS style sheet set name</span> to the 2.111 @@ -1034,7 +1020,7 @@ 2.112 <span title=concept-css-style-sheet-disabled-flag>disabled flag</span> and terminate these steps: 2.113 2.114 <ul> 2.115 - <li><p>The <span title=concept-css-style-sheet-title>title</span> is empty.</p></li> 2.116 + <li><p>The <span title=concept-css-style-sheet-title>title</span> is the empty string.</p></li> 2.117 <li><p>The <span>last CSS style sheet set name</span> is null and the 2.118 <span title=concept-css-style-sheet-title>title</span> is a 2.119 <span data-anolis-spec=dom>case-sensitive</span> match 2.120 @@ -1233,8 +1219,8 @@ 2.121 <p>The <dfn title=dom-Document-selectedStyleSheetSet><code>selectedStyleSheetSet</code></dfn> attribute, on getting, must run these steps:</p> 2.122 <ol> 2.123 <li><p>If there is a single <span>enabled CSS style sheet set</span> and no 2.124 - other <span>document CSS style sheets</span> with a non-empty 2.125 - <span title=concept-css-style-sheet-title>title</span> have the 2.126 + other <span>document CSS style sheets</span> with a 2.127 + <span title=concept-css-style-sheet-title>title</span> that is not the empty string have the 2.128 <span title=concept-css-style-sheet-disabled-flag>disabled flag</span> unset, return the 2.129 <span>CSS style sheet set name</span> of the 2.130 <span>enabled CSS style sheet set</span> and terminate these steps.</li> 2.131 @@ -1248,8 +1234,8 @@ 2.132 <p>Otherwise, return the empty string.</p> 2.133 2.134 <p class='note'>At this point either all 2.135 - <span title="CSS style sheet">CSS style sheets</span> with a non-empty 2.136 - <span title=concept-css-style-sheet-title>title</span> have the 2.137 + <span title="CSS style sheet">CSS style sheets</span> with a 2.138 + <span title=concept-css-style-sheet-title>title</span> that is not the empty string have the 2.139 <span title=concept-css-style-sheet-disabled-flag>disabled flag</span> set, or there are no such 2.140 <span title="CSS style sheet">CSS style sheets</span>.</p> 2.141 </li> 2.142 @@ -1292,8 +1278,8 @@ 2.143 <li><p>If <var title>name</var> is null terminate these steps.</p></li> 2.144 <li><p><span>enable a CSS style sheet set</span> with name <var title>name</var>.</p></li> 2.145 </ol> 2.146 -<p class='note'><span title='CSS style sheet'>CSS style sheets</span> with an 2.147 -empty <span title=concept-css-style-sheet-title>title</span> are never affected by this method. 2.148 +<p class='note'><span title='CSS style sheet'>CSS style sheets</span> with a 2.149 +<span title=concept-css-style-sheet-title>title</span> that is the empty string are never affected by this method. 2.150 This method does not change the values of the 2.151 <code title='dom-Document-lastStyleSheetSet'>lastStyleSheetSet</code> or 2.152 <code title='dom-Document-preferredStyleSheetSet'>preferredStyleSheetSet</code> attributes.</p> 2.153 @@ -1691,10 +1677,8 @@ 2.154 2.155 <p>To <dfn>parse a CSS rule</dfn> ...</p> 2.156 2.157 -<p class="XXX">Should a rule be instantiated in OM if there is a parse error? To 2.158 -what extent should original (but non-valid) CSS text be captured in cssText?</p> 2.159 - 2.160 -<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> 2.161 +<p>To <dfn>serialize a CSS rule</dfn>, perform one of the following in accordance with the <span>CSS rule</span>'s 2.162 +<span title="concept-css-rule-type">type</span>:</p> 2.163 2.164 <dl class="switch"> 2.165 <dt><code>CSSStyleRule</code></dt> 2.166 @@ -1779,8 +1763,6 @@ 2.167 <li><p>Insert <var title>new rule</var> into <var title>list</var> at the zero-indexed position <var title>index</var>.<p></li> 2.168 <li><p>Return <var title>index</var>. 2.169 </ol> 2.170 -<p class='XXX'>DOM-2 CSS specifies that a <code>NO_MODIFICATION_ALLOWED_ERR</code> exception is thrown 2.171 -if the style sheet is read-only. Are there any read-only style sheets?</p> 2.172 2.173 <p>To <dfn>remove a CSS rule</dfn> from a CSS rule list <var title>list</var> at index <var title>index</var>, follow these steps:</p> 2.174 <ol> 2.175 @@ -2085,9 +2067,6 @@ 2.176 2.177 <p>To <dfn>parse a CSS declaration block</dfn> ...</p> 2.178 2.179 -<p class="XXX">What should be captured in the cssText of a declaration block which fails 2.180 -to parse?</p> 2.181 - 2.182 <p>To <dfn>serialize a CSS declaration block</dfn> 2.183 represented by a <code>CSSStyleDeclarations</code> instance named <var title>d</var>, 2.184 let <var title>s</var> be the empty string, then run the steps below:</p>