touchevents.html
author Art Barstow <art.barstow@nokia.com>
Sat, 30 Apr 2011 10:38:20 -0400
changeset 84 95c76867a243
parent 83 9545d8d8162e
child 85 5c770b2dd992
permissions -rw-r--r--
minor editorial changes to Intro
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
     1
<!DOCTYPE html>
74
b1920268c222 Add language and viewport metadata.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 73
diff changeset
     2
<html lang="en">
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
     3
  <head>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
     4
    <title>Touch Events Specification</title>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
     5
    <meta http-equiv='Content-Type' content='text/html;charset=utf-8'/>
74
b1920268c222 Add language and viewport metadata.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 73
diff changeset
     6
    <meta name="viewport" content="width=device-width">
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
     7
    <!--
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
     8
      === NOTA BENE ===
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
     9
      For the three scripts below, if your spec resides on dev.w3 you can check them
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    10
      out in the same tree and use relative links so that they'll work offline,
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    11
     -->
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    12
    <script src='http://dev.w3.org/2009/dap/ReSpec.js/js/respec.js' class='remove'></script>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    13
    <script class='remove'>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    14
      var respecConfig = {
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    15
          // specification status (e.g. WD, LCWD, NOTE, etc.). If in doubt use ED.
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    16
          specStatus:           "ED",
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
    17
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    18
          // the specification's short name, as in http://www.w3.org/TR/short-name/
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    19
          shortName:            "touch-events",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    20
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    21
          // if your specification has a subtitle that goes below the main
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    22
          // formal title, define it here
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    23
          // subtitle   :  "an excellent document",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    24
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    25
          // if you wish the publication date to be other than today, set this
81
e5b2d26a6892 Corrected changes clobbered due to mistake
Sangwhan Moon <smoon@opera.com>
parents: 80
diff changeset
    26
          publishDate:  "2011-05-05",
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    27
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    28
          // if the specification's copyright date is a range of years, specify
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    29
          // the start date here:
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    30
          // copyrightStart: "2005"
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    31
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    32
          // if there is a previously published draft, uncomment this and set its YYYY-MM-DD date
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    33
          // and its maturity status
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    34
          // previousPublishDate:  "1977-03-15",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    35
          // previousMaturity:  "WD",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    36
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    37
          // if there a publicly available Editor's Draft, this is the link
73
16faff414b81 Link to default branch rather than tip.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 72
diff changeset
    38
          edDraftURI:           "http://dvcs.w3.org/hg/webevents/raw-file/default/touchevents.html",
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    39
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    40
          // if this is a LCWD, uncomment and set the end of its review period
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    41
          // lcEnd: "2009-08-05",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    42
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    43
          // if you want to have extra CSS, append them to this list
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    44
          // it is recommended that the respec.css stylesheet be kept
8
3349d49e5f46 added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents: 7
diff changeset
    45
          extraCSS:             ["http://www.w3.org/StyleSheets/TR/W3C-TR.css", "http://dev.w3.org/2009/dap/ReSpec.js/css/respec.css"],
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    46
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    47
          // editors, add as many as you like
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    48
          // only "name" is required
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    49
          editors:  [
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    50
              { name: "Doug Schepers", url: "http://schepers.cc/",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    51
                company: "W3C", companyURL: "http://w3.org/" },
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
    52
              { name: "Sangwhan Moon",
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
    53
                company: "Opera Software ASA", companyURL: "http://www.opera.com/" },
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
    54
              { name: "Matt Brubeck",
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
    55
                company: "Mozilla", companyURL: "http://www.mozilla.org/" },
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    56
          ],
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    57
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
    58
          // authors, add as many as you like.
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    59
          // This is optional, uncomment if you have authors as well as editors.
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    60
          // only "name" is required. Same format as editors.
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    61
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    62
          //authors:  [
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    63
          //    { name: "Your Name", url: "http://example.org/",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    64
          //      company: "Your Company", companyURL: "http://example.com/" },
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    65
          //],
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
    66
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    67
          // name of the WG
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    68
          wg:           "Web Events Working Group",
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
    69
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    70
          // URI of the public WG page
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    71
          wgURI:        "http://www.w3.org/2010/webevents/",
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
    72
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    73
          // name (with the @w3c.org) of the public mailing to which comments are due
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    74
          wgPublicList: "public-webevents",
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
    75
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    76
          // URI of the patent status for this WG, for Rec-track documents
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    77
          // !!!! IMPORTANT !!!!
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    78
          // This is important for Rec-track documents, do not copy a patent URI from a random
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    79
          // document unless you know what you're doing. If in doubt ask your friendly neighbourhood
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    80
          // Team Contact.
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    81
          wgPatentURI:  "http://www.w3.org/2004/01/pp-impl/45559/status",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    82
      };
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    83
    </script>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
    84
66
9555f231576e Fix another validation error.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 61
diff changeset
    85
    <style type="text/css">
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
    86
      .event {
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
    87
        font-family: monospace;
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
    88
        color: #459900;
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
    89
      }
