Add stub section for before input/input events.
authorGary Kacmarcik <garykac@google.com>
Sun, 25 Aug 2013 11:57:12 -0700
changeset 471 4cbb02c69244
parent 470 54045000616c
child 472 52b0e71ee63d
Add stub section for before input/input events.

Add "Issue"s for the remaining outstanding bugs.
Add "Symbol" key.
html/DOM3-Events.html
html/override.css
--- a/html/DOM3-Events.html	Sun Aug 25 10:52:17 2013 -0700
+++ b/html/DOM3-Events.html	Sun Aug 25 11:57:12 2013 -0700
@@ -1215,7 +1215,7 @@
 					<p>The <a class="def" href="#glossary-un-initialized-value">un-initialized value</a> of this attribute MUST be <code>false</code>.</p>
 				</dd>
 			</dl>
-		</section>
+		</section><!-- Event -->
 
 		<section id="interface-CustomEvent">
 			<h2>Interface CustomEvent</h2>
@@ -1242,7 +1242,7 @@
 					<p>The <a class="def" href="#glossary-un-initialized-value">un-initialized value</a> of this attribute MUST be <code>null</code>.</p>
 				</dd>
 			</dl>
-		</section>
+		</section><!-- CustomEvent -->
 
 		<section id="interface-EventTarget">
 			<h2>Interface EventTarget</h2>
@@ -1384,7 +1384,7 @@
 						is thrown.</p>
 				</dd>
 			</dl>
-		</section>
+		</section><!-- EventTarget -->
 
 		<section id="interface-EventListener">
 			<h2>Interface EventListener</h2>
@@ -1421,7 +1421,7 @@
 					</dl>
 				</dd>
 			</dl>
-		</section>
+		</section><!-- EventListener -->
 
 		<section id="interface-DocumentEvent">
 			<h2>Interface DocumentEvent</h2>
@@ -1503,7 +1503,7 @@
 					</dl>
 				</dd>
 			</dl>
-		</section>
+		</section><!-- DocumentEvent -->
 
 	</section>  <!-- event-interfaces  -->
 
@@ -2796,6 +2796,11 @@
 
 				<section id="events-mouseevent-event-order">
 					<h4>Mouse Event Order</h4>
+
+					<p class="issue">
+						See bug <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=22641">22641</a> - "Normatively specify the order in which mouse events should fire"
+						</p>
+						
 					<p>Certain mouse events defined in this specification occur in a set order relative to one another.  The following is the typical sequence of events when a pointing
 						device's cursor is moved over an element:</p>
 
@@ -4086,6 +4091,127 @@
 				</div>
 			</section>
 
