src/indie-ui-events.html
author James Craig <jcraig@apple.com>
Mon, 17 Dec 2012 11:17:59 -0800
changeset 50 a26a506f5392
parent 48 553b89faaeef
child 51 bbcc560d8a81
permissions -rw-r--r--
part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
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>
39
559fb035ef7b Setting up the appendices to use ReSpec external include functionality.
James Craig <jcraig@apple.com>
parents: 36
diff changeset
     6
		<link href="./css/screen.css" rel="stylesheet" type="text/css">
45
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
     7
		<script type="text/javascript" src="./loc/en/strings.js"></script>
44
46316510ce33 Adding transform script to generate a short description list of each defined event.
James Craig <jcraig@apple.com>
parents: 42
diff changeset
     8
		<script type="text/javascript" src="./js/utils.js"></script>
45
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
     9
		<script type="text/javascript" src="./js/respec-transformers.js" class="remove"></script>
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    10
		
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    11
		<!-- 
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    12
      === NOTA BENE ===
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    13
      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
    14
      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
    15
     -->
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    16
		<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
    17
		<script class="remove">
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    18
      var respecConfig = {
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    19
          // 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
    20
          specStatus:           "ED",
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
          // 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
    23
          shortName:            "indie-ui-events",
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    24
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    25
          // 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
    26
          // formal title, define it here
27
2f68808a16c9 ReSpec formatting and bypassing some ReSpec generation errors (todo: rework IDL)
James Craig <jcraig@apple.com>
parents: 26
diff changeset
    27
          subtitle   :  "Events for User Interface Independence",
4
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 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
    30
          // publishDate:  "2009-08-06",
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    31
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    32
          // 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
    33
          // the start date here:
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    34
          // copyrightStart: "2012",
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    35
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    36
          // 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
    37
          // and its maturity status
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    38
          // previousPublishDate:  "1977-03-15",
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    39
          // previousMaturity:  "WD",
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 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
    42
          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
    43
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    44
          // 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
    45
          // lcEnd: "2009-08-05",
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    46
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    47
          // 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
    48
          // 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
    49
          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
    50
            "http://dev.w3.org/2009/dap/ReSpec.js/css/respec.css",
39
559fb035ef7b Setting up the appendices to use ReSpec external include functionality.
James Craig <jcraig@apple.com>
parents: 36
diff changeset
    51
            "./css/screen.css"
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
    52
          ],
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    53
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    54
          // editors, add as many as you like
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    55
          // 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
    56
          editors:  [
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    57
              { 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
    58
              { name: "Michael Cooper", company: "W3C", companyURL: "http://www.w3.org/" },
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    59
          ],
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    60
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    61
          // authors, add as many as you like. 
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    62
          // 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
    63
          // only "name" is required. Same format as editors.
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    64
12
dc2038cb2c9f pulling out explicit author credit for now
James Craig <jcraig@apple.com>
parents: 11
diff changeset
    65
          //authors:  [
dc2038cb2c9f pulling out explicit author credit for now
James Craig <jcraig@apple.com>
parents: 11
diff changeset
    66
          //  { 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
    67
          //],
4
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
          // name of the WG
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    70
          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
    71
          
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    72
          // URI of the public WG page
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    73
          wgURI:        "http://www.w3.org/WAI/IndieUI/",
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
          // 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
    76
          wgPublicList: "public-indie-ui-comments",
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    77
          
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    78
          // 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
    79
          // !!!! IMPORTANT !!!!
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    80
          // 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
    81
          // 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
    82
          // Team Contact.
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    83
          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
    84
      };
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    85
    </script>
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    86
		
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    87
		
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
    88
	</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
    89
	<body>
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    90
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    91
		<section id="abstract">
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
    92
			<p>This specification, in conjunction with the <a href="./indie-ui-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. See the <a href="#intro">introduction</a> for background and usage examples.</p>
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    93
		</section>
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    94
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    95
		<section id="sotd">
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
    96
		</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
    97
		
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
    98
		<!-- :::::::::::::::::::: INTRO :::::::::::::::::::: -->
11
6272d00a4692 more ReSpec conventions
James Craig <jcraig@apple.com>
parents: 10
diff changeset
    99
		<section id="intro" class="introductory informative">
8
c110713738b2 fixing a few validation errors
James Craig <jcraig@apple.com>
parents: 7
diff changeset
   100
			<h2>Introduction</h2>
