touchevents.html
author Art Barstow <art.barstow@nokia.com>
Wed, 08 May 2013 16:12:31 -0400
branchwd
changeset 209 826dea27ad62
parent 208 c7c370852576
permissions -rw-r--r--
Set PR review end date for 6 June 2013
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">
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
     3
<head>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
     4
    <title>Touch Events version 1</title>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
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
     -->
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    12
    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    13
    
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
    14
    
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
    15
66
9555f231576e Fix another validation error.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 61
diff changeset
    16
    <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
    17
      .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
    18
        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
    19
        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
    20
      }
23
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
    21
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
    22
      pre.idl {
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
    23
        white-space: pre-wrap;
4958878564b1 ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 22
diff changeset
    24
      }
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
    25
    </style>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    26
  <style>/*****************************************************************
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    27
 * ReSpec 3 CSS
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    28
 * Robin Berjon - http://berjon.com/
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    29
 *****************************************************************/
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    30
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    31
/* --- INLINES --- */
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    32
em.rfc2119 { 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    33
    text-transform:     lowercase;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    34
    font-variant:       small-caps;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    35
    font-style:         normal;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    36
    color:              #900;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    37
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    38
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    39
h1 acronym, h2 acronym, h3 acronym, h4 acronym, h5 acronym, h6 acronym, a acronym,
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    40
h1 abbr, h2 abbr, h3 abbr, h4 abbr, h5 abbr, h6 abbr, a abbr {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    41
    border: none;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    42
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    43
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    44
dfn {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    45
    font-weight:    bold;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    46
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    47
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    48
a.internalDFN {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    49
    color:  inherit;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    50
    border-bottom:  1px solid #99c;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    51
    text-decoration:    none;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    52
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    53
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    54
a.externalDFN {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    55
    color:  inherit;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    56
    border-bottom:  1px dotted #ccc;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    57
    text-decoration:    none;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    58
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    59
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    60
a.bibref {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    61
    text-decoration:    none;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    62
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    63
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    64
cite .bibref {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    65
    font-style: normal;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    66
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    67
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    68
code {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    69
    color:  #ff4500;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    70
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    71
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    72
/* --- TOC --- */
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    73
.toc a, .tof a {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    74
    text-decoration:    none;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    75
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    76
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    77
a .secno, a .figno {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    78
    color:  #000;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    79
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    80
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    81
ul.tof, ol.tof {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    82
    list-style: none outside none;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    83
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    84
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    85
.caption {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    86
    margin-top: 0.5em;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    87
    font-style:   italic;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    88
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    89
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    90
/* --- TABLE --- */
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    91
table.simple {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    92
    border-spacing: 0;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    93
    border-collapse:    collapse;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    94
    border-bottom:  3px solid #005a9c;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    95
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    96
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    97
.simple th {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    98
    background: #005a9c;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
    99
    color:  #fff;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   100
    padding:    3px 5px;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   101
    text-align: left;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   102
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   103
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   104
.simple th[scope="row"] {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   105
    background: inherit;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   106
    color:  inherit;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   107
    border-top: 1px solid #ddd;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   108
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   109
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   110
.simple td {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   111
    padding:    3px 10px;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   112
    border-top: 1px solid #ddd;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   113
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   114
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   115
.simple tr:nth-child(even) {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   116
    background: #f0f6ff;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   117
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   118
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   119
/* --- DL --- */
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   120
.section dd > p:first-child {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   121
    margin-top: 0;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   122
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   123
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   124
.section dd > p:last-child {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   125
    margin-bottom: 0;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   126
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   127
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   128
.section dd {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   129
    margin-bottom:  1em;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   130
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   131
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   132
.section dl.attrs dd, .section dl.eldef dd {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   133
    margin-bottom:  0;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   134
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   135
</style><style>/* --- EXAMPLES --- */
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   136
div.example-title {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   137
    min-width: 7.5em;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   138
    color: #b9ab2d;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   139
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   140
div.example-title span {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   141
    text-transform: uppercase;   
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   142
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   143
aside.example, div.example, div.illegal-example {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   144
    padding: 0.5em;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   145
    margin: 1em 0;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   146
    position: relative;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   147
    clear: both;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   148
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   149
div.illegal-example { color: red }
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   150
div.illegal-example p { color: black }
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   151
aside.example, div.example {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   152
    padding: .5em;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   153
    border-left-width: .5em;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   154
    border-left-style: solid;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   155
    border-color: #e0cb52;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   156
    background: #fcfaee;    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   157
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   158
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   159
aside.example div.example {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   160
    border-left-width: .1em;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   161
    border-color: #999;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   162
    background: #fff;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   163
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   164
aside.example div.example div.example-title {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   165
    color: #999;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   166
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   167
</style><style>/* --- ISSUES/NOTES --- */
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   168
div.issue-title, div.note-title {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   169
    padding-right:  1em;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   170
    min-width: 7.5em;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   171
    color: #b9ab2d;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   172
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   173
div.issue-title { color: #e05252; }
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   174
div.note-title { color: #2b2; }
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   175
div.issue-title span, div.note-title span {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   176
    text-transform: uppercase;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   177
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   178
div.note, div.issue {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   179
    margin-top: 1em;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   180
    margin-bottom: 1em;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   181
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   182
.note > p:first-child, .issue > p:first-child { margin-top: 0 }
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   183
.issue, .note {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   184
    padding: .5em;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   185
    border-left-width: .5em;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   186
    border-left-style: solid;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   187
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   188
div.issue, div.note {
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   189
    padding: 1em 1.2em 0.5em;
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   190
    margin: 1em 0;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   191
    position: relative;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   192
    clear: both;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   193
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   194
span.note, span.issue { padding: .1em .5em .15em; }
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   195
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   196
.issue {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   197
    border-color: #e05252;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   198
    background: #fbe9e9;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   199
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   200
.note {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   201
    border-color: #52e052;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   202
    background: #e9fbe9;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   203
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   204
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   205
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   206
</style><style>/* --- WEB IDL --- */
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   207
pre.idl {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   208
    border-top: 1px solid #90b8de;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   209
    border-bottom: 1px solid #90b8de;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   210
    padding:    1em;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   211
    line-height:    120%;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   212
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   213
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   214
pre.idl::before {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   215
    content:    "WebIDL";
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   216
    display:    block;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   217
    width:      150px;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   218
    background: #90b8de;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   219
    color:  #fff;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   220
    font-family:    initial;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   221
    padding:    3px;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   222
    font-weight:    bold;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   223
    margin: -1em 0 1em -1em;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   224
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   225
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   226
.idlType {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   227
    color:  #ff4500;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   228
    font-weight:    bold;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   229
    text-decoration:    none;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   230
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   231
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   232
/*.idlModule*/
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   233
/*.idlModuleID*/
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   234
/*.idlInterface*/
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   235
.idlInterfaceID, .idlDictionaryID, .idlCallbackID, .idlEnumID {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   236
    font-weight:    bold;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   237
    color:  #005a9c;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   238
}
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   239
a.idlEnumItem {
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   240
    color:  #000;
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   241
    border-bottom:  1px dotted #ccc;
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   242
    text-decoration: none;
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   243
}
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   244
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   245
.idlSuperclass {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   246
    font-style: italic;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   247
    color:  #005a9c;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   248
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   249
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   250
/*.idlAttribute*/
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   251
.idlAttrType, .idlFieldType, .idlMemberType {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   252
    color:  #005a9c;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   253
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   254
.idlAttrName, .idlFieldName, .idlMemberName {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   255
    color:  #ff4500;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   256
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   257
.idlAttrName a, .idlFieldName a, .idlMemberName a {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   258
    color:  #ff4500;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   259
    border-bottom:  1px dotted #ff4500;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   260
    text-decoration: none;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   261
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   262
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   263
/*.idlMethod*/
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   264
.idlMethType, .idlCallbackType {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   265
    color:  #005a9c;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   266
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   267
.idlMethName {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   268
    color:  #ff4500;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   269
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   270
.idlMethName a {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   271
    color:  #ff4500;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   272
    border-bottom:  1px dotted #ff4500;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   273
    text-decoration: none;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   274
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   275
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   276
/*.idlCtor*/
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   277
.idlCtorName {
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   278
    color:  #ff4500;
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   279
}
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   280
.idlCtorName a {
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   281
    color:  #ff4500;
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   282
    border-bottom:  1px dotted #ff4500;
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   283
    text-decoration: none;
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   284
}
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   285
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   286
/*.idlParam*/
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   287
.idlParamType {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   288
    color:  #005a9c;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   289
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   290
.idlParamName, .idlDefaultValue {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   291
    font-style: italic;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   292
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   293
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   294
.extAttr {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   295
    color:  #666;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   296
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   297
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   298
/*.idlSectionComment*/
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   299
.idlSectionComment {
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   300
    color: gray;
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   301
}
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   302
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   303
/*.idlConst*/
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   304
.idlConstType {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   305
    color:  #005a9c;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   306
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   307
.idlConstName {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   308
    color:  #ff4500;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   309
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   310
.idlConstName a {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   311
    color:  #ff4500;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   312
    border-bottom:  1px dotted #ff4500;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   313
    text-decoration: none;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   314
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   315
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   316
/*.idlException*/
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   317
.idlExceptionID {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   318
    font-weight:    bold;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   319
    color:  #c00;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   320
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   321
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   322
.idlTypedefID, .idlTypedefType {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   323
    color:  #005a9c;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   324
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   325
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   326
.idlRaises, .idlRaises a.idlType, .idlRaises a.idlType code, .excName a, .excName a code {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   327
    color:  #c00;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   328
    font-weight:    normal;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   329
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   330
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   331
.excName a {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   332
    font-family:    monospace;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   333
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   334
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   335
.idlRaises a.idlType, .excName a.idlType {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   336
    border-bottom:  1px dotted #c00;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   337
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   338
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   339
.excGetSetTrue, .excGetSetFalse, .prmNullTrue, .prmNullFalse, .prmOptTrue, .prmOptFalse {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   340
    width:  45px;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   341
    text-align: center;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   342
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   343
.excGetSetTrue, .prmNullTrue, .prmOptTrue { color:  #0c0; }
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   344
.excGetSetFalse, .prmNullFalse, .prmOptFalse { color:  #c00; }
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   345
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   346
.idlImplements a {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   347
    font-weight:    bold;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   348
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   349
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   350
dl.attributes, dl.methods, dl.constants, dl.constructors, dl.fields, dl.dictionary-members {
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   351
    margin-left:    2em;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   352
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   353
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   354
.attributes dt, .methods dt, .constants dt, .constructors dt, .fields dt, .dictionary-members dt {
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   355
    font-weight:    normal;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   356
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   357
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   358
.attributes dt code, .methods dt code, .constants dt code, .constructors dt code, .fields dt code, .dictionary-members dt code {
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   359
    font-weight:    bold;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   360
    color:  #000;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   361
    font-family:    monospace;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   362
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   363
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   364
.attributes dt code, .fields dt code, .dictionary-members dt code {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   365
    background:  #ffffd2;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   366
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   367
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   368
.attributes dt .idlAttrType code, .fields dt .idlFieldType code, .dictionary-members dt .idlMemberType code {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   369
    color:  #005a9c;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   370
    background:  transparent;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   371
    font-family:    inherit;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   372
    font-weight:    normal;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   373
    font-style: italic;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   374
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   375
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   376
.methods dt code {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   377
    background:  #d9e6f8;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   378
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   379
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   380
.constants dt code {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   381
    background:  #ddffd2;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   382
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   383
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   384
.constructors dt code {
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   385
    background:  #cfc;
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   386
}
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   387
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   388
.attributes dd, .methods dd, .constants dd, .constructors dd, .fields dd, .dictionary-members dd {
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   389
    margin-bottom:  1em;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   390
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   391
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   392
table.parameters, table.exceptions {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   393
    border-spacing: 0;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   394
    border-collapse:    collapse;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   395
    margin: 0.5em 0;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   396
    width:  100%;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   397
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   398
table.parameters { border-bottom:  1px solid #90b8de; }
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   399
table.exceptions { border-bottom:  1px solid #deb890; }
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   400
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   401
.parameters th, .exceptions th {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   402
    color:  #fff;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   403
    padding:    3px 5px;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   404
    text-align: left;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   405
    font-family:    initial;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   406
    font-weight:    normal;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   407
    text-shadow:    #666 1px 1px 0;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   408
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   409
.parameters th { background: #90b8de; }
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   410
.exceptions th { background: #deb890; }
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   411
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   412
.parameters td, .exceptions td {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   413
    padding:    3px 10px;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   414
    border-top: 1px solid #ddd;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   415
    vertical-align: top;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   416
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   417
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   418
.parameters tr:first-child td, .exceptions tr:first-child td {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   419
    border-top: none;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   420
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   421
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   422
.parameters td.prmName, .exceptions td.excName, .exceptions td.excCodeName {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   423
    width:  100px;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   424
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   425
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   426
.parameters td.prmType {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   427
    width:  120px;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   428
}
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   429
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   430
table.exceptions table {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   431
    border-spacing: 0;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   432
    border-collapse:    collapse;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   433
    width:  100%;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   434
}
205
3dbec7cbe666 Use https for W3C stylesheet
Art Barstow <art.barstow@nokia.com>
parents: 204
diff changeset
   435
</style><link rel="stylesheet" href="https://www.w3.org/StyleSheets/TR/W3C-PR"><!--[if lt IE 9]><script src='https://www.w3.org/2008/site/js/html5shiv.js'></script><![endif]--><!--[if lt IE 9]><script src='https://www.w3.org/2008/site/js/html5shiv.js'></script><![endif]--></head>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   436
  <body><div class="head">
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   437
  <p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   438
    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   439
      <a href="http://www.w3.org/"><img width="72" height="48" src="https://www.w3.org/Icons/w3c_home" alt="W3C"></a>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   440
    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   441
  </p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   442
  <h1 class="title" id="title">Touch Events version 1</h1>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   443
  
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   444
  <h2 id="w3c-proposed-recommendation-09-may-2013"><abbr title="World Wide Web Consortium">W3C</abbr> Proposed Recommendation 09 May 2013</h2>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   445
  <dl>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   446
    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   447
      <dt>This version:</dt>
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   448
      <dd><a href="http://www.w3.org/TR/2013/PR-touch-events-20130509/">http://www.w3.org/TR/2013/PR-touch-events-20130509/</a></dd>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   449
      <dt>Latest published version:</dt>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   450
      <dd><a href="http://www.w3.org/TR/touch-events/">http://www.w3.org/TR/touch-events/</a></dd>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   451
    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   452
    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   453
      <dt>Latest editor's draft:</dt>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   454
      <dd><a href="http://dvcs.w3.org/hg/webevents/raw-file/v1/touchevents.html">http://dvcs.w3.org/hg/webevents/raw-file/v1/touchevents.html</a></dd>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   455
    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   456
    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   457
    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   458
    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   459
    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   460
      <dt>Previous version:</dt>
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   461
      <dd><a href="http://www.w3.org/TR/2013/WD-touch-events-20130124/">http://www.w3.org/TR/2013/WD-touch-events-20130124/</a></dd>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   462
    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   463
    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   464
    <dt>Editors:</dt>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   465
    <dd><a href="http://schepers.cc/">Doug Schepers</a>, <a href="http://w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a></dd>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   466
<dd><span>Sangwhan Moon</span>, <a href="http://www.opera.com/">Opera Software ASA</a></dd>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   467
<dd><a href="http://limpet.net/mbrubeck/">Matt Brubeck</a>, <a href="http://www.mozilla.org/">Mozilla</a></dd>
208
c7c370852576 Per agreement, add ArtB to Editor list
Art Barstow <art.barstow@nokia.com>
parents: 205
diff changeset
   468
<dd><span>Arthur Barstow</span>, <a href="http://www.nokia.com/">Nokia</a></dd>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   469
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   470
    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   471
  </dl>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   472
  
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   473
  
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   474
  
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   475
  
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   476
    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   477
      <p class="copyright">
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   478
        <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   479
        2013
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   480
        
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   481
        <a href="http://www.w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   482
        (<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts Institute of Technology">MIT</abbr></a>,
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   483
        <a href="http://www.ercim.eu/"><abbr title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>,
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   484
        <a href="http://www.keio.ac.jp/">Keio</a>, <a href="http://ev.buaa.edu.cn/">Beihang</a>), All Rights Reserved.
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   485
        <abbr title="World Wide Web Consortium">W3C</abbr> <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   486
        <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a> and
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   487
        <a href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a> rules apply.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   488
      </p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   489
    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   490
  
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   491
  <hr>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   492
</div>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   493
    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   494
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   495
    <section id="abstract" class="introductory"><h2>Abstract</h2><p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   496
      The Touch Events specification defines a set of low-level events that
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   497
      represent one or more points of contact with a touch-sensitive surface,
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   498
      and changes of those points with respect to the surface and any DOM
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   499
      elements displayed upon it (e.g. for touch screens) or associated with it
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   500
      (e.g. for drawing tablets without displays).  It also addresses
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   501
      pen-tablet devices, such as drawing tablets, with consideration toward
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   502
      stylus capabilities.
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   503
    </p></section><section id="sotd" class="introductory"><h2>Status of This Document</h2>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   504
  
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   505
    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   506
      
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   507
        <p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   508
          <em>This section describes the status of this document at the time of its publication. Other
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   509
          documents may supersede this document. A list of current <abbr title="World Wide Web Consortium">W3C</abbr> publications and the latest revision
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   510
          of this technical report can be found in the <a href="http://www.w3.org/TR/"><abbr title="World Wide Web Consortium">W3C</abbr> technical reports
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   511
          index</a> at http://www.w3.org/TR/.</em>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   512
        </p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   513
        
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   514
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   515
     The last publication of this specification was the 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   516
     <a href="http://www.w3.org/TR/2013/WD-touch-events-20130124/">
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   517
     24 January 2013 Last Call Working Draft</a>.
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   518
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   519
     Comments submitted against the Last Call specification are
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   520
     consolidated in a
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   521
     <a href="http://www.w3.org/2010/webevents/wiki/TouchEvents-LCWD-24-Jan-2013">
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   522
     comment tracking docuemnt</a>.  All of the comments resulted in non-normative
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   523
     changes to the specification.
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   524
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   525
     The WG has completed and approved this specification's 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   526
     <a href="http://w3c-test.org/webevents/tests/touch-events-v1/approved/">Test Suite</a> 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   527
     and created an 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   528
     <a href="http://www.w3.org/2010/webevents/wiki/TEv1ImplReport">
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   529
     Implementation Report</a> that shows that two or more independent implementations 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   530
     pass each test.
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   531
    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   532
        <p>
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   533
          This document was published by the <a href="http://www.w3.org/2010/webevents/">Web Events Working Group</a> as a Proposed Recommendation.
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   534
          
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   535
            This document is intended to become a <abbr title="World Wide Web Consortium">W3C</abbr> Recommendation.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   536
          
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   537
          The <abbr title="World Wide Web Consortium">W3C</abbr> Membership and other interested parties are invited
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   538
          to review the document and send comments to
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   539
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   540
          <a href="mailto:public-webevents@w3.org">public-webevents@w3.org</a> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   541
          (<a href="mailto:public-webevents-request@w3.org?subject=subscribe">subscribe</a>,
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   542
          <a href="http://lists.w3.org/Archives/Public/public-webevents/">archives</a>).
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   543
          Advisory Committee Representatives should consult their
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   544
          <a href="https://www.w3.org/2002/09/wbs/myQuestionnaires">WBS questionnaires</a>. 
209
826dea27ad62 Set PR review end date for 6 June 2013
Art Barstow <art.barstow@nokia.com>
parents: 208
diff changeset
   545
          The deadline for review and comments is 6 June 2013.
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   546
        </p>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   547
        
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   548
        <p>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   549
         Please note the advancement to Recommendation is pending all W3C normative 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   550
         references being Proposed Recommendations or Recommendations, or the group provides 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   551
         evidence to the Director that the features in the references are stable and tested.
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   552
        </p>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   553
        
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   554
          <p>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   555
            Publication as a Proposed Recommendation does not imply endorsement by the <abbr title="World Wide Web Consortium">W3C</abbr> Membership.
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   556
            This is a draft document and may be updated, replaced or obsoleted by other documents at 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   557
            any time. It is inappropriate to cite this document as other than work in progress.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   558
          </p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   559
        
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   560
        
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   561
        <p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   562
          
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   563
            This document was produced by a group operating under the 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   564
            <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5 February 2004 <abbr title="World Wide Web Consortium">W3C</abbr> Patent Policy</a>.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   565
          
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   566
          
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   567
          
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   568
            
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   569
              <abbr title="World Wide Web Consortium">W3C</abbr> maintains a <a href="http://www.w3.org/2004/01/pp-impl/45559/status" rel="disclosure">public list of any patent disclosures</a> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   570
            
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   571
            made in connection with the deliverables of the group; that page also includes instructions for 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   572
            disclosing a patent. An individual who has actual knowledge of a patent which the individual believes contains
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   573
            <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#def-essential">Essential Claim(s)</a> must disclose the
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   574
            information in accordance with <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure">section
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   575
            6 of the <abbr title="World Wide Web Consortium">W3C</abbr> Patent Policy</a>.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   576
          
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   577
          
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   578
        </p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   579
        
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   580
      
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   581
    
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   582
  
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   583
</section><section id="toc"><h2 class="introductory">Table of Contents</h2><ul class="toc"><li class="tocline"><a href="#introduction" class="tocxref"><span class="secno">1. </span>Introduction</a></li><li class="tocline"><a href="#conformance" class="tocxref"><span class="secno">2. </span>Conformance</a></li><li class="tocline"><a href="#touch-interface" class="tocxref"><span class="secno">3. </span><span class="formerLink"><code>Touch</code></span> Interface</a><ul class="toc"><li class="tocline"><a href="#attributes" class="tocxref"><span class="secno">3.1 </span>Attributes</a></li></ul></li><li class="tocline"><a href="#touchlist-interface" class="tocxref"><span class="secno">4. </span><span class="formerLink"><code>TouchList</code></span> Interface</a><ul class="toc"><li class="tocline"><a href="#attributes-1" class="tocxref"><span class="secno">4.1 </span>Attributes</a></li><li class="tocline"><a href="#methods" class="tocxref"><span class="secno">4.2 </span>Methods</a></li></ul></li><li class="tocline"><a href="#touchevent-interface" class="tocxref"><span class="secno">5. </span><span class="formerLink"><code>TouchEvent</code></span> Interface</a><ul class="toc"><li class="tocline"><a href="#attributes-2" class="tocxref"><span class="secno">5.1 </span>Attributes</a></li><li class="tocline"><a href="#touchevent-implementer-s-note" class="tocxref"><span class="secno">5.2 </span>TouchEvent Implementer's Note</a></li><li class="tocline"><a href="#usage-examples" class="tocxref"><span class="secno">5.3 </span>Usage Examples</a><ul class="toc"><li class="tocline"><a href="#touches-and-targettouches-of-a-touchevent" class="tocxref"><span class="secno">5.3.1 </span>touches and targetTouches of a <span class="formerLink"><code>TouchEvent</code></span></a></li><li class="tocline"><a href="#changedtouches-of-a-touchevent" class="tocxref"><span class="secno">5.3.2 </span>changedTouches of a <span class="formerLink"><code>TouchEvent</code></span></a></li></ul></li><li class="tocline"><a href="#list-of-touchevent-types" class="tocxref"><span class="secno">5.4 </span>List of <span class="formerLink"><code>TouchEvent</code></span> types</a></li><li class="tocline"><a href="#the-touchstart-event" class="tocxref"><span class="secno">5.5 </span>The <span class="event">touchstart</span>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   584
        event</a></li><li class="tocline"><a href="#the-touchend-event" class="tocxref"><span class="secno">5.6 </span>The <span class="event">touchend</span> event</a></li><li class="tocline"><a href="#the-touchmove-event" class="tocxref"><span class="secno">5.7 </span>The <span class="event">touchmove</span> event</a></li><li class="tocline"><a href="#the-touchcancel-event" class="tocxref"><span class="secno">5.8 </span>The <span class="event">touchcancel</span> event</a></li></ul></li><li class="tocline"><a href="#extensions-to-the-document-interface" class="tocxref"><span class="secno">6. </span>Extensions to the <span class="formerLink"><code>Document</code></span> Interface</a><ul class="toc"><li class="tocline"><a href="#methods-1" class="tocxref"><span class="secno">6.1 </span>Methods</a></li></ul></li><li class="tocline"><a href="#mouse-events" class="tocxref"><span class="secno">7. </span>Interaction with Mouse Events</a></li><li class="tocline"><a href="#glossary" class="tocxref"><span class="secno">8. </span>Glossary</a></li><li class="tocline"><a href="#issues" class="tocxref"><span class="secno">9. </span>Issues</a></li><li class="tocline"><a href="#acknowledgements" class="tocxref"><span class="secno">A. </span>Acknowledgements</a></li><li class="tocline"><a href="#changes-since-last-publication" class="tocxref"><span class="secno">B. </span>Changes Since Last Publication</a></li><li class="tocline"><a href="#references" class="tocxref"><span class="secno">C. </span>References</a><ul class="toc"><li class="tocline"><a href="#normative-references" class="tocxref"><span class="secno">C.1 </span>Normative references</a></li></ul></li></ul></section>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   585
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   586
    <section id="introduction" class="informative">
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   587
      <!--OddPage--><h2><span class="secno">1. </span>Introduction</h2><p><em>This section is non-normative.</em></p>
81
e5b2d26a6892 Corrected changes clobbered due to mistake
Sangwhan Moon <smoon@opera.com>
parents: 80
diff changeset
   588
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   589
      <p>
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   590
        User Agents that run on terminals which provide touch input to use web
87
4b363819e79b Edits to the introduction
Josh Soref <josh.soref@nokia.com>
parents: 86
diff changeset
   591
        applications typically use interpreted mouse events to allow users
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   592
        to access interactive web applications. However, these interpreted
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   593
        events, being normalized data based on the physical touch input, tend
87
4b363819e79b Edits to the introduction
Josh Soref <josh.soref@nokia.com>
parents: 86
diff changeset
   594
        to have limitations on delivering the intended user experience.
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   595
        Additionally, it is not possible to handle concurrent input regardless
87
4b363819e79b Edits to the introduction
Josh Soref <josh.soref@nokia.com>
parents: 86
diff changeset
   596
        of device capability, due to constraints of mouse events: both
4b363819e79b Edits to the introduction
Josh Soref <josh.soref@nokia.com>
parents: 86
diff changeset
   597
        system level limitations and legacy compatibility.
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   598
      </p>
81
e5b2d26a6892 Corrected changes clobbered due to mistake
Sangwhan Moon <smoon@opera.com>
parents: 80
diff changeset
   599
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   600
      <p>
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   601
        Meanwhile, native applications are capable of handling both cases with
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   602
        the provided system APIs.
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   603
      </p>
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   604
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   605
      <p>
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   606
        The Touch Events specification provides a solution to this problem by
86
653218ffd9c4 spelling fixes
Josh Soref <josh.soref@nokia.com>
parents: 85
diff changeset
   607
        specifying interfaces to allow web applications to directly handle touch
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   608
        events, and multiple touch points for capable devices.
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   609
      </p>
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   610
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   611
      <div class="note"><div class="note-title" role="heading" aria-level="3"><span>Note</span></div><p class="">
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   612
        The <abbr title="World Wide Web Consortium">W3C</abbr>'s <a href="http://www.w3.org/WAI/PF/">
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   613
        Protocols and Formats Working Group</a> created a non-normative document 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   614
        that includes a mapping of hardware events (e.g. keyboard events) to touch 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   615
        events. For more information see 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   616
        <a href="http://www.w3.org/WAI/PF/wiki/Touch_Events_Accessibility_Mapping">
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   617
        Touch Events Accessibility Mapping</a>.
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   618
      </p></div>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   619
81
e5b2d26a6892 Corrected changes clobbered due to mistake
Sangwhan Moon <smoon@opera.com>
parents: 80
diff changeset
   620
    </section>
e5b2d26a6892 Corrected changes clobbered due to mistake
Sangwhan Moon <smoon@opera.com>
parents: 80
diff changeset
   621
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   622
    <section id="conformance"><!--OddPage--><h2><span class="secno">2. </span>Conformance</h2>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   623
<p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   624
  As well as sections marked as non-normative, all authoring guidelines, diagrams, examples,
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   625
  and notes in this specification are non-normative. Everything else in this specification is
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   626
  normative.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   627
</p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   628
<p>
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   629
  The key words <em class="rfc2119" title="MUST">MUST</em>, <em class="rfc2119" title="MUST NOT">MUST NOT</em>, <em class="rfc2119" title="REQUIRED">REQUIRED</em>, <em class="rfc2119" title="SHOULD">SHOULD</em>, <em class="rfc2119" title="SHOULD NOT">SHOULD NOT</em>, <em class="rfc2119" title="RECOMMENDED">RECOMMENDED</em>, <em class="rfc2119" title="MAY">MAY</em>,
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   630
  and <em class="rfc2119" title="OPTIONAL">OPTIONAL</em> in this specification are to be interpreted as described in [<cite><a class="bibref" href="#bib-RFC2119">RFC2119</a></cite>].
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   631
</p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   632
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   633
      <p>
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   634
        This specification defines conformance criteria that apply to a single
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   635
        product: the <dfn id="dfn-user-agent">user agent</dfn> that implements
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   636
        the interfaces that it contains.
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   637
      </p>
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
   638
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   639
      <p>
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   640
        Implementations that use ECMAScript to implement the APIs defined in
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   641
        this specification must implement them in a manner consistent with the
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   642
        ECMAScript Bindings defined in the Web IDL specification [<cite><a class="bibref" href="#bib-WEBIDL">WEBIDL</a></cite>] as
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   643
        this specification uses that specification and terminology.
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   644
      </p>
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
   645
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   646
      <p>
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   647
        A conforming implementation is required to implement all fields
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   648
        defined in this specification.
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   649
      </p>
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   650
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   651
      <p>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   652
        WindowProxy is defined in [<cite><a class="bibref" href="#bib-HTML5">HTML5</a></cite>].
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   653
      </p>
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
   654
    </section>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
   655
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   656
    <section id="touch-interface">
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   657
      <!--OddPage--><h2><span class="secno">3. </span><a href="#idl-def-Touch" class="idlType"><code>Touch</code></a> Interface</h2>
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   658
      <p>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   659
        This interface describes an individual <a href="#dfn-touch-point" class="internalDFN">touch point</a> for a touch
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   660
        event.  <a href="#idl-def-Touch" class="idlType"><code>Touch</code></a> objects are immutable; after one is created, its
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   661
        attributes must not change.
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   662
      </p>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
   663
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   664
      <pre class="idl"><span class="idlInterface" id="idl-def-Touch">interface <span class="idlInterfaceID">Touch</span> {
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   665
<span class="idlAttribute">    readonly    attribute <span class="idlAttrType"><a>long</a></span>        <span class="idlAttrName"><a href="#widl-Touch-identifier">identifier</a></span>;</span>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   666
<span class="idlAttribute">    readonly    attribute <span class="idlAttrType"><a>EventTarget</a></span> <span class="idlAttrName"><a href="#widl-Touch-target">target</a></span>;</span>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   667
<span class="idlAttribute">    readonly    attribute <span class="idlAttrType"><a>long</a></span>        <span class="idlAttrName"><a href="#widl-Touch-screenX">screenX</a></span>;</span>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   668
<span class="idlAttribute">    readonly    attribute <span class="idlAttrType"><a>long</a></span>        <span class="idlAttrName"><a href="#widl-Touch-screenY">screenY</a></span>;</span>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   669
<span class="idlAttribute">    readonly    attribute <span class="idlAttrType"><a>long</a></span>        <span class="idlAttrName"><a href="#widl-Touch-clientX">clientX</a></span>;</span>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   670
<span class="idlAttribute">    readonly    attribute <span class="idlAttrType"><a>long</a></span>        <span class="idlAttrName"><a href="#widl-Touch-clientY">clientY</a></span>;</span>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   671
<span class="idlAttribute">    readonly    attribute <span class="idlAttrType"><a>long</a></span>        <span class="idlAttrName"><a href="#widl-Touch-pageX">pageX</a></span>;</span>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   672
<span class="idlAttribute">    readonly    attribute <span class="idlAttrType"><a>long</a></span>        <span class="idlAttrName"><a href="#widl-Touch-pageY">pageY</a></span>;</span>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   673
};</span></pre><section id="attributes"><h3><span class="secno">3.1 </span>Attributes</h3><dl class="attributes"><dt id="widl-Touch-clientX"><code>clientX</code> of type <span class="idlAttrType"><a>long</a></span>, readonly   </dt><dd>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   674
          The horizontal coordinate of point relative to the viewport in pixels,
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   675
          excluding any scroll offset
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   676
        </dd><dt id="widl-Touch-clientY"><code>clientY</code> of type <span class="idlAttrType"><a>long</a></span>, readonly   </dt><dd>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   677
          The vertical coordinate of point relative to the viewport in pixels,
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   678
          excluding any scroll offset
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   679
        </dd><dt id="widl-Touch-identifier"><code>identifier</code> of type <span class="idlAttrType"><a>long</a></span>, readonly   </dt><dd>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   680
          An identification number for each <a href="#dfn-touch-point" class="internalDFN">touch point</a>.
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
   681
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   682
          When a touch point becomes active, it must be assigned an
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   683
          <a>identifier</a> that is distinct from any other <a href="#dfn-active-touch-point" class="internalDFN">active touch
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   684
          point</a>.  While the touch point remains active, all events that
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   685
          refer to it must assign it the same <a>identifier</a>.
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   686
        </dd><dt id="widl-Touch-pageX"><code>pageX</code> of type <span class="idlAttrType"><a>long</a></span>, readonly   </dt><dd>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   687
          The horizontal coordinate of point relative to the viewport in pixels,
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   688
          including any scroll offset
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   689
        </dd><dt id="widl-Touch-pageY"><code>pageY</code> of type <span class="idlAttrType"><a>long</a></span>, readonly   </dt><dd>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   690
          The vertical coordinate of point relative to the viewport in pixels,
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   691
          including any scroll offset
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   692
        </dd><dt id="widl-Touch-screenX"><code>screenX</code> of type <span class="idlAttrType"><a>long</a></span>, readonly   </dt><dd>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   693
          The horizontal coordinate of point relative to the screen in pixels
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   694
        </dd><dt id="widl-Touch-screenY"><code>screenY</code> of type <span class="idlAttrType"><a>long</a></span>, readonly   </dt><dd>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   695
          The vertical coordinate of point relative to the screen in pixels
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   696
        </dd><dt id="widl-Touch-target"><code>target</code> of type <span class="idlAttrType"><a>EventTarget</a></span>, readonly   </dt><dd>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   697
          The <a>EventTarget</a> on which the <a href="#dfn-touch-point" class="internalDFN">touch point</a> started when it
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   698
          was first placed on the surface, even if the <a href="#dfn-touch-point" class="internalDFN">touch point</a> has
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   699
          since moved outside the interactive area of that element.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   700
        </dd></dl></section>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   701
    </section>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   702
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   703
    <section id="touchlist-interface">
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   704
      <!--OddPage--><h2><span class="secno">4. </span><a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a> Interface</h2>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   705
      <p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   706
        This interface defines a list of individual points of contact for a
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   707
        touch event.  <a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a> objects are immutable; after one is
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   708
        created, its contents must not change.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   709
      </p>
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   710
      <p>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   711
        A TouchList object's <em>supported property indices</em> ([<cite><a class="bibref" href="#bib-WEBIDL">WEBIDL</a></cite>])
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   712
        are the numbers in the range 0 to one less than the length of the list. 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   713
      </p>
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
   714
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   715
      <pre class="idl"><span class="idlInterface" id="idl-def-TouchList">interface <span class="idlInterfaceID">TouchList</span> {
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   716
<span class="idlAttribute">    readonly    attribute <span class="idlAttrType"><a>unsigned long</a></span> <span class="idlAttrName"><a href="#widl-TouchList-length">length</a></span>;</span>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   717
<span class="idlMethod">    <span class="idlMethType"><a>getter Touch</a>?</span> <span class="idlMethName"><a href="#widl-TouchList-item-getter-Touch-unsigned-long-index">item</a></span> (<span class="idlParam"><span class="idlParamType"><a>unsigned long</a></span> <span class="idlParamName">index</span></span>);</span>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   718
};</span></pre><section id="attributes-1"><h3><span class="secno">4.1 </span>Attributes</h3><dl class="attributes"><dt id="widl-TouchList-length"><code>length</code> of type <span class="idlAttrType"><a>unsigned long</a></span>, readonly   </dt><dd>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   719
          returns the number of <a href="#idl-def-Touch" class="idlType"><code>Touch</code></a>es in the list
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   720
        </dd></dl></section><section id="methods"><h3><span class="secno">4.2 </span>Methods</h3><dl class="methods"><dt id="widl-TouchList-item-getter-Touch-unsigned-long-index"><code>item</code></dt><dd>
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   721
          returns the <a href="#idl-def-Touch" class="idlType"><code>Touch</code></a> at the specified index in the list or
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   722
          null if the index is not less than the length of the list. 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   723
        <table class="parameters"><tr><th>Parameter</th><th>Type</th><th>Nullable</th><th>Optional</th><th>Description</th></tr><tr><td class="prmName">index</td><td class="prmType"><code><a>unsigned long</a></code></td><td class="prmNullFalse">✘</td><td class="prmOptFalse">✘</td><td class="prmDesc"></td></tr></table><div><em>Return type: </em><code><a> Touch</a></code>, nullable</div></dd></dl></section>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   724
    </section>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   725
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   726
    <section id="touchevent-interface">
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   727
      <!--OddPage--><h2><span class="secno">5. </span><a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a> Interface</h2>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   728
      <p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   729
        This interface defines the <a href="#dfn-touchstart" class="internalDFN">touchstart</a>, <a href="#dfn-touchend" class="internalDFN">touchend</a>,
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   730
        <a href="#dfn-touchmove" class="internalDFN">touchmove</a>, and <a href="#dfn-touchcancel" class="internalDFN">touchcancel</a> event types.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   731
        <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a> objects are immutable; after one is created and
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   732
        initialized, its attributes must not change.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   733
      </p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   734
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   735
      <pre class="idl"><span class="idlInterface" id="idl-def-TouchEvent">interface <span class="idlInterfaceID">TouchEvent</span> : <span class="idlSuperclass"><a>UIEvent</a></span> {
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   736
<span class="idlAttribute">    readonly    attribute <span class="idlAttrType"><a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a></span> <span class="idlAttrName"><a href="#widl-TouchEvent-touches">touches</a></span>;</span>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   737
<span class="idlAttribute">    readonly    attribute <span class="idlAttrType"><a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a></span> <span class="idlAttrName"><a href="#widl-TouchEvent-targetTouches">targetTouches</a></span>;</span>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   738
<span class="idlAttribute">    readonly    attribute <span class="idlAttrType"><a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a></span> <span class="idlAttrName"><a href="#widl-TouchEvent-changedTouches">changedTouches</a></span>;</span>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   739
<span class="idlAttribute">    readonly    attribute <span class="idlAttrType"><a>boolean</a></span>   <span class="idlAttrName"><a href="#widl-TouchEvent-altKey">altKey</a></span>;</span>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   740
<span class="idlAttribute">    readonly    attribute <span class="idlAttrType"><a>boolean</a></span>   <span class="idlAttrName"><a href="#widl-TouchEvent-metaKey">metaKey</a></span>;</span>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   741
<span class="idlAttribute">    readonly    attribute <span class="idlAttrType"><a>boolean</a></span>   <span class="idlAttrName"><a href="#widl-TouchEvent-ctrlKey">ctrlKey</a></span>;</span>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   742
<span class="idlAttribute">    readonly    attribute <span class="idlAttrType"><a>boolean</a></span>   <span class="idlAttrName"><a href="#widl-TouchEvent-shiftKey">shiftKey</a></span>;</span>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   743
};</span></pre><section id="attributes-2"><h3><span class="secno">5.1 </span>Attributes</h3><dl class="attributes"><dt id="widl-TouchEvent-altKey"><code>altKey</code> of type <span class="idlAttrType"><a>boolean</a></span>, readonly   </dt><dd>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   744
          <code>true</code> if the alt (Alternate) key modifier is activated;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   745
          otherwise <code>false</code>
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   746
        </dd><dt id="widl-TouchEvent-changedTouches"><code>changedTouches</code> of type <span class="idlAttrType"><a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a></span>, readonly   </dt><dd>
32
f1cd4dbbd6f8 Wrap these lines to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 31
diff changeset
   747
          <p>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   748
            a list of <a href="#idl-def-Touch" class="idlType"><code>Touch</code></a>es for every point of contact which contributed
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   749
            to the event.
32
f1cd4dbbd6f8 Wrap these lines to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 31
diff changeset
   750
          </p>
f1cd4dbbd6f8 Wrap these lines to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 31
diff changeset
   751
          <p>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   752
            For the <a href="#dfn-touchstart" class="internalDFN">touchstart</a> event this must be a list of the touch
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   753
            points that just became active with the current event.  For the
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   754
            <a href="#dfn-touchmove" class="internalDFN">touchmove</a> event this must be a list of the touch points that
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   755
            have moved since the last event.  For the <a href="#dfn-touchend" class="internalDFN">touchend</a> and 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   756
			<a href="#dfn-touchcancel" class="internalDFN">touchcancel</a> events this must be a list of the touch points 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   757
			that have just been removed from the surface.
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   758
          </p>
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   759
        </dd><dt id="widl-TouchEvent-ctrlKey"><code>ctrlKey</code> of type <span class="idlAttrType"><a>boolean</a></span>, readonly   </dt><dd>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   760
          <code>true</code> if the ctrl (Control) key modifier is activated;
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   761
          otherwise <code>false</code>
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   762
        </dd><dt id="widl-TouchEvent-metaKey"><code>metaKey</code> of type <span class="idlAttrType"><a>boolean</a></span>, readonly   </dt><dd>
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   763
          <code>true</code> if the meta (Meta) key modifier is activated;
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   764
          otherwise <code>false</code>.  On some platforms this attribute may
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   765
          map to a differently-named key modifier.
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   766
        </dd><dt id="widl-TouchEvent-shiftKey"><code>shiftKey</code> of type <span class="idlAttrType"><a>boolean</a></span>, readonly   </dt><dd>
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   767
          <code>true</code> if the shift (Shift) key modifier is activated;
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   768
          otherwise <code>false</code>
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   769
        </dd><dt id="widl-TouchEvent-targetTouches"><code>targetTouches</code> of type <span class="idlAttrType"><a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a></span>, readonly   </dt><dd>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   770
          a list of <a href="#idl-def-Touch" class="idlType"><code>Touch</code></a>es for every point of contact that is touching
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   771
          the surface <em>and</em> started on the element that is the
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   772
          <a>target</a> of the current event.
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   773
        </dd><dt id="widl-TouchEvent-touches"><code>touches</code> of type <span class="idlAttrType"><a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a></span>, readonly   </dt><dd>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   774
          a list of <a href="#idl-def-Touch" class="idlType"><code>Touch</code></a>es for every point of contact currently
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   775
          touching the surface.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   776
        </dd></dl></section>
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   777
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   778
      <section class="informative" id="touchevent-implementer-s-note">
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   779
       <h3><span class="secno">5.2 </span>TouchEvent Implementer's Note</h3><p><em>This section is non-normative.</em></p>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   780
       <div class="note"><div class="note-title" role="heading" aria-level="4"><span>Note</span></div><div class="">
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   781
        <p>User agents should ensure that all <a href="#idl-def-Touch" class="idlType"><code>Touch</code></a> objects available from a given 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   782
        <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a> are all associated to the same document that the <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a> was dispatched 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   783
        to. To implement this, user agents should maintain a notion of the current 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   784
        <em>touch-active</em> document. On first touch, this is set to the target document 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   785
        where the touch was created. When all active touch points are released, the 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   786
        <em>touch-active</em> document is cleared. All <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a>s are dispatched to the 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   787
        current <em>touch-active</em> document, and each <a href="#idl-def-Touch" class="idlType"><code>Touch</code></a> object it contains refers 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   788
        only to DOM elements (and co-ordinates) in that document. If a touch starts entirely 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   789
        outside the currently <em>touch-active</em> document, then it is ignored entirely. </p>
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   790
       </div></div> 
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   791
      </section>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   792
      
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   793
      <section class="informative" id="usage-examples">
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   794
          <h3><span class="secno">5.3 </span>Usage Examples</h3><p><em>This section is non-normative.</em></p>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   795
          
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   796
          <p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   797
            The examples below demonstrate the relations between the different
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   798
            <a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a> members defined in a <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a>.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   799
          </p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   800
          
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   801
          <section id="touches-and-targettouches-of-a-touchevent">
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   802
              <h4><span class="secno">5.3.1 </span>touches and targetTouches of a <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a></h4><p><em>This section is non-normative.</em></p>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   803
              
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   804
              <p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   805
                This example demonstrates the utility and relations between the
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   806
                touches and targetTouches members defined in the <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   807
                interface. The following code will generate different output based
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   808
                on the number of touch points on the touchable element and the document:
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   809
              </p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   810
      
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   811
              <div class="example"><div class="example-title"><span>Example 1</span></div><pre class="example">&lt;div id='touchable'&gt;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   812
    This element is touchable.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   813
&lt;/div&gt;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   814
          
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   815
document.getElementById('touchable').addEventListener('touchstart', function(ev) {
30
795c0f6c44e7 ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents: 29
diff changeset
   816
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   817
    if (ev.touches.item(0) == ev.targetTouches.item(0))
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   818
    {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   819
        /**
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   820
         * If the first touch on the surface is also targeting the
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   821
         * "touchable" element, the code below should execute.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   822
         * Since targetTouches is a subset of touches which covers the
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   823
         * entire surface, TouchEvent.touches &gt;= TouchEvents.targetTouches
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   824
         * is always true.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   825
         */
8
3349d49e5f46 added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents: 7
diff changeset
   826
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   827
        document.write('Hello Touch Events!');
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   828
    }
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   829
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   830
    if (ev.touches.length == ev.targetTouches.length)
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   831
    {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   832
        /**
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   833
         * If all of the active touch points are on the "touchable"
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   834
         * element, the length properties should be the same.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   835
         */
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   836
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   837
        document.write('All points are on target element')
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   838
    }
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   839
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   840
    if (ev.touches.length &gt; 1)
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   841
    {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   842
        /**
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   843
         * On a single touch input device, there can only be one point
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   844
         * of contact on the surface, so the following code can only
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   845
         * execute when the terminal supports multiple touches.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   846
         */
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   847
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   848
        document.write('Hello Multiple Touch!');
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   849
    }
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   850
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   851
}, false);</pre></div>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   852
          </section>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   853
          
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   854
          <section id="changedtouches-of-a-touchevent">
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   855
              <h4><span class="secno">5.3.2 </span>changedTouches of a <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a></h4>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   856
              
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   857
              <p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   858
                This example demonstrates the utility of changedTouches and it's relation
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   859
                with the other <a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a> members of the <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a> interface.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   860
                The code is a example which triggers whenever a touch point is removed
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   861
                from the defined touchable element:
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   862
              </p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   863
              
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   864
              <div class="example"><div class="example-title"><span>Example 2</span></div><pre class="example">&lt;div id='touchable'&gt;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   865
    This element is touchable.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   866
&lt;/div&gt;
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   867
              
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   868
document.getElementById('touchable').addEventListener('touchend', function(ev) {
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   869
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   870
    /**
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   871
     * Example output when three touch points are on the surface,
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   872
     * two of them being on the "touchable" element and one point
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   873
     * in the "touchable" element is lifted from the surface:
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   874
     *
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   875
     * Touch points removed: 1
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   876
     * Touch points left on element: 1
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   877
     * Touch points left on document: 2
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   878
     */
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   879
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   880
    document.write('Removed: ' + ev.changedTouches.length);
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   881
    document.write('Remaining on element: ' + ev.targetTouches.length);
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   882
    document.write('Remaining on document: ' + ev.touches.length);
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   883
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   884
}, false);</pre></div>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   885
          </section>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   886
              
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   887
      </section>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   888
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   889
      <section class="informative" id="list-of-touchevent-types">
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   890
          <h3><span class="secno">5.4 </span>List of <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a> types</h3><p><em>This section is non-normative.</em></p>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   891
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   892
          <p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   893
            The following table provides a summary of the types of possible
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   894
            <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a> types defined in this specification. All events
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   895
            should accomplish the bubbling phase. Some events are not cancelable
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   896
            (see <a href="#dfn-preventdefault" class="internalDFN">preventDefault</a>).
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   897
          </p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   898
          
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   899
          <!--
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   900
          // FIXME: As of the time of writing, respec.js doesn't have support for
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   901
          // tables like this - we're just piggybacking on a existing class, with
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   902
          // raw markup as a quick and dirty workaround.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   903
          -->
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   904
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   905
          <table class="parameters" id="table-event-summary">
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   906
          <tbody><tr>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   907
              <th>Event Type</th>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   908
              <th>Sync / Async</th>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   909
              <th>Bubbling phase</th>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   910
              <th>Trusted proximal event target types</th>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   911
              <th>DOM interface</th>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   912
              <th>Cancelable</th>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   913
              <th>Default Action</th>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   914
          </tr>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   915
          <tr> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   916
              <td><a href="#dfn-touchstart" class="internalDFN">touchstart</a></td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   917
              <td>Sync</td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   918
              <td>Yes</td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   919
              <td><code>Document, Element</code></td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   920
              <td><a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a></td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   921
              <td>Yes</td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   922
              <td>undefined</td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   923
          </tr>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   924
          <tr> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   925
              <td><a href="#dfn-touchend" class="internalDFN">touchend</a></td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   926
              <td>Sync</td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   927
              <td>Yes</td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   928
              <td><code>Document, Element</code></td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   929
              <td><a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a></td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   930
              <td>Yes</td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   931
              <td>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   932
                Varies: mousemove (If point has been moved), mousedown, 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   933
                mouseup, click
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   934
              </td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   935
          </tr>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   936
          <tr> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   937
              <td><a href="#dfn-touchmove" class="internalDFN">touchmove</a></td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   938
              <td>Sync</td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   939
              <td>Yes</td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   940
              <td><code>Document, Element</code></td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   941
              <td><a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a></td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   942
              <td>Yes</td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   943
              <td>undefined</td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   944
          </tr>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   945
          <tr> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   946
              <td><a href="#dfn-touchcancel" class="internalDFN">touchcancel</a></td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   947
              <td>Sync</td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   948
              <td>Yes</td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   949
              <td><code>Document, Element</code></td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   950
              <td><a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a></td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   951
              <td>No</td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   952
              <td>none</td> 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   953
          </tr>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   954
          </tbody></table>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   955
      </section>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   956
 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   957
      <section id="the-touchstart-event">
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   958
        <h3 id="event-touchstart"><span class="secno">5.5 </span>The <dfn class="event" id="dfn-touchstart">touchstart</dfn>
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   959
        event</h3>
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   960
        <p>
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   961
          A user agent must dispatch this event type to indicate when the user
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   962
          places a <a href="#dfn-touch-point" class="internalDFN">touch point</a> on the touch surface.
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   963
        </p>
55
7df98116715b Clarify targeting of touchmove and touchend events, and add tests.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 54
diff changeset
   964
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   965
        <p>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   966
          The target of this event must be an <a>Element</a>.  If the touch
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   967
          point is within a frame, the event should be dispatched to an element
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   968
          in the <a>child browsing context</a> of that frame.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   969
        </p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   970
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   971
        <p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   972
          If the <a href="#dfn-preventdefault" class="internalDFN">preventDefault</a> method is called on this event, it
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   973
          should prevent any default actions caused by any touch events
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   974
          associated with the same <a href="#dfn-active-touch-point" class="internalDFN">active touch point</a>, including mouse
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   975
          events or scrolling.
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   976
        </p>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
   977
      </section>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
   978
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   979
      <section id="the-touchend-event">
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
   980
        <h3 id="event-touchend"><span class="secno">5.6 </span>The <dfn class="event" id="dfn-touchend">touchend</dfn> event</h3>
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   981
        <p>
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   982
          A user agent must dispatch this event type to indicate when the user
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   983
          removes a <a href="#dfn-touch-point" class="internalDFN">touch point</a> from the touch surface, also including
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   984
          cases where the touch point physically leaves the touch surface, such
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   985
          as being dragged off of the screen.
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   986
        </p>
54
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
   987
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   988
        <p>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   989
          The <a>target</a> of this event must be the same <a>Element</a> on 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   990
		  which the <a href="#dfn-touch-point" class="internalDFN">touch point</a> started when it was first
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   991
          placed on the surface, even if the <a href="#dfn-touch-point" class="internalDFN">touch point</a> has since moved
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   992
          outside the interactive area of the <a>target</a> element.
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   993
        </p>
55
7df98116715b Clarify targeting of touchmove and touchend events, and add tests.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 54
diff changeset
   994
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   995
        <p>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   996
          The <a href="#dfn-touch-point" class="internalDFN">touch point</a> or points that were removed must be included
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
   997
          in the <a>changedTouches</a> attribute of the <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a>, and
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   998
          must not be included in the <a>touches</a> and <a>targetTouches</a>
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
   999
          attributes.
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1000
        </p>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
  1001
      </section>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
  1002
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1003
      <section id="the-touchmove-event">
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
  1004
        <h3 id="event-touchmove"><span class="secno">5.7 </span>The <dfn class="event" id="dfn-touchmove">touchmove</dfn> event</h3>
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1005
        <p>
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1006
          A user agent must dispatch this event type to indicate when the user
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1007
          moves a <a href="#dfn-touch-point" class="internalDFN">touch point</a> along the touch surface.
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1008
        </p>
54
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
  1009
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1010
        <p>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1011
          The <a>target</a> of this event must be the same <a>Element</a> on 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1012
		  which the <a href="#dfn-touch-point" class="internalDFN">touch point</a> started when it was first
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1013
          placed on the surface, even if the <a href="#dfn-touch-point" class="internalDFN">touch point</a> has since moved
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1014
          outside the interactive area of the <a>target</a> element.
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1015
        </p>
54
be35b766b5ef Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 53
diff changeset
  1016
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1017
        <p>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1018
          Note that the rate at which the user agent sends <a href="#dfn-touchmove" class="internalDFN">touchmove</a>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1019
          events is implementation-defined, and may depend on hardware
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1020
          capabilities and other implementation details.
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1021
        </p>
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1022
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1023
        <p>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1024
          If the <a href="#dfn-preventdefault" class="internalDFN">preventDefault</a> method is called on the <em>first</em>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1025
          <a href="#dfn-touchmove" class="internalDFN">touchmove</a> event of an <a href="#dfn-active-touch-point" class="internalDFN">active touch point</a>, it should
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1026
          prevent any default action caused by any <a href="#dfn-touchmove" class="internalDFN">touchmove</a> event
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1027
          associated with the same <a href="#dfn-active-touch-point" class="internalDFN">active touch point</a>, such as scrolling.
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1028
        </p>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
  1029
      </section>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
  1030
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1031
      <section id="the-touchcancel-event">
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
  1032
        <h3 id="event-touchcancel"><span class="secno">5.8 </span>The <dfn class="event" id="dfn-touchcancel">touchcancel</dfn> event</h3>
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1033
        <p>
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1034
          A user agent must dispatch this event type to indicate when a touch
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1035
          point has been disrupted in an implementation-specific manner, such as
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1036
          a synchronous event or action originating from the UA canceling the
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1037
          touch, or the touch point leaving the document window into a
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1038
          non-document area which is capable of handling user interactions.
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1039
          (e.g. The UA's native user interface, plug-ins)  A user agent may
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1040
          also dispatch this event type when the user places more <a href="#dfn-touch-point" class="internalDFN">touch
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1041
          point</a>s on the touch surface than the device or implementation is
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1042
          configured to store, in which case the earliest <a href="#idl-def-Touch" class="idlType"><code>Touch</code></a> object
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1043
          in the <a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a> should be removed.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1044
        </p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1045
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1046
        <p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1047
          The <a>target</a> of this event must be the same <a>Element</a> on 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1048
		  which the <a href="#dfn-touch-point" class="internalDFN">touch point</a> started when it was first
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1049
          placed on the surface, even if the <a href="#dfn-touch-point" class="internalDFN">touch point</a> has since moved
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1050
          outside the interactive area of the <a>target</a> element.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1051
        </p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1052
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1053
        <p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1054
          The <a href="#dfn-touch-point" class="internalDFN">touch point</a> or points that were removed must be included
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1055
          in the <a>changedTouches</a> attribute of the <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a>, and
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1056
          must not be included in the <a>touches</a> and <a>targetTouches</a>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1057
          attributes.
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1058
        </p>
5
e4446bce8960 First draft, using WebKit model
shepazu <schepers@w3.org>
parents: 4
diff changeset
  1059
      </section>
4
dda9bf4072d0 testing hg with Murky
shepazu <schepers@w3.org>
parents:
diff changeset
  1060
    </section>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
  1061
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1062
    <section id="extensions-to-the-document-interface">
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1063
      <!--OddPage--><h2><span class="secno">6. </span>Extensions to the <a href="#idl-def-Document" class="idlType"><code>Document</code></a> Interface</h2>
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1064
      <p>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1065
        The <a href="#idl-def-Document" class="idlType"><code>Document</code></a> interface [<cite><a class="bibref" href="#bib-DOM-LEVEL-3-CORE">DOM-LEVEL-3-CORE</a></cite>] contains methods
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1066
        by which the user can create <a href="#idl-def-Touch" class="idlType"><code>Touch</code></a> and <a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1067
        objects.
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1068
      </p>
68
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
  1069
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1070
      <pre class="idl"><span class="idlInterface" id="idl-def-Document">partial interface <span class="idlInterfaceID">Document</span> {
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
  1071
<span class="idlMethod">    <span class="idlMethType"><a href="#idl-def-Touch" class="idlType"><code>Touch</code></a></span>     <span class="idlMethName"><a href="#widl-Document-createTouch-Touch-WindowProxy-view-EventTarget-target-long-identifier-long-pageX-long-pageY-long-screenX-long-screenY">createTouch</a></span> (<span class="idlParam"><span class="idlParamType"><a>WindowProxy</a></span> <span class="idlParamName">view</span></span>, <span class="idlParam"><span class="idlParamType"><a>EventTarget</a></span> <span class="idlParamName">target</span></span>, <span class="idlParam"><span class="idlParamType"><a>long</a></span> <span class="idlParamName">identifier</span></span>, <span class="idlParam"><span class="idlParamType"><a>long</a></span> <span class="idlParamName">pageX</span></span>, <span class="idlParam"><span class="idlParamType"><a>long</a></span> <span class="idlParamName">pageY</span></span>, <span class="idlParam"><span class="idlParamType"><a>long</a></span> <span class="idlParamName">screenX</span></span>, <span class="idlParam"><span class="idlParamType"><a>long</a></span> <span class="idlParamName">screenY</span></span>);</span>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1072
<span class="idlMethod">    <span class="idlMethType"><a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a></span> <span class="idlMethName"><a href="#widl-Document-createTouchList-TouchList-Touch-touches">createTouchList</a></span> (<span class="idlParam">optional <span class="idlParamType"><a href="#idl-def-Touch" class="idlType"><code>Touch</code></a>...</span> <span class="idlParamName">touches</span></span>);</span>
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
  1073
};</span></pre><section id="methods-1"><h3><span class="secno">6.1 </span>Methods</h3><dl class="methods"><dt id="widl-Document-createTouch-Touch-WindowProxy-view-EventTarget-target-long-identifier-long-pageX-long-pageY-long-screenX-long-screenY"><code>createTouch</code></dt><dd>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1074
          Creates a <a href="#idl-def-Touch" class="idlType"><code>Touch</code></a> object with the specified attributes.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1075
          
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
  1076
        <table class="parameters"><tr><th>Parameter</th><th>Type</th><th>Nullable</th><th>Optional</th><th>Description</th></tr><tr><td class="prmName">view</td><td class="prmType"><code><a>WindowProxy</a></code></td><td class="prmNullFalse">✘</td><td class="prmOptFalse">✘</td><td class="prmDesc"></td></tr><tr><td class="prmName">target</td><td class="prmType"><code><a>EventTarget</a></code></td><td class="prmNullFalse">✘</td><td class="prmOptFalse">✘</td><td class="prmDesc"></td></tr><tr><td class="prmName">identifier</td><td class="prmType"><code><a>long</a></code></td><td class="prmNullFalse">✘</td><td class="prmOptFalse">✘</td><td class="prmDesc"></td></tr><tr><td class="prmName">pageX</td><td class="prmType"><code><a>long</a></code></td><td class="prmNullFalse">✘</td><td class="prmOptFalse">✘</td><td class="prmDesc"></td></tr><tr><td class="prmName">pageY</td><td class="prmType"><code><a>long</a></code></td><td class="prmNullFalse">✘</td><td class="prmOptFalse">✘</td><td class="prmDesc"></td></tr><tr><td class="prmName">screenX</td><td class="prmType"><code><a>long</a></code></td><td class="prmNullFalse">✘</td><td class="prmOptFalse">✘</td><td class="prmDesc"></td></tr><tr><td class="prmName">screenY</td><td class="prmType"><code><a>long</a></code></td><td class="prmNullFalse">✘</td><td class="prmOptFalse">✘</td><td class="prmDesc"></td></tr></table><div><em>Return type: </em><code><a href="#idl-def-Touch" class="idlType"><code>Touch</code></a></code></div></dd><dt id="widl-Document-createTouchList-TouchList-Touch-touches"><code>createTouchList</code></dt><dd>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1077
          Creates a <a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a> object consisting of zero or more <a href="#idl-def-Touch" class="idlType"><code>Touch</code></a> objects.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1078
          Calling this method with no arguments creates a <a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a> with no objects in it 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1079
          and length 0 (zero). 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1080
          
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1081
        <table class="parameters"><tr><th>Parameter</th><th>Type</th><th>Nullable</th><th>Optional</th><th>Description</th></tr><tr><td class="prmName">touches</td><td class="prmType"><code><a href="#idl-def-Touch" class="idlType"><code>Touch</code></a></code></td><td class="prmNullFalse">✘</td><td class="prmOptTrue">✔</td><td class="prmDesc"></td></tr></table><div><em>Return type: </em><code><a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a></code></div></dd></dl></section>
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
  1082
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
  1083
      <div class="note"><div class="note-title" role="heading" aria-level="3"><span>Note</span></div><p class="">
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
  1084
        Some user agents implement an initTouchEvent method as part of the
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
  1085
        <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a> interface.  When this method is available, scripts
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
  1086
        can use it to initialize the properties of a <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a> object,
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
  1087
        including its <a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a> properties (which can be initialized
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
  1088
        with values returned from <a>createTouchList</a>).  The
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
  1089
        <a>initTouchEvent</a> method is not yet standardized, but it may appear
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
  1090
        in some form in a future specification.
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
  1091
      </p></div>
68
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
  1092
    </section>
e8bb9dc16d4e Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 66
diff changeset
  1093
35
8624a3d5cbd7 ISSUE-9: Interaction of touch events and mouse events
Matt Brubeck <mbrubeck@mozilla.com>
parents: 34
diff changeset
  1094
    <section id="mouse-events">
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1095
      <!--OddPage--><h2><span class="secno">7. </span>Interaction with Mouse Events</h2>
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1096
      <p>
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1097
        The user agent may dispatch both touch events and mouse events
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1098
        [<cite><a class="bibref" href="#bib-DOM-LEVEL-2-EVENTS">DOM-LEVEL-2-EVENTS</a></cite>] in response to the same user input.  If the
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1099
        user agent dispatches both touch events and mouse events in response to
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1100
        a single user action, then the <a href="#dfn-touchstart" class="internalDFN">touchstart</a> event type must be
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1101
        dispatched before any mouse event types for that action.  If the
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1102
        <a href="#dfn-preventdefault" class="internalDFN">preventDefault</a> method of <a href="#dfn-touchstart" class="internalDFN">touchstart</a> or <a href="#dfn-touchmove" class="internalDFN">touchmove</a>
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1103
        is called, the user agent should not dispatch any mouse event that
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1104
        would be a consequential result of the the prevented touch event.
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1105
      </p>
58
22e39e76033e Specify basic preventDefault behavior.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 57
diff changeset
  1106
204
18427612773e Proposed Recommendation of Touch Events v1
Art Barstow <art.barstow@nokia.com>
parents: 181
diff changeset
  1107
      <div class="note"><div class="note-title" role="heading" aria-level="3"><span>Note</span></div><p class="">
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1108
        If a Web application can process touch events, it can intercept them, 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1109
        and no corresponding mouse events would need to be dispatched by the 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1110
        user agent. If the Web application is not specifically written for 
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1111
        touch input devices, it can react to the subsequent mouse events instead.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1112
      </p></div>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1113
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1114
      <p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1115
        If the user agent intreprets a sequence of touch events as a click,
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1116
        then it should dispatch <a>mousemove</a>, <a>mousedown</a>,
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1117
        <a>mouseup</a>, and <a>click</a> events (in that order) at the location
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1118
        of the <a href="#dfn-touchend" class="internalDFN">touchend</a> event for the corresponding touch input.  If the
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1119
        contents of the document have changed during processing of the touch
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1120
        events, then the user agent may dispatch the mouse events to a
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1121
        different target than the touch events.
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1122
      </p>
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1123
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1124
      <p>
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1125
        The default actions and ordering of any further touch and mouse events
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1126
        are implementation-defined, except as specified elsewhere.
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1127
      </p>
35
8624a3d5cbd7 ISSUE-9: Interaction of touch events and mouse events
Matt Brubeck <mbrubeck@mozilla.com>
parents: 34
diff changeset
  1128
    </section>
8624a3d5cbd7 ISSUE-9: Interaction of touch events and mouse events
Matt Brubeck <mbrubeck@mozilla.com>
parents: 34
diff changeset
  1129
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1130
    <section id="glossary">
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1131
      <!--OddPage--><h2><span class="secno">8. </span>Glossary</h2>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
  1132
10
bad00fb0d663 added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents: 9
diff changeset
  1133
      <dl>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1134
        <dt><dfn id="dfn-active-touch-point">active touch point</dfn></dt>
85
5c770b2dd992 Rewrapping whitespace
Josh Soref <josh.soref@nokia.com>
parents: 84
diff changeset
  1135
        <dd>
181
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1136
          A <a href="#dfn-touch-point" class="internalDFN">touch point</a> which is currently on the screen and is being
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1137
          tracked by the user agent.  The touch point becomes active when the
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1138
          user agent first dispatches a <a href="#dfn-touchstart" class="internalDFN">touchstart</a> event indicating its
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1139
          appearance.  It ceases to be active after the user agent dispatches a
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1140
          <a href="#dfn-touchend" class="internalDFN">touchend</a> or <a href="#dfn-touchcancel" class="internalDFN">touchcancel</a> event indicating that the touch
06545e9398a1 24-Jan-2013 LCWD with respec references resolved
Art Barstow <art.barstow@nokia.com>
parents: 89
diff changeset
  1141
          point is removed from the surface or no longer tracked.
10
bad00fb0d663 added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents: 9
diff changeset
  1142
        </dd>
20
3a04fe9b8ef2 Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents: 19
diff changeset
  1143