W3C home > Mailing lists > Public > public-html-diffs@w3.org > July 2011

hixie: Rename the command API. Instead of reusing the existing APIs, we'll have an entirely new (readonly) API. Trying to reuse the existing API was an interesting idea but (whatwg r6286)

From: poot <cvsmail@w3.org>
Date: Mon, 11 Jul 2011 17:21:35 -0400
To: public-html-diffs@w3.org
Message-Id: <E1QgNv4-00064e-US@jay.w3.org>
hixie: Rename the command API. Instead of reusing the existing APIs,
we'll have an entirely new (readonly) API. Trying to reuse the existing
API was an interesting idea but  (whatwg r6286)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.5026&r2=1.5027&f=h
http://html5.org/tools/web-apps-tracker?from=6285&to=6286

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5026
retrieving revision 1.5027
diff -u -d -r1.5026 -r1.5027
--- Overview.html	7 Jul 2011 21:19:15 -0000	1.5026
+++ Overview.html	11 Jul 2011 21:21:10 -0000	1.5027
@@ -318,7 +318,7 @@
 
    <h1>HTML5</h1>
    <h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
-   <h2 class="no-num no-toc" id="editor-s-draft-7-july-2011">Editor's Draft 7 July 2011</h2>
+   <h2 class="no-num no-toc" id="editor-s-draft-11-july-2011">Editor's Draft 11 July 2011</h2>
    <dl><dt>Latest Published Version:</dt>
     <dd><a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a></dd>
     <dt>Latest Editor's Draft:</dt>
@@ -464,7 +464,7 @@
   Group</a> is the W3C working group responsible for this
   specification's progress along the W3C Recommendation
   track.
-  This specification is the 7 July 2011 Editor's Draft.
+  This specification is the 11 July 2011 Editor's Draft.
   </p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><p>Work on this specification is also done at the <a href="http://www.whatwg.org/">WHATWG</a>. The W3C HTML working group
   actively pursues convergence with the WHATWG, as required by the <a href="http://www.w3.org/2007/03/HTML-WG-charter">W3C HTML working
   group charter</a>.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><p>This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5
@@ -8608,10 +8608,11 @@
 
   // <a href="#command-api">command API</a>
   readonly attribute DOMString? <a href="#dom-command-ro-commandtype" title="dom-command-ro-commandType">commandType</a>;
-  readonly attribute DOMString? <a href="#dom-command-ro-label" title="dom-command-ro-label">label</a>;
-  readonly attribute DOMString? <a href="#dom-command-ro-icon" title="dom-command-ro-icon">icon</a>;
-  readonly attribute boolean <a href="#dom-command-ro-disabled" title="dom-command-ro-disabled">disabled</a>;
-  readonly attribute boolean <a href="#dom-command-ro-checked" title="dom-command-ro-checked">checked</a>;
+  readonly attribute DOMString? <a href="#dom-command-ro-commandlabel" title="dom-command-ro-commandLabel">commandLabel</a>;
+  readonly attribute DOMString? <a href="#dom-command-ro-commandicon" title="dom-command-ro-commandIcon">commandIcon</a>;
+  readonly attribute boolean? <a href="#dom-command-ro-commandhidden" title="dom-command-ro-commandHidden">commandHidden</a>;
+  readonly attribute boolean? <a href="#dom-command-ro-commanddisabled" title="dom-command-ro-commandDisabled">commandDisabled</a>;
+  readonly attribute boolean? <a href="#dom-command-ro-commandchecked" title="dom-command-ro-commandChecked">commandChecked</a>;
   // <span>styling</span>
   readonly attribute <span>CSSStyleDeclaration</span> <a href="#dom-style" title="dom-style">style</a>;
 
@@ -41030,7 +41031,7 @@
 
    </dd>
 
-   <dt><var title="">element</var> . <code title="dom-command-ro-label"><a href="#dom-command-ro-label">label</a></code></dt>
+   <dt><var title="">element</var> . <code title="dom-command-ro-commandLabel"><a href="#dom-command-ro-commandlabel">commandLabel</a></code></dt>
 
    <dd>
 