50
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   101
			<p>One of the core principles 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 agents behave as they normally would.</p>
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   102
			<p><strong>Change request events do not cause any direct manipulation or mutation of the <abbr title="Document Object Model">DOM</abbr>.</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. 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 that the event has been captured and understood. If a web application does not cancel any change request event, the user agent can then attempt fallback behavior or communicate to the user that the input has not been recognized.</p>
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   103
			<p class="placeholder">placeholder for remaining intro explaining background, event registration (addEventListener) versus origination (event.target) and receiver (event.receiver defined via @actions or @ui-actions)</p>
19
d08f2356dabf shuffling examples into specific locationsm and adding placeholder terms
James Craig <jcraig@apple.com>
parents: 18
diff changeset
   104
		</section>
50
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   105
		<!-- :::::::::::::::::::: END INTRO :::::::::::::::::::: -->
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   106
		
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   107
		<!-- :::::::::::::::::::: Actions Attribute :::::::::::::::::::: -->
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   108
		<section id="actions">
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   109
			<h2><abbr title="User Interface">UI</abbr> Actions</h2>
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   110
			<p>User interface actions are declared as enumerated attribute values on an element. Each value corresponds to a specific <a href="#RequestEvents">UI Request Event</a>, and declares the web page author's ability to receive and handle each of the request events initiated by the user agent. In order to receive each request event, authors MUST also register for the event using  <code>Element.addEventListener()</code> at this node or higher in the DOM. User agents MUST NOT initiate a <a href="#RequestEvents">UI Request Event</a> when the user's <a href="#def_point_of_regard">point-of-regard</a> is not inside an element with the corresponding defined action.</p>
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   111
			<section id="ui-actions">
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   112
				<h3>The <code>ui-actions</code> attribute</h3>
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   113
				<p>The <code>ui-actions</code> content attribute is an <a href="http://www.w3.org/TR/2011/WD-html5-20110405/common-microsyntaxes.html#enumerated-attribute" class="todo">enumerated attribute</a> accepting zero or more of the following values, separated by whitespace:</p>
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   114
				<div data-transform="listActions"><!-- dynamically generates event list --></div>
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   115
				<p class="ednote">We could probably combine the 'manipulation' events into a single 'manipulation' action value. I don't foresee a case where an author would want to receive some, but not all of them, and even if that case exists, the author just not listen for those specific events.</p>
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   116
				<pre class="example">
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   117
					&lt;body <strong>ui-actions="undo redo"</strong>&gt;
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   118
					  &lt;div id="mapview" <strong>ui-actions="pan zoom"</strong>&gt; ... &lt;/div&gt;
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   119
					  &lt;dialog <strong>ui-actions="dismiss"</strong>&gt; ... &lt;/dialog&gt;
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   120
					&lt;/body&gt;
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   121
					
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   122
					&lt;script type="text/javascript"&gt;
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   123
					  // registered on body as an example of event delegation to help illustrate the difference between
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   124
					  // event target (document.activeElement or point-of-regard), receiver (element with defined actions), and listener (body)
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   125
					  document.body.addEventListener(<strong>'dismissrequest'</strong>, handleDismiss);
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   126
					  document.body.addEventListener(<strong>'panrequest'</strong>, handlePan);
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   127
					  document.body.addEventListener(<strong>'redorequest'</strong>, handleRedo);
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   128
					  document.body.addEventListener(<strong>'undorequest'</strong>, handleUndo);
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   129
					  document.body.addEventListener(<strong>'zoomrequest'</strong>, handleZoom);
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   130
					&lt;/script&gt;
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   131
				</pre>
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   132
				<p class="note">In the previous example, 'undorequest' and 'redorequest' events could be fired any time the user's point-of-regard was inside the document. However, the 'dismissrequest' would only be fired when the user's point-of-regard was inside the dialog. Likewise, the 'panrequest' and 'zoomrequest' would only be fired when the user's <a href="#def_point_of_regard">point-of-regard</a> was inside the map view.
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   133
			</section>
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   134
		</section>
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   135
		<!-- :::::::::::::::::::: End Actions Attribute :::::::::::::::::::: -->
19
d08f2356dabf shuffling examples into specific locationsm and adding placeholder terms
James Craig <jcraig@apple.com>
parents: 18
diff changeset
   136
		
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
   137
		<!-- :::::::::::::::::::: UI Request Event Interfaces :::::::::::::::::::: -->
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   138
		<section id="RequestEvents">
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   139
			<h2><abbr title="User Interface">UI</abbr> Request Events</h2>
50
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   140
			
15
acb7a79d3a18 ACTION-6: add note about using default 'click' event for activations
James Craig <jcraig@apple.com>
parents: 14
diff changeset
   141
			<p class="ednote">There is purposefully no request event for activating the default action. Authors are encouraged to use a standard <code>click</code> event for default actions.</p>
