--- a/touchevents.html Mon May 02 08:07:36 2011 -0700
+++ b/touchevents.html Tue Jan 22 14:19:34 2013 -0500
@@ -1,86 +1,16 @@
<!DOCTYPE html>
<html lang="en">
- <head>
- <title>Touch Events Specification</title>
- <meta http-equiv='Content-Type' content='text/html;charset=utf-8'/>
+<head>
+ <title>Touch Events version 1</title>
+ <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
<meta name="viewport" content="width=device-width">
<!--
=== NOTA BENE ===
For the three scripts below, if your spec resides on dev.w3 you can check them
out in the same tree and use relative links so that they'll work offline,
-->
- <script src='http://dev.w3.org/2009/dap/ReSpec.js/js/respec.js' class='remove'></script>
- <script class='remove'>
- var respecConfig = {
- // specification status (e.g. WD, LCWD, NOTE, etc.). If in doubt use ED.
- specStatus: "FPWD",
-
- // the specification's short name, as in http://www.w3.org/TR/short-name/
- shortName: "touch-events",
-
- // if your specification has a subtitle that goes below the main
- // formal title, define it here
- // subtitle : "an excellent document",
-
- // if you wish the publication date to be other than today, set this
- publishDate: "2011-05-05",
-
- // if the specification's copyright date is a range of years, specify
- // the start date here:
- // copyrightStart: "2005"
-
- // if there is a previously published draft, uncomment this and set its YYYY-MM-DD date
- // and its maturity status
- // previousPublishDate: "1977-03-15",
- // previousMaturity: "WD",
-
- // if there a publicly available Editor's Draft, this is the link
- edDraftURI: "http://dvcs.w3.org/hg/webevents/raw-file/default/touchevents.html",
-
- // if this is a LCWD, uncomment and set the end of its review period
- // lcEnd: "2009-08-05",
-
- // if you want to have extra CSS, append them to this list
- // it is recommended that the respec.css stylesheet be kept
- extraCSS: ["http://www.w3.org/StyleSheets/TR/W3C-TR.css", "http://dev.w3.org/2009/dap/ReSpec.js/css/respec.css"],
-
- // editors, add as many as you like
- // only "name" is required
- editors: [
- { name: "Doug Schepers", url: "http://schepers.cc/",
- company: "W3C", companyURL: "http://w3.org/" },
- { name: "Sangwhan Moon",
- company: "Opera Software ASA", companyURL: "http://www.opera.com/" },
- { name: "Matt Brubeck",
- company: "Mozilla", companyURL: "http://www.mozilla.org/" },
- ],
-
- // authors, add as many as you like.
- // This is optional, uncomment if you have authors as well as editors.
- // only "name" is required. Same format as editors.
-
- //authors: [
- // { name: "Your Name", url: "http://example.org/",
- // company: "Your Company", companyURL: "http://example.com/" },
- //],
-
- // name of the WG
- wg: "Web Events Working Group",
-
- // URI of the public WG page
- wgURI: "http://www.w3.org/2010/webevents/",
-
- // name (with the @w3c.org) of the public mailing to which comments are due
- wgPublicList: "public-webevents",
-
- // URI of the patent status for this WG, for Rec-track documents
- // !!!! IMPORTANT !!!!
- // This is important for Rec-track documents, do not copy a patent URI from a random
- // document unless you know what you're doing. If in doubt ask your friendly neighbourhood
- // Team Contact.
- wgPatentURI: "http://www.w3.org/2004/01/pp-impl/45559/status",
- };
- </script>
+
+
<style type="text/css">
.event {
@@ -92,20 +22,546 @@
white-space: pre-wrap;
}
</style>
- </head>
- <body>
- <section id='abstract'>
- The Touch Interface specification defines a set of low-level events that
+ <style>/*****************************************************************
+ * ReSpec 3 CSS
+ * Robin Berjon - http://berjon.com/
+ *****************************************************************/
+
+/* --- INLINES --- */
+em.rfc2119 {
+ text-transform: lowercase;
+ font-variant: small-caps;
+ font-style: normal;
+ color: #900;
+}
+
+h1 acronym, h2 acronym, h3 acronym, h4 acronym, h5 acronym, h6 acronym, a acronym,
+h1 abbr, h2 abbr, h3 abbr, h4 abbr, h5 abbr, h6 abbr, a abbr {
+ border: none;
+}
+
+dfn {
+ font-weight: bold;
+}
+
+a.internalDFN {
+ color: inherit;
+ border-bottom: 1px solid #99c;
+ text-decoration: none;
+}
+
+a.externalDFN {
+ color: inherit;
+ border-bottom: 1px dotted #ccc;
+ text-decoration: none;
+}
+
+a.bibref {
+ text-decoration: none;
+}
+
+cite .bibref {
+ font-style: normal;
+}
+
+code {
+ color: #ff4500;
+}
+
+
+/* --- --- */
+ol.algorithm { counter-reset:numsection; list-style-type: none; }
+ol.algorithm li { margin: 0.5em 0; }
+ol.algorithm li:before { font-weight: bold; counter-increment: numsection; content: counters(numsection, ".") ") "; }
+
+/* --- TOC --- */
+.toc a, .tof a {
+ text-decoration: none;
+}
+
+a .secno, a .figno {
+ color: #000;
+}
+
+ul.tof, ol.tof {
+ list-style: none outside none;
+}
+
+.caption {
+ margin-top: 0.5em;
+ font-style: italic;
+}
+
+/* --- TABLE --- */
+table.simple {
+ border-spacing: 0;
+ border-collapse: collapse;
+ border-bottom: 3px solid #005a9c;
+}
+
+.simple th {
+ background: #005a9c;
+ color: #fff;
+ padding: 3px 5px;
+ text-align: left;
+}
+
+.simple th[scope="row"] {
+ background: inherit;
+ color: inherit;
+ border-top: 1px solid #ddd;
+}
+
+.simple td {
+ padding: 3px 10px;
+ border-top: 1px solid #ddd;
+}
+
+.simple tr:nth-child(even) {
+ background: #f0f6ff;
+}
+
+/* --- DL --- */
+.section dd > p:first-child {
+ margin-top: 0;
+}
+
+.section dd > p:last-child {
+ margin-bottom: 0;
+}
+
+.section dd {
+ margin-bottom: 1em;
+}
+
+.section dl.attrs dd, .section dl.eldef dd {
+ margin-bottom: 0;
+}
+</style><style>/* --- EXAMPLES --- */
+div.example-title {
+ min-width: 7.5em;
+ color: #b9ab2d;
+}
+div.example-title span {
+ text-transform: uppercase;
+}
+aside.example, div.example, div.illegal-example {
+ padding: 0.5em;
+ margin: 1em 0;
+ position: relative;
+ clear: both;
+}
+div.illegal-example { color: red }
+div.illegal-example p { color: black }
+aside.example, div.example {
+ padding: .5em;
+ border-left-width: .5em;
+ border-left-style: solid;
+ border-color: #e0cb52;
+ background: #fcfaee;
+}
+
+aside.example div.example {
+ border-left-width: .1em;
+ border-color: #999;
+ background: #fff;
+}
+aside.example div.example div.example-title {
+ color: #999;
+}
+</style><style>/* --- ISSUES/NOTES --- */
+div.issue-title, div.note-title {
+ padding-right: 1em;
+ min-width: 7.5em;
+ color: #b9ab2d;
+}
+div.issue-title { color: #e05252; }
+div.note-title { color: #52e052; }
+div.issue-title span, div.note-title span {
+ text-transform: uppercase;
+}
+div.note, div.issue {
+ margin-top: 1em;
+ margin-bottom: 1em;
+}
+.note > p:first-child, .issue > p:first-child { margin-top: 0 }
+.issue, .note {
+ padding: .5em;
+ border-left-width: .5em;
+ border-left-style: solid;
+}
+div.issue, div.note {
+ padding: 0.5em;
+ margin: 1em 0;
+ position: relative;
+ clear: both;
+}
+span.note, span.issue { padding: .1em .5em .15em; }
+
+.issue {
+ border-color: #e05252;
+ background: #fbe9e9;
+}
+.note {
+ border-color: #52e052;
+ background: #e9fbe9;
+}
+
+
+</style><style>/* --- WEB IDL --- */
+pre.idl {
+ border-top: 1px solid #90b8de;
+ border-bottom: 1px solid #90b8de;
+ padding: 1em;
+ line-height: 120%;
+}
+
+pre.idl::before {
+ content: "WebIDL";
+ display: block;
+ width: 150px;
+ background: #90b8de;
+ color: #fff;
+ font-family: initial;
+ padding: 3px;
+ font-weight: bold;
+ margin: -1em 0 1em -1em;
+}
+
+.idlType {
+ color: #ff4500;
+ font-weight: bold;
+ text-decoration: none;
+}
+
+/*.idlModule*/
+/*.idlModuleID*/
+/*.idlInterface*/
+.idlInterfaceID, .idlDictionaryID, .idlCallbackID, .idlEnumID {
+ font-weight: bold;
+ color: #005a9c;
+}
+
+.idlSuperclass {
+ font-style: italic;
+ color: #005a9c;
+}
+
+/*.idlAttribute*/
+.idlAttrType, .idlFieldType, .idlMemberType {
+ color: #005a9c;
+}
+.idlAttrName, .idlFieldName, .idlMemberName {
+ color: #ff4500;
+}
+.idlAttrName a, .idlFieldName a, .idlMemberName a {
+ color: #ff4500;
+ border-bottom: 1px dotted #ff4500;
+ text-decoration: none;
+}
+
+/*.idlMethod*/
+.idlMethType, .idlCallbackType {
+ color: #005a9c;
+}
+.idlMethName {
+ color: #ff4500;
+}
+.idlMethName a {
+ color: #ff4500;
+ border-bottom: 1px dotted #ff4500;
+ text-decoration: none;
+}
+
+/*.idlParam*/
+.idlParamType {
+ color: #005a9c;
+}
+.idlParamName, .idlDefaultValue {
+ font-style: italic;
+}
+
+.extAttr {
+ color: #666;
+}
+
+/*.idlConst*/
+.idlConstType {
+ color: #005a9c;
+}
+.idlConstName {
+ color: #ff4500;
+}
+.idlConstName a {
+ color: #ff4500;
+ border-bottom: 1px dotted #ff4500;
+ text-decoration: none;
+}
+
+/*.idlException*/
+.idlExceptionID {
+ font-weight: bold;
+ color: #c00;
+}
+
+.idlTypedefID, .idlTypedefType {
+ color: #005a9c;
+}
+
+.idlRaises, .idlRaises a.idlType, .idlRaises a.idlType code, .excName a, .excName a code {
+ color: #c00;
+ font-weight: normal;
+}
+
+.excName a {
+ font-family: monospace;
+}
+
+.idlRaises a.idlType, .excName a.idlType {
+ border-bottom: 1px dotted #c00;
+}
+
+.excGetSetTrue, .excGetSetFalse, .prmNullTrue, .prmNullFalse, .prmOptTrue, .prmOptFalse {
+ width: 45px;
+ text-align: center;
+}
+.excGetSetTrue, .prmNullTrue, .prmOptTrue { color: #0c0; }
+.excGetSetFalse, .prmNullFalse, .prmOptFalse { color: #c00; }
+
+.idlImplements a {
+ font-weight: bold;
+}
+
+dl.attributes, dl.methods, dl.constants, dl.fields, dl.dictionary-members {
+ margin-left: 2em;
+}
+
+.attributes dt, .methods dt, .constants dt, .fields dt, .dictionary-members dt {
+ font-weight: normal;
+}
+
+.attributes dt code, .methods dt code, .constants dt code, .fields dt code, .dictionary-members dt code {
+ font-weight: bold;
+ color: #000;
+ font-family: monospace;
+}
+
+.attributes dt code, .fields dt code, .dictionary-members dt code {
+ background: #ffffd2;
+}
+
+.attributes dt .idlAttrType code, .fields dt .idlFieldType code, .dictionary-members dt .idlMemberType code {
+ color: #005a9c;
+ background: transparent;
+ font-family: inherit;
+ font-weight: normal;
+ font-style: italic;
+}
+
+.methods dt code {
+ background: #d9e6f8;
+}
+
+.constants dt code {
+ background: #ddffd2;
+}
+
+.attributes dd, .methods dd, .constants dd, .fields dd, .dictionary-members dd {
+ margin-bottom: 1em;
+}
+
+table.parameters, table.exceptions {
+ border-spacing: 0;
+ border-collapse: collapse;
+ margin: 0.5em 0;
+ width: 100%;
+}
+table.parameters { border-bottom: 1px solid #90b8de; }
+table.exceptions { border-bottom: 1px solid #deb890; }
+
+.parameters th, .exceptions th {
+ color: #fff;
+ padding: 3px 5px;
+ text-align: left;
+ font-family: initial;
+ font-weight: normal;
+ text-shadow: #666 1px 1px 0;
+}
+.parameters th { background: #90b8de; }
+.exceptions th { background: #deb890; }
+
+.parameters td, .exceptions td {
+ padding: 3px 10px;
+ border-top: 1px solid #ddd;
+ vertical-align: top;
+}
+
+.parameters tr:first-child td, .exceptions tr:first-child td {
+ border-top: none;
+}
+
+.parameters td.prmName, .exceptions td.excName, .exceptions td.excCodeName {
+ width: 100px;
+}
+
+.parameters td.prmType {
+ width: 120px;
+}
+
+table.exceptions table {
+ border-spacing: 0;
+ border-collapse: collapse;
+ width: 100%;
+}
+</style><link rel="stylesheet" href="https://www.w3.org/StyleSheets/TR/W3C-WD"><!--[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>
+ <body><div class="head">
+ <p>
+
+ <a href="http://www.w3.org/"><img width="72" height="48" src="https://www.w3.org/Icons/w3c_home" alt="W3C"></a>
+
+ </p>
+ <h1 class="title" id="title">Touch Events version 1</h1>
+
+ <h2 id="w3c-working-draft-24-january-2013"><abbr title="World Wide Web Consortium">W3C</abbr> Working Draft 24 January 2013</h2>
+ <dl>
+
+ <dt>This version:</dt>
+ <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>
+ <dt>Latest published version:</dt>
+ <dd><a href="http://www.w3.org/TR/touch-events/">http://www.w3.org/TR/touch-events/</a></dd>
+
+
+ <dt>Latest editor's draft:</dt>
+ <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>
+
+
+
+
+
+ <dt>Previous version:</dt>
+ <dd><a href="http://www.w3.org/TR/2011/CR-touch-events-20111215/">http://www.w3.org/TR/2011/CR-touch-events-20111215/</a></dd>
+
+
+ <dt>Editors:</dt>
+ <dd><a href="http://schepers.cc/">Doug Schepers</a>, <a href="http://w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a></dd>
+<dd><span>Sangwhan Moon</span>, <a href="http://www.opera.com/">Opera Software ASA</a></dd>
+<dd><a href="http://limpet.net/mbrubeck/">Matt Brubeck</a>, <a href="http://www.mozilla.org/">Mozilla</a></dd>
+
+
+ </dl>
+
+
+
+
+
+ <p class="copyright">
+ <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> ©
+ 2013
+
+ <a href="http://www.w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup>
+ (<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts Institute of Technology">MIT</abbr></a>,
+ <a href="http://www.ercim.eu/"><abbr title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>,
+ <a href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved.
+ <abbr title="World Wide Web Consortium">W3C</abbr> <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
+ <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a> and
+ <a href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a> rules apply.
+ </p>
+
+
+ <hr>
+</div>
+
+
+ <section id="abstract" class="introductory"><h2>Abstract</h2><p>
+ The Touch Events specification defines a set of low-level events that
represent one or more points of contact with a touch-sensitive surface,
and changes of those points with respect to the surface and any DOM
elements displayed upon it (e.g. for touch screens) or associated with it
(e.g. for drawing tablets without displays). It also addresses
pen-tablet devices, such as drawing tablets, with consideration toward
stylus capabilities.
- </section>
+ </p></section><section id="sotd" class="introductory"><h2>Status of This Document</h2>
+
+
+
+ <p>
+ <em>This section describes the status of this document at the time of its publication. Other
+ documents may supersede this document. A list of current <abbr title="World Wide Web Consortium">W3C</abbr> publications and the latest revision
+ 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
+ index</a> at http://www.w3.org/TR/.</em>
+ </p>
+
+ This specification is the 24 January 2013 Last Call Working Draft.
+ The comment period for this Last Call Working Draft ends 14 February 2013.
- <section id='introduction' class='informative'>
- <h2>Introduction</h2>
+ The <a href="http://www.w3.org/TR/2011/CR-touch-events-20111215/">
+ 15 December 2011 Candidate Recommendation</a>
+ was returned to Last Call Working Draft because of
+ <a href="https://www.w3.org/2010/webevents/track/">issues</a>
+ found during the implementation and interoperability testing phases.
+
+ The WG will complete its
+ <a href="http://w3c-test.org/webevents/tests/touch-events-v1/">test suite</a>
+ and two or more independent implementations must pass each test before
+ the specification is published as a Proposed Recommendation.
+ The group will also create an Implementation Report.
+
+ <p>
+ This document was published by the <a href="http://www.w3.org/2010/webevents/">Web Events Working Group</a> as a Last Call Working Draft.
+
+ This document is intended to become a <abbr title="World Wide Web Consortium">W3C</abbr> Recommendation.
+
+
+ If you wish to make comments regarding this document, please send them to
+ <a href="mailto:public-webevents@w3.org">public-webevents@w3.org</a>
+ (<a href="mailto:public-webevents-request@w3.org?subject=subscribe">subscribe</a>,
+ <a href="http://lists.w3.org/Archives/Public/public-webevents/">archives</a>).
+
+ The Last Call period ends 14 February 2013.
+
+
+ All comments are welcome.
+
+
+ </p><p>
+ Publication as a Working Draft does not imply endorsement by the <abbr title="World Wide Web Consortium">W3C</abbr> Membership.
+ This is a draft document and may be updated, replaced or obsoleted by other documents at
+ any time. It is inappropriate to cite this document as other than work in progress.
+ </p>
+
+
+ <p>
+ This is a Last Call Working Draft and thus the Working Group has determined that this document has satisfied the
+ relevant technical requirements and is sufficiently stable to advance through the Technical Recommendation process.
+ </p>
+
+ <p>
+
+ This document was produced by a group operating under the
+ <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5 February 2004 <abbr title="World Wide Web Consortium">W3C</abbr> Patent Policy</a>.
+
+
+
+
+ <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>
+
+ made in connection with the deliverables of the group; that page also includes instructions for
+ disclosing a patent. An individual who has actual knowledge of a patent which the individual believes contains
+ <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#def-essential">Essential Claim(s)</a> must disclose the
+ information in accordance with <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure">section
+ 6 of the <abbr title="World Wide Web Consortium">W3C</abbr> Patent Policy</a>.
+
+
+ </p>
+
+
+
+
+</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="#usage-examples" class="tocxref"><span class="secno">5.2 </span>Usage Examples</a><ul class="toc"><li class="tocline"><a href="#touches-and-targettouches-of-a-touchevent" class="tocxref"><span class="secno">5.2.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.2.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.3 </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.4 </span>The <span class="event">touchstart</span>
+ event</a></li><li class="tocline"><a href="#the-touchend-event" class="tocxref"><span class="secno">5.5 </span>The <span class="event">touchend</span> event</a></li><li class="tocline"><a href="#the-touchmove-event" class="tocxref"><span class="secno">5.6 </span>The <span class="event">touchmove</span> event</a></li><li class="tocline"><a href="#the-touchcancel-event" class="tocxref"><span class="secno">5.7 </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="#references" class="tocxref"><span class="secno">B. </span>References</a><ul class="toc"><li class="tocline"><a href="#normative-references" class="tocxref"><span class="secno">B.1 </span>Normative references</a></li></ul></li></ul></section>
+
+ <section id="introduction" class="informative">
+ <!--OddPage--><h2><span class="secno">1. </span>Introduction</h2><p><em>This section is non-normative.</em></p>
<p>
User Agents that run on terminals which provide touch input to use web
@@ -130,7 +586,17 @@
</p>
</section>
- <section id='conformance'>
+ <section id="conformance"><!--OddPage--><h2><span class="secno">2. </span>Conformance</h2>
+<p>
+ As well as sections marked as non-normative, all authoring guidelines, diagrams, examples,
+ and notes in this specification are non-normative. Everything else in this specification is
+ normative.
+</p>
+<p>
+ 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>,
+ 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>].
+</p>
+
<p>
This specification defines conformance criteria that apply to a single
product: the <dfn id="dfn-user-agent">user agent</dfn> that implements
@@ -140,7 +606,7 @@
<p>
Implementations that use ECMAScript to implement the APIs defined in
this specification must implement them in a manner consistent with the
- ECMAScript Bindings defined in the Web IDL specification [[!WEBIDL]] as
+ ECMAScript Bindings defined in the Web IDL specification [<cite><a class="bibref" href="#bib-WEBIDL">WEBIDL</a></cite>] as
this specification uses that specification and terminology.
</p>
@@ -150,312 +616,363 @@
</p>
</section>
- <section>
- <h2><a>Touch</a> Interface</h2>
+ <section id="touch-interface">
+ <!--OddPage--><h2><span class="secno">3. </span><a href="#idl-def-Touch" class="idlType"><code>Touch</code></a> Interface</h2>
<p>
- This interface defines an individual point of contact for a touch
- event.
+ This interface describes an individual <a href="#dfn-touch-point" class="internalDFN">touch point</a> for a touch
+ event. <a href="#idl-def-Touch" class="idlType"><code>Touch</code></a> objects are immutable; after one is created, its
+ attributes must not change.
</p>
- <dl title='interface Touch' class='idl'>
- <dt>readonly attribute long identifier</dt>
- <dd>
- An identification number for each <a>touch point</a>, unique to that
- <a>touch point</a> per session.
-
- <p>
- The algorithm for determining the <a>identifier</a> value is as
- follows:
- </p>
- <ol>
- <li>
- if there are no other <a>active touch event session</a>s, the
- value of <a>identifier</a> must be <code>0</code>
- </li>
- <li>
- if there is at least one <a>active touch event session</a>, the
- value of <a>identifier</a> must be the lowest integer not
- currently used by any active <a>Touch</a> object in any
- <a>active touch event session</a>
- </li>
- </ol>
- </dd>
-
- <dt>readonly attribute long screenX</dt>
- <dd>
- x-coordinate of point relative to the screen
- </dd>
- <dt>readonly attribute long screenY</dt>
- <dd>
- y-coordinate of point relative to the screen
- </dd>
+ <pre class="idl"><span class="idlInterface" id="idl-def-Touch">interface <span class="idlInterfaceID">Touch</span> {
+<span class="idlAttribute"> readonly attribute <span class="idlAttrType"><a>long</a></span> <span class="idlAttrName"><a href="#widl-Touch-identifier">identifier</a></span>;</span>
+<span class="idlAttribute"> readonly attribute <span class="idlAttrType"><a>EventTarget</a></span> <span class="idlAttrName"><a href="#widl-Touch-target">target</a></span>;</span>
+<span class="idlAttribute"> readonly attribute <span class="idlAttrType"><a>long</a></span> <span class="idlAttrName"><a href="#widl-Touch-screenX">screenX</a></span>;</span>
+<span class="idlAttribute"> readonly attribute <span class="idlAttrType"><a>long</a></span> <span class="idlAttrName"><a href="#widl-Touch-screenY">screenY</a></span>;</span>
+<span class="idlAttribute"> readonly attribute <span class="idlAttrType"><a>long</a></span> <span class="idlAttrName"><a href="#widl-Touch-clientX">clientX</a></span>;</span>
+<span class="idlAttribute"> readonly attribute <span class="idlAttrType"><a>long</a></span> <span class="idlAttrName"><a href="#widl-Touch-clientY">clientY</a></span>;</span>
+<span class="idlAttribute"> readonly attribute <span class="idlAttrType"><a>long</a></span> <span class="idlAttrName"><a href="#widl-Touch-pageX">pageX</a></span>;</span>
+<span class="idlAttribute"> readonly attribute <span class="idlAttrType"><a>long</a></span> <span class="idlAttrName"><a href="#widl-Touch-pageY">pageY</a></span>;</span>
+};</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>
+ The horizontal coordinate of point relative to the viewport in pixels,
+ excluding any scroll offset
+ </dd><dt id="widl-Touch-clientY"><code>clientY</code> of type <span class="idlAttrType"><a>long</a></span>, readonly</dt><dd>
+ The vertical coordinate of point relative to the viewport in pixels,
+ excluding any scroll offset
+ </dd><dt id="widl-Touch-identifier"><code>identifier</code> of type <span class="idlAttrType"><a>long</a></span>, readonly</dt><dd>
+ An identification number for each <a href="#dfn-touch-point" class="internalDFN">touch point</a>.
- <dt>readonly attribute long clientX</dt>
- <dd>
- x-coordinate of point relative to the viewport, excluding any scroll
- offset
- </dd>
- <dt>readonly attribute long clientY</dt>
- <dd>
- y-coordinate of point relative to the viewport, excluding any scroll
- offset
- </dd>
-
- <dt>readonly attribute long pageX</dt>
- <dd>
- x-coordinate of point relative to the viewport, including any scroll
- offset
- </dd>
- <dt>readonly attribute long pageY</dt>
- <dd>
- y-coordinate of point relative to the viewport, including any scroll
- offset
- </dd>
+ When a touch point becomes active, it must be assigned an
+ <a>identifier</a> that is distinct from any other <a href="#dfn-active-touch-point" class="internalDFN">active touch
+ point</a>. While the touch point remains active, all events that
+ refer to it must assign it the same <a>identifier</a>.
+ </dd><dt id="widl-Touch-pageX"><code>pageX</code> of type <span class="idlAttrType"><a>long</a></span>, readonly</dt><dd>
+ The horizontal coordinate of point relative to the viewport in pixels,
+ including any scroll offset
+ </dd><dt id="widl-Touch-pageY"><code>pageY</code> of type <span class="idlAttrType"><a>long</a></span>, readonly</dt><dd>
+ The vertical coordinate of point relative to the viewport in pixels,
+ including any scroll offset
+ </dd><dt id="widl-Touch-screenX"><code>screenX</code> of type <span class="idlAttrType"><a>long</a></span>, readonly</dt><dd>
+ The horizontal coordinate of point relative to the screen in pixels
+ </dd><dt id="widl-Touch-screenY"><code>screenY</code> of type <span class="idlAttrType"><a>long</a></span>, readonly</dt><dd>
+ The vertical coordinate of point relative to the screen in pixels
+ </dd><dt id="widl-Touch-target"><code>target</code> of type <span class="idlAttrType"><a>EventTarget</a></span>, readonly</dt><dd>
+ The <a>Element</a> on which the <a href="#dfn-touch-point" class="internalDFN">touch point</a> started when it
+ was first placed on the surface, even if the <a href="#dfn-touch-point" class="internalDFN">touch point</a> has
+ since moved outside the interactive area of that element.
+ </dd></dl></section>
+ </section>
- <dt>readonly attribute long radiusX</dt>
- <dd>
- the radius of the ellipse which most closely circumscribes the
- touching area (e.g. finger, stylus) along the x-axis, in pixels of
- the same scale as <a>screenX</a>; <code>1</code> if no value is
- known. The value must be positive.
- <p class="issue" id="issue-units"><strong>Issue:</strong> What are
- units of radiusX/radiusY? CSS Pixels?</p>
- </dd>
- <dt>readonly attribute long radiusY</dt>
- <dd>
- the radius of the ellipse which most closely circumscribes the
- touching area (e.g. finger, stylus) along the y-axis, in pixels of
- the same scale as <a>screenY</a>; <code>1</code> if no value is
- known. The value must be positive.
- </dd>
+ <section id="touchlist-interface">
+ <!--OddPage--><h2><span class="secno">4. </span><a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a> Interface</h2>
+ <p>
+ This interface defines a list of individual points of contact for a
+ touch event. <a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a> objects are immutable; after one is
+ created, its contents must not change.
+ </p>
- <dt>readonly attribute float rotationAngle</dt>
- <dd>
+ <pre class="idl"><span class="idlInterface" id="idl-def-TouchList">interface <span class="idlInterfaceID">TouchList</span> {
+<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>
+<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>
+};</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>
+ returns the number of <a href="#idl-def-Touch" class="idlType"><code>Touch</code></a>es in the list
+ </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>
+ returns the <a href="#idl-def-Touch" class="idlType"><code>Touch</code></a> at the specified index in the list
+ <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>getter Touch</a></code></div></dd></dl></section>
+ </section>
+
+ <section id="touchevent-interface">
+ <!--OddPage--><h2><span class="secno">5. </span><a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a> Interface</h2>
+ <p>
+ This interface defines the <a href="#dfn-touchstart" class="internalDFN">touchstart</a>, <a href="#dfn-touchend" class="internalDFN">touchend</a>,
+ <a href="#dfn-touchmove" class="internalDFN">touchmove</a>, and <a href="#dfn-touchcancel" class="internalDFN">touchcancel</a> event types.
+ <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a> objects are immutable; after one is created and
+ initialized, its attributes must not change.
+ </p>
+
+ <pre class="idl"><span class="idlInterface" id="idl-def-TouchEvent">interface <span class="idlInterfaceID">TouchEvent</span> : <span class="idlSuperclass"><a>UIEvent</a></span> {
+<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>
+<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>
+<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>
+<span class="idlAttribute"> readonly attribute <span class="idlAttrType"><a>boolean</a></span> <span class="idlAttrName"><a href="#widl-TouchEvent-altKey">altKey</a></span>;</span>
+<span class="idlAttribute"> readonly attribute <span class="idlAttrType"><a>boolean</a></span> <span class="idlAttrName"><a href="#widl-TouchEvent-metaKey">metaKey</a></span>;</span>
+<span class="idlAttribute"> readonly attribute <span class="idlAttrType"><a>boolean</a></span> <span class="idlAttrName"><a href="#widl-TouchEvent-ctrlKey">ctrlKey</a></span>;</span>
+<span class="idlAttribute"> readonly attribute <span class="idlAttrType"><a>boolean</a></span> <span class="idlAttrName"><a href="#widl-TouchEvent-shiftKey">shiftKey</a></span>;</span>
+};</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>
+ <code>true</code> if the alt (Alternate) key modifier is activated;
+ otherwise <code>false</code>
+ </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>
<p>
- the angle (in degrees) that the ellipse described by <a>radiusX</a>
- and <a>radiusY</a> is rotated clockwise about its center;
- <code>0</code> if no value is known. The value must be greater
- than or equal to <code>0</code> and less than <code>90</code>.
+ a list of <a href="#idl-def-Touch" class="idlType"><code>Touch</code></a>es for every point of contact which contributed
+ to the event.
</p>
<p>
- If the ellipse described by <a>radiusX</a> and <a>radiusY</a> is
- circular, then <a>rotationAngle</a> has no effect. The user agent
- may use <code>0</code> as the value in this case, or it may use any
- other value in the allowed range. (For example, the user agent may
- use the <a>rotationAngle</a> value from the previous touch event,
- to avoid sudden changes.)
- </p>
- </dd>
-
- <dt>readonly attribute float force</dt>
- <dd>
- a relative value of pressure applied, in the range <code>0</code> to
- <code>1</code>, where <code>0</code> is no pressure, and
- <code>1</code> is the highest level of pressure the touch device is
- capable of sensing; <code>0</code> if no value is known. In
- environments where <a>force</a> is known, the absolute pressure
- represented by the <a>force</a> attribute, and the sensitivity in
- levels of pressure, may vary.
-
- <p class="issue" id="issue-inkml">
- <strong>Issue:</strong>
- Consider aligning with other "channels" and values from
- <a href="http://www.w3.org/TR/InkML/#channelContents">Ink Markup
- Language (InkML)</a>, in addition to <a>force</a>, e.g. adding
- <a>angle</a>, <a>clientZ</a>, <a>rotation</a>, etc.
+ For the <a href="#dfn-touchstart" class="internalDFN">touchstart</a> event this must be a list of the touch
+ points that just became active with the current event. For the
+ <a href="#dfn-touchmove" class="internalDFN">touchmove</a> event this must be a list of the touch points that
+ have moved since the last event. For the <a href="#dfn-touchend" class="internalDFN">touchend</a> and
+ <a href="#dfn-touchcancel" class="internalDFN">touchcancel</a> events this must be a list of the touch points
+ that have just been removed from the surface.
</p>
- </dd>
- </dl>
- </section>
-
- <section>
- <h2><a>TouchList</a> Interface</h2>
- <p>
- This interface defines a list of individual points of contact for a
- touch event.
- </p>
-
- <dl title='interface TouchList' class='idl'>
- <dt>readonly attribute unsigned long length</dt>
- <dd>
- returns the number of <a>Touch</a>es in the list
- </dd>
- <dt>getter <a>Touch</a> item (in unsigned long <a>index</a>)</dt>
- <dd>
- returns the <a>Touch</a> with index <a>index</a> from the list,
- sorted in order from latest to earliest
- </dd>
- <dt><a>Touch</a> identifiedTouch (in long <a>identifier</a>)</dt>
- <dd>
- returns the first <a>Touch</a> with long <a>identifier</a> from the
- list
- </dd>
- </dl>
- </section>
-
- <section>
- <h2><a>TouchEvent</a> Interface</h2>
- <p>
- This interface defines the <a>touchstart</a>, <a>touchend</a>,
- <a>touchmove</a>, <a>touchenter</a>, <a>touchleave</a>, and
- <a>touchcancel</a> event types.
- </p>
-
- <dl title='interface TouchEvent : UIEvent' class='idl'>
- <dt>readonly attribute <a>TouchList</a> touches</dt>
- <dd>
- a list of <a>Touch</a>es for every point of contact currently
- touching the surface
- </dd>
- <dt>readonly attribute <a>TouchList</a> targetTouches</dt>
- <dd>
- a list of <a>Touch</a>es for every point of contact currently
- touching the surface, which started on the same target
- </dd>
- <dt>readonly attribute <a>TouchList</a> changedTouches</dt>
- <dd>
- a list of <a>Touch</a>es for every point of contact which contributed
- to the event
- </dd>
-
- <dt>readonly attribute boolean altKey</dt>
- <dd>
- <code>true</code> if the alt (Alternate) key modifier is activated;
+ </dd><dt id="widl-TouchEvent-ctrlKey"><code>ctrlKey</code> of type <span class="idlAttrType"><a>boolean</a></span>, readonly</dt><dd>
+ <code>true</code> if the ctrl (Control) key modifier is activated;
otherwise <code>false</code>
- </dd>
- <dt>readonly attribute boolean metaKey</dt>
- <dd>
+ </dd><dt id="widl-TouchEvent-metaKey"><code>metaKey</code> of type <span class="idlAttrType"><a>boolean</a></span>, readonly</dt><dd>
<code>true</code> if the meta (Meta) key modifier is activated;
otherwise <code>false</code>. On some platforms this attribute may
map to a differently-named key modifier.
- </dd>
- <dt>readonly attribute boolean ctrlKey</dt>
- <dd>
- <code>true</code> if the ctrl (Control) key modifier is activated;
- otherwise <code>false</code>
- </dd>
- <dt>readonly attribute boolean shiftKey</dt>
- <dd>
+ </dd><dt id="widl-TouchEvent-shiftKey"><code>shiftKey</code> of type <span class="idlAttrType"><a>boolean</a></span>, readonly</dt><dd>
<code>true</code> if the shift (Shift) key modifier is activated;
otherwise <code>false</code>
- </dd>
- <dt>readonly attribute EventTarget? relatedTarget</dt>
- <dd>
- identifies a secondary EventTarget related to a touch event. This
- attribute is used with the <a>touchenter</a> event to indicate the
- <a>EventTarget</a> the touch point exited, and with the
- <a>touchleave</a> event to indicate the <a>EventTarget</a> the touch
- point entered. For other event types, this attribute must be
- <code>null</code>.
- </dd>
+ </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>
+ a list of <a href="#idl-def-Touch" class="idlType"><code>Touch</code></a>es for every point of contact that is touching
+ the surface <em>and</em> started on the element that is the
+ <a>target</a> of the current event.
+ </dd><dt 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>
+ a list of <a href="#idl-def-Touch" class="idlType"><code>Touch</code></a>es for every point of contact currently
+ touching the surface.
+ </dd></dl></section>
+
+ <section class="informative" id="usage-examples">
+ <h3><span class="secno">5.2 </span>Usage Examples</h3><p><em>This section is non-normative.</em></p>
+
+ <p>
+ The examples below demonstrate the relations between the different
+ <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>.
+ </p>
+
+ <section id="touches-and-targettouches-of-a-touchevent">
+ <h4><span class="secno">5.2.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>
+
+ <p>
+ This example demonstrates the utility and relations between the
+ touches and targetTouches members defined in the <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a>
+ interface. The following code will generate different output based
+ on the number of touch points on the touchable element and the document:
+ </p>
+
+ <div class="example"><div class="example-title"><span>Example 1</span></div><pre class="example"><div id='touchable'>
+ This element is touchable.
+</div>
+
+document.getElementById('touchable').addEventListener('touchstart', function(ev) {
- <!-- Methods -->
- <dt>void initTouchEvent()</dt>
- <dd>
- initializes a TouchEvent created through the <a>DocumentEvent</a>
- interface.
- <dl class='parameters'>
- <dt>DOMString type</dt> <dd></dd>
- <dt>boolean canBubble</dt> <dd></dd>
- <dt>boolean cancelable</dt> <dd></dd>
- <dt>AbstractView view</dt> <dd></dd>
- <dt>long detail</dt> <dd></dd>
- <dt>boolean ctrlKey</dt> <dd></dd>
- <dt>boolean altKey</dt> <dd></dd>
- <dt>boolean shiftKey</dt> <dd></dd>
- <dt>boolean metaKey</dt> <dd></dd>
- <dt>TouchList touches</dt> <dd></dd>
- <dt>TouchList targetTouches</dt> <dd></dd>
- <dt>TouchList changedTouches</dt> <dd></dd>
- </dl>
- </dd>
- </dl>
+ if (ev.touches.item(0) == ev.targetTouches.item(0))
+ {
+ /**
+ * If the first touch on the surface is also targeting the
+ * "touchable" element, the code below should execute.
+ * Since targetTouches is a subset of touches which covers the
+ * entire surface, TouchEvent.touches >= TouchEvents.targetTouches
+ * is always true.
+ */
- <section>
- <h3 id="event-touchstart">The <dfn class="event">touchstart</dfn>
+ document.write('Hello Touch Events!');
+ }
+
+ if (ev.touches.length == ev.targetTouches.length)
+ {
+ /**
+ * If all of the active touch points are on the "touchable"
+ * element, the length properties should be the same.
+ */
+
+ document.write('All points are on target element')
+ }
+
+ if (ev.touches.length > 1)
+ {
+ /**
+ * On a single touch input device, there can only be one point
+ * of contact on the surface, so the following code can only
+ * execute when the terminal supports multiple touches.
+ */
+
+ document.write('Hello Multiple Touch!');
+ }
+
+}, false);</pre></div>
+ </section>
+
+ <section id="changedtouches-of-a-touchevent">
+ <h4><span class="secno">5.2.2 </span>changedTouches of a <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a></h4>
+
+ <p>
+ This example demonstrates the utility of changedTouches and it's relation
+ 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.
+ The code is a example which triggers whenever a touch point is removed
+ from the defined touchable element:
+ </p>
+
+ <div class="example"><div class="example-title"><span>Example 2</span></div><pre class="example"><div id='touchable'>
+ This element is touchable.
+</div>
+
+document.getElementById('touchable').addEventListener('touchend', function(ev) {
+
+ /**
+ * Example output when three touch points are on the surface,
+ * two of them being on the "touchable" element and one point
+ * in the "touchable" element is lifted from the surface:
+ *
+ * Touch points removed: 1
+ * Touch points left on element: 1
+ * Touch points left on document: 2
+ */
+
+ document.write('Removed: ' + ev.changedTouches.length);
+ document.write('Remaining on element: ' + ev.targetTouches.length);
+ document.write('Remaining on document: ' + ev.touches.length);
+
+}, false);</pre></div>
+ </section>
+
+ </section>
+
+ <section class="informative" id="list-of-touchevent-types">
+ <h3><span class="secno">5.3 </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>
+
+ <p>
+ The following table provides a summary of the types of possible
+ <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a> types defined in this specification. All events
+ should accomplish the bubbling phase. Some events are not cancelable
+ (see <a href="#dfn-preventdefault" class="internalDFN">preventDefault</a>).
+ </p>
+
+ <!--
+ // FIXME: As of the time of writing, respec.js doesn't have support for
+ // tables like this - we're just piggybacking on a existing class, with
+ // raw markup as a quick and dirty workaround.
+ -->
+
+ <table class="parameters" id="table-event-summary">
+ <tbody><tr>
+ <th>Event Type</th>
+ <th>Sync / Async</th>
+ <th>Bubbling phase</th>
+ <th>Trusted proximal event target types</th>
+ <th>DOM interface</th>
+ <th>Cancelable</th>
+ <th>Default Action</th>
+ </tr>
+ <tr>
+ <td><a href="#dfn-touchstart" class="internalDFN">touchstart</a></td>
+ <td>Sync</td>
+ <td>Yes</td>
+ <td><code>Document, Element</code></td>
+ <td><a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a></td>
+ <td>Yes</td>
+ <td>undefined</td>
+ </tr>
+ <tr>
+ <td><a href="#dfn-touchend" class="internalDFN">touchend</a></td>
+ <td>Sync</td>
+ <td>Yes</td>
+ <td><code>Document, Element</code></td>
+ <td><a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a></td>
+ <td>Yes</td>
+ <td>
+ Varies: mousemove (If point has been moved), mousedown,
+ mouseup, click
+ </td>
+ </tr>
+ <tr>
+ <td><a href="#dfn-touchmove" class="internalDFN">touchmove</a></td>
+ <td>Sync</td>
+ <td>Yes</td>
+ <td><code>Document, Element</code></td>
+ <td><a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a></td>
+ <td>Yes</td>
+ <td>undefined</td>
+ </tr>
+ <tr>
+ <td><a href="#dfn-touchcancel" class="internalDFN">touchcancel</a></td>
+ <td>Sync</td>
+ <td>Yes</td>
+ <td><code>Document, Element</code></td>
+ <td><a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a></td>
+ <td>No</td>
+ <td>none</td>
+ </tr>
+ </tbody></table>
+ </section>
+
+ <section id="the-touchstart-event">
+ <h3 id="event-touchstart"><span class="secno">5.4 </span>The <dfn class="event" id="dfn-touchstart">touchstart</dfn>
event</h3>
<p>
A user agent must dispatch this event type to indicate when the user
- places a <a>touch point</a> on the touch surface.
+ places a <a href="#dfn-touch-point" class="internalDFN">touch point</a> on the touch surface.
</p>
<p>
- The target of this event must be an <a>Element</a>.
+ The target of this event must be an <a>Element</a>. If the touch
+ point is within a frame, the event should be dispatched to an element
+ in the <a>child browsing context</a> of that frame.
+ </p>
+
+ <p>
+ If the <a href="#dfn-preventdefault" class="internalDFN">preventDefault</a> method is called on this event, it
+ should prevent any default actions caused by any touch events
+ associated with the same <a href="#dfn-active-touch-point" class="internalDFN">active touch point</a>, including mouse
+ events or scrolling.
</p>
</section>
- <section>
- <h3 id="event-touchend">The <dfn class="event">touchend</dfn> event</h3>
+ <section id="the-touchend-event">
+ <h3 id="event-touchend"><span class="secno">5.5 </span>The <dfn class="event" id="dfn-touchend">touchend</dfn> event</h3>
<p>
A user agent must dispatch this event type to indicate when the user
- removes a <a>touch point</a> from the touch surface, also including
+ removes a <a href="#dfn-touch-point" class="internalDFN">touch point</a> from the touch surface, also including
cases where the touch point physically leaves the touch surface, such
as being dragged off of the screen.
</p>
<p>
- The <a>target</a> of this event must be the same <a>Element</a> that
- received the <a>touchstart</a> event when this <a>touch point</a> was
- placed on the surface, even if the <a>touch point</a> has since moved
+ The <a>target</a> of this event must be the same <a>Element</a> on
+ which the <a href="#dfn-touch-point" class="internalDFN">touch point</a> started when it was first
+ placed on the surface, even if the <a href="#dfn-touch-point" class="internalDFN">touch point</a> has since moved
outside the interactive area of the <a>target</a> element.
</p>
<p>
- The <a>touch point</a> or points that were removed must be included
- in the <a>changedTouches</a> attribute of the <a>TouchEvent</a>, and
+ The <a href="#dfn-touch-point" class="internalDFN">touch point</a> or points that were removed must be included
+ in the <a>changedTouches</a> attribute of the <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a>, and
must not be included in the <a>touches</a> and <a>targetTouches</a>
attributes.
</p>
</section>
- <section>
- <h3 id="event-touchmove">The <dfn class="event">touchmove</dfn> event</h3>
+ <section id="the-touchmove-event">
+ <h3 id="event-touchmove"><span class="secno">5.6 </span>The <dfn class="event" id="dfn-touchmove">touchmove</dfn> event</h3>
<p>
A user agent must dispatch this event type to indicate when the user
- moves a <a>touch point</a> along the touch surface.
+ moves a <a href="#dfn-touch-point" class="internalDFN">touch point</a> along the touch surface.
</p>
<p>
- The <a>target</a> of this event must be the same <a>Element</a> that
- received the <a>touchstart</a> event when this <a>touch point</a> was
- placed on the surface, even if the <a>touch point</a> has since moved
+ The <a>target</a> of this event must be the same <a>Element</a> on
+ which the <a href="#dfn-touch-point" class="internalDFN">touch point</a> started when it was first
+ placed on the surface, even if the <a href="#dfn-touch-point" class="internalDFN">touch point</a> has since moved
outside the interactive area of the <a>target</a> element.
</p>
<p>
- If the values of <a>radiusX</a>, <a>radiusY</a>,
- <a>rotationAngle</a>, or <a>force</a> are known, then the user agent
- also must dispatch this event type to indicate when any of these
- attributes of a <a>touch point</a> have changed.
+ Note that the rate at which the user agent sends <a href="#dfn-touchmove" class="internalDFN">touchmove</a>
+ events is implementation-defined, and may depend on hardware
+ capabilities and other implementation details.
</p>
<p>
- Note that the rate at which the user agent sends <a>touchmove</a>
- events is implementation-defined, and may depend on hardware
- capabilities and other implementation details.
+ If the <a href="#dfn-preventdefault" class="internalDFN">preventDefault</a> method is called on the <em>first</em>
+ <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
+ prevent any default action caused by any <a href="#dfn-touchmove" class="internalDFN">touchmove</a> event
+ associated with the same <a href="#dfn-active-touch-point" class="internalDFN">active touch point</a>, such as scrolling.
</p>
</section>
- <section>
- <h3 id="event-touchenter">The <dfn class="event">touchenter</dfn> event</h3>
- <p>
- A user agent must dispatch this event type to indicate when a
- <a>touch point</a> moves onto the interactive area defined by a DOM
- element. Events of this type must not bubble.
- </p>
- </section>
-
- <section>
- <h3 id="event-touchleave">The <dfn class="event">touchleave</dfn> event</h3>
- <p>
- A user agent must dispatch this event type to indicate when a
- <a>touch point</a> moves off the interactive area defined by a DOM
- element. Events of this type must not bubble.
- </p>
- </section>
-
- <section>
- <h3 id="event-touchcancel">The <dfn class="event">touchcancel</dfn> event</h3>
+ <section id="the-touchcancel-event">
+ <h3 id="event-touchcancel"><span class="secno">5.7 </span>The <dfn class="event" id="dfn-touchcancel">touchcancel</dfn> event</h3>
<p>
A user agent must dispatch this event type to indicate when a touch
point has been disrupted in an implementation-specific manner, such as
@@ -463,129 +980,134 @@
touch, or the touch point leaving the document window into a
non-document area which is capable of handling user interactions.
(e.g. The UA's native user interface, plug-ins) A user agent may
- also dispatch this event type when the user places more <a>touch
+ also dispatch this event type when the user places more <a href="#dfn-touch-point" class="internalDFN">touch
point</a>s on the touch surface than the device or implementation is
- configured to store, in which case the earliest <a>Touch</a> object
- in the <a>TouchList</a> should be removed.
+ configured to store, in which case the earliest <a href="#idl-def-Touch" class="idlType"><code>Touch</code></a> object
+ in the <a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a> should be removed.
+ </p>
+
+ <p>
+ The <a>target</a> of this event must be the same <a>Element</a> on
+ which the <a href="#dfn-touch-point" class="internalDFN">touch point</a> started when it was first
+ placed on the surface, even if the <a href="#dfn-touch-point" class="internalDFN">touch point</a> has since moved
+ outside the interactive area of the <a>target</a> element.
+ </p>
+
+ <p>
+ The <a href="#dfn-touch-point" class="internalDFN">touch point</a> or points that were removed must be included
+ in the <a>changedTouches</a> attribute of the <a href="#idl-def-TouchEvent" class="idlType"><code>TouchEvent</code></a>, and
+ must not be included in the <a>touches</a> and <a>targetTouches</a>
+ attributes.
</p>
</section>
</section>
- <section>
- <h2><a>DocumentTouch</a> Interface</h2>
+ <section id="extensions-to-the-document-interface">
+ <!--OddPage--><h2><span class="secno">6. </span>Extensions to the <a href="#idl-def-Document" class="idlType"><code>Document</code></a> Interface</h2>
<p>
- The <a>DocumentTouch</a> interface provides a mechanism by which the
- user can create <a>Touch</a> and <a>TouchList</a> objects. The
- <a>DocumentTouch</a> interface must be implemented on the
- <a>Document</a> object.
+ 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
+ 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>
+ objects.
</p>
- <dl title='interface DocumentTouch' class='idl'>
- <dt>Touch createTouch()</dt>
- <dd>
- Creates a <a>Touch</a> object with the specified attributes.
- <dl class='parameters'>
- <dt>AbstractView view</dt> <dd></dd>
- <dt>EventTarget target</dt> <dd></dd>
- <dt>long identifier</dt> <dd></dd>
- <dt>long pageX</dt> <dd></dd>
- <dt>long pageY</dt> <dd></dd>
- <dt>long screenX</dt> <dd></dd>
- <dt>long screenY</dt> <dd></dd>
- <dt>optional long clientX</dt> <dd></dd>
- <dt>optional long clientY</dt> <dd></dd>
- <dt>optional long radiusX</dt> <dd></dd>
- <dt>optional long radiusY</dt> <dd></dd>
- <dt>optional float rotationAngle</dt> <dd></dd>
- <dt>optional float force</dt> <dd></dd>
- </dl>
- </dd>
-
- <dt>TouchList createTouchList()</dt>
- <dd>
- Creates a <a>TouchList</a> object containing the specified
- <a>Touch</a> objects.
- <dl class='parameters'>
- <dt>Touch[] touches</dt> <dd></dd>
- </dl>
- </dd>
-
- <dt>TouchList createTouchList()</dt>
- <dd>
- Creates a <a>TouchList</a> object containing a single <a>Touch</a>.
- <dl class='parameters'>
- <dt>Touch touch</dt> <dd></dd>
- </dl>
- </dd>
- </dl>
-
- <p class="issue" id="issue-createTouch-pageXY">
- <strong>Issue:</strong>
- Does <a>createTouch</a> need to take both pageX/pageY <em>and</em>
- clientX/clientY as parameters? If not, which pair should be removed?
- </p>
+ <pre class="idl"><span class="idlInterface" id="idl-def-Document">partial interface <span class="idlInterfaceID">Document</span> {
+<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-AbstractView-view-EventTarget-target-long-identifier-long-pageX-long-pageY-long-screenX-long-screenY">createTouch</a></span> (<span class="idlParam"><span class="idlParamType"><a>AbstractView</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>
+<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>
+};</span></pre><section id="methods-1"><h3><span class="secno">6.1 </span>Methods</h3><dl class="methods"><dt id="widl-Document-createTouch-Touch-AbstractView-view-EventTarget-target-long-identifier-long-pageX-long-pageY-long-screenX-long-screenY"><code>createTouch</code></dt><dd>
+ Creates a <a href="#idl-def-Touch" class="idlType"><code>Touch</code></a> object with the specified attributes.
+
+ <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>AbstractView</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>
+ 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.
+ Calling this method with no arguments creates a <a href="#idl-def-TouchList" class="idlType"><code>TouchList</code></a> with no objects in it
+ and length 0 (zero).
+
+ <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>
</section>
<section id="mouse-events">
- <h2>Interaction with Mouse Events</h2>
+ <!--OddPage--><h2><span class="secno">7. </span>Interaction with Mouse Events</h2>
<p>
The user agent may dispatch both touch events and mouse events
- [[!DOM-LEVEL-2-EVENTS]] in response to the same user input. If the
+ [<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
user agent dispatches both touch events and mouse events in response to
- a single user action, then the <a>touchstart</a> event type must be
+ a single user action, then the <a href="#dfn-touchstart" class="internalDFN">touchstart</a> event type must be
dispatched before any mouse event types for that action. If the
- <a>preventDefault</a> method of <a>touchstart</a> or <a>touchmove</a>
+ <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>
is called, the user agent should not dispatch any mouse event that
would be a consequential result of the the prevented touch event.
</p>
+ <div class="note"><div class="note-title"><span>Note</span></div><p class="">
+ If a Web application can process touch events, it can intercept them,
+ and no corresponding mouse events would need to be dispatched by the
+ user agent. If the Web application is not specifically written for
+ touch input devices, it can react to the subsequent mouse events instead.
+ </p></div>
+
+ <p>
+ If the user agent intreprets a sequence of touch events as a click,
+ then it should dispatch <a>mousemove</a>, <a>mousedown</a>,
+ <a>mouseup</a>, and <a>click</a> events (in that order) at the location
+ of the <a href="#dfn-touchend" class="internalDFN">touchend</a> event for the corresponding touch input. If the
+ contents of the document have changed during processing of the touch
+ events, then the user agent may dispatch the mouse events to a
+ different target than the touch events.
+ </p>
+
<p>
The default actions and ordering of any further touch and mouse events
are implementation-defined, except as specified elsewhere.
</p>
</section>
- <section>
- <h2>Glossary</h2>
+ <section id="glossary">
+ <!--OddPage--><h2><span class="secno">8. </span>Glossary</h2>
<dl>
- <dt><dfn>active touch event session</dfn></dt>
+ <dt><dfn id="dfn-active-touch-point">active touch point</dfn></dt>
<dd>
- A conceptual state in which there is at least one instance of a
- <a>TouchEvent</a> event with at least one non-empty <a>TouchList</a>.
- <!-- <pre class='example'>
- </pre> -->
+ A <a href="#dfn-touch-point" class="internalDFN">touch point</a> which is currently on the screen and is being
+ tracked by the user agent. The touch point becomes active when the
+ user agent first dispatches a <a href="#dfn-touchstart" class="internalDFN">touchstart</a> event indicating its
+ appearance. It ceases to be active after the user agent dispatches a
+ <a href="#dfn-touchend" class="internalDFN">touchend</a> or <a href="#dfn-touchcancel" class="internalDFN">touchcancel</a> event indicating that the touch
+ point is removed from the surface or no longer tracked.
</dd>
- <dt><dfn>touch point</dfn></dt>
+ <dt><dfn id="dfn-touch-point">touch point</dfn></dt>
<dd>
The coordinate point at which a pointer (e.g finger or stylus)
intersects the target surface of an interface. This may apply to a
finger touching a touch-screen, or an digital pen writing on a piece
of paper.
</dd>
+
+ <dt><dfn id="dfn-preventdefault">preventDefault</dfn></dt>
+ <dd>
+ If a event is cancelable, the preventDefault method is used to signify
+ that the event is to be canceled, and any default actions defined in the
+ user agent as a result of this event, or consequential events from the
+ canceled event will not occur. Calling this method on non-cancelable
+ events will have no effect.
+ </dd>
</dl>
</section>
- <section id='issues' class='informative'>
- <h2>Issues</h2>
+ <section id="issues" class="informative">
+ <!--OddPage--><h2><span class="secno">9. </span>Issues</h2><p><em>This section is non-normative.</em></p>
<p>
- The working group maintains <a
- href='http://www.w3.org/2010/webevents/track/products/2'
- >a list of open issues in this specification</a>. These issues may be
+ The working group maintains <a href="http://www.w3.org/2010/webevents/track/products/2">a list of open issues in this specification</a>. These issues may be
addressed in future revisions of the specification.
</p>
</section>
- <section class='appendix informative'>
- <h2>Acknowledgements</h2>
+ <section class="appendix informative" id="acknowledgements">
+ <!--OddPage--><h2><span class="secno">A. </span>Acknowledgements</h2><p><em>This section is non-normative.</em></p>
<p>
Many thanks to the WebKit engineers for developing the model used as a
basis for this spec, Neil Roberts (SitePen) for his summary of WebKit
touch events, Peter-Paul Koch (PPK) for his write-ups and suggestions,
- Robin Berjon for developing the <a
- href="http://dev.w3.org/2009/dap/ReSpec.js/documentation.html"
- >ReSpec.js spec authoring tool</a>, and the WebEvents WG for their many
+ Robin Berjon for developing the <a href="http://dev.w3.org/2009/dap/ReSpec.js/documentation.html">ReSpec.js spec authoring tool</a>, and the WebEvents WG for their many
contributions.
</p>
@@ -596,5 +1118,11 @@
please let me know.
</p>
</section>
- </body>
-</html>
+
+
+<section id="references" class="appendix"><!--OddPage--><h2><span class="secno">B. </span>References</h2><section id="normative-references"><h3><span class="secno">B.1 </span>Normative references</h3><dl class="bibliography"><dt id="bib-DOM-LEVEL-2-EVENTS">[DOM-LEVEL-2-EVENTS]</dt><dd>Tom Pixley. <a href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113"><cite>Document Object Model (DOM) Level 2 Events Specification.</cite></a> 13 November 2000. W3C Recommendation. URL: <a href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113">http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113</a>
+</dd><dt id="bib-DOM-LEVEL-3-CORE">[DOM-LEVEL-3-CORE]</dt><dd>Gavin Nicol; et al. <a href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407"><cite>Document Object Model (DOM) Level 3 Core Specification.</cite></a> 7 April 2004. W3C Recommendation. URL: <a href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407">http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407</a>
+</dd><dt id="bib-RFC2119">[RFC2119]</dt><dd>S. Bradner. <a href="http://www.ietf.org/rfc/rfc2119.txt"><cite>Key words for use in RFCs to Indicate Requirement Levels.</cite></a> March 1997. Internet RFC 2119. URL: <a href="http://www.ietf.org/rfc/rfc2119.txt">http://www.ietf.org/rfc/rfc2119.txt</a>
+</dd><dt id="bib-WEBIDL">[WEBIDL]</dt><dd>Cameron McCormack. <a href="http://www.w3.org/TR/2011/WD-WebIDL-20110927/"><cite>Web IDL.</cite></a> 27 September 2011. W3C Working Draft. (Work in progress.) URL: <a href="http://www.w3.org/TR/2011/WD-WebIDL-20110927/">http://www.w3.org/TR/2011/WD-WebIDL-20110927/</a>
+</dd></dl></section></section></body></html>
+