- From: Anne van Kesteren via cvs-syncmail <cvsmail@w3.org>
- Date: Sat, 02 Jul 2011 11:24:24 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/cssom
In directory hutz:/tmp/cvs-serv24479
Modified Files:
Overview.html Overview.src.html cssom-source
Log Message:
update Conformance
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/cssom/Overview.html,v
retrieving revision 1.146
retrieving revision 1.147
diff -u -d -r1.146 -r1.147
--- Overview.html 2 Jul 2011 10:59:02 -0000 1.146
+++ Overview.html 2 Jul 2011 11:24:22 -0000 1.147
@@ -70,81 +70,80 @@
<li><a href="#introduction"><span class="secno">1 </span>Introduction</a>
<ol class="toc">
<li><a href="#history"><span class="secno">1.1 </span>History</a></ol></li>
- <li><a href="#infrastructure"><span class="secno">2 </span>Common Infrastructure</a>
+ <li><a href="#conformance"><span class="secno">2 </span>Conformance</a></li>
+ <li><a href="#terminology"><span class="secno">3 </span>Terminology</a>
<ol class="toc">
- <li><a href="#terminology"><span class="secno">2.1 </span>Terminology</a></li>
- <li><a href="#conformance"><span class="secno">2.2 </span>Conformance Requirements</a></li>
- <li><a href="#common-serializing-idioms"><span class="secno">2.3 </span>Common Serializing Idioms</a></ol></li>
- <li><a href="#media-queries"><span class="secno">3 </span>Media Queries</a>
+ <li><a href="#common-serializing-idioms"><span class="secno">3.1 </span>Common Serializing Idioms</a></ol></li>
+ <li><a href="#media-queries"><span class="secno">4 </span>Media Queries</a>
<ol class="toc">
- <li><a href="#parsing-media-queries"><span class="secno">3.1 </span>Parsing Media Queries</a></li>
- <li><a href="#serializing-media-queries"><span class="secno">3.2 </span>Serializing Media Queries</a>
+ <li><a href="#parsing-media-queries"><span class="secno">4.1 </span>Parsing Media Queries</a></li>
+ <li><a href="#serializing-media-queries"><span class="secno">4.2 </span>Serializing Media Queries</a>
<ol class="toc">
- <li><a href="#serializing-media-feature-values"><span class="secno">3.2.1 </span>Serializing Media Feature Values</a></ol></li>
- <li><a href="#comparing-media-queries"><span class="secno">3.3 </span>Comparing Media Queries</a></li>
- <li><a href="#the-medialist-interface"><span class="secno">3.4 </span>The <code title="">MediaList</code> Interface</a></li>
- <li><a href="#creating-a-medialist-object"><span class="secno">3.5 </span>Creating a <code title="">MediaList</code> Object</a></ol></li>
- <li><a href="#selectors"><span class="secno">4 </span>Selectors</a>
+ <li><a href="#serializing-media-feature-values"><span class="secno">4.2.1 </span>Serializing Media Feature Values</a></ol></li>
+ <li><a href="#comparing-media-queries"><span class="secno">4.3 </span>Comparing Media Queries</a></li>
+ <li><a href="#the-medialist-interface"><span class="secno">4.4 </span>The <code title="">MediaList</code> Interface</a></li>
+ <li><a href="#creating-a-medialist-object"><span class="secno">4.5 </span>Creating a <code title="">MediaList</code> Object</a></ol></li>
+ <li><a href="#selectors"><span class="secno">5 </span>Selectors</a>
<ol class="toc">
- <li><a href="#parsing-selectors"><span class="secno">4.1 </span>Parsing Selectors</a></li>
- <li><a href="#serializing-selectors"><span class="secno">4.2 </span>Serializing Selectors</a></ol></li>
- <li><a href="#css"><span class="secno">5 </span>CSS</a>
+ <li><a href="#parsing-selectors"><span class="secno">5.1 </span>Parsing Selectors</a></li>
+ <li><a href="#serializing-selectors"><span class="secno">5.2 </span>Serializing Selectors</a></ol></li>
+ <li><a href="#css"><span class="secno">6 </span>CSS</a>
<ol class="toc">
- <li><a href="#style-sheet-0"><span class="secno">5.1 </span>Style Sheet</a>
+ <li><a href="#style-sheet-0"><span class="secno">6.1 </span>Style Sheet</a>
<ol class="toc">
- <li><a href="#the-stylesheet-interface"><span class="secno">5.1.1 </span>The <code title="">StyleSheet</code> Interface</a></li>
- <li><a href="#the-cssstylesheet-interface"><span class="secno">5.1.2 </span>The <code title="">CSSStyleSheet</code> Interface</a></ol></li>
- <li><a href="#style-sheet-collections"><span class="secno">5.2 </span>Style Sheet Collections</a>
+ <li><a href="#the-stylesheet-interface"><span class="secno">6.1.1 </span>The <code title="">StyleSheet</code> Interface</a></li>
+ <li><a href="#the-cssstylesheet-interface"><span class="secno">6.1.2 </span>The <code title="">CSSStyleSheet</code> Interface</a></ol></li>
+ <li><a href="#style-sheet-collections"><span class="secno">6.2 </span>Style Sheet Collections</a>
<ol class="toc">
- <li><a href="#the-http-default-style-header"><span class="secno">5.2.1 </span>The HTTP <code title="">Default-Style</code> Header</a></li>
- <li><a href="#the-stylesheetlist-sequence"><span class="secno">5.2.2 </span>The <code title="">StyleSheetList</code> Sequence</a></li>
- <li><a href="#extensions-to-the-document-interface"><span class="secno">5.2.3 </span>Extensions to the <code title="">Document</code> Interface</a></li>
- <li><a href="#interaction-with-the-user-interface"><span class="secno">5.2.4 </span>Interaction with the User Interface</a>
+ <li><a href="#the-http-default-style-header"><span class="secno">6.2.1 </span>The HTTP <code title="">Default-Style</code> Header</a></li>
+ <li><a href="#the-stylesheetlist-sequence"><span class="secno">6.2.2 </span>The <code title="">StyleSheetList</code> Sequence</a></li>
+ <li><a href="#extensions-to-the-document-interface"><span class="secno">6.2.3 </span>Extensions to the <code title="">Document</code> Interface</a></li>
+ <li><a href="#interaction-with-the-user-interface"><span class="secno">6.2.4 </span>Interaction with the User Interface</a>
<ol class="toc">
- <li><a href="#persisting-the-selected-style-sheet-set"><span class="secno">5.2.4.1 </span>Persisting the selected style sheet set</a></ol></li>
- <li><a href="#examples"><span class="secno">5.2.5 </span>Examples</a></ol></li>
- <li><a href="#style-sheet-association"><span class="secno">5.3 </span>Style Sheet Association</a>
+ <li><a href="#persisting-the-selected-style-sheet-set"><span class="secno">6.2.4.1 </span>Persisting the selected style sheet set</a></ol></li>
+ <li><a href="#examples"><span class="secno">6.2.5 </span>Examples</a></ol></li>
+ <li><a href="#style-sheet-association"><span class="secno">6.3 </span>Style Sheet Association</a>
<ol class="toc">
- <li><a href="#the-linkstyle-interface"><span class="secno">5.3.1 </span>The <code title="">LinkStyle</code> Interface</a></li>
- <li><a href="#requirements-on-specifications"><span class="secno">5.3.2 </span>Requirements on specifications</a></li>
- <li><a href="#requirements-on-user-agents-implementing-the-xml-stylesheet-processing-instruction"><span class="secno">5.3.3 </span>Requirements on User Agents Implementing the
+ <li><a href="#the-linkstyle-interface"><span class="secno">6.3.1 </span>The <code title="">LinkStyle</code> Interface</a></li>
+ <li><a href="#requirements-on-specifications"><span class="secno">6.3.2 </span>Requirements on specifications</a></li>
+ <li><a href="#requirements-on-user-agents-implementing-the-xml-stylesheet-processing-instruction"><span class="secno">6.3.3 </span>Requirements on User Agents Implementing the
<span title=""><code>xml-stylesheet</code> processing instruction</span></a></li>
- <li><a href="#requirements-on-user-agents-implementing-the-http-link-header"><span class="secno">5.3.4 </span>Requirements on User Agents Implementing the HTTP
+ <li><a href="#requirements-on-user-agents-implementing-the-http-link-header"><span class="secno">6.3.4 </span>Requirements on User Agents Implementing the HTTP
<code title="">Link</code> Header</a></ol></li>
- <li><a href="#css-rules"><span class="secno">5.4 </span>CSS Rules</a>
+ <li><a href="#css-rules"><span class="secno">6.4 </span>CSS Rules</a>
<ol class="toc">
- <li><a href="#the-cssrulelist-sequence"><span class="secno">5.4.1 </span>The <code title="">CSSRuleList</code> Sequence</a></li>
- <li><a href="#the-cssrule-interface"><span class="secno">5.4.2 </span>The <code title="">CSSRule</code> Interface</a>
+ <li><a href="#the-cssrulelist-sequence"><span class="secno">6.4.1 </span>The <code title="">CSSRuleList</code> Sequence</a></li>
+ <li><a href="#the-cssrule-interface"><span class="secno">6.4.2 </span>The <code title="">CSSRule</code> Interface</a>
<ol class="toc">
- <li><a href="#extensibility"><span class="secno">5.4.2.1 </span>Extensibility</a></ol></li>
- <li><a href="#css-style-rule-rule-set"><span class="secno">5.4.3 </span>CSS Style Rule (Rule Set)</a></li>
- <li><a href="#css-import-rule"><span class="secno">5.4.4 </span>CSS <code title="">@import</code> Rule</a></li>
- <li><a href="#css-media-rule"><span class="secno">5.4.5 </span>CSS <code title="">@media</code> Rule</a></li>
- <li><a href="#css-font-face-rule"><span class="secno">5.4.6 </span>CSS <code title="">@font-face</code> Rule</a></li>
- <li><a href="#css-page-rule"><span class="secno">5.4.7 </span>CSS <code title="">@page</code> Rule</a></li>
- <li><a href="#css-namespace-rule"><span class="secno">5.4.8 </span>CSS <code title="">@namespace</code> Rule</a></ol></li>
- <li><a href="#css-declaration-blocks"><span class="secno">5.5 </span>CSS Declaration Blocks</a>
+ <li><a href="#extensibility"><span class="secno">6.4.2.1 </span>Extensibility</a></ol></li>
+ <li><a href="#css-style-rule-rule-set"><span class="secno">6.4.3 </span>CSS Style Rule (Rule Set)</a></li>
+ <li><a href="#css-import-rule"><span class="secno">6.4.4 </span>CSS <code title="">@import</code> Rule</a></li>
+ <li><a href="#css-media-rule"><span class="secno">6.4.5 </span>CSS <code title="">@media</code> Rule</a></li>
+ <li><a href="#css-font-face-rule"><span class="secno">6.4.6 </span>CSS <code title="">@font-face</code> Rule</a></li>
+ <li><a href="#css-page-rule"><span class="secno">6.4.7 </span>CSS <code title="">@page</code> Rule</a></li>
+ <li><a href="#css-namespace-rule"><span class="secno">6.4.8 </span>CSS <code title="">@namespace</code> Rule</a></ol></li>
+ <li><a href="#css-declaration-blocks"><span class="secno">6.5 </span>CSS Declaration Blocks</a>
<ol class="toc">
- <li><a href="#the-cssstyledeclaration-interface"><span class="secno">5.5.1 </span>The <code title="">CSSStyleDeclaration</code> Interface</a></li>
- <li><a href="#the-cssstyledeclarationvalue-interface"><span class="secno">5.5.2 </span>The <code title="">CSSStyleDeclarationValue</code> Interface</a></ol></li>
- <li><a href="#css-values"><span class="secno">5.6 </span>CSS Values</a>
+ <li><a href="#the-cssstyledeclaration-interface"><span class="secno">6.5.1 </span>The <code title="">CSSStyleDeclaration</code> Interface</a></li>
+ <li><a href="#the-cssstyledeclarationvalue-interface"><span class="secno">6.5.2 </span>The <code title="">CSSStyleDeclarationValue</code> Interface</a></ol></li>
+ <li><a href="#css-values"><span class="secno">6.6 </span>CSS Values</a>
<ol class="toc">
- <li><a href="#parsing-css-values"><span class="secno">5.6.1 </span>Parsing CSS Values</a></li>
- <li><a href="#serializing-css-values"><span class="secno">5.6.2 </span>Serializing CSS Values</a>
+ <li><a href="#parsing-css-values"><span class="secno">6.6.1 </span>Parsing CSS Values</a></li>
+ <li><a href="#serializing-css-values"><span class="secno">6.6.2 </span>Serializing CSS Values</a>
<ol class="toc">
- <li><a href="#examples-0"><span class="secno">5.6.2.1 </span>Examples</a></ol></li>
- <li><a href="#the-csspropertyvalue-interface"><span class="secno">5.6.3 </span>The <code title="">CSSPropertyValue</code> Interface</a></li>
- <li><a href="#the-cssmapvalue-interface"><span class="secno">5.6.4 </span>The <code title="">CSSMapValue</code> Interface</a></li>
- <li><a href="#the-csspropertyvaluelist-interface"><span class="secno">5.6.5 </span>The <code title="">CSSPropertyValueList</code> Interface</a></li>
- <li><a href="#the-csscomponentvalue-interface"><span class="secno">5.6.6 </span>The <code title="">CSSComponentValue</code> Interface</a></ol></ol></li>
- <li><a href="#dom-access-to-css-declaration-blocks"><span class="secno">6 </span>DOM Access to CSS Declaration Blocks</a>
+ <li><a href="#examples-0"><span class="secno">6.6.2.1 </span>Examples</a></ol></li>
+ <li><a href="#the-csspropertyvalue-interface"><span class="secno">6.6.3 </span>The <code title="">CSSPropertyValue</code> Interface</a></li>
+ <li><a href="#the-cssmapvalue-interface"><span class="secno">6.6.4 </span>The <code title="">CSSMapValue</code> Interface</a></li>
+ <li><a href="#the-csspropertyvaluelist-interface"><span class="secno">6.6.5 </span>The <code title="">CSSPropertyValueList</code> Interface</a></li>
+ <li><a href="#the-csscomponentvalue-interface"><span class="secno">6.6.6 </span>The <code title="">CSSComponentValue</code> Interface</a></ol></ol></li>
+ <li><a href="#dom-access-to-css-declaration-blocks"><span class="secno">7 </span>DOM Access to CSS Declaration Blocks</a>
<ol class="toc">
- <li><a href="#the-elementcssinlinestyle-interface"><span class="secno">6.1 </span>The <code>ElementCSSInlineStyle</code> Interface</a></li>
- <li><a href="#extensions-to-the-window-interface"><span class="secno">6.2 </span>Extensions to the <code title="">Window</code> Interface</a></ol></li>
- <li><a href="#resolved-values"><span class="secno">7 </span>Resolved Values</a></li>
- <li><a href="#iana-considerations"><span class="secno">8 </span>IANA Considerations</a>
+ <li><a href="#the-elementcssinlinestyle-interface"><span class="secno">7.1 </span>The <code>ElementCSSInlineStyle</code> Interface</a></li>
+ <li><a href="#extensions-to-the-window-interface"><span class="secno">7.2 </span>Extensions to the <code title="">Window</code> Interface</a></ol></li>
+ <li><a href="#resolved-values"><span class="secno">8 </span>Resolved Values</a></li>
+ <li><a href="#iana-considerations"><span class="secno">9 </span>IANA Considerations</a>
<ol class="toc">
- <li><a href="#default-style"><span class="secno">8.1 </span><code>Default-Style</code></a></ol></li>
+ <li><a href="#default-style"><span class="secno">9.1 </span><code>Default-Style</code></a></ol></li>
<li><a class="no-num" href="#references">References</a>
<ol class="toc">
<li><a class="no-num" href="#normative-references">Normative references</a></li>
@@ -170,11 +169,42 @@
been removed as well as they were not deemed necessary.</p>
+ <h2 id="conformance"><span class="secno">2 </span>Conformance</h2>
+<p>All diagrams, examples, and notes in this specification are
+non-normative, as are all sections explicitly marked non-normative.
+Everything else in this specification is normative.
- <h2 id="infrastructure"><span class="secno">2 </span>Common Infrastructure</h2>
+<p>The key words "MUST", "MUST NOT", "REQUIRED", <!--"SHALL", "SHALL
+NOT",--> "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and
+"OPTIONAL" in the normative parts of this document are to be
+interpreted as described in RFC2119. For readability, these words do
+not appear in all uppercase letters in this specification.
+<a href="#refsRFC2119">[RFC2119]</a>
- <h3 id="terminology"><span class="secno">2.1 </span>Terminology</h3>
+<p>Requirements phrased in the imperative as part of algorithms
+(such as "strip any leading space characters" or "return false and
+terminate these steps") are to be interpreted with the meaning of the
+key word ("must", "should", "may", etc) used in introducing the
+algorithm.
+
+<p>Conformance requirements phrased as algorithms or specific steps
+may be implemented in any manner, so long as the end result is
+equivalent. (In particular, the algorithms defined in this
+specification are intended to be easy to follow, and not intended to
+be performant.)
+
+<p id="hardwareLimitations">User agents may impose
+implementation-specific limits on otherwise unconstrained inputs,
+e.g. to prevent denial of service attacks, to guard against running
+out of memory, or to work around platform-specific limitations.
+
+<p>When a method or an attribute is said to call another method or attribute, the user agent must invoke its internal API for that attribute or method so that e.g. the author can't change the behavior by overriding attributes or methods with custom properties or functions in ECMAScript.
+
+<p>Unless otherwise stated, string comparisons are done in a <span>case-sensitive</span> manner.
+
+
+ <h2 id="terminology"><span class="secno">3 </span>Terminology</h2>
<p class="XXX">
<dfn id="content-type-metadata">Content-Type metadata</dfn>,
@@ -190,19 +220,7 @@
CSS. <!--XXX <a href="#ref-css">[CSS]</a>--></p>
- <h3 id="conformance"><span class="secno">2.2 </span>Conformance Requirements</h3>
-
- <p>Everything in this specification is normative except for diagrams,
- examples, notes and sections marked non-normative.</p>
-
- <p>The key words must, must not, required, shall, shall not, should,
- should not and may in the normative parts of this document are to be
- interpreted as described in RFC 2119.
- <a href="#refsRFC2119">[RFC2119]</a>
-
-
-
- <h3 id="common-serializing-idioms"><span class="secno">2.3 </span>Common Serializing Idioms</h3>
+ <h3 id="common-serializing-idioms"><span class="secno">3.1 </span>Common Serializing Idioms</h3>
<p>To <dfn id="serialize-a-character">serialize a character</dfn> means to create a string of
"<code>\</code>" (U+005C), followed by the character.</p>
@@ -267,7 +285,7 @@
items of the list in list order while separating them a space (U+0020).</p>
- <h2 id="media-queries"><span class="secno">3 </span>Media Queries</h2>
+ <h2 id="media-queries"><span class="secno">4 </span>Media Queries</h2>
<p>Media queries are defined by the Media Queries specification. This
section defines various concepts around media queries, including their API
@@ -275,7 +293,7 @@
<!-- XXX ref -->
- <h3 id="parsing-media-queries"><span class="secno">3.1 </span>Parsing Media Queries</h3>
+ <h3 id="parsing-media-queries"><span class="secno">4.1 </span>Parsing Media Queries</h3>
<p>To
<dfn id="parse-a-media-query-list">parse a media query list</dfn> for a
@@ -297,7 +315,7 @@
turn into "<code title="">not all</code>".</p>
- <h3 id="serializing-media-queries"><span class="secno">3.2 </span>Serializing Media Queries</h3>
+ <h3 id="serializing-media-queries"><span class="secno">4.2 </span>Serializing Media Queries</h3>
<p>To
<dfn id="serialize-a-media-query-list">serialize a media query list</dfn>
@@ -379,7 +397,7 @@
</div>
- <h4 id="serializing-media-feature-values"><span class="secno">3.2.1 </span>Serializing Media Feature Values</h4>
+ <h4 id="serializing-media-feature-values"><span class="secno">4.2.1 </span>Serializing Media Feature Values</h4>
<p class="XXX">This should probably be done in terms of mapping it to
serializing CSS values as media features are defined in terms of CSS
@@ -444,7 +462,7 @@
- <h3 id="comparing-media-queries"><span class="secno">3.3 </span>Comparing Media Queries</h3>
+ <h3 id="comparing-media-queries"><span class="secno">4.3 </span>Comparing Media Queries</h3>
<p>To
<dfn id="compare-media-queries">compare media queries</dfn>
@@ -456,7 +474,7 @@
- <h3 id="the-medialist-interface"><span class="secno">3.4 </span>The <code title="">MediaList</code> Interface</h3>
+ <h3 id="the-medialist-interface"><span class="secno">4.4 </span>The <code title="">MediaList</code> Interface</h3>
<p>An object that implements the <code><a href="#medialist">MediaList</a></code> interface has an
associated <dfn id="collection-of-media-queries">collection of media queries</dfn>.</p>
@@ -543,7 +561,7 @@
</ol>
- <h3 id="creating-a-medialist-object"><span class="secno">3.5 </span>Creating a <code title="">MediaList</code> Object</h3>
+ <h3 id="creating-a-medialist-object"><span class="secno">4.5 </span>Creating a <code title="">MediaList</code> Object</h3>
<p>To
<dfn id="create-a-medialist-object">create a <code>MediaList</code> object</dfn>
@@ -561,14 +579,14 @@
- <h2 id="selectors"><span class="secno">4 </span>Selectors</h2>
+ <h2 id="selectors"><span class="secno">5 </span>Selectors</h2>
<p>Selectors are defined in the Selectors specification. This section
mainly defines how to serialize them.</p> <!-- XXX ref -->
<!-- XXX ref universal selector etc? some are in <span> some not -->
- <h3 id="parsing-selectors"><span class="secno">4.1 </span>Parsing Selectors</h3>
+ <h3 id="parsing-selectors"><span class="secno">5.1 </span>Parsing Selectors</h3>
<p>To
<dfn id="parse-a-group-of-selectors">parse a group of selectors</dfn>
@@ -578,7 +596,7 @@
fail.</p> <!-- XXX ref -->
- <h3 id="serializing-selectors"><span class="secno">4.2 </span>Serializing Selectors</h3>
+ <h3 id="serializing-selectors"><span class="secno">5.2 </span>Serializing Selectors</h3>
<!-- http://dump.testsuite.org/2009/cssom/serializing-selectors.htm -->
<p>To
@@ -768,9 +786,9 @@
- <h2 id="css"><span class="secno">5 </span>CSS</h2>
+ <h2 id="css"><span class="secno">6 </span>CSS</h2>
- <h3 id="style-sheet-0"><span class="secno">5.1 </span>Style Sheet</h3>
+ <h3 id="style-sheet-0"><span class="secno">6.1 </span>Style Sheet</h3>
<!-- XXX
element inserted into the DOM, style sheet created, element removed from
@@ -866,7 +884,7 @@
<!-- same-origin restrictions -->
- <h4 id="the-stylesheet-interface"><span class="secno">5.1.1 </span>The <code title="">StyleSheet</code> Interface</h4>
+ <h4 id="the-stylesheet-interface"><span class="secno">6.1.1 </span>The <code title="">StyleSheet</code> Interface</h4>
<p>The <code><a href="#stylesheet">StyleSheet</a></code> interface represents a base interface that
has no meaning on its own.</p>
@@ -919,7 +937,7 @@
the given value.</p>
- <h4 id="the-cssstylesheet-interface"><span class="secno">5.1.2 </span>The <code title="">CSSStyleSheet</code> Interface</h4>
+ <h4 id="the-cssstylesheet-interface"><span class="secno">6.1.2 </span>The <code title="">CSSStyleSheet</code> Interface</h4>
<p>The <code><a href="#cssstylesheet">CSSStyleSheet</a></code> interface represents a
<a href="#style-sheet">style sheet</a>.</p>
@@ -966,7 +984,7 @@
- <h3 id="style-sheet-collections"><span class="secno">5.2 </span>Style Sheet Collections</h3>
+ <h3 id="style-sheet-collections"><span class="secno">6.2 </span>Style Sheet Collections</h3>
<p>Below various new concepts are defined that are associated with each
<code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#document">Document</a></code> object.</p>
@@ -1116,7 +1134,7 @@
-->
- <h4 id="the-http-default-style-header"><span class="secno">5.2.1 </span>The HTTP <code title="">Default-Style</code> Header</h4>
+ <h4 id="the-http-default-style-header"><span class="secno">6.2.1 </span>The HTTP <code title="">Default-Style</code> Header</h4>
<p>The HTTP <code title="http-default-style"><a href="#default-style">Default-Style</a></code> header
can be used to set the <a href="#preferred-style-sheet-set-name">preferred style sheet set name</a>
@@ -1131,7 +1149,7 @@
- <h4 id="the-stylesheetlist-sequence"><span class="secno">5.2.2 </span>The <code title="">StyleSheetList</code> Sequence</h4>
+ <h4 id="the-stylesheetlist-sequence"><span class="secno">6.2.2 </span>The <code title="">StyleSheetList</code> Sequence</h4>
<p>The sequence parameterized type represents an ordered collection of
<a href="#style-sheet" title="style sheet">style sheets</a>.</p>
@@ -1158,7 +1176,7 @@
-->
- <h4 id="extensions-to-the-document-interface"><span class="secno">5.2.3 </span>Extensions to the <code title="">Document</code> Interface</h4>
+ <h4 id="extensions-to-the-document-interface"><span class="secno">6.2.3 </span>Extensions to the <code title="">Document</code> Interface</h4>
<!-- https://bugzilla.mozilla.org/show_bug.cgi?id=200930 (FIXED) -->
<pre class="idl">partial interface <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#document">Document</a> {
@@ -1272,7 +1290,7 @@
attributes.</p>
- <h4 id="interaction-with-the-user-interface"><span class="secno">5.2.4 </span>Interaction with the User Interface</h4>
+ <h4 id="interaction-with-the-user-interface"><span class="secno">6.2.4 </span>Interaction with the User Interface</h4>
<p>The user interface of Web browsers that support style sheets
should list the style sheet titles given in the
@@ -1291,7 +1309,7 @@
<code title="dom-Document-lastStyleSheetSet"><a href="#dom-document-lastStyleSheetSet">lastStyleSheetSet</a></code>
attribute.</p>
- <h5 id="persisting-the-selected-style-sheet-set"><span class="secno">5.2.4.1 </span>Persisting the selected style sheet set</h5>
+ <h5 id="persisting-the-selected-style-sheet-set"><span class="secno">6.2.4.1 </span>Persisting the selected style sheet set</h5>
<p>If a user agent persist the selected style sheet set, they should use
the value of the
@@ -1318,7 +1336,7 @@
<!-- XXX this UI section suggests we may want to introduce a few more
idioms -->
- <h4 id="examples"><span class="secno">5.2.5 </span>Examples</h4>
+ <h4 id="examples"><span class="secno">6.2.5 </span>Examples</h4>
<div class="example">
<p>Thus, in the following HTML snippet:</p>
@@ -1377,7 +1395,7 @@
- <h3 id="style-sheet-association"><span class="secno">5.3 </span>Style Sheet Association</h3>
+ <h3 id="style-sheet-association"><span class="secno">6.3 </span>Style Sheet Association</h3>
<p>This section defines the interface a <a href="#style-sheet-owner-node">style sheet owner node</a> of a
<a href="#style-sheet">style sheet</a> has to implement and defines the requirements for
@@ -1393,7 +1411,7 @@
this specification, in due course.</p>
- <h4 id="the-linkstyle-interface"><span class="secno">5.3.1 </span>The <code title="">LinkStyle</code> Interface</h4>
+ <h4 id="the-linkstyle-interface"><span class="secno">6.3.1 </span>The <code title="">LinkStyle</code> Interface</h4>
<p>The <dfn id="associated-style-sheet">associated style sheet</dfn> of a
node is the <a href="#style-sheet">style sheet</a> in the list of
@@ -1430,7 +1448,7 @@
- <h4 id="requirements-on-specifications"><span class="secno">5.3.2 </span>Requirements on specifications</h4>
+ <h4 id="requirements-on-specifications"><span class="secno">6.3.2 </span>Requirements on specifications</h4>
<p>Specifications introducing new ways of associating style sheets through
the DOM should define which nodes implement the
@@ -1441,7 +1459,7 @@
- <h4 id="requirements-on-user-agents-implementing-the-xml-stylesheet-processing-instruction"><span class="secno">5.3.3 </span>Requirements on User Agents Implementing the
+ <h4 id="requirements-on-user-agents-implementing-the-xml-stylesheet-processing-instruction"><span class="secno">6.3.3 </span>Requirements on User Agents Implementing the
<span title=""><code>xml-stylesheet</code> processing instruction</span></h4>
<!-- XXX ref, one day -->
@@ -1523,7 +1541,7 @@
- <h4 id="requirements-on-user-agents-implementing-the-http-link-header"><span class="secno">5.3.4 </span>Requirements on User Agents Implementing the HTTP
+ <h4 id="requirements-on-user-agents-implementing-the-http-link-header"><span class="secno">6.3.4 </span>Requirements on User Agents Implementing the HTTP
<code title="">Link</code> Header</h4>
<!-- XXX ref, one day -->
@@ -1596,7 +1614,7 @@
</ol>
- <h3 id="css-rules"><span class="secno">5.4 </span>CSS Rules</h3>
+ <h3 id="css-rules"><span class="secno">6.4 </span>CSS Rules</h3>
<p>To <dfn id="parse-a-css-rule">parse a CSS rule</dfn> ...</p>
@@ -1681,7 +1699,7 @@
</ol>
- <h4 id="the-cssrulelist-sequence"><span class="secno">5.4.1 </span>The <code title="">CSSRuleList</code> Sequence</h4>
+ <h4 id="the-cssrulelist-sequence"><span class="secno">6.4.1 </span>The <code title="">CSSRuleList</code> Sequence</h4>
<p>The <code><a href="#cssrulelist">CSSRuleList</a></code> object represents an ordered collection of
CSS rules.</p>
@@ -1689,7 +1707,7 @@
<pre class="idl">typedef sequence<<a href="#cssrule">CSSRule</a>> <dfn id="cssrulelist">CSSRuleList</dfn>;</pre>
- <h4 id="the-cssrule-interface"><span class="secno">5.4.2 </span>The <code title="">CSSRule</code> Interface</h4>
+ <h4 id="the-cssrule-interface"><span class="secno">6.4.2 </span>The <code title="">CSSRule</code> Interface</h4>
<p>The <code><a href="#cssrule">CSSRule</a></code> interface is a base interface. Each unique
CSS rule has its own interface which inherits from this one.</p>
@@ -1776,7 +1794,7 @@
object that contains the the current rule.</p>
- <h5 id="extensibility"><span class="secno">5.4.2.1 </span>Extensibility</h5>
+ <h5 id="extensibility"><span class="secno">6.4.2.1 </span>Extensibility</h5>
<p>The constant values 0-1000 are reserved for future use by the CSS WG.</p>
@@ -1793,7 +1811,7 @@
such as <code>www-style@w3.org</code>.</p>
- <h4 id="css-style-rule-rule-set"><span class="secno">5.4.3 </span>CSS Style Rule (Rule Set)</h4>
+ <h4 id="css-style-rule-rule-set"><span class="secno">6.4.3 </span>CSS Style Rule (Rule Set)</h4>
<p>The <code><a href="#cssstylerule">CSSStyleRule</a></code> object represents a rule set.</p>
<!-- XXX ref -->
@@ -1830,7 +1848,7 @@
<code><a href="#cssstyledeclaration">CSSStyleDeclaration</a></code> object for the rule set.</p>
- <h4 id="css-import-rule"><span class="secno">5.4.4 </span>CSS <code title="">@import</code> Rule</h4>
+ <h4 id="css-import-rule"><span class="secno">6.4.4 </span>CSS <code title="">@import</code> Rule</h4>
<p>The <code><a href="#cssimportrule">CSSImportRule</a></code> object represents an
<code>@import</code> rule.</p>
@@ -1867,7 +1885,7 @@
<a href="#style-sheet">style sheet</a>.</p>
- <h4 id="css-media-rule"><span class="secno">5.4.5 </span>CSS <code title="">@media</code> Rule</h4>
+ <h4 id="css-media-rule"><span class="secno">6.4.5 </span>CSS <code title="">@media</code> Rule</h4>
<p>The <code><a href="#cssmediarule">CSSMediaRule</a></code> object represents an
<code title="">@media</code> rule.</p>
@@ -1907,7 +1925,7 @@
<var title="">index</var>.</p>
- <h4 id="css-font-face-rule"><span class="secno">5.4.6 </span>CSS <code title="">@font-face</code> Rule</h4>
+ <h4 id="css-font-face-rule"><span class="secno">6.4.6 </span>CSS <code title="">@font-face</code> Rule</h4>
<p>The <code><a href="#cssfontfacerule">CSSFontFaceRule</a></code> object represents an
<code>@font-face</code> rule.</p>
@@ -1923,7 +1941,7 @@
<code>@font-face</code> rule.</p>
- <h4 id="css-page-rule"><span class="secno">5.4.7 </span>CSS <code title="">@page</code> Rule</h4>
+ <h4 id="css-page-rule"><span class="secno">6.4.7 </span>CSS <code title="">@page</code> Rule</h4>
<p class="XXX">Need to define the rules for
<dfn id="parse-a-css-page-selector">parse a CSS page selector</dfn> and
@@ -1964,7 +1982,7 @@
<code><a href="#cssstyledeclaration">CSSStyleDeclaration</a></code> for the <code>@page</code> rule.</p>
- <h4 id="css-namespace-rule"><span class="secno">5.4.8 </span>CSS <code title="">@namespace</code> Rule</h4>
+ <h4 id="css-namespace-rule"><span class="secno">6.4.8 </span>CSS <code title="">@namespace</code> Rule</h4>
<p>The <code><a href="#cssnamespacerule">CSSNamespaceRule</a></code> object represents an
<code>@namespace</code> rule.</p>
@@ -1985,7 +2003,7 @@
<code>@namespace</code> rule or the empty string if there is no prefix.</p>
- <h3 id="css-declaration-blocks"><span class="secno">5.5 </span>CSS Declaration Blocks</h3>
+ <h3 id="css-declaration-blocks"><span class="secno">6.5 </span>CSS Declaration Blocks</h3>
<p>A <dfn id="css-declaration-block">CSS declaration block</dfn> is an ordered collection of CSS
properties with their associated values, also named CSS declarations. In
@@ -2017,7 +2035,7 @@
- <h4 id="the-cssstyledeclaration-interface"><span class="secno">5.5.1 </span>The <code title="">CSSStyleDeclaration</code> Interface</h4>
+ <h4 id="the-cssstyledeclaration-interface"><span class="secno">6.5.1 </span>The <code title="">CSSStyleDeclaration</code> Interface</h4>
<!-- XXX review nullable DOMString more carefully (DOMString?) -->
@@ -2697,7 +2715,7 @@
-->
- <h4 id="the-cssstyledeclarationvalue-interface"><span class="secno">5.5.2 </span>The <code title="">CSSStyleDeclarationValue</code> Interface</h4>
+ <h4 id="the-cssstyledeclarationvalue-interface"><span class="secno">6.5.2 </span>The <code title="">CSSStyleDeclarationValue</code> Interface</h4>
<pre class="idl">interface <dfn id="cssstyledeclarationvalue">CSSStyleDeclarationValue</dfn> {
<span class="XXX">// ...</span>
@@ -2714,9 +2732,9 @@
<code><a href="#csspercentagecomponentvalue">CSSPercentageComponentValue</a></code>.</p>
- <h3 id="css-values"><span class="secno">5.6 </span>CSS Values</h3>
+ <h3 id="css-values"><span class="secno">6.6 </span>CSS Values</h3>
- <h4 id="parsing-css-values"><span class="secno">5.6.1 </span>Parsing CSS Values</h4>
+ <h4 id="parsing-css-values"><span class="secno">6.6.1 </span>Parsing CSS Values</h4>
<p>To <dfn id="parse-a-css-value">parse a CSS value</dfn> for a given
<var title="">property</var> means to a parse the given value according to
@@ -2731,7 +2749,7 @@
<a href="#parse-a-css-value">parse a CSS value</a> to return null.</p>
- <h4 id="serializing-css-values"><span class="secno">5.6.2 </span>Serializing CSS Values</h4>
+ <h4 id="serializing-css-values"><span class="secno">6.6.2 </span>Serializing CSS Values</h4>
<!-- based on http://damowmow.com/playground/canon.txt -->
@@ -2928,7 +2946,7 @@
define the CSS components.</p>
- <h5 id="examples-0"><span class="secno">5.6.2.1 </span>Examples</h5>
+ <h5 id="examples-0"><span class="secno">6.6.2.1 </span>Examples</h5>
<p>Here are some examples of before and after results on specified values.
The before column could be what the author wrote in a style sheet, while
@@ -2957,7 +2975,7 @@
- <h4 id="the-csspropertyvalue-interface"><span class="secno">5.6.3 </span>The <code title="">CSSPropertyValue</code> Interface</h4>
+ <h4 id="the-csspropertyvalue-interface"><span class="secno">6.6.3 </span>The <code title="">CSSPropertyValue</code> Interface</h4>
<pre class="idl">interface <dfn id="csspropertyvalue">CSSPropertyValue</dfn> {
attribute DOMString <span title="dom-CSSPropertyValue-cssText">cssText</span>;
@@ -2977,7 +2995,7 @@
-->
- <h4 id="the-cssmapvalue-interface"><span class="secno">5.6.4 </span>The <code title="">CSSMapValue</code> Interface</h4>
+ <h4 id="the-cssmapvalue-interface"><span class="secno">6.6.4 </span>The <code title="">CSSMapValue</code> Interface</h4>
<pre class="idl">[NoInterfaceObject] interface <dfn id="cssmapvalue">CSSMapValue</dfn> {
getter <span>CSSValue</span> (DOMString <var title="">name</var>);
@@ -2987,7 +3005,7 @@
<p class="XXX">This seems the simplest we can get away with.</p>
- <h4 id="the-csspropertyvaluelist-interface"><span class="secno">5.6.5 </span>The <code title="">CSSPropertyValueList</code> Interface</h4>
+ <h4 id="the-csspropertyvaluelist-interface"><span class="secno">6.6.5 </span>The <code title="">CSSPropertyValueList</code> Interface</h4>
<pre class="idl">[NoInterfaceObject] interface <dfn id="csspropertyvaluelist">CSSPropertyValueList</dfn> {
readonly attribute <span>CSSValue</span>[] <span title="dom-CSSPropertyValue-list">list</span>;
@@ -2996,7 +3014,7 @@
<p class="XXX">Ideally this attribute just returns a mutable array.</p>
- <h4 id="the-csscomponentvalue-interface"><span class="secno">5.6.6 </span>The <code title="">CSSComponentValue</code> Interface</h4>
+ <h4 id="the-csscomponentvalue-interface"><span class="secno">6.6.6 </span>The <code title="">CSSComponentValue</code> Interface</h4>
<pre class="idl">[NoInterfaceObject] interface <dfn id="csscomponentvalue">CSSComponentValue</dfn> {
readonly attribute DOMString <span title="dom-CSSComponentValue-type">type</span>;
@@ -3044,9 +3062,9 @@
- <h2 id="dom-access-to-css-declaration-blocks"><span class="secno">6 </span>DOM Access to CSS Declaration Blocks</h2>
+ <h2 id="dom-access-to-css-declaration-blocks"><span class="secno">7 </span>DOM Access to CSS Declaration Blocks</h2>
- <h3 id="the-elementcssinlinestyle-interface"><span class="secno">6.1 </span>The <code><a href="#elementcssinlinestyle">ElementCSSInlineStyle</a></code> Interface</h3>
+ <h3 id="the-elementcssinlinestyle-interface"><span class="secno">7.1 </span>The <code><a href="#elementcssinlinestyle">ElementCSSInlineStyle</a></code> Interface</h3>
<pre class="idl">[NoInterfaceObject] interface <dfn id="elementcssinlinestyle">ElementCSSInlineStyle</dfn> {
readonly attribute <a href="#cssstyledeclaration">CSSStyleDeclaration</a> <span>style</span>;
@@ -3060,7 +3078,7 @@
- <h3 id="extensions-to-the-window-interface"><span class="secno">6.2 </span>Extensions to the <code title="">Window</code> Interface</h3>
+ <h3 id="extensions-to-the-window-interface"><span class="secno">7.2 </span>Extensions to the <code title="">Window</code> Interface</h3>
<pre class="idl">partial interface <a class="external" href="http://www.whatwg.org/html/#window">Window</a> {
<a href="#cssstyledeclaration">CSSStyleDeclaration</a> <a href="#dom-window-getcomputedstyle" title="dom-Window-getComputedStyle">getComputedStyle</a>(<a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#element">Element</a> <var title="">elt</var>);
@@ -3117,7 +3135,7 @@
- <h2 id="resolved-values"><span class="secno">7 </span>Resolved Values</h2>
+ <h2 id="resolved-values"><span class="secno">8 </span>Resolved Values</h2>
<p><code title="dom-Window-getComputedStyle"><a href="#dom-window-getcomputedstyle">getComputedStyle()</a></code> was
historically defined to return the "computed value" of an element or
@@ -3186,9 +3204,9 @@
- <h2 id="iana-considerations"><span class="secno">8 </span>IANA Considerations</h2>
+ <h2 id="iana-considerations"><span class="secno">9 </span>IANA Considerations</h2>
- <h3 id="default-style"><span class="secno">8.1 </span><dfn title="http-default-style"><code>Default-Style</code></dfn></h3>
+ <h3 id="default-style"><span class="secno">9.1 </span><dfn title="http-default-style"><code>Default-Style</code></dfn></h3>
<p>This section describes a header field for registration in the Permanent
Message Header Field Registry.
Index: cssom-source
===================================================================
RCS file: /sources/public/csswg/cssom/cssom-source,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -d -r1.2 -r1.3
--- cssom-source 2 Jul 2011 10:59:03 -0000 1.2
+++ cssom-source 2 Jul 2011 11:24:22 -0000 1.3
@@ -94,11 +94,42 @@
been removed as well as they were not deemed necessary.</p>
+ <h2>Conformance</h2>
+<p>All diagrams, examples, and notes in this specification are
+non-normative, as are all sections explicitly marked non-normative.
+Everything else in this specification is normative.
- <h2 id="infrastructure">Common Infrastructure</h2>
+<p>The key words "MUST", "MUST NOT", "REQUIRED", <!--"SHALL", "SHALL
+NOT",--> "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and
+"OPTIONAL" in the normative parts of this document are to be
+interpreted as described in RFC2119. For readability, these words do
+not appear in all uppercase letters in this specification.
+<span data-anolis-ref>RFC2119</span>
- <h3 id="terminology">Terminology</h3>
+<p>Requirements phrased in the imperative as part of algorithms
+(such as "strip any leading space characters" or "return false and
+terminate these steps") are to be interpreted with the meaning of the
+key word ("must", "should", "may", etc) used in introducing the
+algorithm.
+
+<p>Conformance requirements phrased as algorithms or specific steps
+may be implemented in any manner, so long as the end result is
+equivalent. (In particular, the algorithms defined in this
+specification are intended to be easy to follow, and not intended to
+be performant.)
+
+<p id="hardwareLimitations">User agents may impose
+implementation-specific limits on otherwise unconstrained inputs,
+e.g. to prevent denial of service attacks, to guard against running
+out of memory, or to work around platform-specific limitations.
+
+<p>When a method or an attribute is said to call another method or attribute, the user agent must invoke its internal API for that attribute or method so that e.g. the author can't change the behavior by overriding attributes or methods with custom properties or functions in ECMAScript.
+
+<p>Unless otherwise stated, string comparisons are done in a <span>case-sensitive</span> manner.
+
+
+ <h2 id="terminology">Terminology</h2>
<p class="XXX">
<dfn>Content-Type metadata</dfn>,
@@ -114,18 +145,6 @@
CSS. <!--XXX <a href="#ref-css">[CSS]</a>--></p>
- <h3 id="conformance">Conformance Requirements</h3>
-
- <p>Everything in this specification is normative except for diagrams,
- examples, notes and sections marked non-normative.</p>
-
- <p>The key words must, must not, required, shall, shall not, should,
- should not and may in the normative parts of this document are to be
- interpreted as described in RFC 2119.
- <span data-anolis-ref>RFC2119</span>
-
-
-
<h3>Common Serializing Idioms</h3>
<p>To <dfn>serialize a character</dfn> means to create a string of
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/cssom/Overview.src.html,v
retrieving revision 1.149
retrieving revision 1.150
diff -u -d -r1.149 -r1.150
--- Overview.src.html 2 Jul 2011 10:59:03 -0000 1.149
+++ Overview.src.html 2 Jul 2011 11:24:22 -0000 1.150
@@ -94,11 +94,42 @@
been removed as well as they were not deemed necessary.</p>
+ <h2>Conformance</h2>
+<p>All diagrams, examples, and notes in this specification are
+non-normative, as are all sections explicitly marked non-normative.
+Everything else in this specification is normative.
- <h2 id="infrastructure">Common Infrastructure</h2>
+<p>The key words "MUST", "MUST NOT", "REQUIRED", <!--"SHALL", "SHALL
+NOT",--> "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and
+"OPTIONAL" in the normative parts of this document are to be
+interpreted as described in RFC2119. For readability, these words do
+not appear in all uppercase letters in this specification.
+<span data-anolis-ref>RFC2119</span>
- <h3 id="terminology">Terminology</h3>
+<p>Requirements phrased in the imperative as part of algorithms
+(such as "strip any leading space characters" or "return false and
+terminate these steps") are to be interpreted with the meaning of the
+key word ("must", "should", "may", etc) used in introducing the
+algorithm.
+
+<p>Conformance requirements phrased as algorithms or specific steps
+may be implemented in any manner, so long as the end result is
+equivalent. (In particular, the algorithms defined in this
+specification are intended to be easy to follow, and not intended to
+be performant.)
+
+<p id="hardwareLimitations">User agents may impose
+implementation-specific limits on otherwise unconstrained inputs,
+e.g. to prevent denial of service attacks, to guard against running
+out of memory, or to work around platform-specific limitations.
+
+<p>When a method or an attribute is said to call another method or attribute, the user agent must invoke its internal API for that attribute or method so that e.g. the author can't change the behavior by overriding attributes or methods with custom properties or functions in ECMAScript.
+
+<p>Unless otherwise stated, string comparisons are done in a <span>case-sensitive</span> manner.
+
+
+ <h2 id="terminology">Terminology</h2>
<p class="XXX">
<dfn>Content-Type metadata</dfn>,
@@ -114,18 +145,6 @@
CSS. <!--XXX <a href="#ref-css">[CSS]</a>--></p>
- <h3 id="conformance">Conformance Requirements</h3>
-
- <p>Everything in this specification is normative except for diagrams,
- examples, notes and sections marked non-normative.</p>
-
- <p>The key words must, must not, required, shall, shall not, should,
- should not and may in the normative parts of this document are to be
- interpreted as described in RFC 2119.
- <span data-anolis-ref>RFC2119</span>
-
-
-
<h3>Common Serializing Idioms</h3>
<p>To <dfn>serialize a character</dfn> means to create a string of
Received on Saturday, 2 July 2011 11:24:35 UTC