23
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
    90
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
    91
      pre.idl {
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
    92
        white-space: pre-wrap;
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
    93
      }
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
    94
    </style>
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    95
  </head>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    96
  <body>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    97
    <section id='abstract'>
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
    98
      The Touch Interface specification defines a set of low-level events that represent one or more points of contact with a touch-sensitive surface, and changes of those points with respect to the surface and any DOM elements displayed upon it (e.g. for touch screens) or associated with it (e.g. for drawing tablets without displays).  It also addresses pen-tablet devices, such as drawing tablets, with consideration toward stylus capabilities.
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    99
    </section>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   100
81
e5b2d26a6892 Corrected changes clobbered due to mistake
Sangwhan Moon <smoon@opera.com>
parents: 80
diff changeset
   101
    <section id='introduction' class='informative'>
e5b2d26a6892 Corrected changes clobbered due to mistake
Sangwhan Moon <smoon@opera.com>
parents: 80
diff changeset
   102
      <h2>Introduction</h2>
e5b2d26a6892 Corrected changes clobbered due to mistake
Sangwhan Moon <smoon@opera.com>
parents: 80
diff changeset
   103
      
e5b2d26a6892 Corrected changes clobbered due to mistake
Sangwhan Moon <smoon@opera.com>
parents: 80
diff changeset
   104
      <p>User Agents that run on terminals which provide touch input to use web applications typically use interpreted mouse events to allow the users to access interactive web applications. However, these interpreted events, being normalized data based on the physical touch input, tend to have limitations on delivering the exact intended user experience. Additionally, it is not possible to handle concurrent input regardless of the device capability, due the constraints of mouse events: both system level limitations, and legacy compatibility.</p>
e5b2d26a6892 Corrected changes clobbered due to mistake
Sangwhan Moon <smoon@opera.com>
parents: 80
diff changeset
   105
e5b2d26a6892 Corrected changes clobbered due to mistake
Sangwhan Moon <smoon@opera.com>
parents: 80
diff changeset
   106
      <p>Meanwhile, native applications are capable of handling both cases with the provided system APIs.</p>
e5b2d26a6892 Corrected changes clobbered due to mistake
Sangwhan Moon <smoon@opera.com>
parents: 80
diff changeset
   107
84
95c76867a243 minor editorial changes to Intro
Art Barstow <art.barstow@nokia.com>
parents: 83
diff changeset
   108
      <p>The Touch Events specification provides a solution to this problem by specifing interfaces to allow web applications to directly handle touch events, and multiple touch points for capable devices.</p>
81
e5b2d26a6892 Corrected changes clobbered due to mistake
Sangwhan Moon <smoon@opera.com>
parents: 80
diff changeset
   109
    </section>
e5b2d26a6892 Corrected changes clobbered due to mistake
Sangwhan Moon <smoon@opera.com>
parents: 80
diff changeset
   110
28
4cbcb68446b5 First draft of a Conformance section based on the DAP WG's Contacts API:
Art Barstow <art.barstow@nokia.com>
parents: 27
diff changeset
   111
    <section id='conformance'>
4cbcb68446b5 First draft of a Conformance section based on the DAP WG's Contacts API:
Art Barstow <art.barstow@nokia.com>
parents: 27
diff changeset
   112
      <p>This specification defines conformance criteria that apply to a single product: the <dfn id="dfn-user-agent">user agent</dfn> that implements the interfaces that it contains. </p>
4cbcb68446b5 First draft of a Conformance section based on the DAP WG's Contacts API:
Art Barstow <art.barstow@nokia.com>
parents: 27
diff changeset
   113
4cbcb68446b5 First draft of a Conformance section based on the DAP WG's Contacts API:
Art Barstow <art.barstow@nokia.com>
parents: 27
diff changeset
   114
      <p>Implementations that use ECMAScript to implement the APIs defined in this specification must implement them in a manner consistent with the ECMAScript Bindings defined in the Web IDL specification [[!WEBIDL]] as this specification uses that specification and terminology.  </p>
4cbcb68446b5 First draft of a Conformance section based on the DAP WG's Contacts API:
Art Barstow <art.barstow@nokia.com>
parents: 27
diff changeset
   115
4cbcb68446b5 First draft of a Conformance section based on the DAP WG's Contacts API:
Art Barstow <art.barstow@nokia.com>
parents: 27
diff changeset
   116
      <p> A conforming implementation is required to implement all fields defined in this specification. </p>
4cbcb68446b5 First draft of a Conformance section based on the DAP WG's Contacts API:
Art Barstow <art.barstow@nokia.com>
parents: 27
diff changeset
   117
    </section>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
   118
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   119
    <section>
46
e761aa494278 ISSUE-11: Rename TouchPoint to Touch
Matt Brubeck <mbrubeck@mozilla.com>
parents: 45
diff changeset
   120
      <h2><a>Touch</a> Interface</h2>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   121
      <p>This interface defines an individual point of contact for a touch event.</p>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
   122
46
e761aa494278 ISSUE-11: Rename TouchPoint to Touch
Matt Brubeck <mbrubeck@mozilla.com>
parents: 45
diff changeset
   123
      <dl title='interface Touch' class='idl'>
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
   124
        <dt>readonly attribute long identifier</dt>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   125
        <dd>
