- From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 27 Oct 2011 21:46:27 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv30244
Modified Files:
browsers.html editing.html spec.html
Log Message:
Tweak definition to heycam's wording. (whatwg r6774)
[updated by splitter]
Index: editing.html
===================================================================
RCS file: /sources/public/html5/spec/editing.html,v
retrieving revision 1.1060
retrieving revision 1.1061
diff -u -d -r1.1060 -r1.1061
--- editing.html 27 Oct 2011 00:46:30 -0000 1.1060
+++ editing.html 27 Oct 2011 21:46:24 -0000 1.1061
@@ -816,7 +816,45 @@
or digit.</p><p>User agents can provide users with a list of the keyboard
shortcuts, but authors are encouraged to do so also. The <code title="dom-accessKeyLabel"><a href="#dom-accesskeylabel">accessKeyLabel</a></code> IDL attribute
returns a string representing the actual key combination assigned by
- the user agent.</p><h4 id="the-accesskey-attribute"><span class="secno">7.4.2 </span>The <dfn title="attr-accesskey"><code>accesskey</code></dfn> attribute</h4><p>All <a href="infrastructure.html#html-elements">HTML elements</a> may have the <code title="attr-accesskey"><a href="#the-accesskey-attribute">accesskey</a></code> content attribute set. The
+ the user agent.</p><div class="example">
+
+ <p>In this example, an author has provided a button that can be
+ invoked using a shortcut key. To support full keyboards, the author
+ has provided "C" as a possible key. To support devices equipped
+ only with numeric keypads, the author has provided "1" as another
+ possibly key.</p>
+
+ <pre><input type=button value=Collect onclick="collect()"
+ <strong>accesskey="C 1"</strong> id=c></pre>
+
+ </div><div class="example">
+
+ <p>To tell the user what the shortcut key is, the author has
+ this script here opted to explicitly add the key combination to the
+ button's label:</p>
+
+ <pre>function addShortcutKeyLabel(button) {
+<strong> if (button.accessKeyLabel != '')
+ button.value += ' (' + button.accessKeyLabel + ')';</strong>
+}
+addShortcutKeyLabel(document.getElementById('c'));</pre>
+
+ <p>Browsers on different platforms will show different labels, even
+ for the same key combination, based on the convention prevalent on
+ that platform. For example, if the key combination is the Control
+ key, the Shift key, and the letter C, a Windows browser might
+ display "<samp>Ctrl+Shift+C</samp>", whereas a Mac browser might
+ display "<samp>^⇧C</samp>", while an Emacs browser might
+ just display "<samp>C-C</samp>". Similarly, if the key combination
+ is the Alt key and the Escape key, Windows might use
+ "<samp>Alt+Esc</samp>", Mac might use
+ "<samp>⌥⎋</samp>", and an Emacs browser might use
+ "<samp>M-ESC</samp>" or "<samp>ESC ESC</samp>".</p>
+
+ <p>In general, therefore, it is unwise to attempt to parse the
+ value returned from the <code title="dom-accessKeyLabel"><a href="#dom-accesskeylabel">accessKeyLabel</a></code> IDL attribute.</p>
+
+ </div><h4 id="the-accesskey-attribute"><span class="secno">7.4.2 </span>The <dfn title="attr-accesskey"><code>accesskey</code></dfn> attribute</h4><p>All <a href="infrastructure.html#html-elements">HTML elements</a> may have the <code title="attr-accesskey"><a href="#the-accesskey-attribute">accesskey</a></code> content attribute set. The
<code title="attr-accesskey"><a href="#the-accesskey-attribute">accesskey</a></code> attribute's value is
used by the user agent as a guide for creating a keyboard shortcut
that activates or focuses the element.</p><p>If specified, the value must be an <a href="common-microsyntaxes.html#ordered-set-of-unique-space-separated-tokens">ordered set of unique
Index: browsers.html
===================================================================
RCS file: /sources/public/html5/spec/browsers.html,v
retrieving revision 1.1084
retrieving revision 1.1085
diff -u -d -r1.1084 -r1.1085
--- browsers.html 24 Oct 2011 23:46:24 -0000 1.1084
+++ browsers.html 27 Oct 2011 21:46:24 -0000 1.1085
@@ -1050,9 +1050,6 @@
[TreatNonCallableAsNull] attribute <a href="webappapis.html#function">Function</a>? <a href="webappapis.html#handler-window-onunload" title="handler-window-onunload">onunload</a>;
[TreatNonCallableAsNull] attribute <a href="webappapis.html#function">Function</a>? <a href="webappapis.html#handler-onvolumechange" title="handler-onvolumechange">onvolumechange</a>;
[TreatNonCallableAsNull] attribute <a href="webappapis.html#function">Function</a>? <a href="webappapis.html#handler-onwaiting" title="handler-onwaiting">onwaiting</a>;
-
- // legacy "interfaces"
- readonly attribute object <a href="#htmldocument" title="HTMLDocument">HTMLDocument</a>;
};</pre><dl class="domintro"><dt><var title="">window</var> . <code title="dom-window"><a href="#dom-window">window</a></code></dt>
<dt><var title="">window</var> . <code title="dom-frames"><a href="#dom-frames">frames</a></code></dt>
<dt><var title="">window</var> . <code title="dom-self"><a href="#dom-self">self</a></code></dt>
@@ -1098,8 +1095,10 @@
<code><a href="#windowproxy">WindowProxy</a></code> object, if there is one, or null
otherwise.</p>
- <hr><p>The <dfn id="htmldocument"><code>HTMLDocument</code></dfn> IDL attribute must
- return the <code><a href="infrastructure.html#document">Document</a></code> interface prototype object.</p>
+ <hr><p>For historical reasons, <code><a href="#window">Window</a></code> objects must also
+ have a writable, configurable, non-enumerable property named
+ <dfn id="htmldocument"><code>HTMLDocument</code></dfn> whose value is the
+ <code><a href="infrastructure.html#document">Document</a></code> interface object.</p>
</div><div class="impl">
Index: spec.html
===================================================================
RCS file: /sources/public/html5/spec/spec.html,v
retrieving revision 1.1756
retrieving revision 1.1757
diff -u -d -r1.1756 -r1.1757
--- spec.html 27 Oct 2011 20:46:57 -0000 1.1756
+++ spec.html 27 Oct 2011 21:46:25 -0000 1.1757
@@ -349,7 +349,7 @@
<a href="Overview.html">single page HTML</a>,
<a href="spec.html">multipage HTML</a>,
<a href="author/">web developer edition</a>.
-This is revision 1.5421.
+This is revision 1.5423.
</p>
<p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
© 2011 <a href="http://www.w3.org/"><abbr title="World Wide
Received on Thursday, 27 October 2011 21:46:29 UTC