src/indie-ui-events.html
author James Craig <jcraig@apple.com>
Sun, 11 Nov 2012 12:02:19 -0800
changeset 14 7401654f89c6
parent 13 5fc4a798972c
child 15 acb7a79d3a18
permissions -rw-r--r--
substantive: removing DOMAttrChangeRequest as its deemed no longer necessary
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
     1
<!DOCTYPE html>
8
c110713738b2 fixing a few validation errors
James Craig <jcraig@apple.com>
parents: 7
diff changeset
     2
<html lang="en-us">
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
     3
	<head>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
     4
		<meta http-equiv="Content-type" content="text/html; charset=utf-8">
7
5506543e39e4 bringing spec and css more in line with ReSpec formatting, plus a few minor editorial changes
James Craig <jcraig@apple.com>
parents: 6
diff changeset
     5
		<title>IndieUI: Events 1.0</title>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
     6
		<link href="./csi/screen.css" rel="stylesheet" type="text/css">
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
     7
		
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
     8
		<!-- 
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
     9
      === NOTA BENE ===
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    10
      For the three scripts below, if your spec resides on dev.w3 you can check them
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    11
      out in the same tree and use relative links so that they'll work offline,
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    12
     -->
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    13
		<script src="http://www.w3.org/Tools/respec/respec-w3c-common" class="remove"></script>
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    14
		<script class="remove">
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    15
      var respecConfig = {
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    16
          // specification status (e.g. WD, LCWD, NOTE, etc.). If in doubt use ED.
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    17
          specStatus:           "ED",
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    18
          
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    19
          // the specification's short name, as in http://www.w3.org/TR/short-name/
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    20
          shortName:            "indie-ui-events",
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    21
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    22
          // if your specification has a subtitle that goes below the main
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    23
          // formal title, define it here
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    24
          // subtitle   :  "an excellent document",
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    25
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    26
          // if you wish the publication date to be other than today, set this
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    27
          // publishDate:  "2009-08-06",
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    28
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    29
          // if the specification's copyright date is a range of years, specify
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    30
          // the start date here:
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    31
          // copyrightStart: "2012",
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    32
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    33
          // if there is a previously published draft, uncomment this and set its YYYY-MM-DD date
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    34
          // and its maturity status
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    35
          // previousPublishDate:  "1977-03-15",
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    36
          // previousMaturity:  "WD",
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    37
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    38
          // if there a publicly available Editor's Draft, this is the link
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    39
          edDraftURI:           "http://dvcs.w3.org/hg/IndieUI/raw-file/tip/events/indie-ui-events.html",
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    40
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    41
          // if this is a LCWD, uncomment and set the end of its review period
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    42
          // lcEnd: "2009-08-05",
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    43
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    44
          // if you want to have extra CSS, append them to this list
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    45
          // it is recommended that the respec.css stylesheet be kept
7
5506543e39e4 bringing spec and css more in line with ReSpec formatting, plus a few minor editorial changes
James Craig <jcraig@apple.com>
parents: 6
diff changeset
    46
          extraCSS:             [
5506543e39e4 bringing spec and css more in line with ReSpec formatting, plus a few minor editorial changes
James Craig <jcraig@apple.com>
parents: 6
diff changeset
    47
            "http://dev.w3.org/2009/dap/ReSpec.js/css/respec.css",
5506543e39e4 bringing spec and css more in line with ReSpec formatting, plus a few minor editorial changes
James Craig <jcraig@apple.com>
parents: 6
diff changeset
    48
            "./csi/screen.css"
5506543e39e4 bringing spec and css more in line with ReSpec formatting, plus a few minor editorial changes
James Craig <jcraig@apple.com>
parents: 6
diff changeset
    49
          ],
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    50
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    51
          // editors, add as many as you like
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    52
          // only "name" is required, also can have url, company, companyURL in comma separated list
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    53
          editors:  [
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    54
              { name: "James Craig", company: "Apple Inc.", companyURL: "http://www.apple.com/" },
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    55
              { name: "Michael Cooper", company: "W3C", companyURL: "http://www.w3.org/" },
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    56
          ],
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    57
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    58
          // authors, add as many as you like. 
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    59
          // This is optional, uncomment if you have authors as well as editors.
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    60
          // only "name" is required. Same format as editors.
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    61
12
dc2038cb2c9f pulling out explicit author credit for now
James Craig <jcraig@apple.com>
parents: 11
diff changeset
    62
          //authors:  [
dc2038cb2c9f pulling out explicit author credit for now
James Craig <jcraig@apple.com>
parents: 11
diff changeset
    63
          //  { name: "James Craig", company: "Apple Inc.", companyURL: "http://www.apple.com/" },
dc2038cb2c9f pulling out explicit author credit for now
James Craig <jcraig@apple.com>
parents: 11
diff changeset
    64
          //],
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    65
          
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    66
          // name of the WG
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    67
          wg:           "Independent User Interface (Indie UI) and Web Events Working Groups",
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    68
          
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    69
          // URI of the public WG page
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    70
          wgURI:        "http://www.w3.org/WAI/IndieUI/",
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    71
          
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    72
          // name (without the @w3c.org) of the public mailing to which comments are due
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    73
          wgPublicList: "public-indie-ui-comments",
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    74
          
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    75
          // URI of the patent status for this WG, for Rec-track documents
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    76
          // !!!! IMPORTANT !!!!
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    77
          // This is important for Rec-track documents, do not copy a patent URI from a random
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    78
          // document unless you know what you're doing. If in doubt ask your friendly neighbourhood
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    79
          // Team Contact.
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    80
          wgPatentURI:  "http://www.w3.org/2004/01/pp-impl/54953/status",
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    81
      };
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    82
    </script>
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    83
		
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    84
		
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
    85
	</head>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
    86
	<body>
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    87
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    88
		<section id="abstract">
