touchevents.html
author shepazu <schepers@w3.org>
Tue, 25 Jan 2011 12:28:20 -0500
changeset 8 3349d49e5f46
parent 7 c0397a870384
child 9 8171bbe11ccc
permissions -rw-r--r--
added force attribute; added issues around InkML, units, preventDefault(), timestamp
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
     1
<!DOCTYPE html>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
     2
<html>
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'/>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
     6
    <!-- 
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
     7
      === NOTA BENE ===
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
     8
      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
     9
      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
    10
     -->
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    11
    <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
    12
    <script class='remove'>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    13
      var respecConfig = {
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    14
          // 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
    15
          specStatus:           "ED",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    16
          
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    17
          // 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
    18
          shortName:            "touch-events",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    19
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    20
          // if your specification has a subtitle that goes below the main
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    21
          // formal title, define it here
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    22
          // subtitle   :  "an excellent document",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    23
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    24
          // if you wish the publication date to be other than today, set this
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    25
          // publishDate:  "2009-08-06",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    26
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    27
          // if the specification's copyright date is a range of years, specify
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    28
          // the start date here:
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    29
          // copyrightStart: "2005"
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    30
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    31
          // 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
    32
          // and its maturity status
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    33
          // previousPublishDate:  "1977-03-15",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    34
          // previousMaturity:  "WD",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    35
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    36
          // if there a publicly available Editor's Draft, this is the link
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
    37
          edDraftURI:           "http://dvcs.w3.org/hg/webevents/raw-file/tip/touchevents.html",
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    38
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    39
          // 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
    40
          // lcEnd: "2009-08-05",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    41
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    42
          // if you want to have extra CSS, append them to this list
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    43
          // 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
    44
          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
    45
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    46
          // editors, add as many as you like
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    47
          // only "name" is required
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    48
          editors:  [
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    49
              { name: "Doug Schepers", url: "http://schepers.cc/",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    50
                company: "W3C", companyURL: "http://w3.org/" },
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    51
          ],
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    52
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    53
          // authors, add as many as you like. 
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    54
          // This is optional, uncomment if you have authors as well as editors.
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    55
          // only "name" is required. Same format as editors.
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
          //authors:  [
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    58
          //    { name: "Your Name", url: "http://example.org/",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    59
          //      company: "Your Company", companyURL: "http://example.com/" },
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    60
          //],
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
          // name of the WG
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    63
          wg:           "Web Events Working Group",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    64
          
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    65
          // URI of the public WG page
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    66
          wgURI:        "http://www.w3.org/2010/webevents/",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    67
          
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    68
          // 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
    69
          wgPublicList: "public-webevents",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    70
          
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    71
          // URI of the patent status for this WG, for Rec-track documents
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    72
          // !!!! IMPORTANT !!!!
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    73
          // 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
    74
          // 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
    75
          // Team Contact.
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    76
          wgPatentURI:  "http://www.w3.org/2004/01/pp-impl/45559/status",
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    77
      };
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    78
    </script>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    79
  </head>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    80
  <body>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    81
    <section id='abstract'>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
    82
      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).
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    83
    </section>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
    84
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    85
    
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    86
    <section>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
    87
      <h2><dfn>TouchPoint</dfn> Interface</h2>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
    88
      <p>This interface defines an individual point of contact for a touch event.</p>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
    89
       
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
    90
      <dl title='interface TouchPoint' class='idl'>
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
    91
        <dt>readonly attribute float identifier</dt>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
    92
        <dd>
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
    93
          an identification number unique to each touch point, per session
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
    94
        </dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
    95
        <dt>readonly attribute EventTarget target</dt>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
    96
        <dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
    97
          the original proximal event target for this touch point 
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
    98
        </dd>
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
    99
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   100
        <dt>readonly attribute float screenX</dt>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   101
        <dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   102
          x-coordinate of point relative to the screen
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   103
        </dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   104
        <dt>readonly attribute float screenY</dt>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   105
        <dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   106
          y-coordinate of point relative to the screen
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   107
        </dd>
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   108
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   109
        <dt>readonly attribute float clientX</dt>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   110
        <dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   111
          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
   112
        </dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   113
        <dt>readonly attribute float clientY</dt>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   114
        <dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   115
          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
   116
        </dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   117
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   118
        <dt>readonly attribute float pageX</dt>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   119
        <dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   120
          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
   121
        </dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   122
        <dt>readonly attribute float pageY</dt>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   123
        <dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   124
          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
   125
        </dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   126