@@ -41046,7 +41047,7 @@
 
    </dd>
 
-   <dt><var title="">element</var> . <code title="dom-command-ro-icon"><a href="#dom-command-ro-icon">icon</a></code></dt>
+   <dt><var title="">element</var> . <code title="dom-command-ro-commandIcon"><a href="#dom-command-ro-commandicon">commandIcon</a></code></dt>
 
    <dd>
 
@@ -41062,21 +41063,15 @@
 
    </dd>
 
-   <dt><var title="">element</var> . <code title="dom-hidden"><a href="#dom-hidden">hidden</a></code></dt>
+   <dt><var title="">element</var> . <code title="dom-command-ro-commandHidden"><a href="#dom-command-ro-commandhidden">commandHidden</a></code></dt>
 
    <dd>
 
-    <p>Exposes the state of the element's <code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code> attribute, which is generally
-    equivalent to the <a href="#command-facet-hiddenstate" title="command-facet-HiddenState">Hidden
-    State</a> facet of the command. For <code><a href="#the-label-element">label</a></code> and
-    <code><a href="#the-legend-element">legend</a></code> elements (used in conjunction with the <code title="attr-accesskey"><a href="#the-accesskey-attribute">accesskey</a></code> attribute), the <a href="#command-facet-hiddenstate" title="command-facet-HiddenState">Hidden State</a> facet is
-    derived from another element (the one that the <a href="#assigned-access-key">assigned
-    access key</a> will trigger), and cannot be directly accessed
-    from the element.</p>
+    <p>Exposes the <a href="#command-facet-hiddenstate" title="command-facet-HiddenState">Hidden State</a> facet of the command.</p>
 
    </dd>
 
-   <dt><var title="">element</var> . <code title="dom-command-ro-disabled"><a href="#dom-command-ro-disabled">disabled</a></code></dt>
+   <dt><var title="">element</var> . <code title="dom-command-ro-commandDisabled"><a href="#dom-command-ro-commanddisabled">commandDisabled</a></code></dt>
 
    <dd>
 
@@ -41084,7 +41079,7 @@
 
    </dd>
 
-   <dt><var title="">element</var> . <code title="dom-command-ro-checked"><a href="#dom-command-ro-checked">checked</a></code></dt>
+   <dt><var title="">element</var> . <code title="dom-command-ro-commandChecked"><a href="#dom-command-ro-commandchecked">commandChecked</a></code></dt>
 
    <dd>
 
@@ -41108,42 +41103,42 @@
   element is "command", "radio", or "checkbox" respectively. If the
   element does not define a command, it must return null.</p>
 
-  <p>The <dfn id="dom-command-ro-label" title="dom-command-ro-label"><code>label</code></dfn>
+  <p>The <dfn id="dom-command-ro-commandlabel" title="dom-command-ro-commandLabel"><code>commandLabel</code></dfn>
   attribute must return the command's <a href="#command-facet-label" title="command-facet-Label">Label</a>, or null if the element
-  does not define a command or does not specify a <a href="#command-facet-label" title="command-facet-Label">Label</a>. This attribute will be
-  shadowed by the <code title="">label</code> IDL attribute on
-  various elements.</p>
+  does not define a command or does not specify a <a href="#command-facet-label" title="command-facet-Label">Label</a>.</p>
 
-  <p>The <dfn id="dom-command-ro-icon" title="dom-command-ro-icon"><code>icon</code></dfn>
+  <p>The <dfn id="dom-command-ro-commandicon" title="dom-command-ro-commandIcon"><code>commandIcon</code></dfn>
   attribute must return the <a href="#absolute-url">absolute URL</a> of the command's
   <a href="#command-facet-icon" title="command-facet-Icon">Icon</a>. If the element does
   not specify an icon, or if the element does not define a command,
