[cssom-view] Add document.elementsFromPoint(). https://www.w3.org/Bugs/Public/show_bug.cgi?id=19753

Author: Simon Pieters

cssom-view/Overview.html

@@ -25,7 +25,7 @@
 
  <h1>CSSOM View Module</h1>
 
- <h2 class="no-num no-toc" id="w3c-doctype">Editor's Draft 20 June 2013</h2>
+ <h2 class="no-num no-toc" id="w3c-doctype">Editor's Draft 24 June 2013</h2>
 
  <dl>
 
@@ -92,7 +92,7 @@ <h2 class="no-num no-toc" id="sotd">Status of This Document</h2>
 can be found in the <a href="http://www.w3.org/TR/">W3C technical reports
 index at http://www.w3.org/TR/.</a></em>
 
-<p>This is the 20 June 2013 Editor's Draft of CSSOM View. Please send
+<p>This is the 24 June 2013 Editor's Draft of CSSOM View. Please send
 comments to
 <a href="mailto:www-style@w3.org?subject=%5Bcssom-view%5D%20">www-style@w3.org</a>
 (<a href="http://lists.w3.org/Archives/Public/www-style/">archived</a>)
@@ -717,6 +717,7 @@ <h2 id="extensions-to-the-document-interface"><span class="secno">6 </span>Exten
 
 <pre class="idl">partial interface <a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#document">Document</a> {
   <a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#element">Element</a>? <a href="#dom-document-elementfrompoint" title="dom-Document-elementFromPoint">elementFromPoint</a>(double x, double y);
+  sequence&lt;<a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#element">Element</a>&gt; <a href="#dom-document-elementsfrompoint" title="dom-Document-elementsFromPoint">elementsFromPoint</a>(double x, double y);
   <a href="#caretposition">CaretPosition</a>? <a href="#dom-document-caretpositionfrompoint" title="dom-Document-caretPositionFromPoint">caretPositionFromPoint</a>(double x, double y);
 };</pre>
 
@@ -727,6 +728,16 @@ <h2 id="extensions-to-the-document-interface"><span class="secno">6 </span>Exten
 return null. If there is no element at the given position the method must return the root element, if any, or null otherwise. If there is no
 <a href="#viewport">viewport</a> associated with the document, the method must return null.</p>
 
+<p class="note">The <code title="dom-Document-elementFromPoint"><a href="#dom-document-elementfrompoint">elementFromPoint()</a></code> method does not necessarily return the top-most painted element. For
+instnace, an element can be excluded from being a target for hit testing by using the 'pointer-events' CSS property.
+
+<p class="atrisk">The <dfn id="dom-document-elementsfrompoint" title="dom-Document-elementsFromPoint"><code>elementsFromPoint(<var>x</var>, <var>y</var>)</code></dfn> method must return a sequence of
+elements at coordinates <var>x</var>,<var>y</var> in the <a href="#viewport">viewport</a>. The sequence to be returned is sorted by paint order, with the first element as
+the topmost in the order. If either argument is negative, <var>x</var> is greater than the <a href="#viewport">viewport</a> width excluding the size of a rendered scroll
+bar (if any), or <var>y</var> is greater than the <a href="#viewport">viewport</a> height excluding the size of a rendered scroll bar (if any), the method must return an
+empty sequence. If there is no element at the given position the method must return a sequence containing the root element, if any, or an empty sequence
+otherwise. If there is no <a href="#viewport">viewport</a> associated with the document, the method must return an empty sequence.
+
 <p>The <dfn id="dom-document-caretpositionfrompoint" title="dom-Document-caretPositionFromPoint"><code>caretPositionFromPoint(<var>x</var>, <var>y</var>)</code></dfn> method must return the
 result of running these steps:</p>
 <ol>
@@ -1549,10 +1560,12 @@ <h2 class="no-num" id="acknowledgments">Acknowledgments</h2>
 
 <p>The editors would like to thank
 
+Alan Stearns,
 Alexey Feldgendler,
 Björn Höhrmann,
 Dan Bates,
 David Vest,
+Elliott Sprehn,
 Garrett Smith,
 Hallvord R. M. Steen,
 Leif Arne Storset,

cssom-view/Overview.src.html

@@ -679,6 +679,7 @@ <h2>Extensions to the <code title>Document</code> Interface</h2>
 
 <pre class=idl>partial interface <span data-anolis-spec=dom>Document</span> {
   <span data-anolis-spec=dom>Element</span>? <span title=dom-Document-elementFromPoint>elementFromPoint</span>(double x, double y);
+  sequence&lt;<span data-anolis-spec=dom>Element</span>> <span title=dom-Document-elementsFromPoint>elementsFromPoint</span>(double x, double y);
   <span>CaretPosition</span>? <span title=dom-Document-caretPositionFromPoint>caretPositionFromPoint</span>(double x, double y);
 };</pre>
 
@@ -689,6 +690,16 @@ <h2>Extensions to the <code title>Document</code> Interface</h2>
 return null. If there is no element at the given position the method must return the root element, if any, or null otherwise. If there is no
 <span>viewport</span> associated with the document, the method must return null.</p>
 
+<p class=note>The <code title=dom-Document-elementFromPoint>elementFromPoint()</code> method does not necessarily return the top-most painted element. For
+instnace, an element can be excluded from being a target for hit testing by using the 'pointer-events' CSS property.
+
+<p class=atrisk>The <dfn title=dom-Document-elementsFromPoint><code>elementsFromPoint(<var>x</var>, <var>y</var>)</code></dfn> method must return a sequence of
+elements at coordinates <var>x</var>,<var>y</var> in the <span>viewport</span>. The sequence to be returned is sorted by paint order, with the first element as
+the topmost in the order. If either argument is negative, <var>x</var> is greater than the <span>viewport</span> width excluding the size of a rendered scroll
+bar (if any), or <var>y</var> is greater than the <span>viewport</span> height excluding the size of a rendered scroll bar (if any), the method must return an
+empty sequence. If there is no element at the given position the method must return a sequence containing the root element, if any, or an empty sequence
+otherwise. If there is no <span>viewport</span> associated with the document, the method must return an empty sequence.
+
 <p>The <dfn title=dom-Document-caretPositionFromPoint><code>caretPositionFromPoint(<var>x</var>, <var>y</var>)</code></dfn> method must return the
 result of running these steps:</p>
 <ol>
@@ -1491,10 +1502,12 @@ <h2 class="no-num">Acknowledgments</h2>
 
 <p>The editors would like to thank
 
+Alan Stearns,
 Alexey Feldgendler,
 Bj&ouml;rn H&ouml;hrmann,
 Dan Bates,
 David Vest,
+Elliott Sprehn,
 Garrett Smith,
 Hallvord R. M. Steen,
 Leif Arne Storset,