12
183be84c0a6c defined 'touch point'
shepazu <schepers@w3.org>
parents: 11
diff changeset
   126
          An identification number for each <a>touch point</a>, unique to that <a>touch point</a> per session.
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
   127
10
bad00fb0d663 added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents: 9
diff changeset
   128
          <p>The algorithm for determining the <a>identifier</a> value is as follows:</p>
bad00fb0d663 added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents: 9
diff changeset
   129
          <ol>
bad00fb0d663 added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents: 9
diff changeset
   130
            <li>if there are no other <a>active touch event session</a>s, the value of <a>identifier</a> must be <code>0</code></li>
46
e761aa494278 ISSUE-11: Rename TouchPoint to Touch
Matt Brubeck <mbrubeck@mozilla.com>
parents: 45
diff changeset
   131
            <li>if there is at least one <a>active touch event session</a>, the value of <a>identifier</a> must be the lowest integer not currently used by any active <a>Touch</a> object in any <a>active touch event session</a></li>
19
f6cda6b9d1ae ISSUE-7: Event targets should be Elements.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 18
diff changeset
   132
          </ol>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   133
        </dd>
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   134
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
   135
        <dt>readonly attribute long screenX</dt>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   136
        <dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   137
          x-coordinate of point relative to the screen
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   138
        </dd>
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
   139
        <dt>readonly attribute long screenY</dt>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   140
        <dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   141
          y-coordinate of point relative to the screen
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   142
        </dd>
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   143
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
   144
        <dt>readonly attribute long clientX</dt>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   145
        <dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   146
          x-coordinate of point relative to the viewport, excluding any scroll offset
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   147
        </dd>
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
   148
        <dt>readonly attribute long clientY</dt>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   149
        <dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   150
          y-coordinate of point relative to the viewport, excluding any scroll offset
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   151
        </dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   152
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
   153
        <dt>readonly attribute long pageX</dt>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   154
        <dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   155
          x-coordinate of point relative to the viewport, including any scroll offset
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   156
        </dd>
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
   157
        <dt>readonly attribute long pageY</dt>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   158
        <dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   159
          y-coordinate of point relative to the viewport, including any scroll offset
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   160
        </dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   161
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
   162
        <dt>readonly attribute long radiusX</dt>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   163
        <dd>
42
49296bde5e04 radiusX and radiusY must be positive.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 39
diff changeset
   164
          the radius of the ellipse which most closely circumscribes the touching area (e.g. finger, stylus) along the x-axis, in pixels of the same scale as <a>screenX</a>; <code>1</code> if no value is known.  The value must be positive.
10
bad00fb0d663 added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents: 9
diff changeset
   165
          <p class="issue" id="issue-units"><strong>Issue:</strong> What are units of radiusX/radiusY?  CSS Pixels?</p>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   166
        </dd>
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
   167
        <dt>readonly attribute long radiusY</dt>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   168
        <dd>
42
49296bde5e04 radiusX and radiusY must be positive.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 39
diff changeset
   169
          the radius of the ellipse which most closely circumscribes the touching area (e.g. finger, stylus) along the y-axis, in pixels of the same scale as <a>screenY</a>; <code>1</code> if no value is known.  The value must be positive.
6
83ce29dff849 changed cx/cy to rx/ry, defined units for both; added key modifier attributes; changed identifier to float
shepazu <schepers@w3.org>
parents: 5
diff changeset
   170
        </dd>
83ce29dff849 changed cx/cy to rx/ry, defined units for both; added key modifier attributes; changed identifier to float
shepazu <schepers@w3.org>
parents: 5
diff changeset
   171
18
1ea45991d3e9 ISSUE-1: Add rotationAngle attribute for elliptical touch areas.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 17
diff changeset
   172
        <dt>readonly attribute float rotationAngle</dt>
1ea45991d3e9 ISSUE-1: Add rotationAngle attribute for elliptical touch areas.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 17
diff changeset
   173
        <dd>
32
f1cd4dbbd6f8 Wrap these lines to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 31
diff changeset
   174
          <p>
f1cd4dbbd6f8 Wrap these lines to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 31
diff changeset
   175
            the angle (in degrees) that the ellipse described by <a>radiusX</a>
f1cd4dbbd6f8 Wrap these lines to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 31
diff changeset
   176
            and <a>radiusY</a> is rotated clockwise about its center;
33
be8b19639be5 ACTION-31: Remove restriction on rotationAngle and add explanation.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 32
diff changeset
   177
            <code>0</code> if no value is known.  The value must be greater
be8b19639be5 ACTION-31: Remove restriction on rotationAngle and add explanation.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 32
diff changeset
   178
            than or equal to <code>0</code> and less than <code>90</code>.
32
f1cd4dbbd6f8 Wrap these lines to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 31
diff changeset
   179
          </p>
f1cd4dbbd6f8 Wrap these lines to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 31
diff changeset
   180
          <p>
f1cd4dbbd6f8 Wrap these lines to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 31
diff changeset
   181
            If the ellipse described by <a>radiusX</a> and <a>radiusY</a> is
33
be8b19639be5 ACTION-31: Remove restriction on rotationAngle and add explanation.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 32
diff changeset
   182
            circular, then <a>rotationAngle</a> has no effect.  The user agent