9
1e9250559af5 moving context draft to respec format
James Craig <jcraig@apple.com>
parents: 8
diff changeset
    89
			<p class="placeholder">Placeholder abstract.</p>
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    90
		</section>
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    91
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    92
		<section id="sotd">
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    93
		</section>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
    94
		
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
    95
		<!-- :::::::::::::::::::: INTRO :::::::::::::::::::: -->
11
6272d00a4692 more ReSpec conventions
James Craig <jcraig@apple.com>
parents: 10
diff changeset
    96
		<section id="intro" class="introductory informative">
8
c110713738b2 fixing a few validation errors
James Craig <jcraig@apple.com>
parents: 7
diff changeset
    97
			<h2>Introduction</h2>
13
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
    98
			<p>This specification, in conjunction with the <a href="./user_context.html">User Context Module</a>, is intended address the problem of device-, <abbr title="operating system">OS</abbr>-, and localization-independent control of web content.</p>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
    99
			<p class="placeholder">placeholder for remaining intro</p>
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   100
		</section>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   101
		
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   102
		<!-- :::::::::::::::::::: UI Request Event Interfaces :::::::::::::::::::: -->
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   103
		<section id="RequestEvents">
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   104
			<h2><abbr title="User Interface">UI</abbr> Change Request Events</h2>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   105
			<p>The core principle behind <abbr title="User Interface">UI</abbr> Change Request Events is that they operate on a completely backwards-compatible, opt-in basis. In other words, the web application author has to be aware of these events and register event listeners, or the user agent and assistive technology behave as they normally would.</p>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   106
			<p><strong>Change request events do not cause any direct manipulation or mutation of the DOM.</strong> Instead, the event object conveys the user's intent to the web application, and allows the web application to make the appropriate changes to the DOM, on behalf of the user agent or assistive technology. If a web application is authored to understand the change request event, it can cancel the event using <code>preventDefault()</code>, which informs the user agent or assistive technology that the event has been captured and understood. If a web application does not cancel any change request event, the user agent or assistive technology can then attempt fallback behavior or communicate to the user that the input has not been recognized.</p>
13
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   107
			<p class="ednote">Event fires on point of regard (document.activeElement, clicked element, or AT equivalent) if applicable, or otherwise document.body.</p>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   108
			<p class="ednote">These events should be asynchronous, but when used in conjunction with keyboard events, should fire after keydown, but before both keyup and keypress.</p>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   109
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   110
			<!-- :::::::::::::::::::: UIRequestEvent :::::::::::::::::::: -->
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   111
			<section id="UIRequestEvent">
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   112
				<h3><strong>Interface <em>UIRequestEvent</em></strong></h3>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   113