16
aa5994321182 formatting and editorial notes
James Craig <jcraig@apple.com>
parents: 15
diff changeset
   142
			<p class="ednote">Event fires on point-of-regard (<code>document.activeElement</code>, clicked element, or AT equivalent) if applicable, or otherwise <code>document.body</code>.</p>
aa5994321182 formatting and editorial notes
James Craig <jcraig@apple.com>
parents: 15
diff changeset
   143
			<p class="ednote">These events should be asynchronous, but when used in conjunction with keyboard events, should fire after <code>keydown</code>, but before both <code>keyup</code> and <code>keypress</code>.</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
   144
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
			<!-- :::::::::::::::::::: UIRequestEvent :::::::::::::::::::: -->
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   146
			<section id="UIRequestEvent">
27
2f68808a16c9 ReSpec formatting and bypassing some ReSpec generation errors (todo: rework IDL)
James Craig <jcraig@apple.com>
parents: 26
diff changeset
   147
				<h3>Interface UIRequestEvent</h3>
50
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   148
				<p class="ednote">Separate interface from UIEvent because the @ui-actions attribute will 1) affect when and where these events are fired, and 2) adds the distinction of an event "receiver" element (element declaring the ui-actions attribute) in addition to the "target" element where the event initiates and the "listener" element where the event is registered for and handled.</p>
29
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   149
				<dl title="[Constructor] interface UIRequestEvent : UIEvent" class="idl">
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   150
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   151
					<dt>readonly attribute DOMString typeArg</dt>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   152
					<dd>The type of event (e.g., <code>undorequest</code>, <code>redorequest</code>).</dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   153
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   154
					<dt>readonly attribute boolean canBubbleArg</dt>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   155
					<dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   156
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   157
					<dt>readonly attribute boolean cancelableArg</dt>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   158
					<dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   159
35
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   160
					<dt>void initUIRequestEvent(
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   161
						DOMString typeArg,
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   162
						boolean canBubbleArg,
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   163
						boolean cancelableArg,
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   164
						views::AbstractView viewArg,
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   165
						long detailArg)</dt>
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   166
					<dd></dd>
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   167
29
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   168
				</dl>
35
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   169
26
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   170
				<section id="UIRequestEvents">
27
2f68808a16c9 ReSpec formatting and bypassing some ReSpec generation errors (todo: rework IDL)
James Craig <jcraig@apple.com>
parents: 26
diff changeset
   171
					<h4>UIRequestEvent Types</h4>
2f68808a16c9 ReSpec formatting and bypassing some ReSpec generation errors (todo: rework IDL)
James Craig <jcraig@apple.com>
parents: 26
diff changeset
   172
					<p>The different types of UIRequestEvents that can occur are:</p>
26
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   173
					<dl>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   174
						<dt id="undorequest">Undo Request <code class="event">undorequest</code></dt>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   175
						<dd>
45
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   176
							<p>Indicates the user desires to 'undo' the previous action.</p>
26
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   177
							<ul>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   178
								<li>Bubbles: Yes</li>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   179
								<li>Cancelable: Yes</li>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   180
							</ul>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   181
							<div class="example" title="Informative Example">
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   182
								<p>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.</p>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   183
							</div>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   184
						</dd>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   185
						<dt id="redorequest">Redo Request <code class="event">redorequest</code></dt>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   186
						<dd>
45
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   187
							<p>Indicates the user desires to 'redo' the previously 'undone' action.</p>
26
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   188
							<ul>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   189
								<li>Bubbles: Yes</li>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   190
								<li>Cancelable: Yes</li>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   191
							</ul>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   192
							<div class="example" title="Informative Example">
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   193
								<p>Users, wanting to 'redo' a discrete action in a web application, can indicate their intent a number of ways, including pressing <kbd>Control+Shift+Z</kbd> on Windows or Linux, <kbd>Command+Shift+Z</kbd> on Mac OS X.</p>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   194
							</div>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   195
						</dd>
45
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   196
						<dt id="expandrequest">Expand Request <code class="event">expandrequest</code></dt>
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   197
						<dd>
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   198
							<p>Indicates the user desires to to reveal information in a collapsed section (e.g. a disclosure widget) or branch node in a hierarchy (e.g., a tree view).</p>
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   199
							<ul>
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   200
								<li>Bubbles: Yes</li>
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   201
								<li>Cancelable: Yes</li>
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   202
							</ul>
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   203
						</dd>
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   204
						<dt id="collapserequest">Collapse Request <code class="event">collapserequest</code></dt>
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   205
						<dd>
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   206
							<p>Indicates the user desires 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>
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   207
							<ul>
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   208
								<li>Bubbles: Yes</li>
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   209
								<li>Cancelable: Yes</li>
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   210
							</ul>
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   211
						</dd>