be8b19639be5 ACTION-31: Remove restriction on rotationAngle and add explanation.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 32
diff changeset
   183
            may use <code>0</code> as the value in this case, or it may use any
be8b19639be5 ACTION-31: Remove restriction on rotationAngle and add explanation.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 32
diff changeset
   184
            other value in the allowed range.  (For example, the user agent may
37
d5eb1e9315e7 Minor wording change for clarity.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 36
diff changeset
   185
            use the <a>rotationAngle</a> value from the previous touch event,
d5eb1e9315e7 Minor wording change for clarity.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 36
diff changeset
   186
            to avoid sudden changes.)
32
f1cd4dbbd6f8 Wrap these lines to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 31
diff changeset
   187
          </p>
18
1ea45991d3e9 ISSUE-1: Add rotationAngle attribute for elliptical touch areas.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 17
diff changeset
   188
        </dd>
1ea45991d3e9 ISSUE-1: Add rotationAngle attribute for elliptical touch areas.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 17
diff changeset
   189
8
3349d49e5f46 added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents: 7
diff changeset
   190
        <dt>readonly attribute float force</dt>
3349d49e5f46 added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents: 7
diff changeset
   191
        <dd>
31
80a964ec062b Remove "This attribute may not be available..." disclaimers.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 30
diff changeset
   192
          a relative value of pressure applied, in the range <code>0</code> to <code>1</code>, where <code>0</code> is no pressure, and <code>1</code> is the highest level of pressure the touch device is capable of sensing; <code>0</code> if no value is known.  In environments where <a>force</a> is known, the absolute pressure represented by the <a>force</a> attribute, and the sensitivity in levels of pressure, may vary.
10
bad00fb0d663 added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents: 9
diff changeset
   193
bad00fb0d663 added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents: 9
diff changeset
   194
          <p class="issue" id="issue-inkml"><strong>Issue:</strong> Consider aligning with other "channels" and values from <a href="http://www.w3.org/TR/InkML/#channelContents">Ink Markup Language (InkML)</a>, in addition to <a>force</a>, e.g. adding <a>angle</a>, <a>clientZ</a>, <a>rotation</a>, etc.</p>
8
3349d49e5f46 added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents: 7
diff changeset
   195
        </dd>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   196
      </dl>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   197
    </section>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   198
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   199
    <section>
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
   200
      <h2><a>TouchList</a> Interface</h2>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   201
      <p>This interface defines a list of individual points of contact for a touch event.</p>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
   202
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   203
      <dl title='interface TouchList' class='idl'>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   204
        <dt>readonly attribute unsigned long length</dt>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   205
        <dd>
47
926af59e3515 Fix typos in previous commit
Matt Brubeck <mbrubeck@mozilla.com>
parents: 46
diff changeset
   206
          returns the number of <a>Touch</a>es in the list
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   207
        </dd>
60
cc50b9cdc4f8 Remove 'caller'/'caller getter' from item/identifiedTouch
Matt Brubeck <mbrubeck@mozilla.com>
parents: 59
diff changeset
   208
        <dt>getter <a>Touch</a> item (in unsigned long <a>index</a>)</dt>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   209
        <dd>
47
926af59e3515 Fix typos in previous commit
Matt Brubeck <mbrubeck@mozilla.com>
parents: 46
diff changeset
   210
          returns the <a>Touch</a> with index <a>index</a> from the list, sorted in order from latest to earliest
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   211
        </dd>
60
cc50b9cdc4f8 Remove 'caller'/'caller getter' from item/identifiedTouch
Matt Brubeck <mbrubeck@mozilla.com>
parents: 59
diff changeset
   212
        <dt><a>Touch</a> identifiedTouch (in long <a>identifier</a>)</dt>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   213
        <dd>
47
926af59e3515 Fix typos in previous commit
Matt Brubeck <mbrubeck@mozilla.com>
parents: 46
diff changeset
   214
          returns the first <a>Touch</a> with long <a>identifier</a> from the list
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   215
        </dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   216
      </dl>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   217
    </section>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   218
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   219
    <section>
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
   220
      <h2><a>TouchEvent</a> Interface</h2>
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
   221
      <p>This interface defines the <a>touchstart</a>, <a>touchend</a>, <a>touchmove</a>, <a>touchenter</a>, <a>touchleave</a>, and <a>touchcancel</a> event types.</p>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   222
6
83ce29dff849 changed cx/cy to rx/ry, defined units for both; added key modifier attributes; changed identifier to float
shepazu <schepers@w3.org>
parents: 5
diff changeset
   223
      <dl title='interface TouchEvent : UIEvent' class='idl'>
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
   224
        <dt>readonly attribute <a>TouchList</a> touches</dt>
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   225
        <dd>
46
e761aa494278 ISSUE-11: Rename TouchPoint to Touch
Matt Brubeck <mbrubeck@mozilla.com>
parents: 45
diff changeset
   226
          a list of <a>Touch</a>es for every point of contact currently touching the surface
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   227
        </dd>
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
   228
        <dt>readonly attribute <a>TouchList</a> targetTouches</dt>
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   229
        <dd>