7
5506543e39e4 bringing spec and css more in line with ReSpec formatting, plus a few minor editorial changes
James Craig <jcraig@apple.com>
parents: 6
diff changeset
   114
				<div class="idlwrapper">
5506543e39e4 bringing spec and css more in line with ReSpec formatting, plus a few minor editorial changes
James Craig <jcraig@apple.com>
parents: 6
diff changeset
   115
					<pre class="idl">interface UIRequestEvent : UIEvent {
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   116
  void initUIRequestEvent(
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   117
         in DOMString typeArg,
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   118
         in boolean canBubbleArg,
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   119
         in boolean cancelableArg,
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   120
         in views::AbstractView viewArg,
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   121
         in long detailArg,
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   122
       );
7
5506543e39e4 bringing spec and css more in line with ReSpec formatting, plus a few minor editorial changes
James Craig <jcraig@apple.com>
parents: 6
diff changeset
   123
};</pre>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   124
				</div>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   125
				<h4>The different types of UIRequestEvents that can occur are:</h4>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   126
				<dl>
13
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   127
					<dt id="undorequest">Undo Request <code class="event">undorequest</code></dt>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   128
					<dd>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   129
						<p>Initiated when the user agent or assistive technology sends an 'undo' request to the web application.</p>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   130
						<ul>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   131
							<li>Bubbles: Yes</li>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   132
							<li>Cancelable: Yes</li>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   133
						</ul>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   134
					</dd>
13
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   135
					<dt id="redorequest">Redo Request <code class="event">redorequest</code></dt>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   136
					<dd>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   137
						<p>Initiated when the user agent or assistive technology sends a 'redo' request to the web application.</p>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   138
						<ul>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   139
							<li>Bubbles: Yes</li>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   140
							<li>Cancelable: Yes</li>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   141
						</ul>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   142
					</dd>
13
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   143
					<dt id="dismissrequest">Dismiss Request <code class="event">dismissrequest</code></dt>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   144
					<dd>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   145
						<p>Initiated when the user agent or assistive technology sends a 'dismiss' request to the web application.</p>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   146
						<ul>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   147
							<li>Bubbles: Yes</li>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   148
							<li>Cancelable: Yes</li>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   149
						</ul>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   150
					</dd>
13
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   151
					<dt id="deleterequest">Delete Request <code class="event">deleterequest</code></dt>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   152
					<dd>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   153
						<p>Initiated when the user agent or assistive technology sends a 'delete' request to the web application.</p>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   154
						<ul>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   155
							<li>Bubbles: Yes</li>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   156
							<li>Cancelable: Yes</li>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   157
						</ul>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   158
					</dd>
13
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   159
					<dt id="expandrequest">Expand Request <code class="event">expandrequest</code></dt>
3
f9c37160629e ACTION-5: Expand/Collapse
James Craig <jcraig@apple.com>
parents: 2
diff changeset
   160
					<dd>
f9c37160629e ACTION-5: Expand/Collapse
James Craig <jcraig@apple.com>
parents: 2
diff changeset
   161
						<p>Initiated when the user agent or assistive technology conveys intent to reveal information in a collapsed section (e.g. a disclosure widget) or branch node in a hierarchy (e.g., a tree view).</p>
f9c37160629e ACTION-5: Expand/Collapse
James Craig <jcraig@apple.com>
parents: 2
diff changeset
   162
						<ul>
f9c37160629e ACTION-5: Expand/Collapse
James Craig <jcraig@apple.com>
parents: 2
diff changeset
   163
							<li>Bubbles: Yes</li>
f9c37160629e ACTION-5: Expand/Collapse
James Craig <jcraig@apple.com>
parents: 2
diff changeset
   164
							<li>Cancelable: Yes</li>
f9c37160629e ACTION-5: Expand/Collapse
James Craig <jcraig@apple.com>
parents: 2
diff changeset
   165
						</ul>
f9c37160629e ACTION-5: Expand/Collapse
James Craig <jcraig@apple.com>
parents: 2
diff changeset
   166
					</dd>