-  then the attribute must return null. This attribute will be shadowed
-  by the <code title="dom-command-icon"><a href="#dom-command-icon">icon</a></code> IDL attribute on
-  <code><a href="#the-command-element">command</a></code> elements.</p>
+  then the attribute must return null.</p>
 
-  <p>The <dfn id="dom-command-ro-disabled" title="dom-command-ro-disabled"><code>disabled</code></dfn>
+  <p>The <dfn id="dom-command-ro-commandhidden" title="dom-command-ro-commandHidden"><code>commandHidden</code></dfn>
+  attribute must return true if the command's <a href="#command-facet-hiddenstate" title="command-facet-HiddenState">Hidden State</a> is that the
+  command is hidden, and false if the command is not hidden. If the
+  element does not define a command, the attribute must return
+  null.</p>
+
+  <p>The <dfn id="dom-command-ro-commanddisabled" title="dom-command-ro-commandDisabled"><code>commandDisabled</code></dfn>
   attribute must return true if the command's <a href="#command-facet-disabledstate" title="command-facet-DisabledState">Disabled State</a> is that
-  the command is disabled, and false if the command is not
-  disabled. This attribute is not affected by the command's <a href="#command-facet-hiddenstate" title="command-facet-HiddenState">Hidden State</a>. If the
+  the command is disabled, and false if the command is not disabled.
+  This attribute is not affected by the command's <a href="#command-facet-hiddenstate" title="command-facet-HiddenState">Hidden State</a>. If the
   element does not define a command, the attribute must return
-  false. This attribute will be shadowed by the <code title="">disabled</code> IDL attribute on various elements.</p>
+  null.</p>
 
-  <p>The <dfn id="dom-command-ro-checked" title="dom-command-ro-checked"><code>checked</code></dfn> attribute
-  must return true if the command's <a href="#command-facet-checkedstate" title="command-facet-CheckedState">Checked State</a> is that the
+  <p>The <dfn id="dom-command-ro-commandchecked" title="dom-command-ro-commandChecked"><code>commandChecked</code></dfn>
+  attribute must return true if the command's <a href="#command-facet-checkedstate" title="command-facet-CheckedState">Checked State</a> is that the
   command is checked, and false if it is that the command is not
   checked. If the element does not define a command, the attribute
-  must return false. This attribute will be shadowed by the <code title="">checked</code> IDL attribute on <code><a href="#the-input-element">input</a></code> and
-  <code><a href="#the-command-element">command</a></code> elements.</p>
+  must return null.</p>
 
 
   <p class="note">The <a href="#command-facet-id" title="command-facet-ID">ID</a> facet
-  is exposed by the <code title="dom-id"><a href="#dom-id">id</a></code> IDL attribute,
-  the <a href="#command-facet-hint" title="command-facet-Hint">Hint</a> facet is exposed by
-  the <code title="dom-title"><a href="#dom-title">title</a></code> IDL attribute, the <a href="#command-facet-accesskey" title="command-facet-AccessKey">AccessKey</a> facet is exposed by
+  is exposed by the <code title="dom-id"><a href="#dom-id">id</a></code> IDL attribute, the
+  <a href="#command-facet-hint" title="command-facet-Hint">Hint</a> facet is exposed by the
+  <code title="dom-title"><a href="#dom-title">title</a></code> IDL attribute, and the <a href="#command-facet-accesskey" title="command-facet-AccessKey">AccessKey</a> facet is exposed by
   the <code title="dom-accessKeyLabel"><a href="#dom-accesskeylabel">accessKeyLabel</a></code> IDL
-  attribute, and the <a href="#command-facet-hiddenstate" title="command-facet-HiddenState">Hidden
-  State</a> facet is exposed by the <code title="dom-hidden"><a href="#dom-hidden">hidden</a></code> IDL attribute.</p>
+  attribute.</p>
 
   </div><hr><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-commands"><a href="#dom-document-commands">commands</a></code></dt>
    <dd>
Received on Monday, 11 July 2011 21:21:41 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 11 July 2011 21:21:41 GMT