Sat, 27 Oct 2012 13:57:22 +0200
[cssom] (1) throw exception of attempting to serialize an identifier or string containing U+0000;
(2) improve language of common idiom serialization rules;
(3) replace use of 'unset' with 'clear', define 'set'/'clear' usage in terminology section;
(4) format 'null' as code;
(5) improve language of style sheet state itmes (6.1);
(6) improve prose w.r.t. nullable style sheet state items (6.1);
cssom/Overview.html | file | annotate | diff | comparison | revisions | |
cssom/cssom-source | file | annotate | diff | comparison | revisions |
1.1 --- a/cssom/Overview.html Fri Oct 26 15:25:45 2012 -0700 1.2 +++ b/cssom/Overview.html Sat Oct 27 13:57:22 2012 +0200 1.3 @@ -18,7 +18,7 @@ 1.4 1.5 <!-- ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> 1.6 1.7 - <h2 class="no-num no-toc" id="w3c-doctype">Editor's Draft 19 October 2012</h2> 1.8 + <h2 class="no-num no-toc" id="w3c-doctype">Editor's Draft 27 October 2012</h2> 1.9 1.10 <dl> 1.11 1.12 @@ -83,7 +83,7 @@ 1.13 can be found in the 1.14 <a href="http://www.w3.org/TR/">W3C technical reports index at http://www.w3.org/TR/.</a></em> 1.15 1.16 - <p class="dontpublish">This is the 19 October 2012 Editor's Draft of CSSOM. Please send comments to 1.17 + <p class="dontpublish">This is the 27 October 2012 Editor's Draft of CSSOM. Please send comments to 1.18 <a href="mailto:www-style@w3.org?subject=%5Bcssom%5D%20">www-style@w3.org</a> 1.19 (<a href="http://lists.w3.org/Archives/Public/www-style/">archived</a>) 1.20 with <samp>[cssom]</samp> at the start of the subject line. 1.21 @@ -260,6 +260,10 @@ 1.22 1.23 <p>The term <dfn id="whitespace">whitespace</dfn> is used as defined in <a href="#refsCSS">[CSS]</a>. 1.24 1.25 + <p>The terms <dfn id="set">set</dfn> and <dfn id="clear">clear</dfn> to refer to the <code>true</code> and 1.26 + <code>false</code> values of binary flags or variables, respectively. These terms are also used as verbs in which case they refer to 1.27 + mutating some value to make it <code>true</code> or <code>false</code>, respectively.</p> 1.28 + 1.29 <!-- ........................................................................................................................ --> 1.30 <!-- ........................................................................................................................ --> 1.31 1.32 @@ -278,23 +282,25 @@ 1.33 by the concatenation of, for each character of the identifier:</p> 1.34 1.35 <ul> 1.36 - <li>If the character is in the range U+0000 to U+001F or U+007F to 1.37 - U+009F, the character 1.38 + <li>If the character is NULL (U+0000), then <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-throw" title="concept-throw">throw</a> a 1.39 + <code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#invalidcharactererror">InvalidCharacterError</a></code> exception and terminate these steps.</li> 1.40 + <li>If the character is in the range [\1-\1f] (U+0001 to U+001F) or 1.41 + [\7f-\9f] (U+007F to U+009F), then the character 1.42 <a href="#escape-a-character-as-code-point" title="escape a character as code point">escaped as code point</a>.</li> 1.43 - <li>If the character is the first character and is in the range 0-9 1.44 - (U+0030 to U+0039), the character 1.45 + <li>If the character is the first character and is in the range [0-9] 1.46 + (U+0030 to U+0039), then the character 1.47 <a href="#escape-a-character-as-code-point" title="escape a character as code point">escaped as code point</a>.</li> 1.48 - <li>If the character is the second character and is in the range 0-9 1.49 + <li>If the character is the second character and is in the range [0-9] 1.50 (U+0030 to U+0039) and the first character is a "<code>-</code>" 1.51 - (U+002D), the character 1.52 + (U+002D), then the character 1.53 <a href="#escape-a-character-as-code-point" title="escape a character as code point">escaped as code point</a>.</li> 1.54 <li>If the character is the second character and is "<code>-</code>" 1.55 - (U+002D) and the first character is "<code>-</code>" too, the 1.56 + (U+002D) and the first character is "<code>-</code>" as well, then the 1.57 <a href="#escape-a-character" title="escape a character">escaped</a> character.</li> 1.58 <li>If the character is not handled by one of the above rules and is 1.59 greater than or equal to U+0080, is "<code>-</code>" (U+002D) or 1.60 - "<code>_</code>" (U+005F), or is in one of the ranges 0-9 (U+0030 to 1.61 - U+0039), A-Z (U+0041 to U+005A), or a-z (U+0061 to U+007A), the character 1.62 + "<code>_</code>" (U+005F), or is in one of the ranges [0-9] (U+0030 to 1.63 + U+0039), [A-Z] (U+0041 to U+005A), or [a-z] (U+0061 to U+007A), then the character 1.64 itself.</li> 1.65 <li>Otherwise, the <a href="#escape-a-character" title="escape a character">escaped</a> 1.66 character.</li> 1.67 @@ -306,9 +312,10 @@ 1.68 '<code>"</code>' (U+0022):</p> 1.69 1.70 <ul> 1.71 - <li>If the character is in the range U+0000 to U+001F or U+007F to 1.72 - U+009F, the character 1.73 - <a href="#escape-a-character-as-code-point" title="escape a character as code point">escaped as code point</a>.</li> 1.74 + <li>If the character is NULL (U+0000), then <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-throw" title="concept-throw">throw</a> a 1.75 + <code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#invalidcharactererror">InvalidCharacterError</a></code> exception and terminate these steps.</li> 1.76 + <li>If the character is in the range [\1-\1f] (U+0001 to U+001F) or [\7f-\9f] (U+007F to 1.77 + U+009F), the character <a href="#escape-a-character-as-code-point" title="escape a character as code point">escaped as code point</a>.</li> 1.78 <li>If the character is '<code>"</code>' (U+0022) or '<code>\</code>' 1.79 (U+005C), the <a href="#escape-a-character" title="escape a character">escaped</a> character.</li> 1.80 <li>Otherwise, the character itself.</li> 1.81 @@ -323,11 +330,17 @@ 1.82 string, followed by "<code>)</code>".</p> 1.83 1.84 <p>To <dfn id="serialize-a-comma-separated-list">serialize a comma-separated list</dfn> concatenate all items of 1.85 - the list in list order while separating them by "<code>,</code>" (U+002C), 1.86 - followed by a space (U+0020).</p> 1.87 + the list in list order while separating them by "<code>, </code>", i.e., 1.88 + COMMA (U+002C) followed by a single SPACE (U+0020).</p> 1.89 1.90 <p>To <dfn id="serialize-a-whitespace-separated-list">serialize a whitespace-separated list</dfn> concatenate all 1.91 - items of the list in list order while separating them a space (U+0020).</p> 1.92 + items of the list in list order while separating them by "<code> </code>", i.e., 1.93 + a single SPACE (U+0020).</p> 1.94 + 1.95 + <p class="note">When serializing a list according to the above rules, 1.96 + extraneous whitespace is not inserted prior to the first item or subsequent to 1.97 + the last item. Unless otherwise specified, an empty list is serialized as the 1.98 + empty string.</p> 1.99 1.100 <!-- ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> 1.101 1.102 @@ -356,7 +369,7 @@ 1.103 <p>To 1.104 <dfn id="parse-a-media-query">parse a media query</dfn> for a given string 1.105 <var>s</var> means to follow the 1.106 - <a href="#parse-a-media-query-list">parse a media query list</a> steps and return null if more 1.107 + <a href="#parse-a-media-query-list">parse a media query list</a> steps and return <code>null</code> if more 1.108 than one media query is returned or a media query if a 1.109 single media query is returned.</p> 1.110 1.111 @@ -589,7 +602,7 @@ 1.112 <dfn id="parse-a-group-of-selectors">parse a group of selectors</dfn> 1.113 means to parse the value using the <code>selectors_group</code> 1.114 production defined in the Selectors specification and return either a 1.115 - group of selectors if parsing did not fail or null if parsing did 1.116 + group of selectors if parsing did not fail or <code>null</code> if parsing did 1.117 fail.</p> <!-- XXX ref --> 1.118 1.119 <!-- ........................................................................................................................ --> 1.120 @@ -807,21 +820,21 @@ 1.121 1.122 <dt><dfn id="style-sheet-location">style sheet location</dfn></dt> 1.123 <dd><p>The <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/urls.html#url">URL</a> of the 1.124 - <span>style sheet</span> or null if the <span>style sheet</span> was 1.125 + <span>style sheet</span> or <code>null</code> if the <span>style sheet</span> was 1.126 embedded.</dd> 1.127 1.128 <dt><dfn id="style-sheet-parent">style sheet parent</dfn></dt> 1.129 <dd><p>The <span>style sheet</span> that is the parent of the 1.130 - <span>style sheet</span>.</dd> 1.131 + <span>style sheet</span> or <code>null</code> if there is no associated parent.</dd> 1.132 1.133 <dt><dfn id="style-sheet-owner-node">style sheet owner node</dfn></dt> 1.134 <dd><p>The DOM node associated with the <span>style sheet</span> or 1.135 - null if there is no associated DOM node.</dd> 1.136 + <code>null</code> if there is no associated DOM node.</dd> 1.137 1.138 <dt><dfn id="style-sheet-owner-css-rule">style sheet owner CSS rule</dfn></dt> 1.139 <dd><p>The <a href="#rule">CSS rule</a> in the <a href="#style-sheet-parent">style sheet parent</a> 1.140 - that caused the inclusion of the <span>style sheet</span> or null if 1.141 - there is no such <a href="#rule">CSS rule</a>.</dd> 1.142 + that caused the inclusion of the <span>style sheet</span> or <code>null</code> if 1.143 + there is no associated rule.</dd> 1.144 1.145 <dt><dfn id="style-sheet-media">style sheet media</dfn></dt> 1.146 <dd> 1.147 @@ -836,22 +849,28 @@ 1.148 1.149 <dt><dfn id="style-sheet-title">style sheet title</dfn></dt> 1.150 <dd> 1.151 - <p>The title of the <span>style sheet</span>. It is said to be empty 1.152 - if the title is the empty string.</p> 1.153 + <p>The title of the <span>style sheet</span> or <code>null</code> if no title 1.154 + is specified or is the empty string, in which case the title is referred to 1.155 + as an empty title.</p> 1.156 1.157 <div class="example"> 1.158 - <p>In these examples the <a href="#style-sheet-title">style sheet title</a> ends up being 1.159 - empty:</p> 1.160 - 1.161 - <pre><style> body { background:papayawhip } </style></pre> 1.162 - 1.163 - <pre><style> body { background:orange } </style></pre> 1.164 + <p>In the following, the <a href="#style-sheet-title">style sheet title</a> is non-empty 1.165 + for the first style sheet, but is empty for the second and third style sheets.</p> 1.166 + <pre><style title="papaya"> 1.167 + body { background:papayawhip } 1.168 +</style></pre> 1.169 + <pre><style title=""> 1.170 + body { background:orange } 1.171 +</style></pre> 1.172 + <pre><style> 1.173 + body { background:brown } 1.174 +</style></pre> 1.175 </div> 1.176 </dd> 1.177 1.178 <dt><dfn id="style-sheet-alternate-flag">style sheet alternate flag</dfn></dt> 1.179 <dd> 1.180 - <p>Either set or unset. Unset by default.</p> 1.181 + <p>Either set or clear. Clear by default.</p> 1.182 1.183 <div class="example"> 1.184 <p>The following <span title="style sheet">style sheets</span> have 1.185 @@ -865,9 +884,9 @@ 1.186 1.187 <dt><dfn id="style-sheet-disabled-flag">style sheet disabled flag</dfn></dt> 1.188 <dd> 1.189 - <p>Either set or unset. Unset by default.</p> 1.190 - 1.191 - <p class="note">Even when unset it does not necessarily mean that the 1.192 + <p>Either set or clear. Clear by default.</p> 1.193 + 1.194 + <p class="note">Even when clear it does not necessarily mean that the 1.195 <span>style sheet</span> is actually used for rendering.</p> 1.196 </dd> 1.197 1.198 @@ -1006,18 +1025,18 @@ 1.199 these steps.</li> 1.200 1.201 <li><p>If the <a href="#style-sheet-title">style sheet title</a> is non-empty, the 1.202 - <a href="#style-sheet-alternate-flag">style sheet alternate flag</a> is unset, and 1.203 + <a href="#style-sheet-alternate-flag">style sheet alternate flag</a> is clear, and 1.204 <a href="#preferred-style-sheet-set-name">preferred style sheet set name</a> is the empty string 1.205 <a href="#change-the-preferred-style-sheet-set-name">change the preferred style sheet set name</a> to the 1.206 <a href="#style-sheet-title">style sheet title</a>.</li> 1.207 1.208 <li> 1.209 - <p>If any of the following is true unset the 1.210 + <p>If any of the following is true clear the 1.211 <a href="#style-sheet-disabled-flag">style sheet disabled flag</a> and terminate these steps: 1.212 1.213 <ul> 1.214 <li><p>The <a href="#style-sheet-title">style sheet title</a> is empty.</li> 1.215 - <li><p>The <a href="#last-style-sheet-set-name">last style sheet set name</a> is null and the 1.216 + <li><p>The <a href="#last-style-sheet-set-name">last style sheet set name</a> is <code>null</code> and the 1.217 <a href="#style-sheet-title">style sheet title</a> is a 1.218 <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#case-sensitive">case-sensitive</a> match 1.219 for the <a href="#preferred-style-sheet-set-name">preferred style sheet set name</a>.</li> 1.220 @@ -1033,7 +1052,7 @@ 1.221 <p>A <dfn id="persistent-style-sheet">persistent style sheet</dfn> is a 1.222 <span>style sheet</span> from the <a href="#document-style-sheets">document style sheets</a> 1.223 whose <a href="#style-sheet-title">style sheet title</a> is the empty string and whose 1.224 - <a href="#style-sheet-alternate-flag">style sheet alternate flag</a> is unset.</p> 1.225 + <a href="#style-sheet-alternate-flag">style sheet alternate flag</a> is clear.</p> 1.226 1.227 <p>A <dfn id="style-sheet-set">style sheet set</dfn> is an ordered 1.228 collection of one or more <span title="style sheet">style sheets</span> 1.229 @@ -1046,7 +1065,7 @@ 1.230 1.231 <p>An <dfn id="enabled-style-sheet-set">enabled style sheet set</dfn> is a 1.232 <a href="#style-sheet-set">style sheet set</a> of which each <span>style sheet</span> has 1.233 - its <a href="#style-sheet-disabled-flag">style sheet disabled flag</a> unset.</p> 1.234 + its <a href="#style-sheet-disabled-flag">style sheet disabled flag</a> clear.</p> 1.235 1.236 <p>To <dfn id="enable-a-style-sheet-set">enable a style sheet set</dfn> 1.237 with name <var>name</var>, run these steps:</p> 1.238 @@ -1056,7 +1075,7 @@ 1.239 <a href="#style-sheet-disabled-flag">style sheet disabled flag</a> for each <span>style sheet</span> 1.240 that is in a <a href="#style-sheet-set">style sheet set</a> and terminate these steps.</li> 1.241 1.242 - <li><p>Unset the <a href="#style-sheet-disabled-flag">style sheet disabled flag</a> for each 1.243 + <li><p>Clear the <a href="#style-sheet-disabled-flag">style sheet disabled flag</a> for each 1.244 <span>style sheet</span> in a <a href="#style-sheet-set">style sheet set</a> whose 1.245 <a href="#style-sheet-set-name">style sheet set name</a> is a 1.246 <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#case-sensitive">case-sensitive</a> match for 1.247 @@ -1079,13 +1098,13 @@ 1.248 <p>A <dfn id="last-style-sheet-set-name">last style sheet set name</dfn> 1.249 is a concept to determine what <a href="#style-sheet-set">style sheet set</a> was last 1.250 <a href="#select-a-style-sheet-set" title="select a style sheet set">selected</a>. Initially its 1.251 - value is null.</p> 1.252 + value is <code>null</code>.</p> 1.253 1.254 <p>A 1.255 <dfn id="preferred-style-sheet-set-name">preferred style sheet set name</dfn> 1.256 is a concept to determine which 1.257 <span title="style sheet">style sheets</span> need to have their 1.258 - <a href="#style-sheet-disabled-flag">style sheet disabled flag</a> unset. Initially its value 1.259 + <a href="#style-sheet-disabled-flag">style sheet disabled flag</a> clear. Initially its value 1.260 is the empty string. 1.261 1.262 <p>To 1.263 @@ -1101,7 +1120,7 @@ 1.264 <li><p>If <var>name</var> is not a 1.265 <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#case-sensitive">case-sensitive</a> match for 1.266 <var>current</var> and 1.267 - <a href="#last-style-sheet-set-name">last style sheet set name</a> is null 1.268 + <a href="#last-style-sheet-set-name">last style sheet set name</a> is <code>null</code> 1.269 <a href="#enable-a-style-sheet-set">enable a style sheet set</a> with name 1.270 <var>name</var>.</li> 1.271 </ol> 1.272 @@ -1188,7 +1207,7 @@ 1.273 showing the 1.274 <code title="dom-Document-selectedStyleSheetSet">selectedStyleSheetSet</code> 1.275 as the selected style sheet set, leaving none selected if it is 1.276 - null or the empty string, and selecting an extra option 1.277 + <code>null</code> or the empty string, and selecting an extra option 1.278 "Basic Page Style" (or similar) if it is the empty string and the 1.279 <code title="dom-Document-preferredStyleSheetSet">preferredStyleSheetSet</code> 1.280 is the empty string as well.</p> 1.281 @@ -1204,10 +1223,10 @@ 1.282 <p>If a user agent persist the selected style sheet set, they should use 1.283 the value of the 1.284 <code title="dom-Document-selectedStyleSheetSet">selectedStyleSheetSet</code> 1.285 - attribute, or if that is null, the 1.286 + attribute, or if that is <code>null</code>, the 1.287 <code title="dom-Document-lastStyleSheetSet">lastStyleSheetSet</code> 1.288 attribute, when leaving the page (or at some other time) to determine the 1.289 - set name to store. If that is null then the style sheet set should not be 1.290 + set name to store. If that is <code>null</code> then the style sheet set should not be 1.291 persisted.</p> 1.292 1.293 <p>When re-setting the style sheet set to the persisted value (which can 1.294 @@ -1245,7 +1264,7 @@ 1.295 <p>...the style sheets that end up enabled are style sheets "a", "b", 1.296 and "c", the 1.297 <code title="dom-Document-selectedStyleSheetSet">selectedStyleSheetSet</code> 1.298 - attribute would return null, 1.299 + attribute would return <code>null</code>, 1.300 <code title="dom-Document-lastStyleSheetSet">lastStyleSheetSet</code> 1.301 would return "foo", and 1.302 <code title="dom-Document-preferredStyleSheetSet">preferredStyleSheetSet</code> 1.303 @@ -1278,7 +1297,7 @@ 1.304 was never set 1.305 explicitly, leaving 1.306 <code title="dom-Document-lastStyleSheetSet">lastStyleSheetSet</code> at 1.307 - null throughout), which changes which style sheets are enabled and which 1.308 + <code>null</code> throughout), which changes which style sheets are enabled and which 1.309 are not.</p> 1.310 </div> 1.311 1.312 @@ -1323,7 +1342,7 @@ 1.313 <p>In the following HTML snippet the first HTML <code>style</code> 1.314 element has a <code>sheet</code> attribute that returns a 1.315 <code>StyleSheet</code> object representing the style sheet, but for 1.316 - the second <code>style</code> attribute it returns null. 1.317 + the second <code>style</code> attribute it returns <code>null</code>. 1.318 (Assuming the user agent supports CSS (<code>text/css</code>) and does 1.319 not support ExampleSheets (<code>text/example-sheets</code>).</p> 1.320 1.321 @@ -1415,13 +1434,13 @@ 1.322 resource.</dd> 1.323 1.324 <dt><a href="#style-sheet-parent">style sheet parent</a></dt> 1.325 - <dd><p>null</dd> 1.326 + <dd><p><code>null</code></dd> 1.327 1.328 <dt><a href="#style-sheet-owner-node">style sheet owner node</a></dt> 1.329 <dd><p>The node.</dd> 1.330 1.331 <dt><a href="#style-sheet-owner-css-rule">style sheet owner CSS rule</a></dt> 1.332 - <dd><p>null</dd> 1.333 + <dd><p><code>null</code></dd> 1.334 1.335 <dt><a href="#style-sheet-media">style sheet media</a></dt> 1.336 <dd><p>The value of the <code>media</code> <a class="external" href="http://www.w3.org/TR/xml-stylesheet/#dt-pseudo-attribute">pseudo-attribute</a> 1.337 @@ -1433,7 +1452,7 @@ 1.338 <dt><a href="#style-sheet-alternate-flag">style sheet alternate flag</a></dt> 1.339 <dd><p>Set if the <code>alternate</code> <a class="external" href="http://www.w3.org/TR/xml-stylesheet/#dt-pseudo-attribute">pseudo-attribute</a> 1.340 value is a <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#case-sensitive">case-sensitive</a> match for 1.341 - "<code>yes</code>", or unset otherwise. 1.342 + "<code>yes</code>", or clear otherwise. 1.343 </dl> 1.344 </li> 1.345 </ol> 1.346 @@ -1488,13 +1507,13 @@ 1.347 resource.</dd> 1.348 1.349 <dt><a href="#style-sheet-owner-node">style sheet owner node</a></dt> 1.350 - <dd><p>null</dd> 1.351 + <dd><p><code>null</code></dd> 1.352 1.353 <dt><a href="#style-sheet-parent">style sheet parent</a></dt> 1.354 - <dd><p>null</dd> 1.355 + <dd><p><code>null</code></dd> 1.356 1.357 <dt><a href="#style-sheet-owner-css-rule">style sheet owner CSS rule</a></dt> 1.358 - <dd><p>null</dd> 1.359 + <dd><p><code>null</code></dd> 1.360 1.361 <dt><a href="#style-sheet-media">style sheet media</a></dt> 1.362 <dd><p>The value of the first <code>media</code> parameter.</dd> 1.363 @@ -1518,9 +1537,9 @@ 1.364 <h3 id="css-rules"><span class="secno">6.4 </span>CSS Rules</h3> 1.365 1.366 <p>A <dfn id="rule">CSS rule</dfn> is an abstract concept that 1.367 - represents a rule as defined by the CSS specification. In the CSSOM a 1.368 + denotes a rule as defined by the CSS specification. A 1.369 <a href="#rule">CSS rule</a> is represented as an object that implements a subclass of 1.370 - the <code>CSSRule</code> interface. A <a href="#rule">CSS rule</a> has the following 1.371 + the <code>CSSRule</code> interface, and which has the following 1.372 associated state items:</p> 1.373 1.374 <dl> 1.375 @@ -1534,17 +1553,17 @@ 1.376 1.377 <dt><dfn id="rule-parent">rule parent</dfn></dt> 1.378 <dd><p>An optional reference to another, enclosing <a href="#rule">CSS rule</a>. 1.379 - If the rule has an enclosing rule when it is created, then this item is initialized to the enclosing rule; otherwise it is null. 1.380 - Subsequent to initialization, this item is reset to null if the rule becomes non-enclosed. Once reset to null, it must never change.</dd> 1.381 + If the rule has an enclosing rule when it is created, then this item is initialized to the enclosing rule; otherwise it is <code>null</code>. 1.382 + Subsequent to initialization, this item is reset to <code>null</code> if the rule becomes non-enclosed. Once reset to <code>null</code>, it must never change.</dd> 1.383 1.384 <dt><dfn id="rule-style-sheet">rule parent style sheet</dfn></dt> 1.385 <dd><p>An optional reference to an associated <a href="#css-style-sheet">CSS style sheet</a>. 1.386 This item is initialized to reference an associated style sheet when the rule is created. Subsequent to initialization, this item 1.387 - is reset to null if the rule becomes disassociated from its initial style sheet. Once reset to null, it must never change.</dd> 1.388 + is reset to <code>null</code> if the rule becomes disassociated from its initial style sheet. Once reset to <code>null</code>, it must never change.</dd> 1.389 </dl> 1.390 1.391 <p>In addition to the above state, each <a href="#rule">CSS rule</a> may be associated 1.392 - with other state in accordance to the <a href="#rule-type">rule type</a>.</p> 1.393 + with other state in accordance with its <a href="#rule-type">rule type</a>.</p> 1.394 1.395 <p>To <dfn id="parse-a-css-rule">parse a CSS rule</dfn> ...</p> 1.396 1.397 @@ -1831,8 +1850,8 @@ 1.398 1.399 <dl> 1.400 <dt><dfn id="css-declaration-block-readonly-flag">CSS declaration block readonly flag</dfn></dt> 1.401 - <dd><p>Unset if the object can be manipulated. Set if it can not be 1.402 - manipulated. Unless otherwise stated it is unset.</dd> 1.403 + <dd><p>Clear if the object can be manipulated. Set if it can not be 1.404 + manipulated. Unless otherwise stated it is clear.</dd> 1.405 1.406 <dt><dfn id="css-declaration-block-declarations">CSS declaration block declarations</dfn></dt> 1.407 <dd><p>The CSS declarations associated with the object.</dd> 1.408 @@ -2003,12 +2022,12 @@ 1.409 the definition of the property that is an 1.410 <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#ascii-case-insensitive">ASCII case-insensitive</a> match for 1.411 <var>property</var> in the CSS specification. If the given value 1.412 - is <span>ignored</span> return null. Otherwise return the CSS value for 1.413 + is <span>ignored</span> return <code>null</code>. Otherwise return the CSS value for 1.414 the given <var>property</var>.</p> 1.415 1.416 <p class="note">"<code>!important</code>" declarations are not 1.417 part of the property value space and will therefore cause 1.418 - <a href="#parse-a-css-value">parse a CSS value</a> to return null.</p> 1.419 + <a href="#parse-a-css-value">parse a CSS value</a> to return <code>null</code>.</p> 1.420 1.421 1.422 <!-- ........................................................................................................................ --> 1.423 @@ -2349,6 +2368,12 @@ 1.424 <dt>'<code>border-style</code>' 1.425 <dt>'<code>border-top</code>' 1.426 <dt>'<code>border-right</code>' 1.427 + <dt>'<code>border-collapse</code>' 1.428 + <dt>'<code>border-color</code>' 1.429 + <dt>'<code>border-spacing</code>' 1.430 + <dt>'<code>border-style</code>' 1.431 + <dt>'<code>border-top</code>' 1.432 + <dt>'<code>border-right</code>' 1.433 <dt>'<code>border-bottom</code>' 1.434 <dt>'<code>border-left</code>' 1.435 <dt>'<code>border-width</code>'
2.1 --- a/cssom/cssom-source Fri Oct 26 15:25:45 2012 -0700 2.2 +++ b/cssom/cssom-source Sat Oct 27 13:57:22 2012 +0200 2.3 @@ -190,6 +190,10 @@ 2.4 2.5 <p>The term <dfn id="whitespace">whitespace</dfn> is used as defined in <span data-anolis-ref>CSS</span>. 2.6 2.7 + <p>The terms <dfn id="set">set</dfn> and <dfn id="clear">clear</dfn> to refer to the <code>true</code> and 2.8 + <code>false</code> values of binary flags or variables, respectively. These terms are also used as verbs in which case they refer to 2.9 + mutating some value to make it <code>true</code> or <code>false</code>, respectively.</p> 2.10 + 2.11 <!-- ........................................................................................................................ --> 2.12 <!-- ........................................................................................................................ --> 2.13 2.14 @@ -208,23 +212,25 @@ 2.15 by the concatenation of, for each character of the identifier:</p> 2.16 2.17 <ul> 2.18 - <li>If the character is in the range U+0000 to U+001F or U+007F to 2.19 - U+009F, the character 2.20 + <li>If the character is NULL (U+0000), then <span data-anolis-spec=dom title=concept-throw>throw</span> a 2.21 + <code data-anolis-spec=dom>InvalidCharacterError</code> exception and terminate these steps.</li> 2.22 + <li>If the character is in the range [\1-\1f] (U+0001 to U+001F) or 2.23 + [\7f-\9f] (U+007F to U+009F), then the character 2.24 <span title="escape a character as code point">escaped as code point</span>.</li> 2.25 - <li>If the character is the first character and is in the range 0-9 2.26 - (U+0030 to U+0039), the character 2.27 + <li>If the character is the first character and is in the range [0-9] 2.28 + (U+0030 to U+0039), then the character 2.29 <span title="escape a character as code point">escaped as code point</span>.</li> 2.30 - <li>If the character is the second character and is in the range 0-9 2.31 + <li>If the character is the second character and is in the range [0-9] 2.32 (U+0030 to U+0039) and the first character is a "<code>-</code>" 2.33 - (U+002D), the character 2.34 + (U+002D), then the character 2.35 <span title="escape a character as code point">escaped as code point</span>.</li> 2.36 <li>If the character is the second character and is "<code>-</code>" 2.37 - (U+002D) and the first character is "<code>-</code>" too, the 2.38 + (U+002D) and the first character is "<code>-</code>" as well, then the 2.39 <span title="escape a character">escaped</span> character.</li> 2.40 <li>If the character is not handled by one of the above rules and is 2.41 greater than or equal to U+0080, is "<code>-</code>" (U+002D) or 2.42 - "<code>_</code>" (U+005F), or is in one of the ranges 0-9 (U+0030 to 2.43 - U+0039), A-Z (U+0041 to U+005A), or a-z (U+0061 to U+007A), the character 2.44 + "<code>_</code>" (U+005F), or is in one of the ranges [0-9] (U+0030 to 2.45 + U+0039), [A-Z] (U+0041 to U+005A), or [a-z] (U+0061 to U+007A), then the character 2.46 itself.</li> 2.47 <li>Otherwise, the <span title="escape a character">escaped</span> 2.48 character.</li> 2.49 @@ -236,9 +242,10 @@ 2.50 '<code>"</code>' (U+0022):</p> 2.51 2.52 <ul> 2.53 - <li>If the character is in the range U+0000 to U+001F or U+007F to 2.54 - U+009F, the character 2.55 - <span title="escape a character as code point">escaped as code point</span>.</li> 2.56 + <li>If the character is NULL (U+0000), then <span data-anolis-spec=dom title=concept-throw>throw</span> a 2.57 + <code data-anolis-spec=dom>InvalidCharacterError</code> exception and terminate these steps.</li> 2.58 + <li>If the character is in the range [\1-\1f] (U+0001 to U+001F) or [\7f-\9f] (U+007F to 2.59 + U+009F), the character <span title="escape a character as code point">escaped as code point</span>.</li> 2.60 <li>If the character is '<code>"</code>' (U+0022) or '<code>\</code>' 2.61 (U+005C), the <span title="escape a character">escaped</span> character.</li> 2.62 <li>Otherwise, the character itself.</li> 2.63 @@ -253,11 +260,17 @@ 2.64 string, followed by "<code>)</code>".</p> 2.65 2.66 <p>To <dfn>serialize a comma-separated list</dfn> concatenate all items of 2.67 - the list in list order while separating them by "<code>,</code>" (U+002C), 2.68 - followed by a space (U+0020).</p> 2.69 + the list in list order while separating them by "<code>, </code>", i.e., 2.70 + COMMA (U+002C) followed by a single SPACE (U+0020).</p> 2.71 2.72 <p>To <dfn>serialize a whitespace-separated list</dfn> concatenate all 2.73 - items of the list in list order while separating them a space (U+0020).</p> 2.74 + items of the list in list order while separating them by "<code> </code>", i.e., 2.75 + a single SPACE (U+0020).</p> 2.76 + 2.77 + <p class="note">When serializing a list according to the above rules, 2.78 + extraneous whitespace is not inserted prior to the first item or subsequent to 2.79 + the last item. Unless otherwise specified, an empty list is serialized as the 2.80 + empty string.</p> 2.81 2.82 <!-- ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> 2.83 2.84 @@ -286,7 +299,7 @@ 2.85 <p>To 2.86 <dfn id="parse-a-media-query">parse a media query</dfn> for a given string 2.87 <var>s</var> means to follow the 2.88 - <span>parse a media query list</span> steps and return null if more 2.89 + <span>parse a media query list</span> steps and return <code>null</code> if more 2.90 than one media query is returned or a media query if a 2.91 single media query is returned.</p> 2.92 2.93 @@ -480,7 +493,7 @@ 2.94 <dfn id="parse-a-group-of-selectors">parse a group of selectors</dfn> 2.95 means to parse the value using the <code>selectors_group</code> 2.96 production defined in the Selectors specification and return either a 2.97 - group of selectors if parsing did not fail or null if parsing did 2.98 + group of selectors if parsing did not fail or <code>null</code> if parsing did 2.99 fail.</p> <!-- XXX ref --> 2.100 2.101 <!-- ........................................................................................................................ --> 2.102 @@ -698,21 +711,21 @@ 2.103 2.104 <dt><dfn id="style-sheet-location">style sheet location</dfn></dt> 2.105 <dd><p>The <span data-anolis-spec=html>URL</span> of the 2.106 - <span>style sheet</span> or null if the <span>style sheet</span> was 2.107 + <span>style sheet</span> or <code>null</code> if the <span>style sheet</span> was 2.108 embedded.</p></dd> 2.109 2.110 <dt><dfn id="style-sheet-parent">style sheet parent</dfn></dt> 2.111 <dd><p>The <span>style sheet</span> that is the parent of the 2.112 - <span>style sheet</span>.</p></dd> 2.113 + <span>style sheet</span> or <code>null</code> if there is no associated parent.</p></dd> 2.114 2.115 <dt><dfn id="style-sheet-owner-node">style sheet owner node</dfn></dt> 2.116 <dd><p>The DOM node associated with the <span>style sheet</span> or 2.117 - null if there is no associated DOM node.</p></dd> 2.118 + <code>null</code> if there is no associated DOM node.</p></dd> 2.119 2.120 <dt><dfn id="style-sheet-owner-css-rule">style sheet owner CSS rule</dfn></dt> 2.121 <dd><p>The <span>CSS rule</span> in the <span>style sheet parent</span> 2.122 - that caused the inclusion of the <span>style sheet</span> or null if 2.123 - there is no such <span>CSS rule</span>.</p></dd> 2.124 + that caused the inclusion of the <span>style sheet</span> or <code>null</code> if 2.125 + there is no associated rule.</p></dd> 2.126 2.127 <dt><dfn id="style-sheet-media">style sheet media</dfn></dt> 2.128 <dd> 2.129 @@ -727,22 +740,28 @@ 2.130 2.131 <dt><dfn id="style-sheet-title">style sheet title</dfn></dt> 2.132 <dd> 2.133 - <p>The title of the <span>style sheet</span>. It is said to be empty 2.134 - if the title is the empty string.</p> 2.135 + <p>The title of the <span>style sheet</span> or <code>null</code> if no title 2.136 + is specified or is the empty string, in which case the title is referred to 2.137 + as an empty title.</p> 2.138 2.139 <div class="example"> 2.140 - <p>In these examples the <span>style sheet title</span> ends up being 2.141 - empty:</p> 2.142 - 2.143 - <pre><style> body { background:papayawhip } </style></pre> 2.144 - 2.145 - <pre><style> body { background:orange } </style></pre> 2.146 + <p>In the following, the <span>style sheet title</span> is non-empty 2.147 + for the first style sheet, but is empty for the second and third style sheets.</p> 2.148 + <pre><style title="papaya"> 2.149 + body { background:papayawhip } 2.150 +</style></pre> 2.151 + <pre><style title=""> 2.152 + body { background:orange } 2.153 +</style></pre> 2.154 + <pre><style> 2.155 + body { background:brown } 2.156 +</style></pre> 2.157 </div> 2.158 </dd> 2.159 2.160 <dt><dfn id="style-sheet-alternate-flag">style sheet alternate flag</dfn></dt> 2.161 <dd> 2.162 - <p>Either set or unset. Unset by default.</p> 2.163 + <p>Either set or clear. Clear by default.</p> 2.164 2.165 <div class="example"> 2.166 <p>The following <span title="style sheet">style sheets</span> have 2.167 @@ -756,9 +775,9 @@ 2.168 2.169 <dt><dfn id="style-sheet-disabled-flag">style sheet disabled flag</dfn></dt> 2.170 <dd> 2.171 - <p>Either set or unset. Unset by default.</p> 2.172 + <p>Either set or clear. Clear by default.</p> 2.173 2.174 - <p class="note">Even when unset it does not necessarily mean that the 2.175 + <p class="note">Even when clear it does not necessarily mean that the 2.176 <span>style sheet</span> is actually used for rendering.</p> 2.177 </dd> 2.178 2.179 @@ -830,18 +849,18 @@ 2.180 these steps.</p></li> 2.181 2.182 <li><p>If the <span>style sheet title</span> is non-empty, the 2.183 - <span>style sheet alternate flag</span> is unset, and 2.184 + <span>style sheet alternate flag</span> is clear, and 2.185 <span>preferred style sheet set name</span> is the empty string 2.186 <span>change the preferred style sheet set name</span> to the 2.187 <span>style sheet title</span>.</p></li> 2.188 2.189 <li> 2.190 - <p>If any of the following is true unset the 2.191 + <p>If any of the following is true clear the 2.192 <span>style sheet disabled flag</span> and terminate these steps: 2.193 2.194 <ul> 2.195 <li><p>The <span>style sheet title</span> is empty.</p></li> 2.196 - <li><p>The <span>last style sheet set name</span> is null and the 2.197 + <li><p>The <span>last style sheet set name</span> is <code>null</code> and the 2.198 <span>style sheet title</span> is a 2.199 <span data-anolis-spec=dom>case-sensitive</span> match 2.200 for the <span>preferred style sheet set name</span>.</p></li> 2.201 @@ -857,7 +876,7 @@ 2.202 <p>A <dfn id="persistent-style-sheet">persistent style sheet</dfn> is a 2.203 <span>style sheet</span> from the <span>document style sheets</span> 2.204 whose <span>style sheet title</span> is the empty string and whose 2.205 - <span>style sheet alternate flag</span> is unset.</p> 2.206 + <span>style sheet alternate flag</span> is clear.</p> 2.207 2.208 <p>A <dfn id="style-sheet-set">style sheet set</dfn> is an ordered 2.209 collection of one or more <span title="style sheet">style sheets</span> 2.210 @@ -870,7 +889,7 @@ 2.211 2.212 <p>An <dfn id="enabled-style-sheet-set">enabled style sheet set</dfn> is a 2.213 <span>style sheet set</span> of which each <span>style sheet</span> has 2.214 - its <span>style sheet disabled flag</span> unset.</p> 2.215 + its <span>style sheet disabled flag</span> clear.</p> 2.216 2.217 <p>To <dfn id="enable-a-style-sheet-set">enable a style sheet set</dfn> 2.218 with name <var>name</var>, run these steps:</p> 2.219 @@ -880,7 +899,7 @@ 2.220 <span>style sheet disabled flag</span> for each <span>style sheet</span> 2.221 that is in a <span>style sheet set</span> and terminate these steps.</li> 2.222 2.223 - <li><p>Unset the <span>style sheet disabled flag</span> for each 2.224 + <li><p>Clear the <span>style sheet disabled flag</span> for each 2.225 <span>style sheet</span> in a <span>style sheet set</span> whose 2.226 <span>style sheet set name</span> is a 2.227 <span data-anolis-spec=dom>case-sensitive</span> match for 2.228 @@ -903,13 +922,13 @@ 2.229 <p>A <dfn id="last-style-sheet-set-name">last style sheet set name</dfn> 2.230 is a concept to determine what <span>style sheet set</span> was last 2.231 <span title="select a style sheet set">selected</span>. Initially its 2.232 - value is null.</p> 2.233 + value is <code>null</code>.</p> 2.234 2.235 <p>A 2.236 <dfn id="preferred-style-sheet-set-name">preferred style sheet set name</dfn> 2.237 is a concept to determine which 2.238 <span title="style sheet">style sheets</span> need to have their 2.239 - <span>style sheet disabled flag</span> unset. Initially its value 2.240 + <span>style sheet disabled flag</span> clear. Initially its value 2.241 is the empty string. 2.242 2.243 <p>To 2.244 @@ -925,7 +944,7 @@ 2.245 <li><p>If <var>name</var> is not a 2.246 <span data-anolis-spec=dom>case-sensitive</span> match for 2.247 <var>current</var> and 2.248 - <span>last style sheet set name</span> is null 2.249 + <span>last style sheet set name</span> is <code>null</code> 2.250 <span>enable a style sheet set</span> with name 2.251 <var>name</var>.</p></li> 2.252 </ol> 2.253 @@ -972,7 +991,7 @@ 2.254 showing the 2.255 <code title="dom-Document-selectedStyleSheetSet">selectedStyleSheetSet</code> 2.256 as the selected style sheet set, leaving none selected if it is 2.257 - null or the empty string, and selecting an extra option 2.258 + <code>null</code> or the empty string, and selecting an extra option 2.259 "Basic Page Style" (or similar) if it is the empty string and the 2.260 <code title="dom-Document-preferredStyleSheetSet">preferredStyleSheetSet</code> 2.261 is the empty string as well.</p> 2.262 @@ -988,10 +1007,10 @@ 2.263 <p>If a user agent persist the selected style sheet set, they should use 2.264 the value of the 2.265 <code title="dom-Document-selectedStyleSheetSet">selectedStyleSheetSet</code> 2.266 - attribute, or if that is null, the 2.267 + attribute, or if that is <code>null</code>, the 2.268 <code title="dom-Document-lastStyleSheetSet">lastStyleSheetSet</code> 2.269 attribute, when leaving the page (or at some other time) to determine the 2.270 - set name to store. If that is null then the style sheet set should not be 2.271 + set name to store. If that is <code>null</code> then the style sheet set should not be 2.272 persisted.</p> 2.273 2.274 <p>When re-setting the style sheet set to the persisted value (which can 2.275 @@ -1029,7 +1048,7 @@ 2.276 <p>...the style sheets that end up enabled are style sheets "a", "b", 2.277 and "c", the 2.278 <code title="dom-Document-selectedStyleSheetSet">selectedStyleSheetSet</code> 2.279 - attribute would return null, 2.280 + attribute would return <code>null</code>, 2.281 <code title="dom-Document-lastStyleSheetSet">lastStyleSheetSet</code> 2.282 would return "foo", and 2.283 <code title="dom-Document-preferredStyleSheetSet">preferredStyleSheetSet</code> 2.284 @@ -1062,7 +1081,7 @@ 2.285 was never set 2.286 explicitly, leaving 2.287 <code title="dom-Document-lastStyleSheetSet">lastStyleSheetSet</code> at 2.288 - null throughout), which changes which style sheets are enabled and which 2.289 + <code>null</code> throughout), which changes which style sheets are enabled and which 2.290 are not.</p> 2.291 </div> 2.292 2.293 @@ -1096,7 +1115,7 @@ 2.294 <p>In the following HTML snippet the first HTML <code>style</code> 2.295 element has a <code>sheet</code> attribute that returns a 2.296 <code>StyleSheet</code> object representing the style sheet, but for 2.297 - the second <code>style</code> attribute it returns null. 2.298 + the second <code>style</code> attribute it returns <code>null</code>. 2.299 (Assuming the user agent supports CSS (<code>text/css</code>) and does 2.300 not support ExampleSheets (<code>text/example-sheets</code>).</p> 2.301 2.302 @@ -1185,13 +1204,13 @@ 2.303 resource.</p></dd> 2.304 2.305 <dt><span>style sheet parent</span></dt> 2.306 - <dd><p>null</p></dd> 2.307 + <dd><p><code>null</code></p></dd> 2.308 2.309 <dt><span>style sheet owner node</span></dt> 2.310 <dd><p>The node.</p></dd> 2.311 2.312 <dt><span>style sheet owner CSS rule</span></dt> 2.313 - <dd><p>null</p></dd> 2.314 + <dd><p><code>null</code></p></dd> 2.315 2.316 <dt><span>style sheet media</span></dt> 2.317 <dd><p>The value of the <code>media</code> <span data-anolis-spec=xmlss>pseudo-attribute</span> 2.318 @@ -1203,7 +1222,7 @@ 2.319 <dt><span>style sheet alternate flag</span></dt> 2.320 <dd><p>Set if the <code>alternate</code> <span data-anolis-spec=xmlss>pseudo-attribute</span> 2.321 value is a <span data-anolis-spec=dom>case-sensitive</span> match for 2.322 - "<code>yes</code>", or unset otherwise. 2.323 + "<code>yes</code>", or clear otherwise. 2.324 </dl> 2.325 </li> 2.326 </ol> 2.327 @@ -1258,13 +1277,13 @@ 2.328 resource.</p></dd> 2.329 2.330 <dt><span>style sheet owner node</span></dt> 2.331 - <dd><p>null</p></dd> 2.332 + <dd><p><code>null</code></p></dd> 2.333 2.334 <dt><span>style sheet parent</span></dt> 2.335 - <dd><p>null</p></dd> 2.336 + <dd><p><code>null</code></p></dd> 2.337 2.338 <dt><span>style sheet owner CSS rule</span></dt> 2.339 - <dd><p>null</p></dd> 2.340 + <dd><p><code>null</code></p></dd> 2.341 2.342 <dt><span>style sheet media</span></dt> 2.343 <dd><p>The value of the first <code>media</code> parameter.</p></dd> 2.344 @@ -1288,9 +1307,9 @@ 2.345 <h3>CSS Rules</h3> 2.346 2.347 <p>A <dfn id="rule">CSS rule</dfn> is an abstract concept that 2.348 - represents a rule as defined by the CSS specification. In the CSSOM a 2.349 + denotes a rule as defined by the CSS specification. A 2.350 <span>CSS rule</span> is represented as an object that implements a subclass of 2.351 - the <code>CSSRule</code> interface. A <span>CSS rule</span> has the following 2.352 + the <code>CSSRule</code> interface, and which has the following 2.353 associated state items:</p> 2.354 2.355 <dl> 2.356 @@ -1304,17 +1323,17 @@ 2.357 2.358 <dt><dfn id="rule-parent">rule parent</dfn></dt> 2.359 <dd><p>An optional reference to another, enclosing <span>CSS rule</span>. 2.360 - If the rule has an enclosing rule when it is created, then this item is initialized to the enclosing rule; otherwise it is null. 2.361 - Subsequent to initialization, this item is reset to null if the rule becomes non-enclosed. Once reset to null, it must never change.</p></dd> 2.362 + If the rule has an enclosing rule when it is created, then this item is initialized to the enclosing rule; otherwise it is <code>null</code>. 2.363 + Subsequent to initialization, this item is reset to <code>null</code> if the rule becomes non-enclosed. Once reset to <code>null</code>, it must never change.</p></dd> 2.364 2.365 <dt><dfn id="rule-style-sheet">rule parent style sheet</dfn></dt> 2.366 <dd><p>An optional reference to an associated <span>CSS style sheet</span>. 2.367 This item is initialized to reference an associated style sheet when the rule is created. Subsequent to initialization, this item 2.368 - is reset to null if the rule becomes disassociated from its initial style sheet. Once reset to null, it must never change.</p></dd> 2.369 + is reset to <code>null</code> if the rule becomes disassociated from its initial style sheet. Once reset to <code>null</code>, it must never change.</p></dd> 2.370 </dl> 2.371 2.372 <p>In addition to the above state, each <span>CSS rule</span> may be associated 2.373 - with other state in accordance to the <span>rule type</span>.</p> 2.374 + with other state in accordance with its <span>rule type</span>.</p> 2.375 2.376 <p>To <dfn>parse a CSS rule</dfn> ...</p> 2.377 2.378 @@ -1434,8 +1453,8 @@ 2.379 2.380 <dl> 2.381 <dt><dfn>CSS declaration block readonly flag</dfn></dt> 2.382 - <dd><p>Unset if the object can be manipulated. Set if it can not be 2.383 - manipulated. Unless otherwise stated it is unset.</p></dd> 2.384 + <dd><p>Clear if the object can be manipulated. Set if it can not be 2.385 + manipulated. Unless otherwise stated it is clear.</p></dd> 2.386 2.387 <dt><dfn>CSS declaration block declarations</dfn></dt> 2.388 <dd><p>The CSS declarations associated with the object.</p></dd> 2.389 @@ -1559,12 +1578,12 @@ 2.390 the definition of the property that is an 2.391 <span data-anolis-spec=dom>ASCII case-insensitive</span> match for 2.392 <var>property</var> in the CSS specification. If the given value 2.393 - is <span>ignored</span> return null. Otherwise return the CSS value for 2.394 + is <span>ignored</span> return <code>null</code>. Otherwise return the CSS value for 2.395 the given <var>property</var>.</p> 2.396 2.397 <p class="note">"<code>!important</code>" declarations are not 2.398 part of the property value space and will therefore cause 2.399 - <span>parse a CSS value</span> to return null.</p> 2.400 + <span>parse a CSS value</span> to return <code>null</code>.</p> 2.401 2.402 2.403 <!-- ........................................................................................................................ -->