13
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   167
					<dt id="collapserequest">Collapse Request <code class="event">collapserequest</code></dt>
3
f9c37160629e ACTION-5: Expand/Collapse
James Craig <jcraig@apple.com>
parents: 2
diff changeset
   168
					<dd>
f9c37160629e ACTION-5: Expand/Collapse
James Craig <jcraig@apple.com>
parents: 2
diff changeset
   169
						<p>Initiated when the user agent or assistive technology conveys intent to hide or collapse information in an expanded section (e.g. a disclosure widget) or branch node in a hierarchy (e.g., a tree view).</p>
f9c37160629e ACTION-5: Expand/Collapse
James Craig <jcraig@apple.com>
parents: 2
diff changeset
   170
						<ul>
f9c37160629e ACTION-5: Expand/Collapse
James Craig <jcraig@apple.com>
parents: 2
diff changeset
   171
							<li>Bubbles: Yes</li>
f9c37160629e ACTION-5: Expand/Collapse
James Craig <jcraig@apple.com>
parents: 2
diff changeset
   172
							<li>Cancelable: Yes</li>
f9c37160629e ACTION-5: Expand/Collapse
James Craig <jcraig@apple.com>
parents: 2
diff changeset
   173
						</ul>
f9c37160629e ACTION-5: Expand/Collapse
James Craig <jcraig@apple.com>
parents: 2
diff changeset
   174
					</dd>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   175
				</dl> 
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   176
				<div class="example" title="Informative">
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   177
					<h4>Examples</h4>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   178
					<ol>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   179
						<li>Users, wanting to 'undo' a discrete action in a web application, can indicate their intent a number of ways, including pressing <kbd>Control+Z</kbd> on Windows or Linux, <kbd>Command+Z</kbd> on Mac OS X, and even by shaking some accelerometer- or gyroscope-enabled mobile devices. User agents understanding this intent should initiate an <code>UndoRequest</code> event. Web authors who have registered for this event should process the event to determine whether to cancel the event. If the 'undo' action is understood in the context of the web application, web authors should undo the user's change, and cancel the event using the event object's <code>preventDefault()</code> method.</li>
7
5506543e39e4 bringing spec and css more in line with ReSpec formatting, plus a few minor editorial changes
James Craig <jcraig@apple.com>
parents: 6
diff changeset
   180
						<li>Users, wanting to 'escape from' or 'dismiss' a web application state (for example, closing a modal dialog), can indicate their intent a number of ways, most commonly by pressing <kbd>Escape</kbd> on keyboard-controlled operating systems<!--, or by using a two-finger <a href="http://www.apple.com/voiceover/info/guide/_1133.html">scrub gesture</a> in VoiceOver on iOS or Mac OS X-->. User agents understanding this intent should initiate an <code>DismissRequest</code> event. Web authors who have registered for this event should process the event to determine whether to cancel the event. If the 'dismiss' action is understood in the context of the web application, web authors should perform the appropriate action (such as closing the dialog), and cancel the event using the event object's <code>preventDefault()</code> method.</li>
8
c110713738b2 fixing a few validation errors
James Craig <jcraig@apple.com>
parents: 7
diff changeset
   181
					</ol>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   182
				</div>
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   183
			</section>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   184
			<!-- :::::::::::::::::::: END UIRequestEvent :::::::::::::::::::: -->
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   185
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   186
			<!-- :::::::::::::::::::: UIScrollRequestEvent :::::::::::::::::::: -->
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   187
			<section id="UIScrollRequestEvent">
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   188
				<h3><strong>Interface <em>UIScrollRequestEvent</em></strong></h3>
13
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   189
				<div class="ednote">Editorial Note: </div>
7
5506543e39e4 bringing spec and css more in line with ReSpec formatting, plus a few minor editorial changes
James Craig <jcraig@apple.com>
parents: 6
diff changeset
   190
				<div class="idlwrapper">