26
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   212
						<dt id="dismissrequest">Dismiss Request <code class="event">dismissrequest</code></dt>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   213
						<dd>
45
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   214
							<p>Indicates the user desires 'dismiss' the current view (e.g. canceling a dialog, or closing a popup menu).</p>
26
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   215
							<ul>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   216
								<li>Bubbles: Yes</li>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   217
								<li>Cancelable: Yes</li>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   218
							</ul>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   219
							<div class="example" title="Informative Example">
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   220
								<p>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. 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.</p>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   221
							</div>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   222
						</dd>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   223
						<dt id="deleterequest">Delete Request <code class="event">deleterequest</code></dt>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   224
						<dd>
45
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   225
							<p>Indicates the user wants to initiate a 'delete' action on the <a href="#def_marked_element">marked element</a> or current view.</p>
26
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   226
							<ul>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   227
								<li>Bubbles: Yes</li>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   228
								<li>Cancelable: Yes</li>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   229
							</ul>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   230
						</dd>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   231
					</dl>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   232
				</section>
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   233
			</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
   234
			<!-- :::::::::::::::::::: 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
   235
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   236
			<!-- :::::::::::::::::::: UIManipulationRequestEvent :::::::::::::::::::: -->
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   237
			<section id="UIManipulationRequestEvent">
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   238
				<h3>Interface UIManipulationRequestEvent</h3>
29
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   239
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   240
				<dl title="[Constructor] interface UIManipulationRequestEvent : UIRequestEvent" class="idl">
29
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   241
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   242
					<dt>readonly attribute DOMString typeArg</dt>
42
James Craig <jcraig@apple.com>
parents: 40
diff changeset
   243
					<dd>The type of event. Either one of the simple, discrete types (e.g. <code>panrequest</code>, <code>zoomrequest</code>) or the superset, continuous manipulation events.</dd>
29
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   244
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   245
					<dt>readonly attribute boolean canBubbleArg</dt>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   246
					<dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   247
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   248
					<dt>readonly attribute boolean cancelableArg</dt>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   249
					<dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   250
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   251
					<dt>void initUIManipulationRequestEvent()</dt>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   252
					<dd>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   253
						
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   254
						<dl class="parameters">
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   255
							
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   256
							<dt>DOMString typeArg</dt><dd></dd>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   257
							<dt>boolean canBubbleArg</dt><dd></dd>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   258
							<dt>boolean cancelableArg</dt><dd></dd>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   259
							<dt>views::AbstractView viewArg</dt><dd></dd>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   260
							<dt>long detailArg</dt><dd></dd>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   261
							
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   262
							<dt>optional float originX</dt>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   263
							<dd>The cartesian X coordinate origin point, measured in CSS pixels from the left edge of element box for the <a href="#def_request_event_receiver">receiver element</a>.</dd>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   264
							<dt>optional float originY</dt>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   265
							<dd>The cartesian Y coordinate origin point, measured in CSS pixels from the top edge of element box for the <a href="#def_request_event_receiver">receiver element</a>.</dd>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   266
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   267
							<dt>optional float deltaX</dt>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   268
							<dd>The cartesian X coordinate delta, in CSS pixels.</dd>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   269
							<dt>optional float deltaY</dt>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   270
							<dd>The cartesian Y coordinate delta, in CSS pixels.</dd>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   271
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   272
							<dt>optional float scaleFactor</dt>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   273
							<dd>Scale factor, used in zoom manipulations, where 1.0 is the original scale factor. For example, a value of 2.0 or 3.0 indicates the element should enlarge to 2 or 3 times its original scale, respectively. A value of 0.5 indicates the element should decrease to one-half its original scale.</dd>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   274
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   275
							<dt>optional float rotation</dt>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   276
							<dd>Rotation value, in degrees from 0. Positive values indicate a counter-clockwise rotation. Negative values indicate a clockwise rotation.</dd>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   277
							
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   278
						</dl>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   279
					</dd>
18
5b6d164a504a substantive: ACTION-23 UIPanRequestEvent
James Craig <jcraig@apple.com>
parents: 17
diff changeset
   280
35
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   281
				</dl>
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   282
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   283
				<section id="DiscreteUIManipulationRequestEvents">
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   284
					<h4>Discrete UIManipulationRequestEvent Types</h4>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   285
					<p>The <em>discrete</em> types of UIManipulationRequestEvents that can occur are:</p>
