html/DOM3-Events.html
author Travis Leithead
Fri, 13 Jun 2014 15:29:14 -0700
changeset 671 26dc3d28bfa0
parent 670 42e65115f7e2
child 672 7d98f8bd1933
permissions -rw-r--r--
Minor fixes to previous checkin
411
70e31ba92e14 Fold changes from the 6 Sept "branch" back onto the mainline.
Gary Kacmarcik <garykac@google.com>
parents: 409
diff changeset
     1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
464
2471b17ce4f8 Enable floating "file a bug" div to spec to facilitate comments/feedback.
Gary Kacmarcik <garykac@google.com>
parents: 463
diff changeset
     2
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-US"
2471b17ce4f8 Enable floating "file a bug" div to spec to facilitate comments/feedback.
Gary Kacmarcik <garykac@google.com>
parents: 463
diff changeset
     3
	data-bug-product='WebAppsWG'
2471b17ce4f8 Enable floating "file a bug" div to spec to facilitate comments/feedback.
Gary Kacmarcik <garykac@google.com>
parents: 463
diff changeset
     4
	data-bug-component='DOM3 Events'
2471b17ce4f8 Enable floating "file a bug" div to spec to facilitate comments/feedback.
Gary Kacmarcik <garykac@google.com>
parents: 463
diff changeset
     5
	>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
     6
<head>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
     7
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
     8
	<title>Document Object Model (DOM) Level 3 Events Specification</title>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
     9
	<link rel="author" href="mailto:www-dom@w3.org" />
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
    10
	<link rel="help" href="http://www.w3.org/DOM/" />
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
    11
	<link rel="alternate stylesheet" type="text/css" media="screen" title="geek" href="geek.css" />
411
70e31ba92e14 Fold changes from the 6 Sept "branch" back onto the mainline.
Gary Kacmarcik <garykac@google.com>
parents: 409
diff changeset
    12
	<link rel="stylesheet" type="text/css" href="spec-WD.css" />
436
be4894226f6d Use https for stylesheets to avoid security error on load.
Gary Kacmarcik <garykac@google.com>
parents: 435
diff changeset
    13
	<link rel="stylesheet" type="text/css" href="https://www.w3.org/StyleSheets/TR/w3c-tr.css" />
be4894226f6d Use https for stylesheets to avoid security error on load.
Gary Kacmarcik <garykac@google.com>
parents: 435
diff changeset
    14
	<link rel="stylesheet" type="text/css" href="https://www.w3.org/StyleSheets/TR/W3C-WD" />
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
    15
	<link rel="stylesheet" type="text/css" href="override.css" />
416
7c9bdb1ee920 Remove duplicate figure captions.
Gary Kacmarcik <garykac@google.com>
parents: 414
diff changeset
    16
	<script type="text/javascript" src='https://www.w3.org/Tools/respec/respec-w3c-common' class='remove' async></script>
457
e6c1ebba556e Correct internal links for WheelEvent, MouseEvent, UIEvent, KeyboardEvent, MutationEvent.
Gary Kacmarcik <garykac@google.com>
parents: 456
diff changeset
    17
	<script type="text/javascript" src='fixup.js'></script>
464
2471b17ce4f8 Enable floating "file a bug" div to spec to facilitate comments/feedback.
Gary Kacmarcik <garykac@google.com>
parents: 463
diff changeset
    18
	<script src="bug-assist.js"></script>
414
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    19
	<script type="text/javascript">
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    20
	var respecConfig = {
523
e85f7580093a Change back to ED
garykac@google.com
parents: 521
diff changeset
    21
		specStatus: "ED",
414
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    22
		shortName:  "DOM-Level-3-Events",
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    23
		editors: [
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    24
			{
427
eae783ac561c Revert to Editor's Draft
Gary Kacmarcik <garykac@google.com>
parents: 426
diff changeset
    25
				name: "Gary Kacmarcik", 
eae783ac561c Revert to Editor's Draft
Gary Kacmarcik <garykac@google.com>
parents: 426
diff changeset
    26
				company: "Google, Inc.",
eae783ac561c Revert to Editor's Draft
Gary Kacmarcik <garykac@google.com>
parents: 426
diff changeset
    27
				url: "mailto:garykac@google.com?subject=%5BDOM3-event%5D%20Spec%20Feedback",
eae783ac561c Revert to Editor's Draft
Gary Kacmarcik <garykac@google.com>
parents: 426
diff changeset
    28
				companyURL: "http://www.google.com",
eae783ac561c Revert to Editor's Draft
Gary Kacmarcik <garykac@google.com>
parents: 426
diff changeset
    29
				note: "Jun 2013 - present",
eae783ac561c Revert to Editor's Draft
Gary Kacmarcik <garykac@google.com>
parents: 426
diff changeset
    30
			},
eae783ac561c Revert to Editor's Draft
Gary Kacmarcik <garykac@google.com>
parents: 426
diff changeset
    31
			{
414
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    32
				name: "Travis Leithead", 
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    33
				company: "Microsoft Corp.",
416
7c9bdb1ee920 Remove duplicate figure captions.
Gary Kacmarcik <garykac@google.com>
parents: 414
diff changeset
    34
				url: "mailto:travis.leithead@microsoft.com?subject=%5BDOM3-event%5D%20Spec%20Feedback",
427
eae783ac561c Revert to Editor's Draft
Gary Kacmarcik <garykac@google.com>
parents: 426
diff changeset
    35
				companyURL: "http://www.microsoft.com",
eae783ac561c Revert to Editor's Draft
Gary Kacmarcik <garykac@google.com>
parents: 426
diff changeset
    36
				note: "Feb 2012 - present",
414
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    37
			},
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    38
			{
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    39
				name: "Jacob Rossi", 
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    40
				company: "Microsoft Corp.",
427
eae783ac561c Revert to Editor's Draft
Gary Kacmarcik <garykac@google.com>
parents: 426
diff changeset
    41
				note: "Mar 2011 - Oct 2011",
414
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    42
			},
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    43
			{
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    44
				name: "Doug Schepers", 
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    45
				company: "W3C",
427
eae783ac561c Revert to Editor's Draft
Gary Kacmarcik <garykac@google.com>
parents: 426
diff changeset
    46
				note: "Mar 2008 - May 2011",
414
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    47
			},
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    48
			{
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    49
				name: "Björn Höhrmann", 
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    50
				company: "Invited Expert",
427
eae783ac561c Revert to Editor's Draft
Gary Kacmarcik <garykac@google.com>
parents: 426
diff changeset
    51
				note: "until Jan 2008",
414
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    52
			},
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    53
			{
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    54
				name: "Philippe Le Hégaret", 
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    55
				company: "W3C",
427
eae783ac561c Revert to Editor's Draft
Gary Kacmarcik <garykac@google.com>
parents: 426
diff changeset
    56
				note: "until Nov 2003",
414
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    57
			},
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    58
			{
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    59
				name: "Tom Pixley", 
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    60
				company: "Netscape Communications Corporation",
427
eae783ac561c Revert to Editor's Draft
Gary Kacmarcik <garykac@google.com>
parents: 426
diff changeset
    61
				note: "until Jul 2002",
414
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    62
			}
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    63
		],
646
c3e838808f62 Change TOC level to 3. Change publish date to 27 May 2014.
Gary Kacmarcik <garykac@google.com>
parents: 645
diff changeset
    64
		publishDate:  "2014-05-27",
456
987f6555fc6b Update hyperlinks which have been moved/redirected.
Gary Kacmarcik <garykac@google.com>
parents: 453
diff changeset
    65
		edDraftURI: "https://dvcs.w3.org/hg/dom3events/raw-file/tip/html/DOM3-Events.html",
523
e85f7580093a Change back to ED
garykac@google.com
parents: 521
diff changeset
    66
		previousPublishDate: "2013-11-05",
414
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    67
		previousMaturity: "WD",
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    68
		noIDLIn:  true,
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    69
		inlineCSS:  true,
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    70
		//noRecTrack:  true,
417
3af9a4e6464d Use respec IDL formatting.
Gary Kacmarcik <garykac@google.com>
parents: 416
diff changeset
    71
		wg: ["Web Applications Working Group"],
3af9a4e6464d Use respec IDL formatting.
Gary Kacmarcik <garykac@google.com>
parents: 416
diff changeset
    72
		wgURI: ["http://www.w3.org/2008/webapps/"],
414
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    73
		wgPublicList: "www-dom",
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    74
		wgPatentURI: ["http://www.w3.org/2004/01/pp-impl/42538/status"],
646
c3e838808f62 Change TOC level to 3. Change publish date to 27 May 2014.
Gary Kacmarcik <garykac@google.com>
parents: 645
diff changeset
    75
		maxTocLevel: 3
414
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    76
	};
b85ce1a25754 Temporary fix for xxx-idl -> d3-idl
Gary Kacmarcik <garykac@google.com>
parents: 413
diff changeset
    77
	</script>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
    78
</head>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
    79
<body>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
    80
	<!-- Section: Abstract ========================================================-->
413
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
    81
	<section id="abstract">
591
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
    82
		<p>This specification defines the Document Object Model Events Level 3, a generic
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
    83
			platform- and language-neutral event system which allows registration of event handlers,
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
    84
			describes event flow through a tree structure, and provides basic contextual
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
    85
			information for each event. The Document Object Model Events Level 3 builds on the
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
    86
			Document Object Model Events Level 2 [<a href="#references-DOM2Events">DOM2 Events</a>].
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
    87
			</p>
544
eb5cf0c88b21 Add comments after each </section>
garykac@google.com
parents: 543
diff changeset
    88
	</section>  <!-- abstract -->
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
    89
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
    90
	<!-- Section: SOTD ========================================================-->
413
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
    91
	<section id="sotd">
591
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
    92
		<p>This document is a Working Draft of the Document Object Model Level 3 Events
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
    93
			(DOM3 Events) specification. 
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
    94
			It is expected that this specification will progress to
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
    95
			<abbr title="World Wide Web Consortium">W3C</abbr> 
521
9e251e0967c9 Update respec source to remove Last Call info.
Gary Kacmarcik <garykac@google.com>
parents: 519
diff changeset
    96
			Recommendation status after review and refinement.
9e251e0967c9 Update respec source to remove Last Call info.
Gary Kacmarcik <garykac@google.com>
parents: 519
diff changeset
    97
			</p>
9e251e0967c9 Update respec source to remove Last Call info.
Gary Kacmarcik <garykac@google.com>
parents: 519
diff changeset
    98
9e251e0967c9 Update respec source to remove Last Call info.
Gary Kacmarcik <garykac@google.com>
parents: 519
diff changeset
    99
		<p id="this-document-is-produced-by-the-web-app">
591
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
   100
			This document is produced by the
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
   101
				<a href="http://www.w3.org/2008/webapps/">Web Applications WG</a>,
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
   102
			part of the
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
   103
				<a href="http://www.w3.org/2006/rwc/Activity">Rich Web Clients Activity</a>
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
   104
			in the W3C
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
   105
				<a href="http://www.w3.org/Interaction/">Interaction Domain</a>.
521
9e251e0967c9 Update respec source to remove Last Call info.
Gary Kacmarcik <garykac@google.com>
parents: 519
diff changeset
   106
			It is expected that this document will progress along the W3C's Recommendation track.
9e251e0967c9 Update respec source to remove Last Call info.
Gary Kacmarcik <garykac@google.com>
parents: 519
diff changeset
   107
			Publication as a Working Draft does not imply endorsement by the W3C Membership.
591
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
   108
			This is a draft document and MAY be updated, replaced or obsoleted by other
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
   109
			documents at any time.
521
9e251e0967c9 Update respec source to remove Last Call info.
Gary Kacmarcik <garykac@google.com>
parents: 519
diff changeset
   110
			It is inappropriate to cite this document as other than work in progress.
9e251e0967c9 Update respec source to remove Last Call info.
Gary Kacmarcik <garykac@google.com>
parents: 519
diff changeset
   111
			</p>
9e251e0967c9 Update respec source to remove Last Call info.
Gary Kacmarcik <garykac@google.com>
parents: 519
diff changeset
   112
9e251e0967c9 Update respec source to remove Last Call info.
Gary Kacmarcik <garykac@google.com>
parents: 519
diff changeset
   113
		<p id="latest-editors-draft">