46
e761aa494278 ISSUE-11: Rename TouchPoint to Touch
Matt Brubeck <mbrubeck@mozilla.com>
parents: 45
diff changeset
   230
          a list of <a>Touch</a>es for every point of contact currently touching the surface, which started on the same target
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   231
        </dd>
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
   232
        <dt>readonly attribute <a>TouchList</a> changedTouches</dt>
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   233
        <dd>
46
e761aa494278 ISSUE-11: Rename TouchPoint to Touch
Matt Brubeck <mbrubeck@mozilla.com>
parents: 45
diff changeset
   234
          a list of <a>Touch</a>es for every point of contact which contributed to the event
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   235
        </dd>
23
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
   236
30
795c0f6c44e7 ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents: 29
diff changeset
   237
        <dt>readonly attribute boolean altKey</dt>
795c0f6c44e7 ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents: 29
diff changeset
   238
        <dd>
795c0f6c44e7 ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents: 29
diff changeset
   239
          <code>true</code> if the alt (Alternate) key modifier is activated; otherwise <code>false</code>
795c0f6c44e7 ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents: 29
diff changeset
   240
        </dd>
795c0f6c44e7 ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents: 29
diff changeset
   241
        <dt>readonly attribute boolean metaKey</dt>
795c0f6c44e7 ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents: 29
diff changeset
   242
        <dd>
795c0f6c44e7 ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents: 29
diff changeset
   243
          <code>true</code> if the meta (Meta) key modifier is activated; otherwise <code>false</code>.  On some platforms this attribute may map to a differently-named key modifier.
795c0f6c44e7 ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents: 29
diff changeset
   244
        </dd>
795c0f6c44e7 ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents: 29
diff changeset
   245
        <dt>readonly attribute boolean ctrlKey</dt>
795c0f6c44e7 ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents: 29
diff changeset
   246
        <dd>
795c0f6c44e7 ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents: 29
diff changeset
   247
          <code>true</code> if the ctrl (Control) key modifier is activated; otherwise <code>false</code>
795c0f6c44e7 ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents: 29
diff changeset
   248
        </dd>
795c0f6c44e7 ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents: 29
diff changeset
   249
        <dt>readonly attribute boolean shiftKey</dt>
795c0f6c44e7 ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents: 29
diff changeset
   250
        <dd>
795c0f6c44e7 ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents: 29
diff changeset
   251
          <code>true</code> if the shift (Shift) key modifier is activated; otherwise <code>false</code>
795c0f6c44e7 ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents: 29
diff changeset
   252
        </dd>
43
fc6abcf8b74c ISSUE-10: Add a relatedTarget attribute to the TouchEvent interface.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 42
diff changeset
   253
        <dt>readonly attribute EventTarget? relatedTarget</dt>
fc6abcf8b74c ISSUE-10: Add a relatedTarget attribute to the TouchEvent interface.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 42
diff changeset
   254
        <dd>
fc6abcf8b74c ISSUE-10: Add a relatedTarget attribute to the TouchEvent interface.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 42
diff changeset
   255
          identifies a secondary EventTarget related to a touch event.  This
fc6abcf8b74c ISSUE-10: Add a relatedTarget attribute to the TouchEvent interface.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 42
diff changeset
   256
          attribute is used with the <a>touchenter</a> event to indicate the
fc6abcf8b74c ISSUE-10: Add a relatedTarget attribute to the TouchEvent interface.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 42
diff changeset
   257
          <a>EventTarget</a> the touch point exited, and with the
fc6abcf8b74c ISSUE-10: Add a relatedTarget attribute to the TouchEvent interface.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 42
diff changeset
   258
          <a>touchleave</a> event to indicate the <a>EventTarget</a> the touch
fc6abcf8b74c ISSUE-10: Add a relatedTarget attribute to the TouchEvent interface.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 42
diff changeset
   259
          point entered.  For other event types, this attribute must be
fc6abcf8b74c ISSUE-10: Add a relatedTarget attribute to the TouchEvent interface.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 42
diff changeset
   260
          <code>null</code>.
fc6abcf8b74c ISSUE-10: Add a relatedTarget attribute to the TouchEvent interface.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 42
diff changeset
   261
        </dd>
30
795c0f6c44e7 ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents: 29
diff changeset
   262
23
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
   263
        <!-- Methods -->
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
   264
        <dt>void initTouchEvent()</dt>
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
   265
        <dd>
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
   266
          initializes a TouchEvent created through the <a>DocumentEvent</a> interface.
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
   267
          <dl class='parameters'>
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
   268
            <dt>DOMString type</dt> <dd></dd>
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
   269
            <dt>boolean canBubble</dt> <dd></dd>
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
   270
            <dt>boolean cancelable</dt> <dd></dd>
68
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   271
            <dt>AbstractView view</dt> <dd></dd>
23
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
   272
            <dt>long detail</dt> <dd></dd>
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
   273
            <dt>boolean ctrlKey</dt> <dd></dd>
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
   274
            <dt>boolean altKey</dt> <dd></dd>
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
   275
            <dt>boolean shiftKey</dt> <dd></dd>
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
   276
            <dt>boolean metaKey</dt> <dd></dd>
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
   277
            <dt>TouchList touches</dt> <dd></dd>
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
   278
            <dt>TouchList targetTouches</dt> <dd></dd>
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
   279
            <dt>TouchList changedTouches</dt> <dd></dd>
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
   280
          </dl>
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
   281
        </dd>
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   282
      </dl>