26
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   286
					<dl>
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   287
						<dt id="moverequest">Move Request <code class="event">moverequest</code></dt>
26
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   288
						<dd>
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   289
							<p>Initiated when the user agent sends a move request to the web application with accompanying x/y delta values. This is used, for example, when moving an object to a new location on a layout canvas.</p>
26
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   290
							<ul>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   291
								<li>Bubbles: Yes</li>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   292
								<li>Cancelable: Yes</li>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   293
								<li>Context Info: <code>deltaX</code>, <code>deltaY</code></li>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   294
							</ul>
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   295
						</dd>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   296
						<dt id="panrequest">Pan Request <code class="event">panrequest</code></dt>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   297
						<dd>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   298
							<p>Initiated when the user agent sends a pan request to the web application with accompanying x/y delta values. This is used, for example, when changing the center point while panning a map or another custom image viewer.</p>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   299
							<ul>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   300
								<li>Bubbles: Yes</li>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   301
								<li>Cancelable: Yes</li>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   302
								<li>Context Info: <code>deltaX</code>, <code>deltaY</code></li>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   303
							</ul>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   304
						</dd>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   305
						<dt id="rotationrequest">Rotation Request <code class="event">rotationrequest</code></dt>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   306
						<dd>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   307
							<p>Initiated when the user agent sends a rotation request to the web application with accompanying origin x/y values and a rotation value in degrees.</p>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   308
							<ul>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   309
								<li>Bubbles: Yes</li>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   310
								<li>Cancelable: Yes</li>
40
af76dc7646fb fixing copy/paste errors in event titles, and filled out event context info.
James Craig <jcraig@apple.com>
parents: 39
diff changeset
   311
								<li>Context Info: <code>originX</code>, <code>originY</code>, <code>rotation</code></li>
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   312
							</ul>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   313
						</dd>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   314
						<!-- zoom changes (e.g. maps or custom layout views) -->
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   315
						<dt id="zoomrequest">Zoom Request <code class="event">zoomrequest</code></dt>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   316
						<dd>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   317
							<p>Initiated when the user agent sends a zoom request to the web application with accompanying origin x/y values and the zoom scale factor.</p>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   318
							<ul>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   319
								<li>Bubbles: Yes</li>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   320
								<li>Cancelable: Yes</li>
40
af76dc7646fb fixing copy/paste errors in event titles, and filled out event context info.
James Craig <jcraig@apple.com>
parents: 39
diff changeset
   321
								<li>Context Info: <code>originX</code>, <code>originY</code>, <code>scaleFactor</code></li>
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   322
							</ul>
26
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   323
						</dd>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   324
					</dl>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   325
				</section>
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   326
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   327
				<section id="ContinuousUIManipulationRequestEvents">
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   328
					<h4>Continuous UIManipulationRequestEvent Types</h4>
40
af76dc7646fb fixing copy/paste errors in event titles, and filled out event context info.
James Craig <jcraig@apple.com>
parents: 39
diff changeset
   329
					<p class="ednote">These continuous events may need an identifier per manipulation, for example, to associate a manipulationcancelrequest with the originating manipulationstartrequest that needs to be canceled.</p>
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   330
					<p>The <em>continuous</em> types of UIManipulationRequestEvents that can occur are:</p>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   331
					<dl>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   332
						<dt id="manipulationstartrequest">Manipulation Start Request <code class="event">manipulationstartrequest</code></dt>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   333
						<dd>
45
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   334
							<p class="todo">TDB</p>
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   335
							<ul>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   336
								<li>Bubbles: Yes</li>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   337
								<li>Cancelable: Yes</li>
40
af76dc7646fb fixing copy/paste errors in event titles, and filled out event context info.
James Craig <jcraig@apple.com>
parents: 39
diff changeset
   338
								<li>Context Info: <code>originX</code>, <code>originY</code>, <code>deltaX</code>, <code>deltaY</code>, <code>rotation</code>, <code>scaleFactor</code></li>
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   339
							</ul>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   340
						</dd>
40
af76dc7646fb fixing copy/paste errors in event titles, and filled out event context info.
James Craig <jcraig@apple.com>
parents: 39
diff changeset
   341
						<dt id="manipulationchangerequest">Manipulation Change Request <code class="event">manipulationchangerequest</code></dt>
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   342
						<dd>
45
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   343
							<p class="todo">TDB</p>
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   344
							<ul>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   345
								<li>Bubbles: Yes</li>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   346
								<li>Cancelable: Yes</li>