7
c0397a870384 change rx/ry to radiusX/radiusY, set default to 1 if no value known
shepazu <schepers@w3.org>
parents: 6
diff changeset
   127
        <dt>readonly attribute float radiusX</dt>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   128
        <dd>
8
3349d49e5f46 added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents: 7
diff changeset
   129
          the radius of the ellipse which most closely circumscribes the touching area (e.g. finger, stylus) along the x-axis, in pixels; <code>1</code> if no value is known.  This attribute may not be available on all user agents or platforms.
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   130
        </dd>
7
c0397a870384 change rx/ry to radiusX/radiusY, set default to 1 if no value known
shepazu <schepers@w3.org>
parents: 6
diff changeset
   131
        <dt>readonly attribute float radiusY</dt>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   132
        <dd>
8
3349d49e5f46 added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents: 7
diff changeset
   133
          the radius of the ellipse which most closely circumscribes the touching area (e.g. finger, stylus) along the y-axis, in pixels; <code>1</code> if no value is known.  This attribute may not be available on all user agents or platforms.
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
   134
        </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
   135
8
3349d49e5f46 added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents: 7
diff changeset
   136
        <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
   137
        <dd>
3349d49e5f46 added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents: 7
diff changeset
   138
          a relative value of pressure applied, in the range <code>0</code> to <code>1</code>; <code>0</code> if no value is known.  This attribute may not be available on all user agents or platforms.
3349d49e5f46 added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents: 7
diff changeset
   139
        </dd>
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
   140
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
   141
        <dt>readonly attribute boolean ctrlKey</dt>
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
   142
        <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
   143
          <code>true</code> if the ctrl (Control) key modifier is activated; otherwise <code>false</code>
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
   144
        </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
   145
        <dt>readonly attribute boolean shiftKey</dt>
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
   146
        <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
   147
          <code>true</code> if the shift (Shift) key modifier is activated; otherwise <code>false</code>
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
   148
        </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
   149
        <dt>readonly attribute boolean altKey</dt>
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
   150
        <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
   151
          <code>true</code> if the alt (Alternate) key modifier is activated; otherwise <code>false</code>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   152
        </dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   153
      </dl>
8
3349d49e5f46 added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents: 7
diff changeset
   154
      
3349d49e5f46 added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents: 7
diff changeset
   155
      <p class="issue" id="issue-inkml"><strong>Issue:</strong> Consider aligning with "channels" and values from <a href="http://www.w3.org/TR/InkML/#channelContents">Ink Markup Language (InkML)</a>.</p>
3349d49e5f46 added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents: 7
diff changeset
   156
      
3349d49e5f46 added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents: 7
diff changeset
   157
      <p class="issue" id="issue-timestamp"><strong>Issue:</strong> Should each touchpoint have its own timestamp?</p>
3349d49e5f46 added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents: 7
diff changeset
   158