8
3349d49e5f46 added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents: 7
diff changeset
   283
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   284
      <section>
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
   285
        <h3 id="event-touchstart">The <dfn class="event">touchstart</dfn> event</h3>
54
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   286
        <p>A user agent must dispatch this event type to indicate when the user
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   287
        places a <a>touch point</a> on the touch surface.</p>
55
7df98116715b Clarify targeting of touchmove and touchend events, and add tests.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 54
diff changeset
   288
7df98116715b Clarify targeting of touchmove and touchend events, and add tests.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 54
diff changeset
   289
        <p>The target of this event must be an <a>Element</a>.</p>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   290
      </section>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
   291
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   292
      <section>
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
   293
        <h3 id="event-touchend">The <dfn class="event">touchend</dfn> event</h3>
54
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   294
        <p>A user agent must dispatch this event type to indicate when the user
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   295
        removes a <a>touch point</a> from the touch surface, also including
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   296
        cases where the touch point physically leaves the touch surface, such
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   297
        as being dragged off of the screen.</p>
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   298
55
7df98116715b Clarify targeting of touchmove and touchend events, and add tests.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 54
diff changeset
   299
        <p>The <a>target</a> of this event must be the same <a>Element</a> that
7df98116715b Clarify targeting of touchmove and touchend events, and add tests.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 54
diff changeset
   300
        received the <a>touchstart</a> event when this <a>touch point</a> was
7df98116715b Clarify targeting of touchmove and touchend events, and add tests.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 54
diff changeset
   301
        placed on the surface, even if the <a>touch point</a> has since moved
7df98116715b Clarify targeting of touchmove and touchend events, and add tests.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 54
diff changeset
   302
        outside the interactive area of the <a>target</a> element.</p>
7df98116715b Clarify targeting of touchmove and touchend events, and add tests.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 54
diff changeset
   303
54
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   304
        <p>The <a>touch point</a> or points that were removed must be included
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   305
        in the <a>changedTouches</a> attribute of the <a>TouchEvent</a>, and
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   306
        must not be included in the <a>touches</a> and <a>targetTouches</a>
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   307
        attributes.</p>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   308
      </section>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
   309
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   310
      <section>
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
   311
        <h3 id="event-touchmove">The <dfn class="event">touchmove</dfn> event</h3>
54
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   312
        <p>A user agent must dispatch this event type to indicate when the user
55
7df98116715b Clarify targeting of touchmove and touchend events, and add tests.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 54
diff changeset
   313
        moves a <a>touch point</a> along the touch surface.
7df98116715b Clarify targeting of touchmove and touchend events, and add tests.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 54
diff changeset
   314
7df98116715b Clarify targeting of touchmove and touchend events, and add tests.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 54
diff changeset
   315
        <p>The <a>target</a> of this event must be the same <a>Element</a> that
7df98116715b Clarify targeting of touchmove and touchend events, and add tests.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 54
diff changeset
   316
        received the <a>touchstart</a> event when this <a>touch point</a> was
7df98116715b Clarify targeting of touchmove and touchend events, and add tests.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 54
diff changeset
   317
        placed on the surface, even if the <a>touch point</a> has since moved
7df98116715b Clarify targeting of touchmove and touchend events, and add tests.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 54
diff changeset
   318
        outside the interactive area of the <a>target</a> element.</p>
54
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   319
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   320
        <p>If the values of <a>radiusX</a>, <a>radiusY</a>,
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   321
        <a>rotationAngle</a>, or <a>force</a> are known, then the user agent
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   322
        also must dispatch this event type to indicate when any of these
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   323
        attributes of a <a>touch point</a> have changed.</p>
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   324
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   325
        <p>Note that the rate at which the user agent sends <a>touchmove</a>
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   326
        events is implementation-defined, and may depend on hardware
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   327
        capabilities and other implementation details.</p>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   328
      </section>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
   329
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   330
      <section>
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
   331
        <h3 id="event-touchenter">The <dfn class="event">touchenter</dfn> event</h3>
54
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   332
        <p>A user agent must dispatch this event type to indicate when a
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   333
        <a>touch point</a> moves onto the interactive area defined by a DOM
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   334
        element.  Events of this type must not bubble.</p>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   335
      </section>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
   336
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   337
      <section>
9
8171bbe11ccc changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents: 8
diff changeset
   338
        <h3 id="event-touchleave">The <dfn class="event">touchleave</dfn> event</h3>
54
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   339
        <p>A user agent must dispatch this event type to indicate when a
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   340
        <a>touch point</a> moves off the interactive area defined by a DOM
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   341
        element.  Events of this type must not bubble.</p>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   342
      </section>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
   343
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   344
      <section>
61
d23f3a960205 Fix validation errors.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 60
diff changeset
   345
        <h3 id="event-touchcancel">The <dfn class="event">touchcancel</dfn> event</h3>
