Add some more details about the targetTouches and changedTouches attributes.
authorMatt Brubeck <mbrubeck@mozilla.com>
Fri, 10 Jun 2011 10:42:28 -0700
changeset 96 457c2df41b66
parent 95 80bd73a2e5b2
child 97 3f54db94ae0d
Add some more details about the targetTouches and changedTouches attributes.
touchevents.html
--- a/touchevents.html	Mon Jun 06 17:48:21 2011 -0700
+++ b/touchevents.html	Fri Jun 10 10:42:28 2011 -0700
@@ -296,13 +296,26 @@
         </dd>
         <dt>readonly attribute <a>TouchList</a> targetTouches</dt>
         <dd>
-          a list of <a>Touch</a>es for every point of contact currently
-          touching the surface, which started on the same target
+          a list of <a>Touch</a>es for every point of contact that is touching
+          the surface <em>and</em> started on the element that is the
+          <a>target</a> of the current event.
         </dd>
         <dt>readonly attribute <a>TouchList</a> changedTouches</dt>
         <dd>
-          a list of <a>Touch</a>es for every point of contact which contributed
-          to the event
+          <p>
+            a list of <a>Touch</a>es for every point of contact which contributed
+            to the event.
+          </p>
+          <p>
+            For the <a>touchstart</a> event this must be a list of the touch
+            points that just became active with the current event.  For the
+            <a>touchmove</a> event this must be a list of the touch points that
+            have moved since the last event.  For the <a>touchend</a> event
+            this must be a list of the touch points that have just been removed
+            from the surface.  For the <a>touchenter</a> and <a>touchleave</a>
+            events, this must be a list of the touch points that have just
+            entered or left the target element.
+          </p>
         </dd>
 
         <dt>readonly attribute boolean altKey</dt>