40
af76dc7646fb fixing copy/paste errors in event titles, and filled out event context info.
James Craig <jcraig@apple.com>
parents: 39
diff changeset
   347
								<li>Context Info: <code>originX</code>, <code>originY</code>, <code>deltaX</code>, <code>deltaY</code>, <code>rotation</code>, <code>scaleFactor</code></li>
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   348
							</ul>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   349
						</dd>
40
af76dc7646fb fixing copy/paste errors in event titles, and filled out event context info.
James Craig <jcraig@apple.com>
parents: 39
diff changeset
   350
						<dt id="manipulationendrequest">Manipulation End Request <code class="event">manipulationendrequest</code></dt>
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   351
						<dd>
45
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   352
							<p class="todo">TDB</p>
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   353
							<ul>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   354
								<li>Bubbles: Yes</li>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   355
								<li>Cancelable: Yes</li>
40
af76dc7646fb fixing copy/paste errors in event titles, and filled out event context info.
James Craig <jcraig@apple.com>
parents: 39
diff changeset
   356
								<li>Context Info: <code>originX</code>, <code>originY</code>, <code>deltaX</code>, <code>deltaY</code>, <code>rotation</code>, <code>scaleFactor</code></li>
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   357
							</ul>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   358
						</dd>
40
af76dc7646fb fixing copy/paste errors in event titles, and filled out event context info.
James Craig <jcraig@apple.com>
parents: 39
diff changeset
   359
						<dt id="manipulationcancelrequest">Manipulation Cancel Request <code class="event">manipulationcancelrequest</code></dt>
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   360
						<dd>
45
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   361
							<p class="todo">TDB</p>
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   362
							<ul>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   363
								<li>Bubbles: Yes</li>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   364
								<li>Cancelable: Yes</li>
40
af76dc7646fb fixing copy/paste errors in event titles, and filled out event context info.
James Craig <jcraig@apple.com>
parents: 39
diff changeset
   365
								<li>Context Info: <code>originX</code>, <code>originY</code>, <code>deltaX</code>, <code>deltaY</code>, <code>rotation</code>, <code>scaleFactor</code></li>
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   366
							</ul>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   367
						</dd>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   368
					</dl>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   369
				</section>
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   370
				
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   371
				
18
5b6d164a504a substantive: ACTION-23 UIPanRequestEvent
James Craig <jcraig@apple.com>
parents: 17
diff changeset
   372
			</section>
36
b25c2ee0e568 Added UIManipulationRequestEvent interface for moverequest, panrequest, rotationrequest, and zoomrequest. The new interface replaces previous subset interfaces UIPanRequestEvent and UIZoomRequestEvent, and completes ACTION-27 and ACTION-33
James Craig <jcraig@apple.com>
parents: 35
diff changeset
   373
			<!-- :::::::::::::::::::: END UIManipulationRequestEvent :::::::::::::::::::: -->
18
5b6d164a504a substantive: ACTION-23 UIPanRequestEvent
James Craig <jcraig@apple.com>
parents: 17
diff changeset
   374
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
   375
			<!-- :::::::::::::::::::: UIScrollRequestEvent :::::::::::::::::::: -->
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   376
			<section id="UIScrollRequestEvent">
27
2f68808a16c9 ReSpec formatting and bypassing some ReSpec generation errors (todo: rework IDL)
James Craig <jcraig@apple.com>
parents: 26
diff changeset
   377
				<h3>Interface UIScrollRequestEvent</h3>
50
a26a506f5392 part of ACTION-37: Add @ui-actions element and explain event.receiver as opposed to event.target and element registered as the event listener
James Craig <jcraig@apple.com>
parents: 48
diff changeset
   378
				<div class="ednote">Editorial Note: these constants may change, or they may be replaced with x/y deltas.</div>
29
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   379
				<dl title="[Constructor] interface UIScrollRequestEvent : UIRequestEvent" class="idl">
35
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   380
					
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   381
					<!-- for custom scroll views or widgets (e.g. carousels, lists, grids)... not intended for native scroll views -->
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   382
					