54
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   346
        <p>A user agent must dispatch this event type to indicate when a touch
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   347
        point has been disrupted in an implementation-specific manner, such as
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   348
        a synchronous event or action originating from the UA canceling the
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   349
        touch, or the touch point leaving the document window into a
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   350
        non-document area which is capable of handling user interactions. (e.g.
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   351
        The UA's native user interface, plug-ins)  A user agent may also
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   352
        dispatch this event type when the user places more <a>touch point</a>s
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   353
        on the touch surface than the device or implementation is configured to
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   354
        store, in which case the earliest <a>Touch</a> object in the
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   355
        <a>TouchList</a> should be removed.</p>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   356
      </section>
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   357
    </section>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
   358
68
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   359
    <section>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   360
      <h2><a>DocumentTouch</a> Interface</h2>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   361
      <p>The <a>DocumentTouch</a> interface provides a mechanism by which the user can create <a>Touch</a> and <a>TouchList</a> objects. The <a>DocumentTouch</a> interface must be implemented on the <a>Document</a> object.</p>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   362
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   363
      <dl title='interface DocumentTouch' class='idl'>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   364
        <dt>Touch createTouch()</dt>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   365
        <dd>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   366
          Creates a <a>Touch</a> object with the specified attributes.
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   367
          <dl class='parameters'>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   368
            <dt>AbstractView view</dt> <dd></dd>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   369
            <dt>EventTarget target</dt> <dd></dd>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   370
            <dt>long identifier</dt> <dd></dd>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   371
            <dt>long pageX</dt> <dd></dd>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   372
            <dt>long pageY</dt> <dd></dd>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   373
            <dt>long screenX</dt> <dd></dd>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   374
            <dt>long screenY</dt> <dd></dd>
69
299f0072d6de Make clientX/Y optional in createTouch.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 68
diff changeset
   375
            <dt>optional long clientX</dt> <dd></dd>
299f0072d6de Make clientX/Y optional in createTouch.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 68
diff changeset
   376
            <dt>optional long clientY</dt> <dd></dd>
68
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   377
            <dt>optional long radiusX</dt> <dd></dd>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   378
            <dt>optional long radiusY</dt> <dd></dd>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   379
            <dt>optional float rotationAngle</dt> <dd></dd>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   380
            <dt>optional float force</dt> <dd></dd>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   381
          </dl>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   382
        </dd>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   383
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   384
        <dt>TouchList createTouchList()</dt>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   385
        <dd>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   386
          Creates a <a>TouchList</a> object containing the specified <a>Touch</a> objects.
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   387
          <dl class='parameters'>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   388
            <dt>Touch[] touches</dt> <dd></dd>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   389
          </dl>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   390
        </dd>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   391
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   392
        <dt>TouchList createTouchList()</dt>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   393
        <dd>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   394
          Creates a <a>TouchList</a> object containing a single <a>Touch</a>.
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   395
          <dl class='parameters'>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   396
            <dt>Touch touch</dt> <dd></dd>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   397
          </dl>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   398
        </dd>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   399
      </dl>
72
7d97620f95ec Add an issue about pageX/Y in createTouch.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 71
diff changeset
   400
7d97620f95ec Add an issue about pageX/Y in createTouch.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 71
diff changeset
   401
      <p class="issue" id="issue-createTouch-pageXY"><strong>Issue:</strong>
7d97620f95ec Add an issue about pageX/Y in createTouch.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 71
diff changeset
   402
        Does <a>createTouch</a> need to take both pageX/pageY <em>and</em>
7d97620f95ec Add an issue about pageX/Y in createTouch.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 71
diff changeset
   403
        clientX/clientY as parameters?  If not, which pair should be removed?
7d97620f95ec Add an issue about pageX/Y in createTouch.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 71
diff changeset
   404
      </p>
68
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   405
    </section>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
   406
35
8624a3d5cbd7 ISSUE-9: Interaction of touch events and mouse events
Matt Brubeck <mbrubeck@mozilla.com>
parents: 34
diff changeset
   407
    <section id="mouse-events">
8624a3d5cbd7 ISSUE-9: Interaction of touch events and mouse events
Matt Brubeck <mbrubeck@mozilla.com>
parents: 34
diff changeset
   408
      <h2>Interaction with Mouse Events</h2>
8624a3d5cbd7 ISSUE-9: Interaction of touch events and mouse events
Matt Brubeck <mbrubeck@mozilla.com>
parents: 34
diff changeset
   409
      <p>The user agent may dispatch both touch events and mouse events
8624a3d5cbd7 ISSUE-9: Interaction of touch events and mouse events
Matt Brubeck <mbrubeck@mozilla.com>
parents: 34
diff changeset
   410
      [[!DOM-LEVEL-2-EVENTS]] in response to the same user input.  If the user
8624a3d5cbd7 ISSUE-9: Interaction of touch events and mouse events
Matt Brubeck <mbrubeck@mozilla.com>
parents: 34
diff changeset
   411
      agent dispatches both touch events and mouse events in response to a
8624a3d5cbd7 ISSUE-9: Interaction of touch events and mouse events
Matt Brubeck <mbrubeck@mozilla.com>
parents: 34
diff changeset
   412
      single user action, then the <a>touchstart</a> event type must be
58
22e39e76033e Specify basic preventDefault behavior.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 57
diff changeset
   413
      dispatched before any mouse event types for that action.  If the
83
9545d8d8162e Calling preventDefault() on both touchstart and touchmove should not fire mouse events. ISSUE-4.
Sangwhan Moon <smoon@opera.com>
parents: 81
diff changeset
   414
      <a>preventDefault</a> method of <a>touchstart</a> or <a>touchmove</a>
9545d8d8162e Calling preventDefault() on both touchstart and touchmove should not fire mouse events. ISSUE-4.
Sangwhan Moon <smoon@opera.com>
parents: 81
diff changeset
   415
      is called, the user agent should not dispatch any mouse event that
9545d8d8162e Calling preventDefault() on both touchstart and touchmove should not fire mouse events. ISSUE-4.
Sangwhan Moon <smoon@opera.com>
parents: 81
diff changeset
   416
      would be a consequential result of the the prevented touch event. </p>
58
22e39e76033e Specify basic preventDefault behavior.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 57
diff changeset
   417
22e39e76033e Specify basic preventDefault behavior.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 57
diff changeset
   418
      <p>The default actions and ordering of any further touch and mouse events
22e39e76033e Specify basic preventDefault behavior.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 57
diff changeset
   419
      are implementation-defined, except as specified elsewhere.</p>
35
8624a3d5cbd7 ISSUE-9: Interaction of touch events and mouse events
Matt Brubeck <mbrubeck@mozilla.com>
parents: 34
diff changeset
   420
    </section>
8624a3d5cbd7 ISSUE-9: Interaction of touch events and mouse events
Matt Brubeck <mbrubeck@mozilla.com>
parents: 34
diff changeset
   421
10
bad00fb0d663 added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents: 9
diff changeset
   422
    <section>
bad00fb0d663 added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents: 9
diff changeset
   423
      <h2>Glossary</h2>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
   424
10
bad00fb0d663 added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents: 9
diff changeset
   425
      <dl>
bad00fb0d663 added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents: 9
diff changeset
   426
        <dt><dfn>active touch event session</dfn></dt>
bad00fb0d663 added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents: 9
diff changeset
   427
        <dd>A conceptual state in which there is at least one instance of a <a>TouchEvent</a> event with at least one non-empty <a>TouchList</a>.
bad00fb0d663 added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents: 9
diff changeset
   428
          <!-- <pre class='example'>
bad00fb0d663 added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents: 9
diff changeset
   429
          </pre> -->
bad00fb0d663 added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents: 9
diff changeset
   430
        </dd>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
   431
12
183be84c0a6c defined 'touch point'
shepazu <schepers@w3.org>
parents: 11
diff changeset
   432
        <dt><dfn>touch point</dfn></dt>
183be84c0a6c defined 'touch point'
shepazu <schepers@w3.org>
parents: 11
diff changeset
   433
        <dd>The coordinate point at which a pointer (e.g finger or stylus) intersects the target surface of an interface.  This may apply to a finger touching a touch-screen, or an digital pen writing on a piece of paper.</dd>
10
bad00fb0d663 added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents: 9
diff changeset
   434
      </dl>
bad00fb0d663 added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents: 9
diff changeset
   435
    </section>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
   436
71
4c4b691aab2a Add a link to the issue tracker.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 69
diff changeset
   437
    <section id='issues' class='informative'>
4c4b691aab2a Add a link to the issue tracker.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 69
diff changeset
   438
      <h2>Issues</h2>
4c4b691aab2a Add a link to the issue tracker.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 69
diff changeset
   439
      <p>The working group maintains <a href='http://www.w3.org/2010/webevents/track/products/2'>a list of open issues in this specification</a>.  These issues may be addressed in future revisions of the specification.</p>
4c4b691aab2a Add a link to the issue tracker.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 69
diff changeset
   440
    </section>
4c4b691aab2a Add a link to the issue tracker.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 69
diff changeset
   441
4c4b691aab2a Add a link to the issue tracker.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 69
diff changeset
   442
    <section class='appendix informative'>
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   443
      <h2>Acknowledgements</h2>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   444
      <p>
61
d23f3a960205 Fix validation errors.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 60
diff changeset
   445
        Many thanks to the WebKit engineers for developing the model used as a basis for this spec, Neil Roberts (SitePen) for his summary of WebKit touch events, Peter-Paul Koch (PPK) for his writeups and suggestions, Robin Berjon for developing the <a href="http://dev.w3.org/2009/dap/ReSpec.js/documentation.html">ReSpec.js spec authoring tool</a>, and the WebEvents WG for their many contributions.
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   446
      </p>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
   447
57
25ec8078d266 Acknowledge Andrew Grieve and Cathy Chan.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 55
diff changeset
   448
      <p>Many others have made additional comments as the spec developed, which have led to steady improvements.  Among them are Matthew Schinckel, Andrew Grieve, and Cathy Chan. If I inadvertently omitted your name, please let me know.</p>
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   449
    </section>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   450
  </body>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   451
</html>