5506543e39e4 bringing spec and css more in line with ReSpec formatting, plus a few minor editorial changes
James Craig <jcraig@apple.com>
parents: 6
diff changeset
   191
					<pre class="idl">interface UIScrollRequestEvent : UIRequestEvent {
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   192
  
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   193
  <span class="comment">// for custom scroll views or widgets (e.g. carousels, lists, grids)</span>
13
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   194
  const unsigned short    LEFT          =  TBD;
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   195
  const unsigned short    UP            =  TBD;
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   196
  const unsigned short    RIGHT         =  TBD;
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   197
  const unsigned short    DOWN          =  TBD;
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   198
  const unsigned short    LEFT_LIMIT    =  TBD;
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   199
  const unsigned short    TOP_LIMIT     =  TBD;
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   200
  const unsigned short    RIGHT_LIMIT   =  TBD;
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   201
  const unsigned short    BOTTOM_LIMIT  =  TBD;
5
5e02a5b61698 IDL corrections and editorial comments
James Craig <jcraig@apple.com>
parents: 4
diff changeset
   202
  <span class="comment">// Note: these constants will likely change dramatically based on discussion from the IndieUI Face-to-Face. </span>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   203
  
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   204
  readonly attribute unsigned short   scrollType;
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   205
  
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   206
  void initUIScrollRequestEvent(
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   207
         in DOMString typeArg,
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   208
         in boolean canBubbleArg,
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   209
         in boolean cancelableArg,
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   210
         in views::AbstractView viewArg,
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   211
         in long detailArg,
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   212
         in unsigned short eventTypeArg
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   213
         in unsigned short scrollTypeArg
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   214
       );
7
5506543e39e4 bringing spec and css more in line with ReSpec formatting, plus a few minor editorial changes
James Craig <jcraig@apple.com>
parents: 6
diff changeset
   215
};</pre>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   216
				</div>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   217
				<h4>The single type of UIScrollRequestEvent that can occur is:</h4>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   218
				<dl>
13
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   219
					<dt id="scrollrequest">Scroll Request <code class="event">scrollrequest</code></dt>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   220
					<dd>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   221
						<p>Initiated when the user agent or assistive technology sends a scroll request to the web application. Scroll events need only be used on custom scroll views (lists and grids showing data subsets, carousels, etc.), as user agents and assistive technologies already manage scrolling of native scroll views.</p>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   222
						<p class="note" title="Informative">Note: The scroll type constants are more or less equivalent to expected behavior for <kbd>PageUp</kbd>/<kbd>PageDown</kbd> and <kbd>Home</kbd>/<kbd>End</kbd> keys on native scroll views, but also allow horizontal scrolling.</p>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   223
						<ul>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   224
							<li>Bubbles: Yes</li>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   225
							<li>Cancelable: Yes</li>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   226
							<li>Context Info: <code>scrollType</code></li>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   227
						</ul>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   228
					</dd>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   229
				</dl>
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   230
			</section>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   231
			<!-- :::::::::::::::::::: END UIScrollRequestEvent :::::::::::::::::::: -->
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   232
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   233
			<!-- :::::::::::::::::::: UIValueChangeRequestEvent :::::::::::::::::::: -->
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   234
			<section id="UIValueChangeRequestEvent">
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   235
				<h3><strong>Interface <em>UIValueChangeRequestEvent</em></strong></h3>
7
5506543e39e4 bringing spec and css more in line with ReSpec formatting, plus a few minor editorial changes
James Craig <jcraig@apple.com>
parents: 6
diff changeset
   236
				<div class="idlwrapper">
