caretRangeFromPoint per CSSWG resolution

Author: annevk

cssom-view/Overview.html

@@ -28,13 +28,13 @@
 
    <h1 id=cssom-view-module>CSSOM View Module</h1>
 
-   <h2 class="no-num no-toc" id=w3c-doctype>Editor's Draft 9 April 2008</h2>
+   <h2 class="no-num no-toc" id=w3c-doctype>Editor's Draft 24 April 2008</h2>
 
    <dl>
     <dt>This Version:
 
     <dd><a
-     href="http://www.w3.org/TR/2008/ED-cssom-view-20080409/">http://www.w3.org/TR/2008/ED-cssom-view-20080409/</a>
+     href="http://www.w3.org/TR/2008/ED-cssom-view-20080424/">http://www.w3.org/TR/2008/ED-cssom-view-20080424/</a>
 
     <dt>Latest Version:
 
@@ -549,7 +549,8 @@ <h2 id=the-documentview-interface><span class=secno>6. </span>The <code
 
   <pre class=idl>interface <dfn id=documentview>DocumentView</dfn> {
   readonly attribute <a href="#abstractview">AbstractView</a> <a href="#documentview-defaultview">defaultView</a>;
-  Element <a href="#documentview-elementfrompoint">elementFromPoint</a>(in unsigned long <var title="">x</var>, in unsigned long <var title="">y</var>);
+  Element <a href="#documentview-elementfrompoint">elementFromPoint</a>(in float <var title="">x</var>, in float <var title="">y</var>);
+  Range <a href="#documentview-caretrangefrompoint">caretRangeFromPoint</a>(in float <var title="">x</var>, in float <var title="">y</var>);
 };</pre>
 
   <p>The <dfn id=documentview-defaultview><code>defaultView</code></dfn>
@@ -570,10 +571,27 @@ <h2 id=the-documentview-interface><span class=secno>6. </span>The <code
    than the <a href="#viewport">viewport</a> height, 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 element,
-   if any, or <code>null</code> otherwise.
+   if any, or <code>null</code> otherwise. [<cite><a
+   href="#ref-dom2tr">DOM2TR</a></cite>]
+
+  <p>The <dfn id=documentview-caretrangefrompoint
+   title=caretrangefrompoint><code>caretRangeFromPoint(<var title="">x</var>,
+   <var title="">y</var>)</code></dfn> method, when invoked, <em
+   class=ct>must</em> return an empty text range for the position where a
+   text insertion point indicator would have been placed if editing was
+   enabled and hit testing was performed at the coordinates
+   <var>x</var>,<var>y</var> in the <a href="#viewport">viewport</a>. If
+   either argument is negative, <var title="">x</var> is greater than the <a
+   href="#viewport">viewport</a> width, <var title="">y</var> is greather
+   than the <a href="#viewport">viewport</a> height, or editing is not
+   supported, the method <em class=ct>must</em> return <code>null</code>.
 
   <p class=note>The specifics of hit testing are out of scope of this
-   specification. Hit testing might be defined in a future revision of CSS or
+   specification and therefore the exact details of <code><a
+   href="#documentview-elementfrompoint">elementFromPoint()</a></code> and
+   <code><a
+   href="#documentview-caretrangefrompoint">caretRangeFromPoint()</a></code>
+   are too. Hit testing might be defined in a future revision of CSS or
    HTML&nbsp;5.
 
   <h2 id=the-elementview-interface><span class=secno>7. </span>The <code

cssom-view/Overview.src.html

@@ -437,7 +437,8 @@ <h2 id="the-documentview-interface">The <code title="">DocumentView</code> Inter
 
   <pre class="idl">interface <dfn id="documentview">DocumentView</dfn> {
   readonly attribute <span>AbstractView</span> <span>defaultView</span>;
-  Element <span>elementFromPoint</span>(in unsigned long <var title="">x</var>, in unsigned long <var title="">y</var>);
+  Element <span>elementFromPoint</span>(in float <var title="">x</var>, in float <var title="">y</var>);
+  Range <span>caretRangeFromPoint</span>(in float <var title="">x</var>, in float <var title="">y</var>);
 };</pre>
 
   <p>The <dfn id="documentview-defaultview"><code>defaultView</code></dfn>
@@ -458,10 +459,24 @@ <h2 id="the-documentview-interface">The <code title="">DocumentView</code> Inter
   height, 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 element, if any, or
-  <code>null</code> otherwise.</p>
+  <code>null</code> otherwise. [<cite><span>DOM2TR</span></cite>]</p>
+
+  <p>The
+  <dfn id="documentview-caretrangefrompoint" title="caretrangefrompoint"><code>caretRangeFromPoint(<var title="">x</var>,
+  <var title="">y</var>)</code></dfn> method, when invoked,
+  <em class="ct">must</em> return an empty text range for the position where
+  a text insertion point indicator would have been placed if editing was
+  enabled and hit testing was performed at the coordinates
+  <var>x</var>,<var>y</var> in the <span>viewport</span>. If either argument
+  is negative, <var title="">x</var> is greater than the
+  <span>viewport</span> width, <var title="">y</var> is greather than the
+  <span>viewport</span> height, or editing is not supported, the method
+  <em class="ct">must</em> return <code>null</code>.</p>
 
   <p class="note">The specifics of hit testing are out of scope of this
-  specification. Hit testing might be defined in a future revision of CSS or
+  specification and therefore the exact details of
+  <code>elementFromPoint()</code> and <code>caretRangeFromPoint()</code> are
+  too. Hit testing might be defined in a future revision of CSS or
   HTML&nbsp;5.</p>