3349d49e5f46 added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents: 7
diff changeset
   159
      <p class="issue" id="issue-units"><strong>Issue:</strong> What are units of radiusX/radiusY?</p>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   160
    </section>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   161
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   162
    
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   163
    <section>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   164
      <h2><dfn>TouchList</dfn> Interface</h2>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   165
      <p>This interface defines a list of individual points of contact for a touch event.</p>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   166
       
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   167
      <dl title='interface TouchList' class='idl'>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   168
        <dt>readonly attribute unsigned long length</dt>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   169
        <dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   170
          returns the number of touchpoints in the list
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   171
        </dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   172
        <dt>caller getter TouchPoint item(in unsigned long <dfn>index</dfn>)</dt>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   173
        <dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   174
          returns the touchpoint with index <dfn>index</dfn> from the list, sorted in order from latest to earliest
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   175
        </dd>
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
   176
        <dt>caller getter object identifiedPoint(in float <dfn>identifier</dfn>)</dt>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   177
        <dd>
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
   178
          returns the first touchpoint with float <dfn>identifier</dfn> from the list
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   179
        </dd>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   180
      </dl>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   181
    </section>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   182
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   183
    
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   184
    <section>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   185
      <h2>Touch Interface</h2>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   186
      <p>This interface defines the <dfn>touchstart</dfn>, <dfn>touchend</dfn>, <dfn>touchmove</dfn>, <dfn>touchenter</dfn>, <dfn>touchleave</dfn>, and <dfn>touchcancel</dfn> event types.</p>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   187
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
   188
      <dl title='interface TouchEvent : UIEvent' class='idl'>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   189
        <!-- <dt>readonly attribute views::AbstractView view</dt>
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   190
        <dd>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   191
          The <code>view</code> attribute identifies the <code>AbstractView</code> from which the event was generated.
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   192
        </dd> -->
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   193
        <dt>readonly attribute TouchList touches</dt>
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   194
        <dd>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   195
          a list of <dfn>TouchPoint</dfn>s for every point of contact currently touching the surface
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   196
        </dd>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   197
        <dt>readonly attribute TouchList targetTouches</dt>
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   198
        <dd>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   199
          a list of <dfn>TouchPoint</dfn>s 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
   200
        </dd>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   201
        <dt>readonly attribute TouchList changedTouches</dt>
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   202
        <dd>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   203
          a list of <dfn>TouchPoint</dfn>s for every point of contact which contributed to the event
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   204
        </dd>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   205
      </dl>
8
3349d49e5f46 added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents: 7
diff changeset
   206
3349d49e5f46 added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents: 7
diff changeset
   207
      <p class="issue" id="issue-preventDefault"><strong>Issue:</strong> define behavior of preventDefault() method.</p>
3349d49e5f46 added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents: 7
diff changeset
   208
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   209
      
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   210
      <section>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   211
        <h3 id="event-touchstart">The <dfn>touchstart</dfn> event</h3>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   212
        <p>A user agent must dispatch this event type when the user places a touch point on the touch surface.</p>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   213
      </section>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   214
      
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   215
      <section>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   216
        <h3 id="event-touchstart">The <dfn>touchend</dfn> event</h3>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   217
        <p>A user agent must dispatch this event type when the user removes a touch point from the touch surface.</p>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   218
      </section>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   219
      
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   220
      <section>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   221
        <h3 id="event-touchstart">The <dfn>touchmove</dfn> event</h3>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   222
        <p>A user agent must dispatch this event type when the user moves a touch point along the touch surface.</p>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   223
      </section>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   224
      
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   225
      <section>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   226
        <h3 id="event-touchstart">The <dfn>touchenter</dfn> event</h3>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   227
        <p>A user agent must dispatch this event type when a touch point moves onto the interactive area defined by a DOM element on which it did not originate.  Events of this type must not bubble.</p>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   228
      </section>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   229
      
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   230
      <section>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   231
        <h3 id="event-touchstart">The <dfn>touchleave</dfn> event</h3>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   232
        <p>A user agent must dispatch this event type when a touch point moves off the interactive area defined by a DOM element.  Events of this type must not bubble.</p>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   233
      </section>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   234
      
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   235
      <section>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   236
        <h3 id="event-touchstart">The <dfn>touchcancel</dfn> event</h3>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   237
        <p>A user agent must dispatch this event type when the user places a more touch points on the touch surface than the device or implementation is configured to store, in which case the earliest touch point in the list must be removed.</p>
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   238
      </section>
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   239
    </section>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   240
    
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   241
    <section class='appendix'>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   242
      <h2>Acknowledgements</h2>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   243
      <p>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   244
        Many thanks to Robin Berjon for making our lives so much easier with his cool tool, Neil Roberts (SitePen) for his summary of WebKit touch events, and Peter-Paul Koch (PPK) for his writeups and suggestions.
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   245
      </p>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   246
    </section>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   247
  </body>
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   248
</html>