Per the request from Sangwhan Moon in <http://lists.w3.org/Archives/Public/public-webevents/2013JanMar/0037.html>, add a note for implementers regarding event target handling and documents. v1
authorArt Barstow <art.barstow@nokia.com>
Wed, 20 Mar 2013 15:32:00 -0400
branchv1
changeset 1936f2c52cd50f6
parent 192 0edc668e7910
child 194 bb8c57f3af32
Per the request from Sangwhan Moon in <http://lists.w3.org/Archives/Public/public-webevents/2013JanMar/0037.html>, add a note for implementers regarding event target handling and documents.
touchevents.html
     1.1 --- a/touchevents.html	Wed Mar 20 13:59:55 2013 -0400
     1.2 +++ b/touchevents.html	Wed Mar 20 15:32:00 2013 -0400
     1.3 @@ -328,6 +328,21 @@
     1.4            otherwise <code>false</code>
     1.5          </dd>
     1.6        </dl>
     1.7 +
     1.8 +      <section class="informative">
     1.9 +       <h2>TouchEvent Implementer's Note</h2>
    1.10 +       <div class="note">
    1.11 +        <p>User agents should ensure that all <a>Touch</a> objects available from a given 
    1.12 +        <a>TouchEvent</a> are all associated to the same document that the <a>TouchEvent</a> was dispatched 
    1.13 +        to. To implement this, user agents should maintain a notion of the current 
    1.14 +        <em>touch-active</em> document. On first touch, this is set to the target document 
    1.15 +        where the touch was created. When all active touch points are released, the 
    1.16 +        <em>touch-active</em> document is cleared. All <a>TouchEvent</a>s are dispatched to the 
    1.17 +        current <em>touch-active</em> document, and each <a>Touch</a> object it contains refers 
    1.18 +        only to DOM elements (and co-ordinates) in that document. If a touch starts entirely 
    1.19 +        outside the currently <em>touch-active</em> document, then it is ignored entirely. </p>
    1.20 +       </div> 
    1.21 +      </section>
    1.22        
    1.23        <section class="informative">
    1.24            <h2>Usage Examples</h2>