--- a/html/DOM3-Events.html Sun Aug 25 08:43:19 2013 -0700
+++ b/html/DOM3-Events.html Sun Aug 25 10:20:21 2013 -0700
@@ -265,7 +265,7 @@
<dd><p class="atrisk">This is a feature at risk, which is likely to be removed from the specification.</p></dd>-->
<dt>Spec Issues</dt>
- <dd><p class="issue"><strong>Issue:</strong> This is an open issue.</p></dd>
+ <dd><p class="issue">This is an open issue.</p></dd>
</dl>
<p>In addition, certain terms are used in this specification with particular meanings. The term <q>implementation</q> applies to a browser, content authoring tool,
@@ -6124,110 +6124,34 @@
<key name="ContextMenu">Toggle display of current application's context menu.</key>
<key name="CrSel">The Cursor Select (Crsel) key.</key>
<key name="ExSel">The Extend Selection (Exsel) key.</key>
- <key name="LaunchMail">The Start Mail key.</key>
- <key name="List">Toggle display listing of currently available content or programs.</key>
<key name="Props">The properties (props) key.</key>
<key name="Unidentified">This key value is used when an implementations is unable to identify another key value, due to either hardware, platform, or software constraints.</key>
</div>
- </section>
-
- <section id="keys-function">
- <h4>General-purpose function keys</h4>
- <p>The exact number of these general purpose function keys varies on different platforms, and only the first
- few are defined explicitly here. Additional function key names are implicitly defined by incrementing the
- base-10 index at the end of the function key name. Thus, <span class="key">'F24'</span>,
- <span class="key">'LaunchApplication12'</span> and <span class="key">'Soft8'</span> are all valid
- key values.
- </p>
- <div id="keys-function-keys" class="key-table">
- <key name="F1">The F1 key, a general purpose function key, as index 1.</key>
- <key name="F2">The F2 key, a general purpose function key, as index 2.</key>
- <key name="F3">The F3 key, a general purpose function key, as index 3.</key>
- <key name="F4">The F4 key, a general purpose function key, as index 4.</key>
- <key name="F5">The F5 key, a general purpose function key, as index 5.</key>
- <key name="F6">The F6 key, a general purpose function key, as index 6.</key>
- <key name="F7">The F7 key, a general purpose function key, as index 7.</key>
- <key name="F8">The F8 key, a general purpose function key, as index 8.</key>
- <key name="F9">The F9 key, a general purpose function key, as index 9.</key>
- <key name="F10">The F10 key, a general purpose function key, as index 10.</key>
- <key name="F11">The F11 key, a general purpose function key, as index 11.</key>
- <key name="F12">The F12 key, a general purpose function key, as index 12.</key>
- <key name="LaunchApplication1">The Start Application key, as index 1.</key>
- <key name="LaunchApplication2">The Start Application key, as index 2.</key>
- <key name="Soft1">General purpose virtual function key, as index 1.</key>
- <key name="Soft2">General purpose virtual function key, as index 2.</key>
- <key name="Soft3">General purpose virtual function key, as index 3.</key>
- <key name="Soft4">General purpose virtual function key, as index 4.</key>
- </div>
- </section>
+ </section><!-- keys-general -->
<section id="keys-ui">
<h4>UI keys</h4>
<div id="keys-ui" class="key-table">
<key name="Accept">The Accept (Commit, OK) key. Accept current option or input method sequence conversion.</key>
<key name="Again">The Again key, to redo or repeat an action.</key>
+ <key name="ContextMenu">Show the application's context menu.
+ This key is commonly found between the right <code>'OS'</code> key and the right <code>'Control'</code> key.
+ </key>
<key name="Enter">The Enter key, to activate current selection or accept current input.
This key value is also used for the <code class="key">'Return'</code> (Macintosh numpad) key.
</key>
<key name="Find">The Find key.</key>
<key name="Help">Toggle display of help information.</key>
- <key name="Menu">Toggle display of content or system menu, if available.</key>
<key name="Pause">Pause the current state or application (as appropriate).</key>
<key name="Play">Play or resume the current state or application (as appropriate).</key>
<key name="ScrollLock">The Scroll Lock key, to toggle between scrolling and cursor movement modes.</key>
<key name="Execute">The Execute key.</key>
<key name="Cancel">The Cancel key.</key>
<key name="Escape">The Escape (Esc) key, to initiate an escape sequence.</key>
- <key name="Exit">Exit current state or current application (as appropriate).</key>
<key name="ZoomIn">The ZoomIn key.</key>
<key name="ZoomOut">The ZoomOut key.</key>
</div>
- </section>
-
- <section id="keys-math">
- <h4>Character and Math 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">' '</code>).</key>
- </div>
- </section>
-
- <section id="keys-device">
- <h4>Device keys</h4>
- <div id="keys-device" class="key-table">
- <key name="BrightnessDown">The Brightness Down key. Typically controls the display brightness.</key>
- <key name="BrightnessUp">The Brightness Up key. Typically controls the display brightness.</key>
- <key name="Camera">The Camera key.</key>
- <key name="Eject">Toggle removable media to eject (open) and insert (close) state.</key>
- <key name="PrintScreen">The Print Screen (PrintScrn, SnapShot) key, to initiate print-screen function.</key>
- <key name="Power">Toggle power state.
- <p class="note"><strong>Note:</strong> Some devices might not expose this key to the operating environment.</p>
- </key>
- <key name="Standby">The Standby key.</key>
- <key name="PowerDown">The PowerDown key.</key>
- <key name="PowerOff">The PowerOff key.
- <p class="issue"><strong>Issue:</strong> How is this different from the PowerDown key?</p>
- </key>
- <key name="WakeUp">The WakeUp key.</key>
- <key name="Sleep">The Sleep key.</key>
- <key name="LogOff">The LogOff key.</key>
- <key name="Suspend">The Suspend key.</key>
- <key name="Hibernate">The Hibernate key.</key>
- </div>
- </section>
-
- <section id="keys-browser">
- <h4>Browser keys</h4>
- <div id="keys-browser" class="key-table">
- <key name="BrowserFavorites">The Browser Favorites key.</key>
- <key name="BrowserHome">The Browser Home key, used with keyboard entry, to go to the home page.</key>
- <key name="BrowserRefresh">The Browser Refresh key, to refresh the current page or content.</key>
- <key name="BrowserSearch">The Browser Search key, to call up the user's preferred search page.</key>
- <key name="BrowserStop">The Browser Stop key, to stop loading the current page or content.</key>
- <key name="BrowserBack">Navigate to previous content or page in current history.</key>
- <key name="BrowserForward">Navigate to next content or page in current history.</key>
- </div>
- </section>
+ </section><!-- keys-ui -->
<section id="keys-navication">
<h4>Navigation keys</h4>
@@ -6240,10 +6164,8 @@
<key name="End">The End key, used with keyboard entry to go to the end of content.</key>
<key name="PageDown">The Page Down key, to scroll down or display next page of content.</key>
<key name="PageUp">The Page Up key, to scroll up or display previous page of content.</key>
- <key name="Select">The Select key.</key>
- <key name="Tab">The Horizontal Tabulation (Tab) key.</key>
</div>
- </section>
+ </section><!-- keys-navigation -->
<section id="keys-editing">
<h4>Editing keys</h4>
@@ -6264,7 +6186,95 @@
<key name="Undo">The Undo key.</key>
<key name="Redo">The Redo key.</key>
</div>
- </section>
+ </section><!-- keys-editing -->
+
+ <section id="keys-modifier">
+ <h4>Modifier keys</h4>
+ <div id="keys-modifier" class="key-table">
+ <key name="Alphanumeric">The Alphanumeric key.</key>
+ <key name="Alt">The Alternative (Alt, Option, Menu) key. Enable alternate modifier function for interpreting concurrent or subsequent keyboard input.
+ <p class="note"><strong>Note:</strong> This key value is also used for the Apple <code>'Option'</code> key.</p>
+ </key>
+ <key name="AltGraph">The Alt-Graph key.</key>
+ <key name="CapsLock">The Caps Lock (Capital) key. Toggle capital character lock function for interpreting subsequent keyboard input event.</key>
+ <key name="Control">The Control (Ctrl) key, to enable control modifier function for interpreting concurrent or subsequent keyboard input.</key>
+ <key name="Fn">The Function switch (Fn) key. Activating this key simultaneously with another key changes that key's value to an alternate character or function.</key>
+ <key name="FnLock">The Function-Lock (FnLock, F-Lock) key. Activating this key switches the mode of the keyboard to changes some keys' values to an alternate character or function.</key>
+ <key name="Meta">The Meta key, to enable meta modifier function for interpreting concurrent or subsequent keyboard input.
+ <p class="note"><strong>Note:</strong> This key value is also used for the Apple <code>'Command'</code> key.</p>
+ </key>
+ <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="SymbolLock">The Symbol Lock key.</key>
+ <key name="OS">The operating system key (e.g. the <q>Windows Logo</q> key).</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>
+ </div>
+ </section><!-- keys-modifier -->
+
+ <section id="keys-characater">
+ <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">' '</code>).</key>
+ <key name="Tab">The Horizontal Tabulation (Tab) key.</key>
+ </div>
+ </section><!-- keys-character -->
+
+ <section id="keys-device">
+ <h4>Device keys</h4>
+ <div id="keys-device" class="key-table">
+ <key name="BrightnessDown">The Brightness Down key. Typically controls the display brightness.</key>
+ <key name="BrightnessUp">The Brightness Up key. Typically controls the display brightness.</key>
+ <key name="Camera">The Camera key.</key>
+ <key name="Eject">Toggle removable media to eject (open) and insert (close) state.</key>
+ <key name="PrintScreen">The Print Screen (PrintScrn, SnapShot) key, to initiate print-screen function.</key>
+ <key name="Power">Toggle power state.
+ <p class="note"><strong>Note:</strong> Some devices might not expose this key to the operating environment.</p>
+ </key>
+ <key name="Standby">The Standby key.</key>
+ <key name="PowerDown">The PowerDown key.</key>
+ <key name="PowerOff">The PowerOff key.
+ <p class="issue">How is this different from the PowerDown key?</p>
+ </key>
+ <key name="WakeUp">The WakeUp key.</key>
+ <key name="Sleep">The Sleep key.</key>
+ <key name="LogOff">The LogOff key.</key>
+ <key name="Suspend">The Suspend key.</key>
+ <key name="Hibernate">The Hibernate key.</key>
+ </div>
+ </section><!-- keys-device -->
+
+ <section id="keys-apps">
+ <h4>Application Keys</h4>
+ <p>The exact number of these LaunchApplication keys varies on different platforms, and only the first
+ few are defined explicitly here. Additional key names are implicitly defined by incrementing the
+ base-10 index at the end of the function key name. Thus
+ <span class="key">'LaunchApplication12'</span> is a valid key value.
+ </p>
+ <!-- Key tables. Note that all keys must be defined within a <div class="key-table"> -->
+ <div id="keys-apps" class="key-table">
+ <key name="LaunchApplication1">The Start Application key, as index 1.</key>
+ <key name="LaunchApplication2">The Start Application key, as index 2.</key>
+ <key name="LaunchMail">The Start Mail key.</key>
+ <!--key name="List">Toggle display listing of currently available content or programs.</key-->
+ </div>
+ </section><!-- keys-apps -->
+
+ <section id="keys-browser">
+ <h4>Browser keys</h4>
+ <div id="keys-browser" class="key-table">
+ <key name="BrowserFavorites">The Browser Favorites key.</key>
+ <key name="BrowserHome">The Browser Home key, used with keyboard entry, to go to the home page.</key>
+ <key name="BrowserRefresh">The Browser Refresh key, to refresh the current page or content.</key>
+ <key name="BrowserSearch">The Browser Search key, to call up the user's preferred search page.</key>
+ <key name="BrowserStop">The Browser Stop key, to stop loading the current page or content.</key>
+ <key name="BrowserBack">Navigate to previous content or page in current history.</key>
+ <key name="BrowserForward">Navigate to next content or page in current history.</key>
+ </div>
+ </section><!-- keys-browser -->
<section id="keys-composition">
<h4>Composition keys</h4>
@@ -6286,33 +6296,7 @@
<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>
- </section>
-
- <section id="keys-modifier">
- <h4>Modifier keys</h4>
- <div id="keys-modifier" class="key-table">
- <key name="Alphanumeric">The Alphanumeric key.</key>
- <key name="Alt">The Alternative (Alt, Option, Menu) key. Enable alternate modifier function for interpreting concurrent or subsequent keyboard input.
- <p class="note"><strong>Note:</strong> This key value is also used for the Apple <code>'Option'</code> key.</p>
- </key>
- <key name="AltGraph">The Alt-Graph key.</key>
- <key name="CapsLock">The Caps Lock (Capital) key. Toggle capital character lock function for interpreting subsequent keyboard input event.</key>
- <key name="Control">The Control (Ctrl) key, to enable control modifier function for interpreting concurrent or subsequent keyboard input.</key>
- <key name="Fn">The Function switch (Fn) key. Activating this key simultaneously with another key changes that key's value to an alternate character or function.</key>
- <key name="FnLock">The Function-Lock (FnLock, F-Lock) key. Activating this key switches the mode of the keyboard to changes some keys' values to an alternate character or function.</key>
- <key name="Meta">The Meta key, to enable meta modifier function for interpreting concurrent or subsequent keyboard input.
- <p class="note"><strong>Note:</strong> This key value is also used for the Apple <code>'Command'</code> key.</p>
- </key>
- <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="SymbolLock">The Symbol Lock key.</key>
- <key name="OS">The operating system key (e.g. the <q>Windows Logo</q> key).</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>
- </div>
- </section>
+ </section><!-- keys-composition -->
<section id="keys-ime">
<h4>IME keys</h4>
@@ -6339,7 +6323,34 @@
<key name="Katakana">The Katakana (Japanese Kana characters) key.</key>
<key name="HiraganaKatakana">The Hiragana/Katakana toggle key.</key>
</div>
- </section>
+ </section><!-- keys-ime -->
+
+ <section id="keys-function">
+ <h4>General-purpose function keys</h4>
+ <p>The exact number of these general purpose function keys varies on different platforms, and only the first
+ few are defined explicitly here. Additional function key names are implicitly defined by incrementing the
+ base-10 index at the end of the function key name. Thus, <span class="key">'F24'</span>
+ and <span class="key">'Soft8'</span> are all valid key values.
+ </p>
+ <div id="keys-function-keys" class="key-table">
+ <key name="F1">The F1 key, a general purpose function key, as index 1.</key>
+ <key name="F2">The F2 key, a general purpose function key, as index 2.</key>
+ <key name="F3">The F3 key, a general purpose function key, as index 3.</key>
+ <key name="F4">The F4 key, a general purpose function key, as index 4.</key>
+ <key name="F5">The F5 key, a general purpose function key, as index 5.</key>
+ <key name="F6">The F6 key, a general purpose function key, as index 6.</key>
+ <key name="F7">The F7 key, a general purpose function key, as index 7.</key>
+ <key name="F8">The F8 key, a general purpose function key, as index 8.</key>
+ <key name="F9">The F9 key, a general purpose function key, as index 9.</key>
+ <key name="F10">The F10 key, a general purpose function key, as index 10.</key>
+ <key name="F11">The F11 key, a general purpose function key, as index 11.</key>
+ <key name="F12">The F12 key, a general purpose function key, as index 12.</key>
+ <key name="Soft1">General purpose virtual function key, as index 1.</key>
+ <key name="Soft2">General purpose virtual function key, as index 2.</key>
+ <key name="Soft3">General purpose virtual function key, as index 3.</key>
+ <key name="Soft4">General purpose virtual function key, as index 4.</key>
+ </div>
+ </section><!-- keys-function -->
<section id="keys-media">
<h4>Media controller keys</h4>
@@ -6393,7 +6404,9 @@
<key name="ListProgram">List the current program. (VK_LIST)</key>
<key name="LiveContent">Toggle display listing of currently available live content or programs. (VK_LIVE)</key>
<key name="Lock">Lock or unlock current content or program. (VK_LOCK)</key>
- <key name="MediaApps">Show a list of media applications. (VK_APPS)</key>
+ <key name="MediaApps">Show a list of media applications. (VK_APPS)
+ <p class="note"><strong>Note:</strong> Do not confuse this key value with the Windows' VK_APPS / VK_CONTEXT_MENU key, which is encoded as <code>'ContextMenu'</code>.</p>
+ </key>
<key name="MediaFastForward">Initiate or continue forward playback at faster than normal speed, or increase speed if already fast forwarding. (VK_FAST_FWD)</key>
<key name="MediaLast">Select previously selected channel or media. (VK_LAST)</key>
<key name="MediaPlay">Initiate or continue media playback at normal speed, if not currently playing at normal speed. (VK_PLAY)</key>
@@ -6404,7 +6417,6 @@
<key name="MediaStop">Stop media playing, pausing, forwarding, rewinding, or recording, if not already stopped. (VK_STOP)</key>
<key name="MediaTrackNext">Seek to next media or program track. (VK_TRACK_NEXT)</key>
<key name="MediaTrackPrevious">Seek to previous media or program track. (VK_TRACK_PREV)</key>
- <key name="Menu">Toggle display of the on-screen menu. (VK_MENU)</key>
<key name="NextFavoriteChannel">Cycle to next favorite channel (in favorites list). (VK_NEXT_FAVORITE_CHANNEL)</key>
<key name="OnDemand">Access on-demand content or programs. (VK_ON_DEMAND)</key>
<key name="PinPDown">Move picture-in-picture window down. (VK_PINP_DOWN)</key>
@@ -6424,7 +6436,7 @@
<key name="Subtitle">Toggle display of subtitles, if available. (VK_SUBTITLE)</key>
<key name="Teletext">Toggle display of teletext, if available (VK_TELETEXT).</key>
<key name="VideoModeNext">Advance video mode to next available mode.(VK_VIDEO_MODE_NEXT)</key>
- <key name="Wink">Cause device to identify itself in some manner, e.g., audibly or visibly.</key>
+ <key name="Wink">Cause device to identify itself in some manner, e.g., audibly or visibly. (VK_WINK)</key>
<key name="ZoomToggle">Toggle between full-screen and scaled content, or alter magnification level. (VK_ZOOM)</key>
</div>
@@ -6435,12 +6447,13 @@
<div id="keys-media2" class="key-table">
<key name="BrowserBack">Navigate to previous content or page in current history. (VK_BACK)</key>
<key name="BrowserForward">Navigate to next content or page in current history. (VK_FORWARD)</key>
+ <key name="ContextMenu">Toggle display of the on-screen menu. (VK_MENU)</key>
<key name="Eject">Toggle removable media to eject (open) and insert (close) state. (VK_EJECT_TOGGLE)</key>
<key name="End">The End key, used with keyboard entry to go to the end of content. (VK_GO_TO_END)</key>
<key name="Enter">The Enter key, to activate current selection or accept current input. (VK_SELECT)</key>
<key name="Home">The Home key, used with keyboard entry, to go to start of content. (VK_GO_TO_START)</key>
<key name="Pause">Pause the current state or application (as appropriate). (VK_PAUSE)</key>
- <key name="Power">Toggle power state.</key>
+ <key name="Power">Toggle power state. (VK_POWER)</key>
<key name="Unidentified">This key value is used when an implementations is unable to identify another key value, due to either hardware, platform, or software constraints. (VK_UNDEFINED)</key>
<key name="VolumeDown">Decrease audio volume. (VK_VOLUME_DOWN)</key>
<key name="VolumeUp">Increase audio volume. (VK_VOLUME_UP)</key>