29
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   383
					<dt>const unsigned short LEFT         = TBD</dt><dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   384
					<dt>const unsigned short UP           = TBD</dt><dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   385
					<dt>const unsigned short RIGHT        = TBD</dt><dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   386
					<dt>const unsigned short DOWN         = TBD</dt><dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   387
					<dt>const unsigned short LEFT_LIMIT   = TBD</dt><dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   388
					<dt>const unsigned short TOP_LIMIT    = TBD</dt><dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   389
					<dt>const unsigned short RIGHT_LIMIT  = TBD</dt><dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   390
					<dt>const unsigned short BOTTOM_LIMIT = TBD</dt><dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   391
					
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   392
					<dt>readonly attribute DOMString typeArg</dt>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   393
					<dd>The type of event (<code>scrollrequest</code>).</dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   394
					
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   395
					<dt>readonly attribute boolean canBubbleArg</dt>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   396
					<dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   397
					
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   398
					<dt>readonly attribute boolean cancelableArg</dt>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   399
					<dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   400
					
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   401
					<dt>readonly attribute unsigned short scrollType</dt>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   402
					<dd>Type of scroll requested, as defined in the interface constants.</dd>
35
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   403
				
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   404
					<dt>void initUIScrollRequestEvent(
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   405
						DOMString typeArg,
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   406
						boolean canBubbleArg,
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   407
						boolean cancelableArg,
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   408
						views::AbstractView viewArg,
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   409
						long detailArg,
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   410
						unsigned short scrollTypeArg)</dt>
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   411
					<dd></dd>
29
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   412
					
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   413
				</dl>
35
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   414
				
26
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   415
				<section id="UIScrollRequestEvents">
27
2f68808a16c9 ReSpec formatting and bypassing some ReSpec generation errors (todo: rework IDL)
James Craig <jcraig@apple.com>
parents: 26
diff changeset
   416
					<h4>UIScrollRequestEvent Types</h4>
2f68808a16c9 ReSpec formatting and bypassing some ReSpec generation errors (todo: rework IDL)
James Craig <jcraig@apple.com>
parents: 26
diff changeset
   417
					<p>The single type of UIScrollRequestEvent that can occur is:</p>
26
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   418
					<dl>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   419
						<dt id="scrollrequest">Scroll Request <code class="event">scrollrequest</code></dt>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   420
						<dd>
42
James Craig <jcraig@apple.com>
parents: 40
diff changeset
   421
							<p>Initiated when the user agent sends a scroll request to the web application. Scroll events need only be used on custom scroll views (e.g. lists and grids showing data subsets or carousels), as user agents and assistive technologies already manage scrolling of native scroll views.</p>
26
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   422
							<p class="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>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   423
							<ul>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   424
								<li>Bubbles: Yes</li>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   425
								<li>Cancelable: Yes</li>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   426
								<li>Context Info: <code>scrollType</code></li>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   427
							</ul>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   428
						</dd>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   429
					</dl>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   430
				</section>
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   431
			</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
   432
			<!-- :::::::::::::::::::: 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
   433
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
   434
			<!-- :::::::::::::::::::: UIValueChangeRequestEvent :::::::::::::::::::: -->
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   435
			<section id="UIValueChangeRequestEvent">
27
2f68808a16c9 ReSpec formatting and bypassing some ReSpec generation errors (todo: rework IDL)
James Craig <jcraig@apple.com>
parents: 26
diff changeset
   436
				<h3>Interface UIValueChangeRequestEvent</h3>
29
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   437
				<div class="ednote">Editorial Note: these constants will likely change based on discussion from the IndieUI Face-to-Face.</div>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   438
				<dl title="[Constructor] interface UIValueChangeRequestEvent : UIRequestEvent" class="idl">
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   439
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   440
					<dt>const unsigned short INCREMENT       = TBD</dt><dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   441
					<dt>const unsigned short INCREMENT_SMALL = TBD</dt><dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   442
					<dt>const unsigned short INCREMENT_LARGE = TBD</dt><dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   443
					<dt>const unsigned short INCREMENT_MAX   = TBD</dt><dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   444
					<dt>const unsigned short DECREMENT       = TBD</dt><dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   445
					<dt>const unsigned short DECREMENT_SMALL = TBD</dt><dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   446
					<dt>const unsigned short DECREMENT_LARGE = TBD</dt><dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   447
					<dt>const unsigned short DECREMENT_MIN   = TBD</dt><dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   448
					
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   449
					<dt>readonly attribute DOMString typeArg</dt>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   450
					<dd>The type of event (<code>valuechangerequest</code>).</dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   451
					
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   452
					<dt>readonly attribute boolean canBubbleArg</dt>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   453
					<dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   454
					
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   455
					<dt>readonly attribute boolean cancelableArg</dt>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   456
					<dd></dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   457
					
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   458
					<dt>readonly attribute unsigned short changeType</dt>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   459
					<dd>Type of change requested, as defined in the interface constants.</dd>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   460
					