5506543e39e4 bringing spec and css more in line with ReSpec formatting, plus a few minor editorial changes
James Craig <jcraig@apple.com>
parents: 6
diff changeset
   237
					<pre class="idl">interface UIValueChangeRequestEvent : UIRequestEvent {
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   238
  
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   239
  <span class="comment">// value changes (e.g. ranges)</span>
13
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   240
  const unsigned short    INCREMENT        =  TBD;
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   241
  const unsigned short    INCREMENT_SMALL  =  TBD;
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   242
  const unsigned short    INCREMENT_LARGE  =  TBD;
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   243
  const unsigned short    INCREMENT_MAX    =  TBD;
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   244
  const unsigned short    DECREMENT        =  TBD;
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   245
  const unsigned short    DECREMENT_SMALL  =  TBD;
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   246
  const unsigned short    DECREMENT_LARGE  =  TBD;
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   247
  const unsigned short    DECREMENT_MIN    =  TBD;
5
5e02a5b61698 IDL corrections and editorial comments
James Craig <jcraig@apple.com>
parents: 4
diff changeset
   248
  <span class="comment">// Note: these constants will likely change dramatically based on discussion from the IndieUI Face-to-Face. </span>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   249
  
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   250
  readonly attribute unsigned short   changeType;
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   251
  
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   252
  void initUIValueChangeRequestEvent(
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   253
         in DOMString typeArg,
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   254
         in boolean canBubbleArg,
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   255
         in boolean cancelableArg,
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   256
         in views::AbstractView viewArg,
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   257
         in long detailArg,
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   258
         in unsigned short eventTypeArg,
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   259
         in unsigned short changeTypeArg
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   260
       );
7
5506543e39e4 bringing spec and css more in line with ReSpec formatting, plus a few minor editorial changes
James Craig <jcraig@apple.com>
parents: 6
diff changeset
   261
};</pre>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   262
				</div>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   263
				<h4>The single type of UIValueChangeRequestEvent that can occur is:</h4>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   264
				<dl>
13
5fc4a798972c hash IDs, reformating, lowercasing event names, etc.
James Craig <jcraig@apple.com>
parents: 12
diff changeset
   265
					<dt id="valuechangerequest">Value Change Request <code class="event">valuechangerequest</code></dt>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   266
					<dd>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   267
						<p>Initiated when the user agent or assistive technology sends a value change request to the web application.</p>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   268
						<p>Web authors <strong class="rfc2119">should</strong> code applications to accept all values of the <code>changeType</code> argument. For example, if there is no special behavior for <code>INCREMENT_SMALL</code> or <code>INCREMENT_LARGE</code>, web applications would behave as if they had received a basic <code>INCREMENT</code> change type.</p>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   269
						<ul>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   270
							<li>Bubbles: Yes</li>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   271
							<li>Cancelable: Yes</li>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   272
							<li>Context Info: <code>eventType</code></li>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   273
						</ul>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   274
					</dd>
8
c110713738b2 fixing a few validation errors
James Craig <jcraig@apple.com>
parents: 7
diff changeset
   275
				</dl>
c110713738b2 fixing a few validation errors
James Craig <jcraig@apple.com>
parents: 7
diff changeset
   276
				
c110713738b2 fixing a few validation errors
James Craig <jcraig@apple.com>
parents: 7
diff changeset
   277
				<div class="example" title="Informative">
c110713738b2 fixing a few validation errors
James Craig <jcraig@apple.com>
parents: 7
diff changeset
   278
					<h4>Example</h4>
c110713738b2 fixing a few validation errors
James Craig <jcraig@apple.com>
parents: 7
diff changeset
   279
					<p>Users, wanting to change the value of a custom range widget (slider, media progressbar, etc.) in a web application, can indicate their intent a number of ways, including pressing various keys (<kbd>Up</kbd>, <kbd>Down</kbd>, <kbd>Left</kbd>, <kbd>Right</kbd>, <kbd>PageUp</kbd>, <kbd>PageDown</kbd>, <kbd>Home</kbd>, <kbd>End</kbd>) on most keyboard-controlled interfaces, and through gestures on many touch-enabled interfaces. User agents understanding this intent should initiate a <code>ValueChangeRequest</code> event. Web authors who have registered for this event, should process the event to determine whether to cancel the event. If the value change action is understood in the context of the web application, web authors should change the value of the associated widget by an amount determined via the <code>changeType</code> argument, and cancel the event using the event object's <code>preventDefault()</code> method. If the event is not cancelled by the web author, user agents may pass the literal interaction event to the web application; in this case, in the form of a keypress or touch event.</p>
