W3C home > Mailing lists > Public > public-html-commits@w3.org > October 2011

html5/spec browsers.html,1.1084,1.1085 editing.html,1.1060,1.1061 spec.html,1.1756,1.1757

From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
Date: Thu, 27 Oct 2011 21:46:27 +0000
To: public-html-commits@w3.org
Message-Id: <E1RJXmN-0007s6-78@lionel-hutz.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>&lt;input type=button value=Collect onclick="collect()"
+       <strong>accesskey="C 1"</strong> id=c&gt;</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>^&#8679;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>&#8997;&#9099;</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>
    &#169; 2011 <a href="http://www.w3.org/"><abbr title="World Wide
Received on Thursday, 27 October 2011 21:46:29 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 27 October 2011 21:46:33 GMT