9e251e0967c9 Update respec source to remove Last Call info.
Gary Kacmarcik <garykac@google.com>
parents: 519
diff changeset
   114
			<strong>You can find the latest
460
8b94685f205b Change W3C link from CVS to Mercurial (since that's where the ED lives now).
Gary Kacmarcik <garykac@google.com>
parents: 459
diff changeset
   115
				<a href="https://dvcs.w3.org/hg/dom3events/raw-file/tip/html/DOM3-Events.html">Editor's Draft</a>
8b94685f205b Change W3C link from CVS to Mercurial (since that's where the ED lives now).
Gary Kacmarcik <garykac@google.com>
parents: 459
diff changeset
   116
			of this document in the
8b94685f205b Change W3C link from CVS to Mercurial (since that's where the ED lives now).
Gary Kacmarcik <garykac@google.com>
parents: 459
diff changeset
   117
				<a href="https://dvcs.w3.org/hg/">W3C's Mercurial repository</a>,
521
9e251e0967c9 Update respec source to remove Last Call info.
Gary Kacmarcik <garykac@google.com>
parents: 519
diff changeset
   118
			which is updated on a regular basis.</strong>
9e251e0967c9 Update respec source to remove Last Call info.
Gary Kacmarcik <garykac@google.com>
parents: 519
diff changeset
   119
			</p>
9e251e0967c9 Update respec source to remove Last Call info.
Gary Kacmarcik <garykac@google.com>
parents: 519
diff changeset
   120
9e251e0967c9 Update respec source to remove Last Call info.
Gary Kacmarcik <garykac@google.com>
parents: 519
diff changeset
   121
		<p id="unstable">
9e251e0967c9 Update respec source to remove Last Call info.
Gary Kacmarcik <garykac@google.com>
parents: 519
diff changeset
   122
			<strong class="redNote">Implementers should be aware that this document is not stable.</strong>
591
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
   123
			Implementers who are not taking part in the discussions are likely to find the
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
   124
			specification changing out from under them in incompatible ways.
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
   125
			Vendors interested in implementing this document before it eventually reaches
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
   126
			the Candidate Recommendation stage should join the aforementioned mailing lists
eaeddc69551c Update Abstract and SOTD for D3E-key|code.
Gary Kacmarcik <garykac@google.com>
parents: 589
diff changeset
   127
			and take part in the discussions.
521
9e251e0967c9 Update respec source to remove Last Call info.
Gary Kacmarcik <garykac@google.com>
parents: 519
diff changeset
   128
			</p>
530
27e8c3727373 Fixup respect errors/warnings:
garykac@google.com
parents: 527
diff changeset
   129
	</section>  <!-- sotd -->
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   130
424
a0f0f1530035 Fix many typos, capitalization and minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 423
diff changeset
   131
	<!-- Section 1: DOM3 Events Overview  ========================================================-->
614
9dc74ec13aea Fix 25510 - Spec readability: Move glossary to the bottom
Travis Leithead
parents: 613
diff changeset
   132
	<section id="dom-events-intro">
9dc74ec13aea Fix 25510 - Spec readability: Move glossary to the bottom
Travis Leithead
parents: 613
diff changeset
   133
		<h1>Introduction</h1>
478
5913a35e9e16 Fix lots of typos and other minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 477
diff changeset
   134
		
413
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   135
		<section id="dom-events-overview">
614
9dc74ec13aea Fix 25510 - Spec readability: Move glossary to the bottom
Travis Leithead
parents: 613
diff changeset
   136
			<h2>Overview</h2>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   137
			<p>DOM Events is designed with two main goals. The first goal is the design of an <a class="def" href="#glossary-event">event</a> system which allows registration
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   138
				of event listeners and describes event flow through a tree structure. Additionally, the specification will provide standard modules of events for user interface
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   139
				control and document mutation notifications, including defined contextual information for each of these event modules.</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   140
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   141
			<p>The second goal of DOM Events is to provide a common subset of the current event systems used in existing browsers. This is intended to foster interoperability
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   142
				of existing scripts and content. It is not expected that this goal will be met with full backwards compatibility. However, the specification attempts to achieve
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   143
				this when possible.</p>
413
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   144
		</section>  <!-- dom-events-overview -->
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   145
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   146
		<section id="dom-events-conformance">
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   147
			<h2>Conformance</h2>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   148
			<p><strong>This section is normative.</strong></p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   149
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   150
			<p>Within this specification, the key words <q>MUST</q>, <q>MUST NOT</q>, <q>REQUIRED</q>,
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   151
				<q>SHALL</q>, <q>SHALL NOT</q>, <q>SHOULD</q>, <q>SHOULD NOT</q>,
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   152
				<q>RECOMMENDED</q>, <q>MAY</q>, and <q>OPTIONAL</q> are to be interpreted as described in
525
9056e78dc085 Fixup broken references: RFC2119, event-type-focusIn, interface-CompositionEvent
garykac@google.com
parents: 523
diff changeset
   153
				[<a href="#RFC2119">RFC2119</a>].</p>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   154
645
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   155
			<p>This specification is to be understood in the context of the DOM Level 3 Core specification
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   156
				[<cite><a class="normative" href="#references-DOMCore">DOM3 Core</a></cite>] and the general
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   157
				considerations for DOM implementations apply.
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   158
				For example, handling of <a class="def" href="#glossary-namespaceURI">namespace URIs</a> is discussed in
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   159
				<a class="normative" href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#Namespaces-Considerations"><em>XML Namespaces</em></a>.
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   160
				For additional information about
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   161
				<a class="normative" href="http://www.w3.org/TR/DOM-Level-3-Core/introduction.html#ID-Conformance"><em>conformance</em></a>,
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   162
				please see the DOM Level 3 Core specification
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   163
				[<cite><a class="normative" href="#references-DOMCore">DOM3 Core</a></cite>].
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   164
				A <a class="def" href="#glossary-user-agent">user agent</a> is not required to conform
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   165
				to the entirety of another specification in order to conform to this specification, but it MUST
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   166
				conform to the specific parts of any other specification which are called out in this specification
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   167
				(e.g., a conforming DOM3 Events <a class="def" href="#glossary-user-agent">user agent</a> MUST support
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   168
				the <code>DOMString</code> data type as defined in <a href="#references-WebIDL">Web IDL</a>, but need
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   169
				not support every method or data type defined in <a href="#references-WebIDL">Web IDL</a> in order to
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   170
				conform to DOM3 Events).
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   171
				</p>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   172
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   173
			<p>This specification defines several classes of conformance for different
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   174
				<a class="def" href="#glossary-user-agent">user agents</a>, specifications, and content authors:
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   175
				</p>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   176
			<dl>
645
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   177
				<dt id="conf-interactive-ua">Web browsers and other dynamic or interactive
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   178
					<a class="def" href="#glossary-user-agent">user agents</a>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   179
					</dt>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   180
				<dd>
594
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   181
					<p>A dynamic or interactive <a class="def" href="#glossary-user-agent">user agent</a>, referred to
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   182
						here as a <q>browser</q> (be it a Web browser, AT (Accessibility Technology) application,
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   183
						or other similar program), conforms to DOM Level 3 Events if it supports:
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   184
						</p>
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   185
					<ul>
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   186
						<li>the Core module defined in
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   187
							[<cite><a class="normative" href="#references-DOMCore">DOM3 Core</a></cite>]
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   188
							</li>
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   189
						<li>the <a href="#event-flow">Event dispatch and DOM event flow</a> mechanism
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   190
							</li>
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   191
						<li>all the interfaces and events with their associated methods, attributes, and
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   192
							semantics defined in this specification with the exception of those marked as
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   193
							<a class="def" href="#glossary-deprecated">deprecated</a> (a conforming user
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   194
							agent MAY implement the deprecated interfaces, events, or APIs for backwards
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   195
							compatibility, but is not required to do so in order to be conforming)
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   196
							</li>
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   197
						<li>the complete set of <code>key</code> and <code>code</code> values defined in
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   198
							[<a href="#references-D3E-key">DOM3 key Values</a>] and
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   199
							[<a href="#references-D3E-code">DOM3 code Values</a>]
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   200
							(subject to platform availability), and
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   201
							</li>
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   202
						<li>all other normative requirements defined in this specification.
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   203
							</li>
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   204
					</ul>
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   205
					<p>A conforming browser MUST <a class="def" href="#glossary-dispatch">dispatch</a> events appropriate
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   206
						to the given <a href="#interface-EventTarget">EventTarget</a> when the conditions defined
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   207
						for that <a class="def" href="#glossary-event-type">event type</a> have been met.
63dcb457c1c2 Update links D3E to refer to D3E-key and D3E-code specs where appropriate. Add Normative references.
Gary Kacmarcik <garykac@google.com>
parents: 591
diff changeset
   208
						</p>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   209
645
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   210
					<p>A browser conforms specifically to DOM Level 3 Events if it implements
647
c58ce32b65cb Minor update to conformance text.
Gary Kacmarcik <garykac@google.com>
parents: 646
diff changeset
   211
						the interfaces and related <a class="def" href="#glossary-event-type">event types</a>
c58ce32b65cb Minor update to conformance text.
Gary Kacmarcik <garykac@google.com>
parents: 646
diff changeset
   212
						specified in <a href="#event-types">Event Types</a>.
645
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   213
						</p>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   214
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   215
					<p>A conforming browser MUST support scripting, declarative interactivity, or some other means of
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   216
						detecting and dispatching events in the manner described by this specification, and MUST support
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   217
						the APIs specified for that <a class="def" href="#glossary-event-type">event type</a>.
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   218
						</p>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   219
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   220
					<p>In addition to meeting all other conformance criteria, a conforming browser MAY implement
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   221
						features of this specification marked as
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   222
						<a class="def" href="#glossary-deprecated">deprecated</a>, for backwards compatibility with
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   223
						existing content, but such implementation is discouraged.
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   224
						</p>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   225
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   226
					<p>A conforming browser MAY also support features not found in this specification, but which use
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   227
						the <a href="#event-flow">Event dispatch and DOM event flow</a> mechanism, interfaces, events,
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   228
						or other features defined in DOM Level 3 Events, and MAY implement additional interfaces and
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   229
						<a class="def" href="#glossary-event-type">event types</a> appropriate to that implementation.
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   230
						Such features can be later standardized in future specifications.
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   231
						</p>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   232
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   233
					<p>A browser which does not conform to all required portions of this specification MUST NOT claim
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   234
						conformance to DOM Level 3 Events.
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   235
						Such an implementation which does conform to portions of this specification MAY claim
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   236
						conformance to those specific portions.
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   237
						</p>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   238
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   239
					<p>A conforming browser MUST also be a <i>conforming implementation</i> of the IDL fragments in this
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   240
						specification, as described in the Web IDL specification <a href="#references-WebIDL">[WEBIDL]</a>.
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   241
						</p>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   242
				</dd>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   243
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   244
				<dt id="conf-author-tools">Authoring tools</dt>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   245
				<dd>
645
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   246
					<p>A content authoring tool conforms to DOM Level 3 Events if it produces content which uses the
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   247
						<a class="def" href="#glossary-event-type">event types</a> and
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   248
						<a href="#event-flow">Event dispatch and DOM event flow</a> model, consistent in a manner as
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   249
						defined in this specification.
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   250
						</p>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   251
					<p>A content authoring tool MUST NOT claim conformance to DOM Level 3 Events for content it produces
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   252
						which uses features of this specification marked as
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   253
						<a class="def" href="#glossary-deprecated">deprecated</a> in this specification.
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   254
						</p>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   255
					<p>A conforming content authoring tool SHOULD provide to the content author a means to use all
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   256
						<a class="def" href="#glossary-event-type">event types</a> and interfaces appropriate to all
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   257
						<a class="def" href="#glossary-host-language">host languages</a> in the content document being
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   258
						produced.
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   259
						</p>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   260
				</dd>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   261
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   262
				<dt id="conf-authors">Content authors and content</dt>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   263
				<dd>
645
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   264
					<p>A content author creates conforming DOM Level 3 Events content if that content uses the
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   265
						<a class="def" href="#glossary-event-type">event types</a> and
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   266
						<a href="#event-flow">Event dispatch and DOM event flow</a> model, consistent in a manner as
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   267
						defined in this specification.
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   268
						</p>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   269
					<p>A content author SHOULD NOT use features of this specification marked as
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   270
						<a class="def" href="#glossary-deprecated">deprecated</a>, but SHOULD rely instead upon
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   271
						replacement mechanisms defined in this specification and elsewhere.
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   272
						</p>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   273
					<p>Conforming content MUST use the semantics of the interfaces and
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   274
						<a class="def" href="#glossary-event-type">event types</a> as described in this specification.
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   275
						</p>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   276
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   277
					<p class="note"><strong>Authoring Note:</strong>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   278
						Content authors are advised to follow best practices as described in
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   279
						<a href="http://www.w3.org/TR/WAI-WEBCONTENT/">accessibility</a> and
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   280
						<a href="http://www.w3.org/standards/techs/i18n">internationalization</a> guideline
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   281
						specifications.
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   282
						</p>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   283
				</dd>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   284
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   285
				<dt id="conf-specs">Specifications and host languages</dt>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   286
				<dd>
645
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   287
					<p>A specification or <a class="def" href="#glossary-host-language">host language</a> conforms
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   288
						to DOM Level 3 Events if it references and uses the
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   289
						<a href="#event-flow">Event dispatch and DOM event flow</a> mechanism, interfaces, events,
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   290
						or other features defined in [<a href="#references-DOM4">DOM4</a>], and does not extend these
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   291
						features in incompatible ways.
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   292
						</p>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   293
					<p>A specification or <a class="def" href="#glossary-host-language">host language</a> conforms
647
c58ce32b65cb Minor update to conformance text.
Gary Kacmarcik <garykac@google.com>
parents: 646
diff changeset
   294
						specifically to DOM Level 3 Events if it references and uses the interfaces and
c58ce32b65cb Minor update to conformance text.
Gary Kacmarcik <garykac@google.com>
parents: 646
diff changeset
   295
						related <a class="def" href="#glossary-event-type">event types</a> specified in
c58ce32b65cb Minor update to conformance text.
Gary Kacmarcik <garykac@google.com>
parents: 646
diff changeset
   296
						<a href="#event-types">Event Types</a>.
645
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   297
						A conforming specification MAY define additional interfaces and
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   298
						<a class="def" href="#glossary-event-type">event types</a> appropriate to that specification,
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   299
						or MAY extend the DOM Level 3 Events interfaces and
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   300
						<a class="def" href="#glossary-event-type">event types</a> in a manner that does not contradict
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   301
						or conflict with the definitions of those interfaces and
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   302
						<a class="def" href="#glossary-event-type">event types</a> in this specification.
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   303
						</p>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   304
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   305
					<p>Specifications or <a class="def" href="#glossary-host-language">host languages</a> which
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   306
						reference DOM Level 3 Events SHOULD NOT use or recommend features of this
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   307
						specification marked as <a class="def" href="#glossary-deprecated">deprecated</a>, but
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   308
						SHOULD use or recommend the indicated replacement for that the feature (if available).
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   309
						</p>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   310
				</dd>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   311
			</dl>
413
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   312
		</section>  <!-- dom-events-conformance -->
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   313
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   314
		<section id="style-conventions">
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   315
			<h2>Stylistic Conventions</h2>
613
a5ef91af0785 Fix 25559 - Spec readability: Drop some obvious "stylistic conventions" definitions (Notes, Warnings, Examples)
Travis Leithead
parents: 611
diff changeset
   316
			<p>This specification follows the <a href="http://www.w3.org/People/Schepers/spec-conventions.html">Proposed W3C Specification
a5ef91af0785 Fix 25559 - Spec readability: Drop some obvious "stylistic conventions" definitions (Notes, Warnings, Examples)
Travis Leithead
parents: 611
diff changeset
   317
				Conventions</a>, with the following supplemental additions:</p>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   318
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   319
			<dl>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   320
				<dt>Key and character values</dt>
613
a5ef91af0785 Fix 25559 - Spec readability: Drop some obvious "stylistic conventions" definitions (Notes, Warnings, Examples)
Travis Leithead
parents: 611
diff changeset
   321
				<dd><ul>
623
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   322
					<li>Names of key values are shown as: <code class="key">'='</code> (e.g., the value of 
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   323
						<a href="#widl-KeyboardEvent-key"><code>KeyboardEvent.key</code></a>).
642
0601f18fe5c1 Add missing html close tags. Remove extra cruft at end of document.
Gary Kacmarcik <garykac@google.com>
parents: 641
diff changeset
   324
						</li>
623
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   325
					<li>Names of key codes are shown as: <code class="code">'Equal'</code> (e.g., the value of 
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   326
						<a href="#widl-KeyboardEvent-code"><code>KeyboardEvent.code</code></a>).
642
0601f18fe5c1 Add missing html close tags. Remove extra cruft at end of document.
Gary Kacmarcik <garykac@google.com>
parents: 641
diff changeset
   327
						</li>
623
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   328
					<li>Character values of keys are shown as: <code class="char">'\u003d'</code> (e.g., the code point 
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   329
						of the key value).
642
0601f18fe5c1 Add missing html close tags. Remove extra cruft at end of document.
Gary Kacmarcik <garykac@google.com>
parents: 641
diff changeset
   330
						</li>
623
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   331
					<li>Glyphs representing character values are shown as: <code class="glyph">'='</code> (e.g., the
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   332
						<a href="#key-legends"><em>key cap</em></a> or font associated with a character value).
642
0601f18fe5c1 Add missing html close tags. Remove extra cruft at end of document.
Gary Kacmarcik <garykac@google.com>
parents: 641
diff changeset
   333
						</li>
613
a5ef91af0785 Fix 25559 - Spec readability: Drop some obvious "stylistic conventions" definitions (Notes, Warnings, Examples)
Travis Leithead
parents: 611
diff changeset
   334
				</ul></dd>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   335
			</dl>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   336
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   337
			<p>In addition, certain terms are used in this specification with particular meanings.  The term <q>implementation</q> applies to a browser, content authoring tool,
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   338
				or other <a class="def" href="#glossary-user-agent">user agent</a> that implements this specification, while a content author is a person who writes script or code
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   339
				that takes advantage of the interfaces, methods, attributes, events, and other features described in this specification in order to make Web applications, and a
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   340
				user is the person who uses those Web applications in an implementation.</p>
413
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   341
		</section>  <!-- style-conventions -->
614
9dc74ec13aea Fix 25510 - Spec readability: Move glossary to the bottom
Travis Leithead
parents: 613
diff changeset
   342
	</section>  <!-- dom-events-intro -->
9dc74ec13aea Fix 25510 - Spec readability: Move glossary to the bottom
Travis Leithead
parents: 613
diff changeset
   343
9dc74ec13aea Fix 25510 - Spec readability: Move glossary to the bottom
Travis Leithead
parents: 613
diff changeset
   344
	<!-- Section 2: Issues ==============================================================-->
613
a5ef91af0785 Fix 25559 - Spec readability: Drop some obvious "stylistic conventions" definitions (Notes, Warnings, Examples)
Travis Leithead
parents: 611
diff changeset
   345
	<section id="issues">
a5ef91af0785 Fix 25559 - Spec readability: Drop some obvious "stylistic conventions" definitions (Notes, Warnings, Examples)
Travis Leithead
parents: 611
diff changeset
   346
		<h1>Issues</h1>
a5ef91af0785 Fix 25559 - Spec readability: Drop some obvious "stylistic conventions" definitions (Notes, Warnings, Examples)
Travis Leithead
parents: 611
diff changeset
   347
		
a5ef91af0785 Fix 25559 - Spec readability: Drop some obvious "stylistic conventions" definitions (Notes, Warnings, Examples)
Travis Leithead
parents: 611
diff changeset
   348
		<p class="issue">Open issues in this specification are called out using this convention.</p>
a5ef91af0785 Fix 25559 - Spec readability: Drop some obvious "stylistic conventions" definitions (Notes, Warnings, Examples)
Travis Leithead
parents: 611
diff changeset
   349
	</section>
614
9dc74ec13aea Fix 25510 - Spec readability: Move glossary to the bottom
Travis Leithead
parents: 613
diff changeset
   350
	
424
a0f0f1530035 Fix many typos, capitalization and minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 423
diff changeset
   351
	<!-- Section 3: Architecture ========================================================-->
413
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   352
	<section id="dom-event-architecture">
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   353
		<h1>DOM Event Architecture</h1>
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   354
645
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   355
		<p><em>This section is informative.</em></p>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   356
413
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   357
		<section id="event-flow">
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   358
			<h2>Event dispatch and DOM event flow</h2>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   359
411
70e31ba92e14 Fold changes from the 6 Sept "branch" back onto the mainline.
Gary Kacmarcik <garykac@google.com>
parents: 409
diff changeset
   360
			<p>This section defines the event <a class="def" href="#glossary-dispatch">dispatch</a> mechanism of the event model defined in this specification.
458
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   361
				Applications MAY dispatch event objects using the <a href="#widl-EventTarget-dispatchEvent"><code>EventTarget.dispatchEvent()</code></a> method, and
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   362
				implementations MUST dispatch event objects as if through this method. The behavior of this method depends on the <em>event flow</em>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   363
				associated with the underlying object. An event flow describes how event objects <em>propagate</em> through a data structure. As an example, when an event object
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   364
				is dispatched to an element in an XML document, the object propagates through parts of the document, as determined by the DOM event flow which is defined at the
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   365
				end of this section.</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   366
530
27e8c3727373 Fixup respect errors/warnings:
garykac@google.com
parents: 527
diff changeset
   367
			<figure id="figure-dom-event-flow">
655
009a5ea207d9 Remove width from SVG figures - only specify height.
Gary Kacmarcik <garykac@google.com>
parents: 654
diff changeset
   368
				<img src='images/eventflow.svg' height="560" />
530
27e8c3727373 Fixup respect errors/warnings:
garykac@google.com
parents: 527
diff changeset
   369
				<figcaption>Graphical representation of an event dispatched in a DOM tree using the DOM event flow</figcaption>
27e8c3727373 Fixup respect errors/warnings:
garykac@google.com
parents: 527
diff changeset
   370
			</figure>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   371
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   372
			<p>Event objects are dispatched to an <a class="def" href="#glossary-event-target">event target</a>. At the beginning
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   373
				of the dispatch, implementations MUST first determine the event object's <a class="def" href="#glossary-propagation-path">propagation path</a>.</p>
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   374
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   375
			<p>The propagation path MUST be an ordered list of <a class="def" href="#glossary-current-event-target">current event targets</a> through which
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   376
				the event object MUST pass. For DOM implementations, the propagation path MUST reflect the hierarchical tree
478
5913a35e9e16 Fix lots of typos and other minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 477
diff changeset
   377
				structure of the document. The last item in the list MUST be the <a class="def" href="#glossary-event-target">event target</a>. The
411
70e31ba92e14 Fold changes from the 6 Sept "branch" back onto the mainline.
Gary Kacmarcik <garykac@google.com>
parents: 409
diff changeset
   378
				preceding items in the list are referred to as the <em>target's ancestors</em>, and the immediately preceding item as the <em>target's parent</em>. Once determined, the
478
5913a35e9e16 Fix lots of typos and other minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 477
diff changeset
   379
				propagation path MUST NOT be changed. For DOM implementations, this applies even if an element in the propagation path is moved within the
441
d0dcec6e74c8 Fix minor typos.
Gary Kacmarcik <garykac@google.com>
parents: 440
diff changeset
   380
				DOM or removed from the DOM.</p>
411
70e31ba92e14 Fold changes from the 6 Sept "branch" back onto the mainline.
Gary Kacmarcik <garykac@google.com>
parents: 409
diff changeset
   381
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   382
			<div class="example">
472
52b0e71ee63d Auto-number the Examples.
Gary Kacmarcik <garykac@google.com>
parents: 471
diff changeset
   383
				<div class="example-title"></div>
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   384
				<p>In the DOM event flow, event listeners might change the position of the <a class="def" href="#glossary-event-target">
478
5913a35e9e16 Fix lots of typos and other minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 477
diff changeset
   385
				event target</a> in the document while the event object is being dispatched. Such changes do not affect the propagation path.</p>
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   386
			</div>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   387
650
31a27ed807ff Remove basic event interface descriptions that are already specified in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 649
diff changeset
   388
			<p>Note that event listeners are not copied over when <code>Node</code> are copied using methods such as
31a27ed807ff Remove basic event interface descriptions that are already specified in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 649
diff changeset
   389
				<code>Node.cloneNode</code> or <code>Range.cloneContents</code>
31a27ed807ff Remove basic event interface descriptions that are already specified in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 649
diff changeset
   390
				[<cite><a class="informative" href="#references-DOMRange">DOM Range</a></cite>].
31a27ed807ff Remove basic event interface descriptions that are already specified in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 649
diff changeset
   391
				</p>
31a27ed807ff Remove basic event interface descriptions that are already specified in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 649
diff changeset
   392
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   393
			<p>Exceptions thrown inside event listeners MUST NOT stop the propagation of the event or affect the
424
a0f0f1530035 Fix many typos, capitalization and minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 423
diff changeset
   394
				<a class="def" href="#glossary-propagation-path">propagation path</a>. The exception itself MUST NOT propagate outside the scope of the event
389
9028f6a4b467 Fixing Bug: https://www.w3.org/Bugs/Public/show_bug.cgi?id=17714
tleithea
parents: 388
diff changeset
   395
				handler.</p>
9028f6a4b467 Fixing Bug: https://www.w3.org/Bugs/Public/show_bug.cgi?id=17714
tleithea
parents: 388
diff changeset
   396
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   397
			<div class="example">
472
52b0e71ee63d Auto-number the Examples.
Gary Kacmarcik <garykac@google.com>
parents: 471
diff changeset
   398
				<div class="example-title"></div>
424
a0f0f1530035 Fix many typos, capitalization and minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 423
diff changeset
   399
				<p>In the following code, the exception thrown from the call to <code>throw "Error"</code> does not propagate into the parent scope
389
9028f6a4b467 Fixing Bug: https://www.w3.org/Bugs/Public/show_bug.cgi?id=17714
tleithea
parents: 388
diff changeset
   400
				(which would prevent the <code>console.log</code> statement from executing):</p>
544
eb5cf0c88b21 Add comments after each </section>
garykac@google.com
parents: 543
diff changeset
   401
<pre>var e = document.createEvent("Event");
389
9028f6a4b467 Fixing Bug: https://www.w3.org/Bugs/Public/show_bug.cgi?id=17714
tleithea
parents: 388
diff changeset
   402
e.initEvent("myevent", false, false);
9028f6a4b467 Fixing Bug: https://www.w3.org/Bugs/Public/show_bug.cgi?id=17714
tleithea
parents: 388
diff changeset
   403
var target = document.createElement("div");
9028f6a4b467 Fixing Bug: https://www.w3.org/Bugs/Public/show_bug.cgi?id=17714
tleithea
parents: 388
diff changeset
   404
target.addEventListener("myevent", function () {
9028f6a4b467 Fixing Bug: https://www.w3.org/Bugs/Public/show_bug.cgi?id=17714
tleithea
parents: 388
diff changeset
   405
   throw "Error";
9028f6a4b467 Fixing Bug: https://www.w3.org/Bugs/Public/show_bug.cgi?id=17714
tleithea
parents: 388
diff changeset
   406
});
9028f6a4b467 Fixing Bug: https://www.w3.org/Bugs/Public/show_bug.cgi?id=17714
tleithea
parents: 388
diff changeset
   407
target.dispatchEvent(e); <span class="comment">// Causes the event listener to throw an exception...</span>
9028f6a4b467 Fixing Bug: https://www.w3.org/Bugs/Public/show_bug.cgi?id=17714
tleithea
parents: 388
diff changeset
   408
<span class="comment">// The previously thrown exception doesn't affect the code that follows:</span>
9028f6a4b467 Fixing Bug: https://www.w3.org/Bugs/Public/show_bug.cgi?id=17714
tleithea
parents: 388
diff changeset
   409
console.log("Exceptions? No problem");</pre>
9028f6a4b467 Fixing Bug: https://www.w3.org/Bugs/Public/show_bug.cgi?id=17714
tleithea
parents: 388
diff changeset
   410
			</div>
9028f6a4b467 Fixing Bug: https://www.w3.org/Bugs/Public/show_bug.cgi?id=17714
tleithea
parents: 388
diff changeset
   411
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   412
			<p id="event-phase">As the next step, the event object MUST complete one or more <a class="def" href="#glossary-phase">event phases</a>. This specification defines
424
a0f0f1530035 Fix many typos, capitalization and minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 423
diff changeset
   413
				three event phases: <a href="#capture-phase">capture phase</a>, <a href="#target-phase">target phase</a> and <a href="#bubble-phase">bubble phase</a>.  Event objects
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   414
				complete these phases in the specified order using the partial propagation paths as defined below. A phase MUST be skipped if it is not
458
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   415
				supported, or if the event object's propagation has been stopped. For example, if the <a href="#widl-Event-bubbles"><code>Event.bubbles</code></a>
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   416
				attribute is set to false, the bubble phase will be skipped, and if <a href="#widl-Event-stopPropagation"><code>Event.stopPropagation()</code></a> has been
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   417
				called prior to the dispatch, all phases MUST be skipped.</p>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   418
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   419
			<ol>
424
a0f0f1530035 Fix many typos, capitalization and minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 423
diff changeset
   420
				<li>The <strong id="capture-phase">capture phase</strong>: The event object MUST propagate through the target's ancestors from the <a class="def"
585
c2837d35f150 Fix 24797 - Stop using AbstractView
travil@microsoft.com
parents: 584
diff changeset
   421
					href="#glossary-window">Window</a> to the target's parent. This phase is also known as the <em>capturing phase</em>. Event
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   422
					listeners registered for this phase MUST handle the event before it reaches its target.</li>
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   423
424
a0f0f1530035 Fix many typos, capitalization and minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 423
diff changeset
   424
				<li>The <strong id="target-phase">target phase</strong>: The event object MUST arrive at the event object's <a class="def" href="#glossary-event-target">
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   425
					event target</a>. This phase is also known as the <em>at-target phase</em>. Event listeners registered for this phase MUST
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   426
					handle the event once it has reached its target. If the <a class="def" href="#glossary-event-type">event type</a> indicates that
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   427
					the event MUST NOT bubble, the event object MUST halt after completion of this phase.</li>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   428
424
a0f0f1530035 Fix many typos, capitalization and minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 423
diff changeset
   429
				<li>The <strong id="bubble-phase">bubble phase</strong>: The event object propagates through the target's ancestors in reverse order, starting
585
c2837d35f150 Fix 24797 - Stop using AbstractView
travil@microsoft.com
parents: 584
diff changeset
   430
					with the target's parent and ending with the <a class="def" href="#glossary-window">Window</a>. This phase is also known as the <em>bubbling phase</em>.
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   431
					Event listeners registered for this phase MUST handle the event after it has reached its target.</li>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   432
			</ol>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   433
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   434
			<p>Implementations MUST let event objects accomplish an event phase by applying the following steps while there are pending event targets in
458
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   435
				the partial propagation path for this phase and the event object's propagation has not been stopped through <a href="#widl-Event-stopPropagation"><code>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   436
				Event.stopPropagation()</code></a>.</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   437
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   438
			<p>First, the implementation MUST determine the <em>current target</em>. This MUST be the next pending event target in the partial propagation
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   439
				path, starting with the first. From the perspective of an event listener this MUST be the event target the listener has been registered on.</p>
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   440
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   441
			<p>Next, the implementation MUST determine the current target's <a class="def" href="#glossary-candidate-event-handlers">candidate event listeners</a>.
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   442
				This MUST be the list of all event listeners that have been registered on the current target in their order of registration. [<cite><a class="informative"
411
70e31ba92e14 Fold changes from the 6 Sept "branch" back onto the mainline.
Gary Kacmarcik <garykac@google.com>
parents: 409
diff changeset
   443
				href="#references-HTML5">HTML5</a></cite>] defines the ordering of listeners registered through event handler attributes. Once determined, the candidate event listeners
478
5913a35e9e16 Fix lots of typos and other minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 477
diff changeset
   444
				MUST NOT be changed. Adding or removing listeners does not affect the current target's candidate event listeners.</p>
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   445
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   446
			<p>Finally, the implementation MUST process all candidate <a class="def" href="#glossary-event-handler">event handlers</a> in order and trigger
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   447
				each handler if all the following conditions are met:</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   448
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   449
			<ul>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   450
				<li>The event object's immediate propagation has not been stopped.</li>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   451
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   452
				<li>The listener has been registered for this event phase.</li>
411
70e31ba92e14 Fold changes from the 6 Sept "branch" back onto the mainline.
Gary Kacmarcik <garykac@google.com>
parents: 409
diff changeset
   453
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   454
				<li>The listener has been registered for this <a class="def" href="#glossary-event-type">event type</a>.</li>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   455
			</ul>
411
70e31ba92e14 Fold changes from the 6 Sept "branch" back onto the mainline.
Gary Kacmarcik <garykac@google.com>
parents: 409
diff changeset
   456
585
c2837d35f150 Fix 24797 - Stop using AbstractView
travil@microsoft.com
parents: 584
diff changeset
   457
			<p>In the production of the <a class="def" href="#glossary-propagation-path">propagation path</a>, the event propagates from the <a class="def" href="#glossary-window">Window</a>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   458
				to the <code>document</code> object during the <a class="def" href="#glossary-capture-phase">capture phase</a>, and from the <code>document</code> object to the
585
c2837d35f150 Fix 24797 - Stop using AbstractView
travil@microsoft.com
parents: 584
diff changeset
   459
				<a class="def" href="#glossary-window">Window</a> during the <a class="def" href="#glossary-bubbling-phase">bubble phase</a>.</p>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   460
458
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   461
			<p>After an event completes all the phases of its <a class="def" href="#glossary-propagation-path">propagation path</a>, its <a href="#widl-Event-currentTarget">
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   462
				<code>Event.currentTarget</code></a> MUST be set to <code>null</code> and the <a href="#widl-Event-eventPhase"><code>Event.eventPhase</code></a> MUST be
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   463
				set to <code>0</code> (<a href="#widl-Event-NONE"><code>NONE</code></a>). All other attributes of the <code>Event</code> (or interface derived from <code>Event</code>)
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   464
				are unchanged (including the <a href="#widl-Event-target"><code>Event.target</code></a> attribute, which MUST continue to reference the <a class="def" href="#glossary-event-target">
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   465
				event target</a>).</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   466
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   467
			<p>The model defined above MUST be applied regardless of the specific event flow associated with an event target. Each event flow MUST define how the propagation path
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   468
				MUST be determined and which event phases are supported. The <em>DOM event flow</em> is an application of this model: the propagation path for a <code>Node</code>
585
c2837d35f150 Fix 24797 - Stop using AbstractView
travil@microsoft.com
parents: 584
diff changeset
   469
				object MUST be determined by its <code>Node.parentNode</code> chain, and if applicable, the document's containing <a class="def" href="#glossary-window">Window</a>.
478
5913a35e9e16 Fix lots of typos and other minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 477
diff changeset
   470
				All events accomplish the capture and target phases. Whether an event accomplishes the bubble phase MUST be defined individually for each <a class="def" href="#glossary-event-type">
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   471
				event type</a>. An alternate application of this model can be found in [<cite><a class="informative" href="#references-DOMLS">DOM3 Load and Save</a></cite>].</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   472
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   473
			<p>Implementations of the DOM event model MUST be reentrant. Event listeners MAY perform actions that cause additional events to be dispatched. Such events are handled
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   474
				in a synchronous manner, the event propagation that causes the event listener to be triggered MUST resume only after the event dispatch of the new event is completed.</p>
650
31a27ed807ff Remove basic event interface descriptions that are already specified in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 649
diff changeset
   475
544
eb5cf0c88b21 Add comments after each </section>
garykac@google.com
parents: 543
diff changeset
   476
		</section>  <!-- event-flow -->
413
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   477
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   478
		<section id="event-flow-default-cancel">
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   479
			<h2>Default actions and cancelable events</h2>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   480
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   481
			<p>Events are typically dispatched by the implementation as a result of a user action, in response to the completion of a task, or to signal progress during asynchronous
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   482
				activity (such as a network request). Some events can be used to control the behavior that the implementation MAY take next (or undo an action that the implementation
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   483
				already took). Events in this category are said to be <em>cancelable</em> and the behavior they cancel is called their <a class="def" href="#glossary-default-action">
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   484
				<em>default action</em></a>. Cancelable event objects can be associated with one or more <a class="def" href="#glossary-default-action">default actions</a>.
458
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   485
				To cancel an event, call the <a href="#widl-Event-preventDefault"><code>Event.preventDefault()</code></a> method.</p>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   486
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   487
			<div class="example">
472
52b0e71ee63d Auto-number the Examples.
Gary Kacmarcik <garykac@google.com>
parents: 471
diff changeset
   488
				<div class="example-title"></div>
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   489
				<p>A <a class="eventtype" href="#event-type-mousedown"><code>mousedown</code></a> event is dispatched immediately after the user presses down a button on a
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   490
				pointing device (typically a mouse). One possible <a class="def" href="#glossary-default-action">default action</a> taken by the implementation is to set up a state
424
a0f0f1530035 Fix many typos, capitalization and minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 423
diff changeset
   491
				machine that allows the user to drag images or select text. The <a class="def" href="#glossary-default-action">default action</a> depends on what happens next &mdash; for
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   492
				example, if the user's pointing device is over text, a text selection might begin. If the user's pointing device is over an image, then an image-drag action could
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   493
				begin. Preventing the <a class="def" href="#glossary-default-action">default action</a> of a <a class="eventtype" href="#event-type-mousedown"><code>mousedown</code></a>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   494
				event prevents these actions from occuring.</p>
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   495
			</div>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   496
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   497
			<p><a class="def" href="#glossary-default-action">Default actions</a> SHOULD be performed after the event dispatch has been completed, but in exceptional
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   498
				cases MAY also be performed immediately before the event is dispatched.</p>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   499
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   500
			<div class="example">
472
52b0e71ee63d Auto-number the Examples.
Gary Kacmarcik <garykac@google.com>
parents: 471
diff changeset
   501
				<div class="example-title"></div>
424
a0f0f1530035 Fix many typos, capitalization and minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 423
diff changeset
   502
				<p>The default action associated with the <a class="eventtype" href="#event-type-click"><code>click</code></a> event on <code>&lt;input
a0f0f1530035 Fix many typos, capitalization and minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 423
diff changeset
   503
				type="checkbox"&gt;</code> elements toggles the <code>checked</code> IDL attribute value of that element. If the <a class="eventtype" href="#event-type-click"><code>click</code>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   504
				</a> event's default action is cancelled, then the value is restored to its former state.</p>
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   505
			</div>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   506
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   507
			<p id="events-dt-cancelable-event">When an event is canceled, then the conditional <a class="def" href="#glossary-default-action">default actions</a> associated with the event MUST be skipped (or
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   508
				as mentioned above, if the <a class="def" href="#glossary-default-action">default actions</a> are carried out before the dispatch, their effect MUST be undone).
458
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   509
				Whether an event object is cancelable MUST be indicated by the <a href="#widl-Event-cancelable"><code>Event.cancelable</code></a> attribute. <a href="#widl-Event-preventDefault">
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   510
				<code>Event.preventDefault()</code></a> stops all related <a class="def" href="#glossary-default-action">default actions</a> of an event object. The <a href="#widl-Event-defaultPrevented">
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   511
				<code>Event.defaultPrevented</code></a> attribute indicates whether an event has already been canceled (e.g., by a prior event listener). If the <a class="def" href="#glossary-DOM-application">
458
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   512
				DOM application</a> itself initiated the dispatch, then the return value of the <a href="#widl-EventTarget-dispatchEvent"><code>EventTarget.dispatchEvent()</code></a>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   513
				method indicates whether the event object was cancelled.</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   514
411
70e31ba92e14 Fold changes from the 6 Sept "branch" back onto the mainline.
Gary Kacmarcik <garykac@google.com>
parents: 409
diff changeset
   515
			<p class="note"><strong>Authoring Note: </strong>Many implementations additionally interpret an event listener's return value, such as the value <code>false</code>, to mean
70e31ba92e14 Fold changes from the 6 Sept "branch" back onto the mainline.
Gary Kacmarcik <garykac@google.com>
parents: 409
diff changeset
   516
				that the <a class="def" href="#glossary-default-action">default action</a> of cancelable events will be cancelled (though <code>window.onerror</code> handlers are cancelled
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   517
				by returning <code>true</code>).</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   518
478
5913a35e9e16 Fix lots of typos and other minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 477
diff changeset
   519
			<p class="note"><strong>Authoring Note: </strong>Some cancelable events might not have any observable <a class="def" href="#glossary-default-action">default actions</a>. For
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   520
				example, the <a class="eventtype" href="#event-type-mousemove"><code>mousemove</code></a> event.</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   521
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   522
			<p>This specification does not offer features to programatically query if an event object has any <a class="def" href="#glossary-default-action">default action</a> associated with
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   523
				it, or to associate new <a class="def" href="#glossary-default-action">default actions</a> with an event object. Other specifications SHOULD define what default actions, if any,
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   524
				are associated with certain event objects. Further, implementations MAY associate <a class="def" href="#glossary-default-action">default actions</a> with events as necessary and
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   525
				appropriate for that implementation.</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   526
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   527
			<div class="example">
472
52b0e71ee63d Auto-number the Examples.
Gary Kacmarcik <garykac@google.com>
parents: 471
diff changeset
   528
				<div class="example-title"></div>
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   529
				<p>As an example, one implementation might scroll a document view by a certain amount as the <a class="def" href="#glossary-default-action">
411
70e31ba92e14 Fold changes from the 6 Sept "branch" back onto the mainline.
Gary Kacmarcik <garykac@google.com>
parents: 409
diff changeset
   530
				default action</a> of a <a class="eventtype" href="#event-type-wheel"><code>wheel</code></a> event, while another implementation might instead zoom the document as its <a class="def"
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   531
				href="#glossary-default-action">default action</a>.</p>
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   532
			</div>
544
eb5cf0c88b21 Add comments after each </section>
garykac@google.com
parents: 543
diff changeset
   533
		</section>  <!-- event-flow-default-cancel -->
413
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   534
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   535
		<section id="sync-async">
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   536
			<h2>Synchronous and asynchronous events</h2>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   537
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   538
			<p>Events MAY be dispatched either synchronously or asynchronously.</p>
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   539
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   540
			<p>Events which are synchronous (<em><q>sync events</q></em>) MUST be treated as if they are in a virtual queue in a first-in-first-out model, ordered by sequence
424
a0f0f1530035 Fix many typos, capitalization and minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 423
diff changeset
   541
				of temporal occurrence with respect to other events, to changes in the DOM, and to user interaction.  Each event in this virtual queue MUST be delayed until the
478
5913a35e9e16 Fix lots of typos and other minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 477
diff changeset
   542
				previous event has completed its propagation behavior, or been canceled.  Some sync events are driven by a specific device or process, such as mouse button events.
5913a35e9e16 Fix lots of typos and other minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 477
diff changeset
   543
				These events are governed by the <a class="def" href="#glossary-event-order">event order</a> algorithms defined for that set of events, and a user agent MUST dispatch
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   544
				these events in the defined order.</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   545
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   546
			<div class="example">
472
52b0e71ee63d Auto-number the Examples.
Gary Kacmarcik <garykac@google.com>
parents: 471
diff changeset
   547
				<div class="example-title"></div>
560
d374e5b4fe8e Fix 23912 - 'Del' -> 'Delete'
Gary Kacmarcik <garykac@google.com>
parents: 559
diff changeset
   548
				<p>A user double-clicks a passage of text to select a word, then presses the <code class="key">'Delete'</code>
456
987f6555fc6b Update hyperlinks which have been moved/redirected.
Gary Kacmarcik <garykac@google.com>
parents: 453
diff changeset
   549
				key to erase the word, triggering the following synchronous sequence of events:
987f6555fc6b Update hyperlinks which have been moved/redirected.
Gary Kacmarcik <garykac@google.com>
parents: 453
diff changeset
   550
					<a class="eventtype" href="#event-type-mousedown"><code>mousedown</code></a>,
987f6555fc6b Update hyperlinks which have been moved/redirected.
Gary Kacmarcik <garykac@google.com>
parents: 453
diff changeset
   551
					<a class="eventtype" href="#event-type-mouseup"><code>mouseup</code></a>,
987f6555fc6b Update hyperlinks which have been moved/redirected.
Gary Kacmarcik <garykac@google.com>
parents: 453
diff changeset
   552
					<a class="eventtype" href="#event-type-click"><code>click</code></a>,
987f6555fc6b Update hyperlinks which have been moved/redirected.
Gary Kacmarcik <garykac@google.com>
parents: 453
diff changeset
   553
					<a class="eventtype" href="#event-type-mousedown"><code>mousedown</code></a>,
987f6555fc6b Update hyperlinks which have been moved/redirected.
Gary Kacmarcik <garykac@google.com>
parents: 453
diff changeset
   554
					<a class="eventtype" href="#event-type-mouseup"><code>mouseup</code></a>,
987f6555fc6b Update hyperlinks which have been moved/redirected.
Gary Kacmarcik <garykac@google.com>
parents: 453
diff changeset
   555
					<a class="eventtype" href="#event-type-click"><code>click</code></a>,
987f6555fc6b Update hyperlinks which have been moved/redirected.
Gary Kacmarcik <garykac@google.com>
parents: 453
diff changeset
   556
					<a class="eventtype" href="#event-type-dblclick"><code>dblclick</code></a>,
987f6555fc6b Update hyperlinks which have been moved/redirected.
Gary Kacmarcik <garykac@google.com>
parents: 453
diff changeset
   557
					<a class="eventtype" href="#event-type-select"><code>select</code></a>,
987f6555fc6b Update hyperlinks which have been moved/redirected.
Gary Kacmarcik <garykac@google.com>
parents: 453
diff changeset
   558
					<a class="eventtype" href="#event-type-keydown"><code>keydown</code></a>,
458
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   559
					<a class="eventtype" href="#event-type-beforeinput"><code>beforeinput</code></a>,
456
987f6555fc6b Update hyperlinks which have been moved/redirected.
Gary Kacmarcik <garykac@google.com>
parents: 453
diff changeset
   560
					<a class="eventtype" href="#event-type-input"><code>input</code></a>,
987f6555fc6b Update hyperlinks which have been moved/redirected.
Gary Kacmarcik <garykac@google.com>
parents: 453
diff changeset
   561
					<a class="eventtype" href="#event-type-keyup"><code>keyup</code></a>.
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   562
				Each of these events are fired in the sequence initiated by the user's actions.</p>
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   563
			</div>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   564
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   565
			<p>Events which are asynchronous (<em><q>async events</q></em>) MAY be dispatched as the results of the action are completed, with no relation to other events, to
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   566
				other changes in the DOM, nor to user interaction.</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   567
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   568
			<div class="example">
472
52b0e71ee63d Auto-number the Examples.
Gary Kacmarcik <garykac@google.com>
parents: 471
diff changeset
   569
				<div class="example-title"></div>
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   570
				<p>During loading of a document, an inline script element is parsed and executed. The <a class="eventtype" href="#event-type-load">
411
70e31ba92e14 Fold changes from the 6 Sept "branch" back onto the mainline.
Gary Kacmarcik <garykac@google.com>
parents: 409
diff changeset
   571
				<code>load</code></a> event is queued to be fired asynchronously at the script element. However, because it is an async event, its order with relation to other synchronous
530
27e8c3727373 Fixup respect errors/warnings:
garykac@google.com
parents: 527
diff changeset
   572
				events fired during document load (such as the <code class="eventtype">DOMContentLoaded</code> event from <cite><a class="informative" href="#references-HTML5">HTML5</a></cite>) is not guaranteed.</p>
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   573
			</div>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   574
413
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   575
			<section id="event-order-and-loops">
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   576
				<h3>Event order and event loops</h3>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   577
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   578
				<p>Most events take place in a sequential context.  [<cite><a class="informative" href="#references-HTML5">HTML5</a></cite>] defines its event operations in terms
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   579
					of an event loop mechanism, in which events of all types are fed into different <em>task queues</em>.  This specification does not define events in terms of this
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   580
					event loop mechanism, but it is compatible with this mechanism.  Instead, this specification defines several operation-specific <a class="def" href="#glossary-event-order">
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   581
					event orders</a>.</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   582
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   583
				<p>Using the terminology of HTML5, each independent device, such as a mouse or keyboard, SHOULD be treated as a <em>task source</em> which feeds into the appropriate
478
5913a35e9e16 Fix lots of typos and other minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 477
diff changeset
   584
					<em>task queue</em>, in the order defined by the <a class="def" href="#glossary-event-order">event order</a> associated with that device. Each operation, such as
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   585
					a focus change or composition input, also acts as a <em>task source</em> for the appropriate <em>task queue</em>.  The resolution of these event loops is handled
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   586
					in a manner conforming to the <a class="def" href="#glossary-host-language">host language</a>, such as HTML [<cite><a class="informative" href="#references-HTML5">HTML5</a></cite>].</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   587
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   588
				<p class="note"><strong>Authoring Note:</strong> Certain events, such as <q>hotkeys</q> or control keys pressed in a certain sequence, can be
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   589
					<q>swallowed</q> by the operating system or the application, interrupting the expected <a class="def" href="#glossary-event-order">event order</a>.</p>
544
eb5cf0c88b21 Add comments after each </section>
garykac@google.com
parents: 543
diff changeset
   590
			</section>  <!-- event-order-and-loops -->
eb5cf0c88b21 Add comments after each </section>
garykac@google.com
parents: 543
diff changeset
   591
		</section>  <!-- sync-async -->
413
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   592
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   593
		<section id="trusted-events">
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   594
			<h2>Trusted events</h2>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   595
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   596
			<p>Events that are generated by the user agent, either as a result of user interaction, or as a direct result of changes to the DOM, are trusted by the user agent
458
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   597
				with privileges that are not afforded to events generated by script through the <a href="#widl-DocumentEvent-createEvent"><code>DocumentEvent.createEvent("Event")</code></a>
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   598
				method, modified using the <a href="#widl-Event-initEvent"><code>Event.initEvent()</code></a> method, or dispatched via the <a href="#widl-EventTarget-dispatchEvent">
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   599
				<code>EventTarget.dispatchEvent()</code></a> method.  The <a href="#widl-Event-isTrusted"><code>isTrusted</code></a> attribute of trusted events has a
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   600
				value of <code>true</code>, while untrusted events have a <a href="#widl-Event-isTrusted"><code>isTrusted</code></a> attribute value of <code>false</code>.</p>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   601
599
ddb380ad70de Fix 25365 - About trusted="false" in two event orders
Travis Leithead
parents: 598
diff changeset
   602
			<p>Most untrusted events SHOULD NOT trigger <a class="def" href="#glossary-default-action">default actions</a>, with the exception of the <a class="eventtype" href="#event-type-click">
ddb380ad70de Fix 25365 - About trusted="false" in two event orders
Travis Leithead
parents: 598
diff changeset
   603
				<code>click</code></a> event. This event always triggers the <a class="def" href="#glossary-default-action">
ddb380ad70de Fix 25365 - About trusted="false" in two event orders
Travis Leithead
parents: 598
diff changeset
   604
				default action</a>, even if the <a href="#widl-Event-isTrusted"><code>isTrusted</code></a> attribute is <code>false</code> (this behavior is retained for backward-compatibility).
ddb380ad70de Fix 25365 - About trusted="false" in two event orders
Travis Leithead
parents: 598
diff changeset
   605
				All other untrusted events MUST behave
458
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   606
				as if the <a href="#widl-Event-preventDefault"><code>Event.preventDefault()</code></a> method had been called on that event.</p>
544
eb5cf0c88b21 Add comments after each </section>
garykac@google.com
parents: 543
diff changeset
   607
		</section>  <!-- trusted-events -->
413
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   608
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   609
		<section id="event-flow-activation">
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   610
			<h2>Activation triggers and behavior</h2>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   611
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   612
			<p>Certain <a class="def" href="#glossary-event-target">event targets</a> (such as a link or button element) MAY have associated <a class="def" href="#glossary-activation-behavior">
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   613
				activation behavior</a> (such a following a link) that implementations perform in response to an <em><a class="def" href="#glossary-activation-trigger">activation
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   614
				trigger</a></em> (such as clicking a link).</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   615
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   616
			<p>A <a class="def" href="#glossary-host-language">host language</a> SHOULD indicate which, if any, elements have activation behavior, describe appropriate <a class="def"
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   617
				href="#glossary-activation-trigger">activation triggers</a>, and define the result of that activation behavior.  An implementation which supports a <a class="def"
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   618
				href="#glossary-host-language">host language</a> SHOULD initiate these <a class="def" href="#glossary-activation-behavior">activation behavior</a> when the associated
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   619
				<a class="def" href="#glossary-activation-trigger">activation trigger</a> occurs.</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   620
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   621
			<div class="example" id="example-activation">
472
52b0e71ee63d Auto-number the Examples.
Gary Kacmarcik <garykac@google.com>
parents: 471
diff changeset
   622
				<div class="example-title"></div>
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   623
				<p>Both HTML and SVG have an <code>&lt;a&gt;</code> element which indicates a link.  Relevant <a
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   624
				class="def" href="#glossary-activation-trigger">activation triggers</a> for an <code>&lt;a&gt;</code> element are a <a class="eventtype" href="#event-type-click"><code>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   625
				click</code></a> event on the text or image  content of the <code>&lt;a&gt;</code> element, or a <a class="eventtype" href="#event-type-keydown"><code>keydown</code></a>
623
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   626
				event with a <a href="#widl-KeyboardEvent-key">key</a> attribute value of <code class="key">'Enter'</code> key when the <code>&lt;a&gt;</code>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   627
				element has focus.  The activation behavior for an <code>&lt;a&gt;</code> element is normally to change the content of the window to the content of the new document,
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   628
				in the case of external links, or to reposition the current document relative to the new anchor, in the case of internal links.</p>
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   629
			</div>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   630
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   631
			<p>An <a class="def" href="#glossary-activation-trigger">activation trigger</a> is a user action or an event which indicates to the implementation that an activation
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   632
				behavior SHOULD be initiated.  User-initiated <a class="def" href="#glossary-activation-trigger">activation triggers</a> include clicking a mouse button on an activatable
623
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   633
				element, pressing the <code class="key">'Enter'</code> key when an activatable element has focus, or pressing a key that is somehow
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   634
				linked to an activatable element (a <q>hotkey</q> or <q>access key</q>) even when that element does not have focus.  Event-based <a class="def" href="#glossary-activation-trigger">
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   635
				activation triggers</a> MAY include timer-based events that activate an element at a certain clock time or after a certain time period has elapsed, progress
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   636
				events after a certain action has been completed, or many other condition-based or state-based events.</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   637
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   638
			<p>In some cases, a <a class="def" href="#glossary-host-language">host language</a> MAY define attributes or even attribute values which add to or change the native
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   639
				<a class="def" href="#glossary-activation-trigger">activation trigger</a> or <a class="def" href="#glossary-activation-behavior">activation behavior</a> of an element.
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   640
				For example, ARIA [<cite><a class="informative" href="#ref-ARIA">ARIA</a></cite>] defines values for the <code class="attr">role</code> attribute that add semantics
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   641
				to the element to which it is applied, for purposes of enhanced accessibility.  In such cases, if the <a class="def" href="#glossary-host-language">host language</a>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   642
				does not explicitly define the <a class="def" href="#glossary-activation-trigger">activation trigger</a> or <a class="def" href="#glossary-activation-behavior">activation
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   643
				behavior</a>, the content author MUST provide the mechanics of the <a class="def" href="#glossary-activation-trigger">activation trigger</a> (via an event listener)
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   644
				or <a class="def" href="#glossary-activation-behavior">activation behavior</a> (such as calling an ECMAScript function) for that element when applying that attribute
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   645
				or attribute value.</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   646
413
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   647
			<section id="click-synthesis">
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   648
				<h3>Activation event synthesis</h3>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   649
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   650
				<p>If the instance of the <a class="def" href="#glossary-activation-trigger">activation trigger</a> is not an event of <a class="def" href="#glossary-event-type">event
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   651
					type</a> <a class="eventtype" href="#event-type-click"><code>click</code></a> (that is, when it does not result from a user's activation of a button or link
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   652
					using a mouse or equivalent pointing device), the implementation MUST synthesize and dispatch an event of <a class="def" href="#glossary-event-type">event type</a> <a
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   653
					class="eventtype" href="#event-type-click"><code>click</code></a> as one of the <a class="def" href="#glossary-default-action">default actions</a> of that <a class="def"
458
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   654
					href="#glossary-activation-trigger">activation trigger</a>. The value of the <code class="attribute-name"><a href="#widl-Event-target">Event.target</a></code>
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   655
					MUST be set to the <a class="def" href="#glossary-event-target">event target</a> (normally, the currently focused element), and the event MUST simulate a <em>left
457
e6c1ebba556e Correct internal links for WheelEvent, MouseEvent, UIEvent, KeyboardEvent, MutationEvent.
Gary Kacmarcik <garykac@google.com>
parents: 456
diff changeset
   656
					click</em> (i.e., the <a href="#widl-MouseEvent-button"><code>MouseEvent.button</code></a> attribute value MUST be <code>0</code>, and the <a href="#widl-MouseEvent-buttons">
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   657
					<code>MouseEvent.buttons</code></a> attribute value MUST be <code>1</code>).  Other context information of such a simulated <a class="eventtype" href="#event-type-click">
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   658
					<code>click</code></a> event is implementation dependent, but for historical purposes, the interface for the <a class="eventtype" href="#event-type-click"><code>click</code></a>
457
e6c1ebba556e Correct internal links for WheelEvent, MouseEvent, UIEvent, KeyboardEvent, MutationEvent.
Gary Kacmarcik <garykac@google.com>
parents: 456
diff changeset
   659
					event MUST be the <a href="#interface-MouseEvent"><code>MouseEvent interface</code></a>, regardless of the actual device used to activate the element.  Preventing
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   660
					the <a class="def" href="#glossary-default-action">default action</a> of the <a class="def" href="#glossary-activation-trigger">activation trigger</a>, such as
458
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   661
					with the <a href="#widl-Event-preventDefault"><code>Event.preventDefault()</code></a>, MUST stop the initiation of the <a class="def" href="#glossary-activation-behavior">
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   662
					activation behavior</a>.</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   663
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   664
				<div class="example">
472
52b0e71ee63d Auto-number the Examples.
Gary Kacmarcik <garykac@google.com>
parents: 471
diff changeset
   665
					<div class="example-title"></div>
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   666
					<p>When a user activates a hyperlink using a keyboard, such as by focusing the hyperlink element
623
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   667
					and pressing the <code class="key">'Enter'</code> or <code class="key">'&nbsp;'</code> key, a <a class="eventtype"
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   668
					href="#event-type-click"><code>click</code></a> event would be dispatched as the <a class="def" href="#glossary-default-action">default action</a> of the respective
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   669
					<a class="eventtype" href="#event-type-keydown"><code>keydown</code></a> event.</p>
418
4998aa3eb6a5 Consistent formatting for Examples, Notes and Warnings.
Gary Kacmarcik <garykac@google.com>
parents: 417
diff changeset
   670
				</div>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   671
423
5913e7ca1b9a Remove manual formatting around MAY, SHOULD, MUST, et al.
Gary Kacmarcik <garykac@google.com>
parents: 422
diff changeset
   672
				<p>Implementations MUST dispatch the synthesized <a class="eventtype" href="#event-type-click"><code>click</code></a> event as described above even if they do not
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   673
					normally dispatch such an event (e.g., when activation is requested by a voice command, since this specification does not address <a class="def" href="#glossary-event-type">
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   674
					event types</a> for voice input).</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   675
411
70e31ba92e14 Fold changes from the 6 Sept "branch" back onto the mainline.
Gary Kacmarcik <garykac@google.com>
parents: 409
diff changeset
   676
				<p class="note"><strong>Note:</strong> The activation of an event target is device dependent, but is also application dependent, e.g., a link in a document can be activated
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   677
					using a mouse click or a mouse double click.</p>
544
eb5cf0c88b21 Add comments after each </section>
garykac@google.com
parents: 543
diff changeset
   678
			</section>  <!-- click-synthesis -->
413
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   679
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   680
			<section id="events-activation-event-order">
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   681
				<h3>Activation event order</h3>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   682
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   683
				<p>Activation triggers and behavior can be defined in part by the events which are dispatched in a set order relative to one another.  The following is the typical
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   684
					sequence of events for an element activated by a pointing device (with only pertinent events listed):</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   685
463
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   686
				<table class="event-sequence-table">
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   687
					<tr>
623
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   688
						<td class="cell-number"></td>
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   689
						<th>Event Name</th>
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   690
						<th>Notes</th>
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   691
					</tr>
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   692
					<tr>
463
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   693
						<td class="cell-number">1.</td>
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   694
						<td><a class="eventtype" href="#event-type-click"><code>click</code></a></td>
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   695
						<td></td>
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   696
					</tr>
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   697
					<tr>
623
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   698
						<td class="cell-number"></td>
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   699
						<td></td>
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   700
						<td>
463
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   701
							<em>All <a class="def" href="#glossary-default-action">default actions</a>,
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   702
							including the <a class="def" href="#glossary-activation-behavior">activation behavior</a></em>
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   703
						</td>
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   704
					</tr>
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   705
				</table>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   706
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   707
				<p>The following is the typical sequence of events when a focused element is activated by a key event (with only pertinent events listed):</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   708
463
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   709
				<table class="event-sequence-table">
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   710
					<tr>
623
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   711
						<td class="cell-number"></td>
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   712
						<th>Event Name</th>
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   713
						<th>Notes</th>
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   714
					</tr>
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   715
					<tr>
463
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   716
						<td class="cell-number">1.</td>
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   717
						<td><a class="eventtype" href="#event-type-keydown"><code>keydown</code></a></td>
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   718
						<td>MUST be a key which can activate the element, such as the
623
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   719
							<code class="key">'Enter'</code> or <code class="key">'&nbsp;'</code> key,
463
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   720
							or the element is not activated</td>
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   721
					</tr>
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   722
					<tr>
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   723
						<td class="cell-number">2.</td>
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   724
						<td><a class="eventtype" href="#event-type-click"><code>click</code></a></td>
599
ddb380ad70de Fix 25365 - About trusted="false" in two event orders
Travis Leithead
parents: 598
diff changeset
   725
						<td><a class="def" href="#glossary-default-action">default action</a>; synthesized; <code>isTrusted="true"</code></td>
463
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   726
					</tr>
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   727
					<tr>
623
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   728
						<td class="cell-number"></td>
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   729
						<td></td>
a2c0d8dc96f5 Fix 25539 - Broken links and other correct
Travis Leithead
parents: 622
diff changeset
   730
						<td>
463
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   731
							<em>All <a class="def" href="#glossary-default-action">default actions</a>,
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   732
							including the <a class="def" href="#glossary-activation-behavior">activation behavior</a></em>
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   733
						</td>
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   734
					</tr>
1b4e14ed10f6 Update event order tables to use consistent formatting.
Gary Kacmarcik <garykac@google.com>
parents: 462
diff changeset
   735
				</table>
544
eb5cf0c88b21 Add comments after each </section>
garykac@google.com
parents: 543
diff changeset
   736
			</section>  <!-- events-activation-event-order -->
eb5cf0c88b21 Add comments after each </section>
garykac@google.com
parents: 543
diff changeset
   737
		</section>  <!-- event-flow-activation -->
413
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   738
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   739
		<section id="event-exceptions">
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   740
			<h2>Event exceptions</h2>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   741
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   742
			<p><em>This section is informative.</em></p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   743
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   744
			<p>Event operations can throw a <code>DOMException</code> as specified in their method descriptions.</p>
411
70e31ba92e14 Fold changes from the 6 Sept "branch" back onto the mainline.
Gary Kacmarcik <garykac@google.com>
parents: 409
diff changeset
   745
424
a0f0f1530035 Fix many typos, capitalization and minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 423
diff changeset
   746
			<p class="note" id="note-eventexcpetion-removed"><strong>Note:</strong> The exception <em>EventException</em> introduced in <strong class="version">DOM Level 2</strong> is
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   747
				removed in this specification as part of this specification's normative support of <a href="#references-WebIDL">Web IDL</a>. <em>EventException</em> formerly defined
411
70e31ba92e14 Fold changes from the 6 Sept "branch" back onto the mainline.
Gary Kacmarcik <garykac@google.com>
parents: 409
diff changeset
   748
				an exception code <code>UNSPECIFIED_EVENT_TYPE_ERR</code> which is replaced in this specification by the use of a <code>DOMException</code> of type
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   749
				<code>InvalidStateError</code>.</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   750
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   751
			<p>The following <code>DOMException</code> types are used in this specification.</p>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   752
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   753
			<table class="exceptiontable" summary="Layout table: the first cell contains the name of the DOMException type, the second contains a short description">
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   754
				<tr>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   755
					<th>Type</th>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   756
					<th>Description</th>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   757
				</tr>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   758
				<tr>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   759
					<td><code><dfn>InvalidStateError</dfn></code></td>
458
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   760
					<td>Thrown when the <a href="#widl-Event-type"><code>Event.type</code></a> was not specified by initializing the event before <code>dispatchEvent</code> was
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   761
						called. Also thrown when the <a href="#interface-Event"><code>Event</code></a> object provided to <code>dispatchEvent</code> is already being dispatched.</td>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   762
				</tr>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   763
				<tr>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   764
					<td><code><dfn>NotSupportedError</dfn></code></td>
458
56ce2469eeb4 Correct remaining internal links to point to correct location.
Gary Kacmarcik <garykac@google.com>
parents: 457
diff changeset
   765
					<td>Thrown when <a href="#widl-DocumentEvent-createEvent"><code>DocumentEvent.createEvent()</code></a> is passed an <a href="#interface-Event"><code>Event</code></a>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   766
						interface that the implementation does not support.</td>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   767
				</tr>
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   768
			</table>
544
eb5cf0c88b21 Add comments after each </section>
garykac@google.com
parents: 543
diff changeset
   769
		</section>  <!-- event-exceptions -->
413
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   770
	</section>  <!-- dom-event-architecture -->
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   771
424
a0f0f1530035 Fix many typos, capitalization and minor formatting issues.
Gary Kacmarcik <garykac@google.com>
parents: 423
diff changeset
   772
	<!-- Section 4: Basic Event Interfaces ========================================================-->
413
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   773
	<section id="event-interfaces">
7807985d4615 Convert document to use respec.
Gary Kacmarcik <garykac@google.com>
parents: 411
diff changeset
   774
		<h1>Basic Event Interfaces</h1>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   775
651
ef1a84d5c3db Minor edits to event interface intro.
Gary Kacmarcik <garykac@google.com>
parents: 650
diff changeset
   776
		<p>The basic event interfaces defined in DOM4
ef1a84d5c3db Minor edits to event interface intro.
Gary Kacmarcik <garykac@google.com>
parents: 650
diff changeset
   777
			[<a href="#references-DOM4">DOM4</a>] are fundamental to DOM Level 3 Events.
649
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   778
			These basic event interfaces MUST always be supported by the implementation:
551
7732919a7eaa Fold constructor info from Appendix into main text body for each event.
garykac@garykac-macbookair.roam.corp.google.com
parents: 550
diff changeset
   779
			</p>
7732919a7eaa Fold constructor info from Appendix into main text body for each event.
garykac@garykac-macbookair.roam.corp.google.com
parents: 550
diff changeset
   780
649
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   781
		<ul>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   782
			<li>The <dfn id="interface-Event"><code>Event</code></dfn> interface and its following constants, methods and attributes:
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   783
				<ul>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   784
					<li><dfn id="widl-Event-NONE"><code>NONE</code></dfn> constant</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   785
					<li><dfn id="widl-Event-CAPTURING_PHASE"><code>CAPTURING_PHASE</code></dfn> constant</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   786
					<li><dfn id="widl-Event-AT_TARGET"><code>AT_TARGET</code></dfn> constant</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   787
					<li><dfn id="widl-Event-BUBBLING_PHASE"><code>BUBBLING_PHASE</code></dfn> constant</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   788
					<li><dfn id="widl-Event-type"><code>type</code></dfn> attribute</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   789
					<li><dfn id="widl-Event-target"><code>target</code></dfn> attribute</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   790
					<li><dfn id="widl-Event-currentTarget"><code>currentTarget</code></dfn> attribute</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   791
					<li><dfn id="widl-Event-eventPhase"><code>eventPhase</code></dfn> attribute</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   792
					<li><dfn id="widl-Event-bubbles"><code>bubbles</code></dfn> attribute</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   793
					<li><dfn id="widl-Event-cancelable"><code>cancelable</code></dfn> attribute</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   794
					<li><dfn id="widl-Event-timeStamp"><code>timeStamp</code></dfn> attribute</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   795
					<li><dfn id="widl-Event-defaultPrevented"><code>defaultPrevented</code></dfn> attribute</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   796
					<li><dfn id="widl-Event-isTrusted"><code>isTrusted</code></dfn> attribute</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   797
					<li><dfn id="widl-Event-stopPropagation"><code>stopPropagation()</code></dfn> method</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   798
					<li><dfn id="widl-Event-stopImmediatePropagation"><code>stopImmediatePropagation()</code></dfn> method</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   799
					<li><dfn id="widl-Event-preventDefault"><code>preventDefault()</code></dfn> method</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   800
					<li><dfn id="widl-Event-initEvent"><code>initEvent()</code></dfn> method</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   801
				</ul>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   802
			</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   803
			<li>The <dfn id="interface-CustomEvent"><code>CustomEvent</code></dfn> interface and its following method and attribute:
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   804
				<ul>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   805
					<li><dfn id="widl-CustomEvent-initCustomEvent"><code>initCustomEvent()</code></dfn> method</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   806
					<li><dfn id="widl-CustomEvent-detail"><code>detail</code></dfn> attribute</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   807
				</ul>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   808
			</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   809
			<li>The <dfn id="interface-EventTarget"><code>EventTarget</code></dfn> interface and its following methods:
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   810
				<ul>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   811
					<li><dfn id="widl-EventTarget-addEventListener"><code>addEventListener()</code></dfn> method</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   812
					<li><dfn id="widl-EventTarget-removeEventListener"><code>removeEventListener()</code></dfn> method</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   813
					<li><dfn id="widl-EventTarget-dispatchEvent"><code>dispatchEvent()</code></dfn> method</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   814
				</ul>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   815
			</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   816
			<li>The <dfn id="interface-EventListener"><code>EventListener</code></dfn> interface and its <dfn id="widl-EventListener-handleEvent"><code>handleEvent</code></dfn> method</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   817
			<li>The <code>Document</code> interface's <dfn id="widl-DocumentEvent-createEvent"><code>createEvent</code></dfn> method</li>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   818
		</ul>
8fdcddfa5b40 Add table with list of events defined in DOM4.
Gary Kacmarcik <garykac@google.com>
parents: 647
diff changeset
   819
551
7732919a7eaa Fold constructor info from Appendix into main text body for each event.
garykac@garykac-macbookair.roam.corp.google.com
parents: 550
diff changeset
   820
		<p>The event types defined in this specification derive from these basic interfaces, and MUST
7732919a7eaa Fold constructor info from Appendix into main text body for each event.
garykac@garykac-macbookair.roam.corp.google.com
parents: 550
diff changeset
   821
			inherit all of the attributes, methods, and constants of the interfaces they derive from.
651
ef1a84d5c3db Minor edits to event interface intro.
Gary Kacmarcik <garykac@google.com>
parents: 650
diff changeset
   822
			</p>
ef1a84d5c3db Minor edits to event interface intro.
Gary Kacmarcik <garykac@google.com>
parents: 650
diff changeset
   823
		<p>The following chart describes the inheritance structure of interfaces defined in this specification.
551
7732919a7eaa Fold constructor info from Appendix into main text body for each event.
garykac@garykac-macbookair.roam.corp.google.com
parents: 550
diff changeset
   824
			</p>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   825
530
27e8c3727373 Fixup respect errors/warnings:
garykac@google.com
parents: 527
diff changeset
   826
		<figure id="figure-event-inheritance">
655
009a5ea207d9 Remove width from SVG figures - only specify height.
Gary Kacmarcik <garykac@google.com>
parents: 654
diff changeset
   827
			<img src='images/event-inheritance.svg' height="230" />
530
27e8c3727373 Fixup respect errors/warnings:
garykac@google.com
parents: 527
diff changeset
   828
			<figcaption>Graphical representation of the DOM3 Events interface inheritance</figcaption>
27e8c3727373 Fixup respect errors/warnings:
garykac@google.com
parents: 527
diff changeset
   829
		</figure>
375
573812ecd594 Updates for WD publication:
tleithea
parents: 373
diff changeset
   830
645
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   831
		<section id="event-types-list">
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   832
			<h3>List of Event Types</h3>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   833
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   834
			<p>Each event MUST be associated with a type, called <em>event type</em> and available as the <a href="#widl-Event-type"><code class="interface-attribute">type</code></a>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   835
				attribute on the event object. The event type MUST be of type <code>DOMString</code>.</p>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   836
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   837
			<p>Depending on the level of DOM support, or the devices used for display (e.g., screen) or interaction (e.g., mouse, keyboard, touch screen, or voice), these event
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   838
				types can be generated by the implementation. When used with an [<cite><a class="informative" href="#references-XML">XML 1.0</a></cite>] or
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   839
				[<cite><a class="informative" href="#references-HTML5">HTML5</a></cite>] application, the specifications of those languages MAY restrict the
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   840
				semantics and scope (in particular the possible <a class="def" href="#glossary-event-target">event targets</a>) associated
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   841
				with an event type. Refer to the specification defining the language used in order to find those restrictions or to find event types that are
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   842
				not defined in this document.</p>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   843
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   844
			<p>The following table provides an informative summary of the event types defined in this specification.</p>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   845
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   846
			<table class="data-table"
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   847
				summary="This table contains the complete list of event types defined by DOM Level 3 Events. The first column contains the local name of the event type. The second column indicates if the event accomplish the bubbling phase or not (all events accomplish the capture and target phases). The third column indicates if the default action associated with the event can be canceled. The fourth column indicates the nodes that can be target of the event. the fifth (and last) column indicates the DOM interface implemented by the event object.">
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   848
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   849
					<th>Event Type</th>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   850
					<th>Sync / Async</th>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   851
					<th>Bubbling phase</th>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   852
					<th>Trusted event target types</th>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   853
					<th>DOM interface</th>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   854
					<th>Cancelable</th>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   855
					<th>Default Action</th>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   856
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   857
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   858
					<td><a class="eventtype" href="#event-type-abort"><code>abort</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   859
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   860
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   861
					<td><a class="def" href="#glossary-window"><code>Window</code></a>, <code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   862
					<td><a href="#interface-Event"><code>Event</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   863
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   864
					<td>None</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   865
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   866
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   867
					<td><a class="eventtype" href="#event-type-beforeinput"><code>beforeinput</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   868
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   869
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   870
					<td><code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   871
					<td><a href="#interface-InputEvent"><code>InputEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   872
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   873
					<td>Update the DOM element</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   874
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   875
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   876
					<td><a class="eventtype" href="#event-type-blur"><code>blur</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   877
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   878
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   879
					<td><a class="def" href="#glossary-window"><code>Window</code></a>, <code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   880
					<td><a href="#interface-FocusEvent"><code>FocusEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   881
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   882
					<td>None</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   883
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   884
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   885
					<td><a class="eventtype" href="#event-type-click"><code>click</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   886
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   887
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   888
					<td><code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   889
					<td><a href="#interface-MouseEvent"><code>MouseEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   890
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   891
					<td>Varies:
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   892
						for <a class="def" href="#glossary-event-target">targets</a> with an associated activation 
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   893
						behavior, executes the <a class="def" href="#glossary-activation-behavior">activation behavior</a>;
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   894
						for focusable <a class="def" href="#glossary-event-target">targets</a>, gives the element focus.
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   895
					</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   896
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   897
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   898
					<td><a class="eventtype" href="#event-type-compositionstart"><code>compositionstart</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   899
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   900
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   901
					<td><code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   902
					<td><a href="#interface-CompositionEvent"><code>CompositionEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   903
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   904
					<td>Show a <a class="def" href="#glossary-text-composition-system">text composition system</a> candidate window</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   905
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   906
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   907
					<td><a class="eventtype" href="#event-type-compositionupdate"><code>compositionupdate</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   908
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   909
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   910
					<td><code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   911
					<td><a href="#interface-CompositionEvent"><code>CompositionEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   912
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   913
					<td>None</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   914
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   915
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   916
					<td><a class="eventtype" href="#event-type-compositionend"><code>compositionend</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   917
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   918
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   919
					<td><code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   920
					<td><a href="#interface-CompositionEvent"><code>CompositionEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   921
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   922
					<td>None</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   923
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   924
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   925
					<td><a class="eventtype" href="#event-type-dblclick"><code>dblclick</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   926
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   927
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   928
					<td><code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   929
					<td><a href="#interface-MouseEvent"><code>MouseEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   930
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   931
					<td>Varies:
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   932
						for <a class="def" href="#glossary-event-target">targets</a> with an associated activation 
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   933
						behavior, executes the <a class="def" href="#glossary-activation-behavior">activation behavior</a>;
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   934
						for focusable <a class="def" href="#glossary-event-target">targets</a>, gives the element focus;
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   935
						for selectable <a class="def" href="#glossary-event-target">targets</a>, selects part or all of the 
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   936
						element's content.
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   937
					</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   938
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   939
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   940
					<td><a class="eventtype" href="#event-type-error"><code>error</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   941
					<td>Async</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   942
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   943
					<td><a class="def" href="#glossary-window"><code>Window</code></a>, <code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   944
					<td><a href="#interface-Event"><code>Event</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   945
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   946
					<td>None</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   947
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   948
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   949
					<td><a class="eventtype" href="#event-type-focus"><code>focus</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   950
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   951
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   952
					<td><a class="def" href="#glossary-window"><code>Window</code></a>, <code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   953
					<td><a href="#interface-FocusEvent"><code>FocusEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   954
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   955
					<td>None</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   956
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   957
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   958
					<td><a class="eventtype" href="#event-type-focusin"><code>focusin</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   959
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   960
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   961
					<td><a class="def" href="#glossary-window"><code>Window</code></a>, <code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   962
					<td><a href="#interface-FocusEvent"><code>FocusEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   963
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   964
					<td>None</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   965
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   966
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   967
					<td><a class="eventtype" href="#event-type-focusout"><code>focusout</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   968
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   969
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   970
					<td><a class="def" href="#glossary-window"><code>Window</code></a>, <code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   971
					<td><a href="#interface-FocusEvent"><code>FocusEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   972
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   973
					<td>None</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   974
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   975
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   976
					<td><a class="eventtype" href="#event-type-input"><code>input</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   977
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   978
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   979
					<td><code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   980
					<td><a href="#interface-InputEvent"><code>InputEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   981
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   982
					<td>None</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   983
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   984
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   985
					<td><a class="eventtype" href="#event-type-keydown"><code>keydown</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   986
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   987
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   988
					<td><code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   989
					<td><a href="#interface-KeyboardEvent"><code>KeyboardEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   990
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   991
					<td>Varies:
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   992
						<a class="eventtype" href="#event-type-beforeinput"><code>beforeinput</code></a> and <a class="eventtype" href="#event-type-input"><code>input</code></a> events;
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   993
						launch <a class="def" href="#glossary-text-composition-system">text composition system</a>;
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   994
						<a class="eventtype" href="#event-type-blur"><code>blur</code></a> and <a class="eventtype" href="#event-type-focus"><code>focus</code></a> events;
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   995
						<a class="eventtype" href="#event-type-keypress"><code>keypress</code></a> event;
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   996
						<a class="def" href="#glossary-activation-behavior">activation behavior</a>;
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   997
						other event</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   998
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
   999
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1000
					<td><a class="eventtype" href="#event-type-keyup"><code>keyup</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1001
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1002
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1003
					<td><code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1004
					<td><a href="#interface-KeyboardEvent"><code>KeyboardEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1005
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1006
					<td>None</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1007
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1008
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1009
					<td><a class="eventtype" href="#event-type-load"><code>load</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1010
					<td>Async</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1011
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1012
					<td><a class="def" href="#glossary-window"><code>Window</code></a>, <code>Document</code>, <code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1013
					<td><a href="#interface-Event"><code>Event</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1014
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1015
					<td>None</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1016
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1017
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1018
					<td><a class="eventtype" href="#event-type-mousedown"><code>mousedown</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1019
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1020
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1021
					<td><code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1022
					<td><a href="#interface-MouseEvent"><code>MouseEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1023
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1024
					<td>Varies: start a drag/drop operation; start a text selection; start a scroll/pan interaction (in combination with the middle mouse button, if supported)</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1025
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1026
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1027
					<td><a class="eventtype" href="#event-type-mouseenter"><code>mouseenter</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1028
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1029
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1030
					<td><code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1031
					<td><a href="#interface-MouseEvent"><code>MouseEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1032
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1033
					<td>None</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1034
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1035
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1036
					<td><a class="eventtype" href="#event-type-mouseleave"><code>mouseleave</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1037
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1038
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1039
					<td><code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1040
					<td><a href="#interface-MouseEvent"><code>MouseEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1041
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1042
					<td>None</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1043
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1044
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1045
					<td><a class="eventtype" href="#event-type-mousemove"><code>mousemove</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1046
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1047
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1048
					<td><code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1049
					<td><a href="#interface-MouseEvent"><code>MouseEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1050
					<td><a href="#mousemove-now-cancelable">Yes</a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1051
					<td>None</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1052
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1053
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1054
					<td><a class="eventtype" href="#event-type-mouseout"><code>mouseout</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1055
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1056
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1057
					<td><code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1058
					<td><a href="#interface-MouseEvent"><code>MouseEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1059
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1060
					<td>None</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1061
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1062
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1063
					<td><a class="eventtype" href="#event-type-mouseover"><code>mouseover</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1064
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1065
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1066
					<td><code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1067
					<td><a href="#interface-MouseEvent"><code>MouseEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1068
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1069
					<td>None</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1070
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1071
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1072
					<td><a class="eventtype" href="#event-type-mouseup"><code>mouseup</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1073
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1074
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1075
					<td><code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1076
					<td><a href="#interface-MouseEvent"><code>MouseEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1077
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1078
					<td>Invoke a context menu (in combination with the right mouse button, if supported)</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1079
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1080
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1081
					<td><a class="eventtype" href="#event-type-resize"><code>resize</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1082
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1083
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1084
					<td><a class="def" href="#glossary-window"><code>Window</code></a>, <code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1085
					<td><a href="#interface-UIEvent"><code>UIEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1086
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1087
					<td>None</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1088
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1089
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1090
					<td><a class="eventtype" href="#event-type-scroll"><code>scroll</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1091
					<td>Async</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1092
					<td>No / <a href="#scroll-document">Yes</a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1093
					<td><code>Document</code>, <code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1094
					<td><a href="#interface-UIEvent"><code>UIEvent</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1095
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1096
					<td>None</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1097
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1098
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1099
					<td><a class="eventtype" href="#event-type-select"><code>select</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1100
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1101
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1102
					<td><code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1103
					<td><a href="#interface-Event"><code>Event</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1104
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1105
					<td>None</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1106
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1107
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1108
					<td><a class="eventtype" href="#event-type-unload"><code>unload</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1109
					<td>Sync</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1110
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1111
					<td><a class="def" href="#glossary-window"><code>Window</code></a>, <code>Document</code>, <code>Element</code></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1112
					<td><a href="#interface-Event"><code>Event</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1113
					<td>No</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1114
					<td>None</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1115
				</tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1116
				<tr>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1117
					<td><a class="eventtype" href="#event-type-wheel"><code>wheel</code></a></td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1118
					<td>Async</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1119
					<td>Yes</td>
2b28e1c01737 Hoist list of event types into section 4 ("Basic Event Interfaces").
Gary Kacmarcik <garykac@google.com>
parents: 644
diff changeset
  1120
					<td><code>Element</code></td>