+			<section id="events-inputevents">
+				<h3>Input Event Types</h3>
+				<p>Input events are sent as notifications whenever the DOM is being updated.</p>
+				
+				<p class="issue">
+					This section is still being worked on.
+					See bug <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=22070">22070</a> - "Add input/beforeinput events to D3E"
+					</p>
+
+				<section id="interface-InputEvent">
+					<h4>Interface InputEvent</h4>
+
+					<p class="intro-dom">Introduced in DOM Level 3</p>
+
+					<dl class="idl" title="interface InputEvent : Event">
+						<dt>readonly attribute DOMString data</dt>
+						<dd>
+							<p><code>data</code> holds the value of the characters generated by an input method. This MAY be a single Unicode character or a non-empty sequence of Unicode characters
+								[<cite><a class="normative" href="#references-Unicode">Unicode</a></cite>]. Characters SHOULD be normalized as defined by the Unicode normalization form <em>NFC</em>,
+								defined in [<cite><a class="normative" href="#references-UnicodeNormalization">UAX #15</a></cite>]. This attribute MAY be null or contain the <a class="def" href="#glossary-empty-string">
+								empty string</a>.</p>
+
+							<p>The <a class="def" href="#glossary-un-initialized-value">un-initialized value</a> of this attribute MUST be <code>""</code> (the empty string).</p>
+						</dd>
+					</dl>
+				</section>
+
+				<p>The Input event types are listed below.</p>
+
+				<!-- beforeinput -->
+				<div class="event-definition">
+					<dl>
+						<dt id="event-type-beforeinput"><dfn><a class="eventtype" href="#event-type-beforeinput"><code>beforeinput</code></a></dfn></dt>
+						<dd>
+							<table border="0" summary="This table contains information about the semantics of the given event type" cellpadding="2" cellspacing="0">
+								<tr>
+									<th>Type</th>
+									<td><strong><code>beforeinput</code></strong></td>
+								</tr>
+								<tr>
+									<th>Interface</th>
+									<td><a href="#interface-InputEvent"><code>InputEvent</code></a></td>
+								</tr>
+								<tr>
+									<th>Sync / Async</th>
+									<td>Sync</td>
+								</tr>
+								<tr>
+									<th>Bubbles</th>
+									<td>Yes</td>
+								</tr>
+								<tr>
+									<th>Target</th>
+									<td></td>
+								</tr>
+								<tr>
+									<th>Cancelable</th>
+									<td>Yes</td>
+								</tr>
+								<tr>
+									<th>Default action</th>
+									<td></td>
+								</tr>
+								<tr>
+									<th>Context info</th>
+									<td></td>
+								</tr>
+							</table>
+
+							<p>A <a class="def" href="#glossary-user-agent">user agent</a> MUST dispatch this event when the DOM is about to be updated.</p>
+						</dd>
+					</dl>
+				</div><!-- beforeinput -->
+
+				<!-- input -->
+				<div class="event-definition">
+					<dl>
+						<dt id="event-type-input"><dfn><a class="eventtype" href="#event-type-input"><code>input</code></a></dfn></dt>
+						<dd>
+							<table border="0" summary="This table contains information about the semantics of the given event type" cellpadding="2" cellspacing="0">
+								<tr>
+									<th>Type</th>
+									<td><strong><code>input</code></strong></td>
+								</tr>
+								<tr>
+									<th>Interface</th>
+									<td><a href="#interface-InputEvent"><code>InputEvent</code></a></td>
+								</tr>
+								<tr>
+									<th>Sync / Async</th>
+									<td>Sync</td>
+								</tr>
+								<tr>
+									<th>Bubbles</th>
+									<td>Yes</td>
+								</tr>
+								<tr>
+									<th>Target</th>
+									<td></td>
+								</tr>
+								<tr>
+									<th>Cancelable</th>
+									<td>Yes</td>
+								</tr>
+								<tr>
+									<th>Default action</th>
+									<td></td>
+								</tr>
+								<tr>
+									<th>Context info</th>
+									<td></td>
+								</tr>
+							</table>
+
+							<p>A <a class="def" href="#glossary-user-agent">user agent</a> MUST dispatch this event immediately after the DOM has been updated.</p>
+						</dd>
+					</dl>
+				</div><!-- input -->
+
+			</section>
+
 			<section id="events-keyboardevents">
 				<h3>Keyboard Event Types</h3>
 
@@ -4116,6 +4242,10 @@
 					<p class="note"><strong>Authoring Note: </strong>See [<a href="#references-UIEvents">UI Events</a>] for information about programmatically initializing
 						<a href="#interface-KeyboardEvent"><code>KeyboardEvent</code></a> objects.</p>
 
+					<p class="issue">
+						See bug <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=22834">22834</a> - "DOM_KEY_LOCATION_MOBILE and _JOYSTICK are no longer needed"
+						</p>
+						
 					<dl class="idl" title="interface KeyboardEvent : UIEvent">
 						<dt>// KeyLocationCode</dt>
 
@@ -4259,6 +4389,10 @@
 								printed on that key.</p>
 
 							<p>The <a class="def" href="#glossary-un-initialized-value">un-initialized value</a> of this attribute MUST be <code>""</code> (the empty string).</p>
+							
+							<p class="issue">
+								See bug <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=21830">21830</a> - "KeyboardEvent.locale is too general"
+								</p>
 						</dd>
 
 						<dt>boolean getModifierState()</dt>
@@ -4659,6 +4793,14 @@
 							<td></td>
 						</tr>
 					</table>
+					
+					<p class="issue">
+						See bug <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=18931">18931</a> - "D3E should define when compositionupdate event is fired"
+						</p>
+					
+					<p class="issue">
+						See bug <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=22842">22842</a> - "Should keyboard events fire during a composition session?"
+						</p>
 				</section>
 
 				<section id="handwriting">
@@ -6247,8 +6389,13 @@
 					<key name="Process">The Process key.</key>
 					<key name="NumLock">The Number Lock key, to toggle numer-pad mode function for interpreting subsequent keyboard input.</key>
 					<key name="Shift">The Shift key, to enable shift modifier function for interpreting concurrent or subsequent keyboard input.</key>
+					<key name="Symbol">The Symbol modifier key (used on some virtual keyboards).</key>
 					<key name="SymbolLock">The Symbol Lock key.</key>
-					<key name="OS">The operating system key (e.g. the <q>Windows Logo</q> key).</key>
+					<key name="OS">The operating system key (e.g. the <q>Windows Logo</q> key).
+						<p class="issue">
+							See bug <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=22073">22073</a> - "'Meta' key is the same as the 'OS' or 'Win' key"
+							</p>
+						</key>
 					<key name="Compose">The Compose key, also known as <em>Multi_key</em> on the X Window System.  This key acts in a manner similar to a
 						<a class="def" href="#glossary-dead-key">dead key</a>, triggering a mode where subsequent key presses are combined to produce a different character.
 						</key>
@@ -6259,7 +6406,11 @@
 				<h4>Character keys</h4>
 				<div id="keys-character" class="key-table">
 					<key name="Separator">The Separator key, for context-sensitive text separators.</key>
-					<key name="Spacebar">The Space (Spacebar) key (<code class="glyph">'&nbsp;'</code>).</key>
+					<key name="Spacebar">The Space (Spacebar) key (<code class="glyph">'&nbsp;'</code>).
+						<p class="issue">
+							See bug <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=22081">22081</a> - "Needs to be clearer definition of "Spacebar" whether it should be used when non-ASCII space (U+20) is inputted or physical space key is pressed"
+							</p>
+						</key>
 					<key name="Tab">The Horizontal Tabulation (Tab) key.</key>
 				</div>
 			</section><!-- keys-character -->
@@ -6302,6 +6453,12 @@
 					<key name="LaunchMail">The Start Mail key.</key>
 					<!--key name="List">Toggle display listing of currently available content or programs.</key-->
 				</div>
+				<p class="issue">
+					See bug <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=21134">21134</a> - "Define key names which launches specific application"
+					</p>
+				<p class="issue">
+					See bug <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=21143">21143</a> - "Define command key names for multimedia keyboard"
+					</p>
 			</section><!-- keys-apps -->
 
 			<section id="keys-browser">
@@ -6337,6 +6494,9 @@
 					<key name="DeadVoicedSound">The Combining Katakana-Hiragana Voiced Sound Mark (Dead Voiced Sound) key.</key>
 					<key name="DeadSemivoicedSound">The Combining Katakana-Hiragana Semi-Voiced Sound Mark (Dead Semivoiced Sound) key.</key>
 				</div>
+				<p class="issue">
+					See bug <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=21114">21114</a> - "Dead key names are not enough for Linux"
+					</p>
 			</section><!-- keys-composition -->
 
 			<section id="keys-ime">
@@ -6364,6 +6524,12 @@
 					<key name="Katakana">The Katakana (Japanese Kana characters) key.</key>
 					<key name="HiraganaKatakana">The Hiragana/Katakana toggle key.</key>
 				</div>
+				<p class="issue">
+					See bug <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=21140">21140</a> - "Define key names for keyboard layout change keys"
+					</p>
+				<p class="issue">
+					See bug <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=22750">22750</a> - "What's the good key name for "Eisu" (英数) key of JIS keyboard for Mac?"
+					</p>
 			</section><!-- keys-ime -->
 
 			<section id="keys-function">
--- a/html/override.css	Sun Aug 25 10:52:17 2013 -0700
+++ b/html/override.css	Sun Aug 25 11:57:12 2013 -0700
@@ -52,6 +52,10 @@
 	padding-left: 8px;
 }
 
+.issue {
+	background-color: #fff0f0;
+}
+
 /* Examples */
 
 div.example {