c110713738b2 fixing a few validation errors
James Craig <jcraig@apple.com>
parents: 7
diff changeset
   280
				</div>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   281
					
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   282
			</section>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   283
			<!-- :::::::::::::::::::: END UIValueChangeRequestEvent :::::::::::::::::::: -->
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   284
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   285
		</section>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   286
		<!-- :::::::::::::::::::: END UI Request Event Interfaces :::::::::::::::::::: -->
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   287
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   288
		<!-- :::::::::::::::::::: Accessibility Event Interfaces :::::::::::::::::::: -->
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   289
		<section id="AXevents">
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   290
			<h2>Accessibility Events</h2>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   291
			<p>The following events are only initiated by assistive technologies, as opposed to mainstream user agents.</p>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   292
			
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   293
			<!-- :::::::::::::::::::: AccessibilityEvent :::::::::::::::::::: -->
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   294
			<section id="AccessibilityEvent">
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   295
				<h3><strong>Interface <em>AccessibilityEvent</em></strong></h3>
7
5506543e39e4 bringing spec and css more in line with ReSpec formatting, plus a few minor editorial changes
James Craig <jcraig@apple.com>
parents: 6
diff changeset
   296
				<div class="idlwrapper">
5506543e39e4 bringing spec and css more in line with ReSpec formatting, plus a few minor editorial changes
James Craig <jcraig@apple.com>
parents: 6
diff changeset
   297
					<pre class="idl">interface AccessibilityEvent : UIEvent {
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   298
  void initAccessibilityEvent(
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   299
         in DOMString typeArg,
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   300
         in boolean canBubbleArg,
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   301
         in boolean cancelableArg,
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   302
         in views::AbstractView viewArg,
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   303
         in long detailArg
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   304
       );
7
5506543e39e4 bringing spec and css more in line with ReSpec formatting, plus a few minor editorial changes
James Craig <jcraig@apple.com>
parents: 6
diff changeset
   305
};</pre>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   306
				</div>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   307
				<h4>The different types of AccessibilityEvents that can occur are:</h4>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   308
				<dl>
2
aba80041ed8d ACTION-5
James Craig <jcraig@apple.com>
parents: 0
diff changeset
   309
					<dt><code class="event">ATFocusIn</code></dt>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   310
					<dd>
2
aba80041ed8d ACTION-5
James Craig <jcraig@apple.com>
parents: 0
diff changeset
   311
						<p>Initiated when the assistive technology cursor or point of regard moves to a particular DOM node.</p>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   312
						<ul>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   313
							<li>Bubbles: Yes</li>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   314
							<li>Cancelable: No</li>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   315
							<li>Context Info: None</li>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   316
						</ul>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   317
					</dd>
2
aba80041ed8d ACTION-5
James Craig <jcraig@apple.com>
parents: 0
diff changeset
   318
					<dt><code class="event">ATFocusOut</code></dt>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   319
					<dd>
2
aba80041ed8d ACTION-5
James Craig <jcraig@apple.com>
parents: 0
diff changeset
   320
						<p>Initiated when the assistive technology cursor or point of regard leaves a particular DOM node.</p>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   321
						<ul>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   322
							<li>Bubbles: Yes</li>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   323
							<li>Cancelable: No</li>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   324
							<li>Context Info: None</li>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   325
						</ul>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   326
					</dd>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   327
				</dl>
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   328
			</section>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   329
			<!-- :::::::::::::::::::: END AccessibilityEvent :::::::::::::::::::: -->
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   330
			
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   331
		</section>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   332
		<!-- :::::::::::::::::::: END Accessibility Event Interfaces :::::::::::::::::::: -->
9
1e9250559af5 moving context draft to respec format
James Craig <jcraig@apple.com>
parents: 8
diff changeset
   333
11
6272d00a4692 more ReSpec conventions
James Craig <jcraig@apple.com>
parents: 10
diff changeset
   334
		<section class="placeholder appendix">
9
1e9250559af5 moving context draft to respec format
James Craig <jcraig@apple.com>
parents: 8
diff changeset
   335
			<h2>Acknowledgements</h2>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   336
			<p>Placeholder for footer content (acknowledgements, terms, etc.)</p>
9
1e9250559af5 moving context draft to respec format
James Craig <jcraig@apple.com>
parents: 8
diff changeset
   337
		</section>
0
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   338
		
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   339
	</body>
c6c8037bc37c initial move from proposal to spec, pulled out as much spec-irrelevant content as I noticed on first pass, initiated directory structure.
James Craig <jcraig@apple.com>
parents:
diff changeset
   340
</html>