- From: Anne van Kesteren via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 06 Jul 2011 13:17:50 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/cssom-view
In directory hutz:/tmp/cvs-serv28705
Modified Files:
Overview.html Overview.src.html
Log Message:
update Conformance; Terminology should be top-level
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/cssom-view/Overview.html,v
retrieving revision 1.101
retrieving revision 1.102
diff -u -d -r1.101 -r1.102
--- Overview.html 6 Jul 2011 13:06:41 -0000 1.101
+++ Overview.html 6 Jul 2011 13:17:48 -0000 1.102
@@ -11,7 +11,6 @@
p.note::before { content:"Note: " }
.XXX { padding:.5em; border:solid red }
.XXX::before { content:"Issue: " }
- em.ct { font-weight:bold; font-style:normal }
code { color:orangered }
code :link, code :visited { color:inherit }
</style>
@@ -103,36 +102,37 @@
<li><a href="#background"><span class="secno">1 </span>Background</a></li>
<li><a href="#conformance"><span class="secno">2 </span>Conformance</a>
<ol class="toc">
- <li><a href="#webidl"><span class="secno">2.1 </span>Web IDL</a></li>
- <li><a href="#terminology"><span class="secno">2.2 </span>Terminology</a></li>
- <li><a href="#css-pixels"><span class="secno">2.3 </span>CSS pixels</a></ol></li>
- <li><a href="#extensions-to-the-window-interface"><span class="secno">3 </span>Extensions to the <code title="">Window</code> Interface</a>
+ <li><a href="#webidl"><span class="secno">2.1 </span>Web IDL</a></ol></li>
+ <li><a href="#terminology"><span class="secno">3 </span>Terminology</a>
<ol class="toc">
- <li><a href="#the-mediaquerylist-interface"><span class="secno">3.1 </span>The <code title="">MediaQueryList</code> Interface</a></li>
- <li><a href="#the-screen-interface"><span class="secno">3.2 </span>The <code title="">Screen</code> Interface</a></ol></li>
- <li><a href="#extensions-to-the-document-interface"><span class="secno">4 </span>Extensions to the <code title="">Document</code> Interface</a>
+ <li><a href="#css-pixels"><span class="secno">3.1 </span>CSS pixels</a></ol></li>
+ <li><a href="#extensions-to-the-window-interface"><span class="secno">4 </span>Extensions to the <code title="">Window</code> Interface</a>
<ol class="toc">
- <li><a href="#the-caretposition-interface"><span class="secno">4.1 </span>The <code title="">CaretPosition</code> Interface</a></ol></li>
- <li><a href="#extensions-to-the-element-interface"><span class="secno">5 </span>Extensions to the <code title="">Element</code> Interface</a>
+ <li><a href="#the-mediaquerylist-interface"><span class="secno">4.1 </span>The <code title="">MediaQueryList</code> Interface</a></li>
+ <li><a href="#the-screen-interface"><span class="secno">4.2 </span>The <code title="">Screen</code> Interface</a></ol></li>
+ <li><a href="#extensions-to-the-document-interface"><span class="secno">5 </span>Extensions to the <code title="">Document</code> Interface</a>
<ol class="toc">
- <li><a href="#the-getclientrects-and-getboundingclientrect-methods"><span class="secno">5.1 </span>The <code title="">getClientRects()</code> and
+ <li><a href="#the-caretposition-interface"><span class="secno">5.1 </span>The <code title="">CaretPosition</code> Interface</a></ol></li>
+ <li><a href="#extensions-to-the-element-interface"><span class="secno">6 </span>Extensions to the <code title="">Element</code> Interface</a>
+ <ol class="toc">
+ <li><a href="#the-getclientrects-and-getboundingclientrect-methods"><span class="secno">6.1 </span>The <code title="">getClientRects()</code> and
<code title="">getBoundingClientRect()</code> methods</a></li>
- <li><a href="#element-scrolling-members"><span class="secno">5.2 </span><code title="">Element</code> Scrolling Members</a></li>
- <li><a href="#client-attributes"><span class="secno">5.3 </span>The <code title="">clientTop</code>,
+ <li><a href="#element-scrolling-members"><span class="secno">6.2 </span><code title="">Element</code> Scrolling Members</a></li>
+ <li><a href="#client-attributes"><span class="secno">6.3 </span>The <code title="">clientTop</code>,
<code title="">clientLeft</code>, <code title="">clientWidth</code>, and
<code title="">clientHeight</code> attributes</a></ol></li>
- <li><a href="#extensions-to-the-htmlelement-interface"><span class="secno">6 </span>Extensions to the <code title="">HTMLElement</code> Interface</a>
+ <li><a href="#extensions-to-the-htmlelement-interface"><span class="secno">7 </span>Extensions to the <code title="">HTMLElement</code> Interface</a>
<ol class="toc">
- <li><a href="#offset-attributes"><span class="secno">6.1 </span>The <code title="">offsetParent</code>,
+ <li><a href="#offset-attributes"><span class="secno">7.1 </span>The <code title="">offsetParent</code>,
<code title="">offsetTop</code>, <code title="">offsetLeft</code>,
<code title="">offsetWidth</code>, and <code title="">offsetHeight</code>
attributes</a></ol></li>
- <li><a href="#extensions-to-the-range-interface"><span class="secno">7 </span>Extensions to the <code title="">Range</code> Interface</a></li>
- <li><a href="#extensions-to-the-mouseevent-interface"><span class="secno">8 </span>Extensions to the <code title="">MouseEvent</code> Interface</a></li>
- <li><a href="#rectangles"><span class="secno">9 </span>Rectangles</a>
+ <li><a href="#extensions-to-the-range-interface"><span class="secno">8 </span>Extensions to the <code title="">Range</code> Interface</a></li>
+ <li><a href="#extensions-to-the-mouseevent-interface"><span class="secno">9 </span>Extensions to the <code title="">MouseEvent</code> Interface</a></li>
+ <li><a href="#rectangles"><span class="secno">10 </span>Rectangles</a>
<ol class="toc">
- <li><a href="#the-clientrectlist-interface"><span class="secno">9.1 </span>The <code title="">ClientRectList</code> Interface</a></li>
- <li><a href="#the-clientrect-interface"><span class="secno">9.2 </span>The <code title="">ClientRect</code> Interface</a></ol></li>
+ <li><a href="#the-clientrectlist-interface"><span class="secno">10.1 </span>The <code title="">ClientRectList</code> Interface</a></li>
+ <li><a href="#the-clientrect-interface"><span class="secno">10.2 </span>The <code title="">ClientRect</code> Interface</a></ol></li>
<li><a class="no-num" href="#references">References</a></li>
<li><a class="no-num" href="#references-0">References</a>
<ol class="toc">
@@ -153,15 +153,36 @@
<h2 id="conformance"><span class="secno">2 </span>Conformance</h2>
- <p>Everything in this specification is normative except for diagrams,
- examples, notes and sections marked non-normative.</p>
+<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.
- <!--<p>The key word <em class="ct">must</em>, <em class="ct">must not</em>,
- <em class="ct">should</em> and <em class="ct">may</em> in this document
- are to be interpreted as described in RFC 2119.-->
- <p>The key word <em class="ct">must</em> in this document is to be
- interpreted as described in RFC 2119.
- <a href="#refsRFC2119">[RFC2119]</a>
+<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>
+
+<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.
<p>A conforming user agent implements all the requirements made by this
specification.</p>
@@ -169,12 +190,12 @@
<h3 id="webidl"><span class="secno">2.1 </span>Web IDL</h3>
- <p>The IDL fragments in this specification <em class="ct">must</em> be
+ <p>The IDL fragments in this specification must be
interpreted as required for conforming IDL fragments, as described in the
Web IDL specification. <a href="#refsWEBIDL">[WEBIDL]</a>
- <h3 id="terminology"><span class="secno">2.2 </span>Terminology</h3>
+ <h2 id="terminology"><span class="secno">3 </span>Terminology</h2>
<p>Terminology used in this specification is from
DOM Core,
@@ -215,7 +236,7 @@
axis.</p>
- <h3 id="css-pixels"><span class="secno">2.3 </span>CSS pixels</h3>
+ <h3 id="css-pixels"><span class="secno">3.1 </span>CSS pixels</h3>
<p>All coordinates and dimensions for the APIs defined in this
specification are in CSS pixels. <!--<span data-anolis-ref>CSS</span>-->
@@ -226,15 +247,15 @@
- <h2 id="extensions-to-the-window-interface"><span class="secno">3 </span>Extensions to the <code title="">Window</code> Interface</h2>
+ <h2 id="extensions-to-the-window-interface"><span class="secno">4 </span>Extensions to the <code title="">Window</code> Interface</h2>
<pre class="idl">partial interface <a class="external" href="http://www.whatwg.org/html/#window">Window</a> {
<a href="#mediaquerylist">MediaQueryList</a> <a href="#dom-window-matchmedia" title="dom-Window-matchMedia">matchMedia</a>(DOMString <var title="">media_query_list</var>);
readonly attribute <a href="#screen">Screen</a> <a href="#dom-window-screen" title="dom-Window-screen">screen</a>;
// viewport
- readonly attribute long <a href="#dom-window-innerwidth">innerWidth</a>;
- readonly attribute long <a href="#dom-window-innerheight">innerHeight</a>;
+ readonly attribute long <a href="#dom-window-innerwidth" title="dom-Window-innerWidth">innerWidth</a>;
+ readonly attribute long <a href="#dom-window-innerheight" title="dom-Window-innerHeight">innerHeight</a>;
// viewport scrolling
readonly attribute long <a href="#dom-window-scrollx" title="dom-Window-scrollX">scrollX</a>;
@@ -246,10 +267,10 @@
void <a href="#dom-window-scrollby" title="dom-Window-scrollby">scrollBy</a>(long <var title="">x</var>, long <var title="">y</var>);
// client
- readonly attribute long <a href="#dom-window-screenx">screenX</a>;
- readonly attribute long <a href="#dom-window-screeny">screenY</a>;
- readonly attribute long <a href="#dom-window-outerwidth">outerWidth</a>;
- readonly attribute long <a href="#dom-window-outerheight">outerHeight</a>;
+ readonly attribute long <a href="#dom-window-screenx" title="dom-Window-screenX">screenX</a>;
+ readonly attribute long <a href="#dom-window-screeny" title="dom-Window-screenY">screenY</a>;
+ readonly attribute long <a href="#dom-window-outerwidth" title="dom-Window-outerWidth">outerWidth</a>;
+ readonly attribute long <a href="#dom-window-outerheight" title="dom-Window-outerHeight">outerHeight</a>;
};</pre>
@@ -270,7 +291,7 @@
<p>The
<dfn id="dom-window-screen" title="dom-Window-screen"><code>screen</code></dfn>
- attribute <em class="ct">must</em> return the <code><a href="#screen">Screen</a></code> object
+ attribute must return the <code><a href="#screen">Screen</a></code> object
associated with the <code class="external"><a href="http://www.whatwg.org/html/#window">Window</a></code> object. It always returns the same
object.</p>
@@ -278,8 +299,8 @@
when the <code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#document">Document</a></code> is navigated.</p>
- <p>The <dfn id="dom-window-innerwidth"><code>innerWidth</code></dfn>
- attribute <em class="ct">must</em> return the
+ <p>The <dfn id="dom-window-innerwidth" title="dom-Window-innerWidth"><code>innerWidth</code></dfn>
+ attribute must return the
<a href="#viewport">viewport</a> width including the size of a rendered scroll bar
(if any).</p>
@@ -290,28 +311,28 @@
<pre><code>var viewportWidth = innerWidth</code></pre>
</div>
- <p>The <dfn id="dom-window-innerheight"><code>innerHeight</code></dfn>
- attribute <em class="ct">must</em> return the
+ <p>The <dfn id="dom-window-innerheight" title="dom-Window-innerHeight"><code>innerHeight</code></dfn>
+ attribute must return the
<a href="#viewport">viewport</a> height including the size of a rendered scroll bar
(if any).</p>
<p>The
<dfn id="dom-window-scrollx" title="dom-Window-scrollX"><code>scrollX</code></dfn> and
<dfn id="dom-window-pagexoffset" title="dom-Window-pageXOffset"><code>pageXOffset</code></dfn>
- attributes <em class="ct">must</em> return the x-coordinate,
+ attributes must return the x-coordinate,
relative to the <a href="#initial-containing-block">initial containing block</a> origin, of the left
of the <a href="#viewport">viewport</a>.</p>
<p>The
<dfn id="dom-window-scrolly" title="dom-Window-scrollY"><code>scrollY</code></dfn> and
<dfn id="dom-window-pageyoffset" title="dom-Window-pageYOffset"><code>pageYOffset</code></dfn>
- attributes <em class="ct">must</em> return the y-coordinate,
+ attributes must return the y-coordinate,
relative to the <a href="#initial-containing-block">initial containing block</a> origin, of the top
of the <a href="#viewport">viewport</a>.</p>
<p>When the
- <dfn id="dom-window-scroll" title="dom-Window-scroll"><code>scroll(<var title="">x</var>,<var title="">y</var>)</code></dfn>
- method is invoked these steps <em class="ct">must</em> be run:</p>
+ <dfn id="dom-window-scroll" title="dom-Window-scroll"><code>scroll(<var>x</var>,<var>y</var>)</code></dfn>
+ method is invoked these steps must be run:</p>
<ol>
<li><p>If either <var title="">x</var> or <var title="">y</var> is
@@ -351,43 +372,43 @@
<p>When the
<dfn id="dom-window-scrollto" title="dom-Window-scrollto"><code>scrollTo(<var title="">x</var>,<var title="">y</var>)</code></dfn>
- method is invoked, the user agent <em class="ct">must</em> act as if the
+ method is invoked, the user agent must act as if the
<code title="dom-Window-scroll"><a href="#dom-window-scroll">scroll()</a></code> method was invoked with
the same arguments.</p>
<p>When the
<dfn id="dom-window-scrollby" title="dom-Window-scrollby"><code>scrollBy(<var title="">x</var>,<var title="">y</var>)</code></dfn>
- method is invoked, the user agent <em class="ct">must</em> act as if the
+ method is invoked, the user agent must act as if the
<code title="dom-Window-scroll"><a href="#dom-window-scroll">scroll()</a></code> method was invoked with
<var title="">x</var> plus <code title="dom-Window-scrollX"><a href="#dom-window-scrollx">scrollX</a></code>
as first argument and <var title="">y</var> plus
<code title="dom-Window-scrollY"><a href="#dom-window-scrolly">scrollY</a></code> as second argument.</p>
- <p>The <dfn id="dom-window-screenx"><code>screenX</code></dfn>
- attribute <em class="ct">must</em> return the x-coordinate,
+ <p>The <dfn id="dom-window-screenx" title="dom-Window-screenX"><code>screenX</code></dfn>
+ attribute must return the x-coordinate,
relative to the origin of the screen of the output device, of the top of
the client window as number of pixels, or zero if there is no such
thing.</p>
- <p>The <dfn id="dom-window-screeny"><code>screenY</code></dfn>
- attribute <em class="ct">must</em> return the y-coordinate,
+ <p>The <dfn id="dom-window-screeny" title="dom-Window-screenY""><code>screenY</code></dfn>
+ attribute must return the y-coordinate,
relative to the origin of the screen of the output device, of the left of
the client window as number of pixels, or zero if there is no such
thing.</p>
- <p>The <dfn id="dom-window-outerwidth"><code>outerWidth</code></dfn>
- attribute <em class="ct">must</em> return the width of the
+ <p>The <dfn id="dom-window-outerwidth" title="dom-Window-outerWidth"><code>outerWidth</code></dfn>
+ attribute must return the width of the
client window. If there is no client window this
- attribute <em class="ct">must</em> return zero.</p>
+ attribute must return zero.</p>
- <p>The <dfn id="dom-window-outerheight"><code>outerHeight</code></dfn>
- attribute <em class="ct">must</em> return the height of the
+ <p>The <dfn id="dom-window-outerheight" title="dom-Window-outerHeight"><code>outerHeight</code></dfn>
+ attribute must return the height of the
client window. If there is no client window
- this attribute <em class="ct">must</em> return zero.</p>
+ this attribute must return zero.</p>
- <h3 id="the-mediaquerylist-interface"><span class="secno">3.1 </span>The <code title="">MediaQueryList</code> Interface</h3>
+ <h3 id="the-mediaquerylist-interface"><span class="secno">4.1 </span>The <code title="">MediaQueryList</code> Interface</h3>
<p>A <code><a href="#mediaquerylist">MediaQueryList</a></code> object has an associated media query list
set on creation and an associated
@@ -426,28 +447,28 @@
<p>The
<dfn id="dom-mediaquerylist-media" title="dom-MediaQueryList-media"><code>media</code></dfn>
- <em class="ct">must</em> return the
+ must return the
<span title="serialize a media query list">serialized</span> form of the associated media query list.</p>
<p>The <dfn id="dom-mediaquerylist-matches" title="dom-MediaQueryList-matches"><code>matches</code></dfn>
- <em class="ct">must</em> return true if the associated media query list
+ must return true if the associated media query list
matches the state of the rendered <code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#document">Document</a></code> and false if it
does not.</p>
<p>When the
<dfn id="dom-mediaquerylist-addlistener" title="dom-MediaQueryList-addListener"><code>addListener(<var>listener</var>)</code></dfn>
- is invoked <var title="">listener</var> <em class="ct">must</em> be
+ is invoked <var title="">listener</var> must be
appended to the <a href="#list-of-media-query-list-listeners">list of media query list listeners</a>, unless
it is already in the <a href="#list-of-media-query-list-listeners">list of media query list listeners</a>.</p>
<p>When the
<dfn id="dom-mediaquerylist-removelistener" title="dom-MediaQueryList-removeListener"><code>removeListener(<var>listener</var>)</code></dfn>
- is invoked <var title="">listener</var> <em class="ct">must</em> be
+ is invoked <var title="">listener</var> must be
removed from the <a href="#list-of-media-query-list-listeners">list of media query list listeners</a>.</p>
- <h3 id="the-screen-interface"><span class="secno">3.2 </span>The <code title="">Screen</code> Interface</h3>
+ <h3 id="the-screen-interface"><span class="secno">4.2 </span>The <code title="">Screen</code> Interface</h3>
<p>As its name suggests, the <code><a href="#screen">Screen</a></code> interface represents
information about the screen of the output device.</p>
@@ -462,29 +483,29 @@
};</pre>
<p>The <dfn id="dom-screen-availwidth"><code>availWidth</code></dfn>
- attribute <em class="ct">must</em> return the available width of the
+ attribute must return the available width of the
rendering surface of the output device.</p>
<p>The <dfn id="dom-screen-availheight"><code>availHeight</code></dfn>
- attribute <em class="ct">must</em> return the available height of the
+ attribute must return the available height of the
rendering surface of the output device.</p>
<p>The <dfn id="dom-screen-width"><code>width</code></dfn> attribute
- <em class="ct">must</em> return the width of the output device.</p>
+ must return the width of the output device.</p>
<p>The <dfn id="dom-screen-height"><code>height</code></dfn> attribute
- <em class="ct">must</em> return the height of the output device.</p>
+ must return the height of the output device.</p>
<p>The <dfn id="dom-screen-colordepth"><code>colorDepth</code></dfn> and
<dfn id="dom-screen-pixeldepth"><code>pixelDepth</code></dfn> attributes
- <em class="ct">must</em> both return the number of bits allocated to
+ must both return the number of bits allocated to
colors (i.e. excluding the alpha channel) in the output device. If the
output device does not support colors these attributes
- <em class="ct">must</em> return zero.</p>
+ must return zero.</p>
<!-- pixelDepth is not supported by Internet Explorer 7 -->
- <h2 id="extensions-to-the-document-interface"><span class="secno">4 </span>Extensions to the <code title="">Document</code> Interface</h2>
+ <h2 id="extensions-to-the-document-interface"><span class="secno">5 </span>Extensions to the <code title="">Document</code> Interface</h2>
<pre class="idl">partial interface <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#document">Document</a> {
<a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#element">Element</a>? <a href="#dom-document-elementfrompoint">elementFromPoint</a>(float <var title="">x</var>, float <var title="">y</var>);
@@ -494,21 +515,21 @@
<p>The
<dfn id="dom-document-elementfrompoint" title="elementfrompoint"><code>elementFromPoint(<var title="">x</var>,
<var title="">y</var>)</code></dfn> method, when invoked,
- <em class="ct">must</em> return the element at coordinates
+ must return the element at coordinates
<var>x</var>,<var>y</var> in the <a href="#viewport">viewport</a>. The element to be
returned is determined through hit testing. If either argument is
negative, <var title="">x</var> is greater than the <a href="#viewport">viewport</a>
width excluding the size of a rendered scroll bar (if any), or
<var title="">y</var> is greather than the <a href="#viewport">viewport</a> height
excluding the size of a rendered scroll bar (if any), the method
- <em class="ct">must</em> return <code>null</code>. If there is no element
- at the given position the method <em class="ct">must</em> return the root
+ must return <code>null</code>. If there is no element
+ at the given position the method must return the root
element, if any, or <code>null</code> otherwise.</p>
<p>The
<dfn id="dom-document-caretpositionfrompoint" title="caretpositionfrompoint"><code>caretPositionFromPoint(<var title="">x</var>,
<var title="">y</var>)</code></dfn> method, when invoked,
- <em class="ct">must</em> return the result of running these steps:</p>
+ must return the result of running these steps:</p>
<ol>
<li><p>If either argument is negative, <var title="">x</var> is greater
@@ -568,7 +589,7 @@
- <h3 id="the-caretposition-interface"><span class="secno">4.1 </span>The <code title="">CaretPosition</code> Interface</h3>
+ <h3 id="the-caretposition-interface"><span class="secno">5.1 </span>The <code title="">CaretPosition</code> Interface</h3>
<p>A <dfn id="caret-position">caret position</dfn> gives the position of a
text insertion point indicator. It always has an associated
@@ -584,21 +605,21 @@
<p>The
<dfn id="dom-caretposition-offsetnode" title="dom-CaretPosition-offsetNode"><code>offsetNode</code></dfn>
- attribute <em class="ct">must</em> return the <a href="#caret-node">caret node</a>.</p>
+ attribute must return the <a href="#caret-node">caret node</a>.</p>
<p>The
<dfn id="dom-caretposition-offset" title="dom-CaretPosition-offset"><code>offset</code></dfn>
- attribute <em class="ct">must</em> return the <a href="#caret-offset">caret offset</a>.</p>
+ attribute must return the <a href="#caret-offset">caret offset</a>.</p>
<!--
<p>The
<dfn id="dom-caretposition-range" title="dom-CaretPosition-range"><code>range</code></dfn>
- attribute <em class="ct">must</em> return the <span>caret range</span>.</p>
+ attribute must return the <span>caret range</span>.</p>
-->
<!-- https://bugs.webkit.org/show_bug.cgi?id=27046 -->
- <h2 id="extensions-to-the-element-interface"><span class="secno">5 </span>Extensions to the <code title="">Element</code> Interface</h2>
+ <h2 id="extensions-to-the-element-interface"><span class="secno">6 </span>Extensions to the <code title="">Element</code> Interface</h2>
<pre class="idl">partial interface <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#element">Element</a> {
<a href="#clientrectlist">ClientRectList</a> <a href="#dom-element-getclientrects">getClientRects</a>();
@@ -618,18 +639,18 @@
};</pre>
- <h3 id="the-getclientrects-and-getboundingclientrect-methods"><span class="secno">5.1 </span>The <code title="">getClientRects()</code> and
+ <h3 id="the-getclientrects-and-getboundingclientrect-methods"><span class="secno">6.1 </span>The <code title="">getClientRects()</code> and
<code title="">getBoundingClientRect()</code> methods</h3>
<p>The <code><a href="#dom-element-getclientrects">getClientRects()</a></code> and <code><a href="#dom-element-getboundingclientrect">getBoundingClientRect()</a></code>
methods provide information about the position of the border box edges of
an element relative to the viewport. The objects these methods return
- <em class="ct">must</em> be static. That is, changes to the underlying
+ must be static. That is, changes to the underlying
document are not reflected in the objects.</p>
<p>The
<dfn id="dom-element-getclientrects"><code>getClientRects()</code></dfn>
- method, when invoked, <em class="ct">must</em> return the result of the
+ method, when invoked, must return the result of the
following algorithm:</p>
<ol>
@@ -669,7 +690,7 @@
<p>The
<dfn id="dom-element-getboundingclientrect"><code>getBoundingClientRect()</code></dfn>
- method, when invoked, <em class="ct">must</em> return the result of the
+ method, when invoked, must return the result of the
following algorithm:</p>
<ol>
@@ -699,7 +720,7 @@
</div>
- <h3 id="element-scrolling-members"><span class="secno">5.2 </span><code title="">Element</code> Scrolling Members</h3>
+ <h3 id="element-scrolling-members"><span class="secno">6.2 </span><code title="">Element</code> Scrolling Members</h3>
<p>To <dfn id="scroll-an-element-into-view">scroll an element into view</dfn>, optionally with an
<i title="">align to top flag</i> set, means to run these steps for each
@@ -791,7 +812,7 @@
<p>The
<dfn id="dom-element-scrollintoview" title="dom-Element-scrollIntoView"><code>scrollIntoView([<var title="">top</var>])</code></dfn>
- method <em class="ct">must</em> run these steps:</p>
+ method must run these steps:</p>
<ol>
<li><p>If the element does not have any associated CSS layout box
@@ -804,7 +825,7 @@
<p>The <dfn id="dom-element-scrolltop"><code>scrollTop</code></dfn>
- attribute <em class="ct">must</em> return the result of running these
+ attribute must return the result of running these
steps:</p>
<ol>
@@ -826,7 +847,7 @@
</ol>
<p>When setting the <code><a href="#dom-element-scrolltop">scrollTop</a></code> attribute these steps
- <em class="ct">must</em> be run:</p>
+ must be run:</p>
<ol>
<li><p>Let <var title="">y</var> be the given value.</li>
@@ -852,7 +873,7 @@
</ol>
<p>The <dfn id="dom-element-scrollleft"><code>scrollLeft</code></dfn>
- attribute <em class="ct">must</em> return the result of running these
+ attribute must return the result of running these
steps:</p>
<ol>
@@ -874,7 +895,7 @@
</ol>
<p>When setting the <code><a href="#dom-element-scrollleft">scrollLeft</a></code> attribute these steps
- <em class="ct">must</em> be run:</p>
+ must be run:</p>
<ol>
<li><p>Let <var title="">x</var> be the given value.</li>
@@ -900,7 +921,7 @@
</ol>
<p>The <dfn id="dom-element-scrollwidth"><code>scrollWidth</code></dfn>
- attribute <em class="ct">must</em> return the result of running these
+ attribute must return the result of running these
steps:</p>
<ol>
@@ -909,11 +930,11 @@
<li><p>If the element is the root element and the <code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#document">Document</a></code>
is not in <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-quirks-mode" title="concept-quirks-mode">quirks mode</a> return the value of
- <code><a href="#dom-window-innerwidth">innerWidth</a></code>.</li>
+ <code title="dom-Window-innerWidth"><a href="#dom-window-innerwidth">innerWidth</a></code>.</li>
<li><p>If the element is <a href="#the-html-body-element">the HTML <code>body</code> element</a>
and the <code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#document">Document</a></code> is in <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-quirks-mode" title="concept-quirks-mode">quirks mode</a> return the
- value of <code><a href="#dom-window-innerwidth">innerWidth</a></code>.</li>
+ value of <code title="dom-Window-innerWidth"><a href="#dom-window-innerwidth">innerWidth</a></code>.</li>
<li><p>Return the computed value of the '<code>padding-left</code>'
property, plus the computed value of the '<code>padding-right</code>',
@@ -921,7 +942,7 @@
</ol>
<p>The <dfn id="dom-element-scrollheight"><code>scrollHeight</code></dfn>
- attribute <em class="ct">must</em> return the result of running these
+ attribute must return the result of running these
steps:</p>
<ol>
@@ -930,11 +951,11 @@
<li><p>If the element is the root element and the <code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#document">Document</a></code>
is not in <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-quirks-mode" title="concept-quirks-mode">quirks mode</a> return the value of
- <code><a href="#dom-window-innerheight">innerHeight</a></code>.</li>
+ <code title="dom-Window-innerHeight"><a href="#dom-window-innerheight">innerHeight</a></code>.</li>
<li><p>If the element is <a href="#the-html-body-element">the HTML <code>body</code> element</a>
and the <code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#document">Document</a></code> is in <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-quirks-mode" title="concept-quirks-mode">quirks mode</a> return the
- value of <code><a href="#dom-window-innerheight">innerHeight</a></code>.</li>
+ value of <code title="dom-Window-innerHeight"><a href="#dom-window-innerheight">innerHeight</a></code>.</li>
<li><p>Return the computed value of the '<code>padding-top</code>'
property, plus the computed value of the '<code>padding-bottom</code>',
@@ -944,7 +965,7 @@
<!-- for inline boxes offsetWidth and offsetHeight are identical to offset* -->
- <h3 id="client-attributes"><span class="secno">5.3 </span>The <code title="">clientTop</code>,
+ <h3 id="client-attributes"><span class="secno">6.3 </span>The <code title="">clientTop</code>,
<code title="">clientLeft</code>, <code title="">clientWidth</code>, and
<code title="">clientHeight</code> attributes</h3>
@@ -952,9 +973,9 @@
<dfn id="dom-element-clientleft"><code>clientLeft</code></dfn>,
<dfn id="dom-element-clientwidth"><code>clientWidth</code></dfn>, and
<dfn id="dom-element-clientheight"><code>clientHeight</code></dfn>
- attributes <em class="ct">must</em> return zero if the element does not
+ attributes must return zero if the element does not
have any associated CSS layout box or if the CSS layout box is inline.
- Otherwise, these attributes <em class="ct">must</em> behave as defined in
+ Otherwise, these attributes must behave as defined in
the remainder of this section.</p>
<p>The <code><a href="#dom-element-clienttop">clientTop</a></code> attribute returns the computed value of the
@@ -983,7 +1004,7 @@
- <h2 id="extensions-to-the-htmlelement-interface"><span class="secno">6 </span>Extensions to the <code title="">HTMLElement</code> Interface</h2>
+ <h2 id="extensions-to-the-htmlelement-interface"><span class="secno">7 </span>Extensions to the <code title="">HTMLElement</code> Interface</h2>
<pre class="idl">partial interface <a class="external" href="http://www.whatwg.org/html/#htmlelement">HTMLElement</a> {
readonly attribute Element <a href="#dom-htmlelement-offsetparent">offsetParent</a>;
@@ -994,14 +1015,14 @@
};</pre>
- <h3 id="offset-attributes"><span class="secno">6.1 </span>The <code title="">offsetParent</code>,
+ <h3 id="offset-attributes"><span class="secno">7.1 </span>The <code title="">offsetParent</code>,
<code title="">offsetTop</code>, <code title="">offsetLeft</code>,
<code title="">offsetWidth</code>, and <code title="">offsetHeight</code>
attributes</h3>
<p>The
<dfn id="dom-htmlelement-offsetparent"><code>offsetParent</code></dfn>
- attribute <em class="ct">must</em> return the result of running these
+ attribute must return the result of running these
steps:</p>
<ol>
@@ -1044,7 +1065,7 @@
</ol>
<p>The <dfn id="dom-htmlelement-offsettop"><code>offsetTop</code></dfn>
- attribute <em class="ct">must</em> return the result of running these
+ attribute must return the result of running these
steps:</p>
<ol>
@@ -1072,7 +1093,7 @@
</ol>
<p>The <dfn id="dom-htmlelement-offsetleft"><code>offsetLeft</code></dfn>
- attribute <em class="ct">must</em> return the result of running these
+ attribute must return the result of running these
steps:</p>
<ol>
@@ -1098,7 +1119,7 @@
<p>The
<dfn id="dom-htmlelement-offsetwidth"><code>offsetWidth</code></dfn>
- attribute <em class="ct">must</em> return the result of running these
+ attribute must return the result of running these
steps:</p>
<ol>
@@ -1111,7 +1132,7 @@
<p>The
<dfn id="dom-htmlelement-offsetheight"><code>offsetHeight</code></dfn>
- attribute <em class="ct">must</em> return the result of running these
+ attribute must return the result of running these
steps:</p>
<ol>
@@ -1123,19 +1144,19 @@
</ol>
- <h2 id="extensions-to-the-range-interface"><span class="secno">7 </span>Extensions to the <code title="">Range</code> Interface</h2>
+ <h2 id="extensions-to-the-range-interface"><span class="secno">8 </span>Extensions to the <code title="">Range</code> Interface</h2>
<pre class="idl">partial interface <a class="external" href="http://html5.org/specs/dom-range.html#range">Range</a> {
<a href="#clientrectlist">ClientRectList</a> <a href="#dom-range-getclientrects" title="dom-range-getclientrects">getClientRects</a>();
<a href="#clientrect">ClientRect</a> <a href="#dom-range-getboundingclientrect" title="dom-range-getboundingclientrect">getBoundingClientRect</a>();
};</pre>
- <p>The objects the methods described below return <em class="ct">must</em>
+ <p>The objects the methods described below return must
be static.</p>
<p>The
<dfn id="dom-range-getclientrects" title="dom-range-getclientrects"><code>getClientRects()</code></dfn>
- method, when invoked, <em class="ct">must</em> return an empty
+ method, when invoked, must return an empty
<code><a href="#clientrectlist">ClientRectList</a></code> object if the range is not in the document and
otherwise a <code><a href="#clientrectlist">ClientRectList</a></code> object containing a list of
<code><a href="#clientrect">ClientRect</a></code> objects in content order that matches the
@@ -1157,7 +1178,7 @@
<p>The
<dfn id="dom-range-getboundingclientrect" title="dom-range-getboundingclientrect"><code>getBoundingClientRect()</code></dfn>
- method, when invoked, <em class="ct">must</em> return the result of the
+ method, when invoked, must return the result of the
following algorithm:</p>
<ol>
@@ -1181,7 +1202,7 @@
- <h2 id="extensions-to-the-mouseevent-interface"><span class="secno">8 </span>Extensions to the <code title="">MouseEvent</code> Interface</h2>
+ <h2 id="extensions-to-the-mouseevent-interface"><span class="secno">9 </span>Extensions to the <code title="">MouseEvent</code> Interface</h2>
<pre class="idl">partial interface <a href="#mouseevent">MouseEvent</a> {
readonly attribute long <a href="#dom-mouseevent-screenx" title="dom-mouseevent-screenx">screenX</a>;
@@ -1203,45 +1224,45 @@
resolve this somehow?</p>
<p>The
- <dfn id="dom-mouseevent-screenx" title="dom-mouseevent-screenx"><code>screenX</code></dfn>
- attribute <em class="ct">must</em> return the x-coordinate of
+ <dfn id="dom-mouseevent-screenx" title="dom-mouseevent-screenx"><code title="dom-Window-screenX">screenX</code></dfn>
+ attribute must return the x-coordinate of
the position where the event occurred relative to the origin of the
screen.</p>
<p>The
- <dfn id="dom-mouseevent-screeny" title="dom-mouseevent-screeny"><code>screenY</code></dfn>
- attribute <em class="ct">must</em> return the y-coordinate of
+ <dfn id="dom-mouseevent-screeny" title="dom-mouseevent-screeny"><code title="dom-Window-screenY">screenY</code></dfn>
+ attribute must return the y-coordinate of
the position where the event occurred relative to the origin of the
screen.</p>
<p>The <dfn id="dom-mouseevent-pagex"><code>pageX</code></dfn> attribute
- <em class="ct">must</em> return the horizontal coordinate of
+ must return the horizontal coordinate of
the position where the event occurred relative to
the origin of the <a href="#initial-containing-block">initial containing block</a>.</p>
<p>The <dfn id="dom-mouseevent-pagey"><code>pageY</code></dfn> attribute
- <em class="ct">must</em> return the y-coordinate of the
+ must return the y-coordinate of the
position where the event occurred relative to the origin of the
<a href="#initial-containing-block">initial containing block</a>.</p>
<p>The <dfn id="dom-mouseevent-clientx"><code>clientX</code></dfn>
- attribute <em class="ct">must</em> return the x-coordinate of
+ attribute must return the x-coordinate of
the position where the event occurred relative to the origin of the
<a href="#viewport">viewport</a>.</p>
<p>The <dfn id="dom-mouseevent-clienty"><code>clientY</code></dfn>
- attribute <em class="ct">must</em> return the y-coordinate of
+ attribute must return the y-coordinate of
the position where the event occurred relative to the origin of the
<a href="#viewport">viewport</a>.</p>
<p>The
<dfn id="dom-mouseevent-x" title="dom-mouseevent-x"><code>x</code></dfn>
- attribute <em class="ct">must</em> return the value of
+ attribute must return the value of
<code><a href="#dom-mouseevent-clientx">clientX</a></code>.</p>
<p>The
<dfn id="dom-mouseevent-y" title="dom-mouseevent-y"><code>y</code></dfn>
- attribute <em class="ct">must</em> return the value of
+ attribute must return the value of
<code><a href="#dom-mouseevent-clienty">clientY</a></code>.</p>
<!-- x/y do not match IE in the position:relative case but do match other
@@ -1249,12 +1270,12 @@
<p>The <dfn id="dom-mouseevent-offsetx"><code>offsetX</code></dfn>
- attribute <em class="ct">must</em> return the x-coordinate of
+ attribute must return the x-coordinate of
the position where the event occurred relative to the origin of the
<a href="#padding-edge">padding edge</a> of the target node.</p>
<p>The <dfn id="dom-mouseevent-offsety"><code>offsetY</code></dfn>
- attribute <em class="ct">must</em> return the y-coordinate of
+ attribute must return the y-coordinate of
the position where the event occurred relative to the origin of the
<a href="#padding-edge">padding edge</a> of the target node.</p>
@@ -1262,10 +1283,10 @@
- <h2 id="rectangles"><span class="secno">9 </span>Rectangles</h2>
+ <h2 id="rectangles"><span class="secno">10 </span>Rectangles</h2>
- <h3 id="the-clientrectlist-interface"><span class="secno">9.1 </span>The <code title="">ClientRectList</code> Interface</h3>
+ <h3 id="the-clientrectlist-interface"><span class="secno">10.1 </span>The <code title="">ClientRectList</code> Interface</h3>
<p>The <code><a href="#clientrectlist">ClientRectList</a></code> object consists of an ordered list
of <code><a href="#clientrect">ClientRect</a></code> objects.</p>
@@ -1277,20 +1298,20 @@
<p>The
<dfn id="dom-clientrectlist-length" title="dom-clientrectlist-length"><code>length</code></dfn>
- attribute <em class="ct">must</em> return the total number of
+ attribute must return the total number of
<code><a href="#clientrect">ClientRect</a></code> objects associated with the object.</p>
<p>The
<dfn id="dom-clientrectlist-item" title="dom-clientrectlist-item"><code>item(<var title="">index</var>)</code></dfn>
- method, when invoked, <em class="ct">must</em> raise an
+ method, when invoked, must raise an
<code>INDEX_SIZE_ERR</code> exception when <var title="">index</var> is
negative or greater than the number of <code><a href="#clientrect">ClientRect</a></code> objects
associated with the object. Otherwise, the <code><a href="#clientrect">ClientRect</a></code>
- object at <var title="">index</var> <em class="ct">must</em> be
+ object at <var title="">index</var> must be
returned.</p>
- <h3 id="the-clientrect-interface"><span class="secno">9.2 </span>The <code title="">ClientRect</code> Interface</h3>
+ <h3 id="the-clientrect-interface"><span class="secno">10.2 </span>The <code title="">ClientRect</code> Interface</h3>
<p>Objects implementing the <code><a href="#clientrect">ClientRect</a></code> interface represent
a rectangular box. The type of box is specified by the method that returns
@@ -1307,31 +1328,31 @@
<p>The
<dfn id="dom-clientrect-top" title="dom-clientrect-top"><code>top</code></dfn>
- attribute <em class="ct">must</em> return the y-coordinate,
+ attribute must return the y-coordinate,
relative to the <a href="#viewport">viewport</a> origin, of the top of the rectangle
box.</p>
<p>The
<dfn id="dom-clientrect-right" title="dom-clientrect-right"><code>right</code></dfn>
- attribute <em class="ct">must</em> return the x-coordinate,
+ attribute must return the x-coordinate,
relative to the <a href="#viewport">viewport</a> origin, of the right of the
rectangle box.</p>
<p>The
<dfn id="dom-clientrect-bottom" title="dom-clientrect-bottom"><code>bottom</code></dfn>
- attribute <em class="ct">must</em> return the y-coordinate,
+ attribute must return the y-coordinate,
relative to the <a href="#viewport">viewport</a> origin, of the bottom of the
rectangle box.</p>
<p>The
<dfn id="dom-clientrect-left" title="dom-clientrect-left"><code>left</code></dfn>
- attribute <em class="ct">must</em> return the x-coordinate,
+ attribute must return the x-coordinate,
relative to the <a href="#viewport">viewport</a> origin, of the left of the rectangle
box.</p>
<p>The
<dfn id="dom-clientrect-width" title="dom-clientrect-width"><code>width</code></dfn>
- attribute <em class="ct">must</em> return the width of the
+ attribute must return the width of the
rectangle box.</p>
<p class="note">This is identical to
@@ -1340,7 +1361,7 @@
<p>The
<dfn id="dom-clientrect-height" title="dom-clientrect-height"><code>height</code></dfn>
- attribute <em class="ct">must</em> return the height of the
+ attribute must return the height of the
rectangle box.</p>
<p class="note">This is identical to
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/cssom-view/Overview.src.html,v
retrieving revision 1.102
retrieving revision 1.103
diff -u -d -r1.102 -r1.103
--- Overview.src.html 6 Jul 2011 13:06:41 -0000 1.102
+++ Overview.src.html 6 Jul 2011 13:17:48 -0000 1.103
@@ -13,7 +13,6 @@
p.note::before { content:"Note: " }
.XXX { padding:.5em; border:solid red }
.XXX::before { content:"Issue: " }
- em.ct { font-weight:bold; font-style:normal }
code { color:orangered }
code :link, code :visited { color:inherit }
</style>
@@ -123,15 +122,37 @@
<h2 id="conformance">Conformance</h2>
[...969 lines suppressed...]
+ attribute must return the x-coordinate,
relative to the <span>viewport</span> origin, of the left of the rectangle
box.</p>
<p>The
<dfn id="dom-clientrect-width" title="dom-clientrect-width"><code>width</code></dfn>
- attribute <em class="ct">must</em> return the width of the
+ attribute must return the width of the
rectangle box.</p>
<p class="note">This is identical to
@@ -1310,7 +1331,7 @@
<p>The
<dfn id="dom-clientrect-height" title="dom-clientrect-height"><code>height</code></dfn>
- attribute <em class="ct">must</em> return the height of the
+ attribute must return the height of the
rectangle box.</p>
<p class="note">This is identical to
Received on Wednesday, 6 July 2011 13:17:54 UTC