35
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   461
					<dt>void initUIValueChangeRequestEvent(
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   462
						DOMString typeArg,
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   463
						boolean canBubbleArg,
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   464
						boolean cancelableArg,
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   465
						views::AbstractView viewArg,
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   466
						long detailArg,
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   467
						unsigned short changeTypeArg)</dt>
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   468
					<dd></dd>
ae3ef5676003 Translating the remaining init methods from the original, commented IDL into the ReSpec-formatted WebIDL.
James Craig <jcraig@apple.com>
parents: 30
diff changeset
   469
					
29
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   470
				</dl>
07ac9cb0cc2d IDL and other ReSpec formatting
James Craig <jcraig@apple.com>
parents: 28
diff changeset
   471
26
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   472
				<section id="UIValueChangeRequestEvents">
27
2f68808a16c9 ReSpec formatting and bypassing some ReSpec generation errors (todo: rework IDL)
James Craig <jcraig@apple.com>
parents: 26
diff changeset
   473
					<h4>UIValueChangeRequestEvent Types</h4>
2f68808a16c9 ReSpec formatting and bypassing some ReSpec generation errors (todo: rework IDL)
James Craig <jcraig@apple.com>
parents: 26
diff changeset
   474
					<p>The single type of UIValueChangeRequestEvent that can occur is:</p>
26
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   475
					<dl>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   476
						<dt id="valuechangerequest">Value Change Request <code class="event">valuechangerequest</code></dt>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   477
						<dd>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   478
							<p>Initiated when the user agent sends a value change request to the web application.</p>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   479
							<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>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   480
							<ul>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   481
								<li>Bubbles: Yes</li>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   482
								<li>Cancelable: Yes</li>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   483
								<li>Context Info: <code>changeType</code></li>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   484
							</ul>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   485
							<div class="example" title="Informative Example">
42
James Craig <jcraig@apple.com>
parents: 40
diff changeset
   486
								<p>Users, wanting to change the value of a custom range widget (e.g. sliders or spin buttons) 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. 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.</p>
26
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   487
							</div>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   488
						</dd>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   489
					</dl>
074c1fd4bca5 m. adding addtl <section> groupings. what looks like a sweeping change here is mostly indentation with mere whitespace diffs.
James Craig <jcraig@apple.com>
parents: 24
diff changeset
   490
				</section>
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   491
			</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
   492
			<!-- :::::::::::::::::::: 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
   493
4
7f84811c9874 adding flags for respec
James Craig <jcraig@apple.com>
parents: 3
diff changeset
   494
		</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
   495
		<!-- :::::::::::::::::::: 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
   496
39
559fb035ef7b Setting up the appendices to use ReSpec external include functionality.
James Craig <jcraig@apple.com>
parents: 36
diff changeset
   497
		<!--
559fb035ef7b Setting up the appendices to use ReSpec external include functionality.
James Craig <jcraig@apple.com>
parents: 36
diff changeset
   498
		ReSpec: Use @data-transform to reuse a JavaScript content formatter, and @data-oninclude to transform external content before inclusion.
559fb035ef7b Setting up the appendices to use ReSpec external include functionality.
James Craig <jcraig@apple.com>
parents: 36
diff changeset
   499
		<script type="text/javascript">function xmp(r, content) { return content.replace(/</g,'&lt;').replace(/>/g,'&gt;'); } </script>
559fb035ef7b Setting up the appendices to use ReSpec external include functionality.
James Craig <jcraig@apple.com>
parents: 36
diff changeset
   500
		<pre data-transform='xmp'>This markup is <b>escaped</b> like an <code>xmp</code>.</pre>
559fb035ef7b Setting up the appendices to use ReSpec external include functionality.
James Craig <jcraig@apple.com>
parents: 36
diff changeset
   501
		-->
559fb035ef7b Setting up the appendices to use ReSpec external include functionality.
James Craig <jcraig@apple.com>
parents: 36
diff changeset
   502
		<section id="terms" class="appendix" data-include="./include/terms.html"></section>
45
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   503
		<section id="eventslist" class="">
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   504
			<h2>Events List (alphabetical)</h2>
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   505
			<div data-transform="listEvents"><!-- dynamically generates event list --></div>
2d87fcce799e ACTION-21: on, off, and toggle caption events, initial mention of 'restricted' events in glossary (def TBD) due to user privacy.
James Craig <jcraig@apple.com>
parents: 44
diff changeset
   506
		</section>
39
559fb035ef7b Setting up the appendices to use ReSpec external include functionality.
James Craig <jcraig@apple.com>
parents: 36
diff changeset
   507
		<section id="acknowledgements" class="appendix" data-include="./include/ack.html"></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
   508
		
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
   509
	</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
   510
</html>