- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 14 Aug 2009 10:33:35 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec In directory hutz:/tmp/cvs-serv17042 Modified Files: Overview.html Log Message: Remove <bb>. (whatwg r3621) Index: Overview.html =================================================================== RCS file: /sources/public/html5/spec/Overview.html,v retrieving revision 1.2810 retrieving revision 1.2811 diff -u -d -r1.2810 -r1.2811 --- Overview.html 14 Aug 2009 10:13:44 -0000 1.2810 +++ Overview.html 14 Aug 2009 10:33:32 -0000 1.2811 @@ -698,29 +698,23 @@ <ol> <li><a href="#the-details-element"><span class="secno">4.11.1 </span>The <code>details</code> element</a></li> <li><a href="#the-command"><span class="secno">4.11.2 </span>The <code>command</code> element</a></li> - <li><a href="#the-bb-element"><span class="secno">4.11.3 </span>The <code>bb</code> element</a> - <ol> - <li><a href="#browser-button-types"><span class="secno">4.11.3.1 </span>Browser button types</a> - <ol> - <li><a href="#the-make-application-state"><span class="secno">4.11.3.1.1 </span>The <i>make application</i> state</a></ol></ol></li> - <li><a href="#menus"><span class="secno">4.11.4 </span>The <code>menu</code> element</a> + <li><a href="#menus"><span class="secno">4.11.3 </span>The <code>menu</code> element</a> <ol> - <li><a href="#menus-intro"><span class="secno">4.11.4.1 </span>Introduction</a></li> - <li><a href="#building-menus-and-tool-bars"><span class="secno">4.11.4.2 </span>Building menus and tool bars</a></li> - <li><a href="#context-menus"><span class="secno">4.11.4.3 </span>Context menus</a></li> - <li><a href="#tool-bars"><span class="secno">4.11.4.4 </span>Tool bars</a></ol></li> - <li><a href="#commands"><span class="secno">4.11.5 </span>Commands</a> + <li><a href="#menus-intro"><span class="secno">4.11.3.1 </span>Introduction</a></li> + <li><a href="#building-menus-and-tool-bars"><span class="secno">4.11.3.2 </span>Building menus and tool bars</a></li> + <li><a href="#context-menus"><span class="secno">4.11.3.3 </span>Context menus</a></li> + <li><a href="#tool-bars"><span class="secno">4.11.3.4 </span>Tool bars</a></ol></li> + <li><a href="#commands"><span class="secno">4.11.4 </span>Commands</a> <ol> - <li><a href="#using-the-a-element-to-define-a-command"><span class="secno">4.11.5.1 </span>Using the <code>a</code> element to define a command</a></li> - <li><a href="#using-the-button-element-to-define-a-command"><span class="secno">4.11.5.2 </span>Using the <code>button</code> element to define a command</a></li> - <li><a href="#using-the-input-element-to-define-a-command"><span class="secno">4.11.5.3 </span>Using the <code>input</code> element to define a command</a></li> - <li><a href="#using-the-option-element-to-define-a-command"><span class="secno">4.11.5.4 </span>Using the <code>option</code> element to define a command</a></li> - <li><a href="#using-the-command-element-to-define-a-command"><span class="secno">4.11.5.5 </span>Using the <code>command</code> element to define + <li><a href="#using-the-a-element-to-define-a-command"><span class="secno">4.11.4.1 </span>Using the <code>a</code> element to define a command</a></li> + <li><a href="#using-the-button-element-to-define-a-command"><span class="secno">4.11.4.2 </span>Using the <code>button</code> element to define a command</a></li> + <li><a href="#using-the-input-element-to-define-a-command"><span class="secno">4.11.4.3 </span>Using the <code>input</code> element to define a command</a></li> + <li><a href="#using-the-option-element-to-define-a-command"><span class="secno">4.11.4.4 </span>Using the <code>option</code> element to define a command</a></li> + <li><a href="#using-the-command-element-to-define-a-command"><span class="secno">4.11.4.5 </span>Using the <code>command</code> element to define a command</a></li> - <li><a href="#using-the-bb-element-to-define-a-command"><span class="secno">4.11.5.6 </span>Using the <code>bb</code> element to define a command</a></li> - <li><a href="#using-the-accesskey-attribute-on-a-label-element-to-define-a-command"><span class="secno">4.11.5.7 </span>Using the <code title="attr-accesskey">accesskey</code> attribute on a <code>label</code> element to define a command</a></li> - <li><a href="#using-the-accesskey-attribute-on-a-legend-element-to-define-a-command"><span class="secno">4.11.5.8 </span>Using the <code title="attr-accesskey">accesskey</code> attribute on a <code>legend</code> element to define a command</a></li> - <li><a href="#using-the-accesskey-attribute-to-define-a-command-on-other-elements"><span class="secno">4.11.5.9 </span>Using the <code title="attr-accesskey">accesskey</code> attribute to define a command on other elements</a></ol></ol></li> + <li><a href="#using-the-accesskey-attribute-on-a-label-element-to-define-a-command"><span class="secno">4.11.4.6 </span>Using the <code title="attr-accesskey">accesskey</code> attribute on a <code>label</code> element to define a command</a></li> + <li><a href="#using-the-accesskey-attribute-on-a-legend-element-to-define-a-command"><span class="secno">4.11.4.7 </span>Using the <code title="attr-accesskey">accesskey</code> attribute on a <code>legend</code> element to define a command</a></li> + <li><a href="#using-the-accesskey-attribute-to-define-a-command-on-other-elements"><span class="secno">4.11.4.8 </span>Using the <code title="attr-accesskey">accesskey</code> attribute to define a command on other elements</a></ol></ol></li> <li><a href="#miscellaneous-elements"><span class="secno">4.12 </span>Miscellaneous elements</a> <ol> <li><a href="#the-legend-element"><span class="secno">4.12.1 </span>The <code>legend</code> element</a></li> @@ -1116,23 +1110,22 @@ <li><a href="#bindings"><span class="secno">11.4 </span>Bindings</a> <ol> <li><a href="#introduction-10"><span class="secno">11.4.1 </span>Introduction</a></li> - <li><a href="#the-bb-element-0"><span class="secno">11.4.2 </span>The <code>bb</code> element</a></li> - <li><a href="#the-button-element-0"><span class="secno">11.4.3 </span>The <code>button</code> element</a></li> - <li><a href="#the-details-element-0"><span class="secno">11.4.4 </span>The <code>details</code> element</a></li> - <li><a href="#the-input-element-as-a-text-entry-widget"><span class="secno">11.4.5 </span>The <code>input</code> element as a text entry widget</a></li> - <li><a href="#the-input-element-as-domain-specific-widgets"><span class="secno">11.4.6 </span>The <code>input</code> element as domain-specific widgets</a></li> - <li><a href="#the-input-element-as-a-range-control"><span class="secno">11.4.7 </span>The <code>input</code> element as a range control</a></li> - <li><a href="#the-input-element-as-a-color-well"><span class="secno">11.4.8 </span>The <code>input</code> element as a color well</a></li> - <li><a href="#the-input-element-as-a-check-box-and-radio-button-widgets"><span class="secno">11.4.9 </span>The <code>input</code> element as a check box and radio button widgets</a></li> - <li><a href="#the-input-element-as-a-file-upload-control"><span class="secno">11.4.10 </span>The <code>input</code> element as a file upload control</a></li> - <li><a href="#the-input-element-as-a-button"><span class="secno">11.4.11 </span>The <code>input</code> element as a button</a></li> - <li><a href="#the-marquee-element"><span class="secno">11.4.12 </span>The <code>marquee</code> element</a></li> - <li><a href="#the-meter-element-0"><span class="secno">11.4.13 </span>The <code>meter</code> element</a></li> - <li><a href="#the-progress-element-0"><span class="secno">11.4.14 </span>The <code>progress</code> element</a></li> - <li><a href="#the-select-element-0"><span class="secno">11.4.15 </span>The <code>select</code> element</a></li> - <li><a href="#the-textarea-element-0"><span class="secno">11.4.16 </span>The <code>textarea</code> element</a></li> - <li><a href="#the-keygen-element-0"><span class="secno">11.4.17 </span>The <code>keygen</code> element</a></li> - <li><a href="#the-time-element-0"><span class="secno">11.4.18 </span>The <code>time</code> element</a></ol></li> + <li><a href="#the-button-element-0"><span class="secno">11.4.2 </span>The <code>button</code> element</a></li> + <li><a href="#the-details-element-0"><span class="secno">11.4.3 </span>The <code>details</code> element</a></li> + <li><a href="#the-input-element-as-a-text-entry-widget"><span class="secno">11.4.4 </span>The <code>input</code> element as a text entry widget</a></li> + <li><a href="#the-input-element-as-domain-specific-widgets"><span class="secno">11.4.5 </span>The <code>input</code> element as domain-specific widgets</a></li> + <li><a href="#the-input-element-as-a-range-control"><span class="secno">11.4.6 </span>The <code>input</code> element as a range control</a></li> + <li><a href="#the-input-element-as-a-color-well"><span class="secno">11.4.7 </span>The <code>input</code> element as a color well</a></li> + <li><a href="#the-input-element-as-a-check-box-and-radio-button-widgets"><span class="secno">11.4.8 </span>The <code>input</code> element as a check box and radio button widgets</a></li> + <li><a href="#the-input-element-as-a-file-upload-control"><span class="secno">11.4.9 </span>The <code>input</code> element as a file upload control</a></li> + <li><a href="#the-input-element-as-a-button"><span class="secno">11.4.10 </span>The <code>input</code> element as a button</a></li> + <li><a href="#the-marquee-element"><span class="secno">11.4.11 </span>The <code>marquee</code> element</a></li> + <li><a href="#the-meter-element-0"><span class="secno">11.4.12 </span>The <code>meter</code> element</a></li> + <li><a href="#the-progress-element-0"><span class="secno">11.4.13 </span>The <code>progress</code> element</a></li> + <li><a href="#the-select-element-0"><span class="secno">11.4.14 </span>The <code>select</code> element</a></li> + <li><a href="#the-textarea-element-0"><span class="secno">11.4.15 </span>The <code>textarea</code> element</a></li> + <li><a href="#the-keygen-element-0"><span class="secno">11.4.16 </span>The <code>keygen</code> element</a></li> + <li><a href="#the-time-element-0"><span class="secno">11.4.17 </span>The <code>time</code> element</a></ol></li> <li><a href="#frames-and-framesets"><span class="secno">11.5 </span>Frames and framesets</a></li> <li><a href="#interactive-media"><span class="secno">11.6 </span>Interactive media</a> <ol> @@ -7435,7 +7428,6 @@ <li><code><a href="#the-aside-element">aside</a></code></li> <li><code><a href="#audio">audio</a></code></li> <li><code><a href="#the-b-element">b</a></code></li> - <li><code><a href="#the-bb-element">bb</a></code></li> <li><code><a href="#the-bdo-element">bdo</a></code></li> <li><code><a href="#the-blockquote-element">blockquote</a></code></li> <li><code><a href="#the-br-element">br</a></code></li> @@ -7546,7 +7538,6 @@ <li><code><a href="#the-area-element">area</a></code> (if it is a descendant of a <code><a href="#the-map-element">map</a></code> element)</li> <li><code><a href="#audio">audio</a></code></li> <li><code><a href="#the-b-element">b</a></code></li> - <li><code><a href="#the-bb-element">bb</a></code></li> <li><code><a href="#the-bdo-element">bdo</a></code></li> <li><code><a href="#the-br-element">br</a></code></li> <li><code><a href="#the-button-element">button</a></code></li> @@ -7633,7 +7624,6 @@ --><p><dfn id="interactive-content-0">Interactive content</dfn> is content that is specifically intended for user interaction.<ul class="brief category-list"><li><code><a href="#the-a-element">a</a></code></li> <li><code><a href="#audio">audio</a></code> (if the <code title="attr-media-controls"><a href="#attr-media-controls">controls</a></code> attribute is present)</li> - <li><code><a href="#the-bb-element">bb</a></code></li> <li><code><a href="#the-button-element">button</a></code></li> <!-- v2DATAGRID <li><code>datagrid</code></li> --> <li><code><a href="#the-details-element">details</a></code></li> @@ -35871,164 +35861,7 @@ facet again. --> </div><p class="note"><code><a href="#the-command">command</a></code> elements are not rendered - unless they <a href="#menus" title="menu">form part of a menu</a>.<h4 id="the-bb-element"><span class="secno">4.11.3 </span>The <dfn><code>bb</code></dfn> element</h4><dl class="element"><dt>Categories</dt> - <dd><a href="#flow-content-0">Flow content</a>.</dd> - <dd><a href="#phrasing-content-0">Phrasing content</a>.</dd> - <dd><a href="#interactive-content-0">Interactive content</a>.</dd> - <dt>Contexts in which this element may be used:</dt> - <dd>Where <a href="#phrasing-content-0">phrasing content</a> is expected.</dd> - <dt>Content model:</dt> - <dd><a href="#phrasing-content-0">Phrasing content</a>, but there must be no <a href="#interactive-content-0">interactive content</a> descendant.</dd> - <dt>Content attributes:</dt> - <dd><a href="#global-attributes">Global attributes</a></dd> - <dd><code title="attr-command-type"><a href="#attr-command-type">type</a></code></dd> - <dt>DOM interface:</dt> - <dd> -<pre class="idl">interface <dfn id="htmlbrowserbuttonelement">HTMLBrowserButtonElement</dfn> : <a href="#htmlelement">HTMLElement</a> { - attribute DOMString <a href="#dom-bb-type" title="dom-bb-type">type</a>; - readonly attribute boolean <a href="#dom-bb-supported" title="dom-bb-supported">supported</a>; - readonly attribute boolean <a href="#dom-bb-disabled" title="dom-bb-disabled">disabled</a>; -};</pre> - </dd> - </dl><p>The <code><a href="#the-bb-element">bb</a></code> element represents a user agent command that - the user can invoke.<p>The <dfn id="attr-bb-type" title="attr-bb-type"><code>type</code></dfn> attribute - indicates the kind of command. The <code title="attr-bb-type"><a href="#attr-bb-type">type</a></code> attribute is an <a href="#enumerated-attribute">enumerated - attribute</a>. The following table lists the keywords and states - for the attribute — the keywords in the left column map to the - states listed in the cell in the second column on the same row as - the keyword.<table><thead><tr><th> Keyword <th> State - <tbody><tr><td> <dfn id="attr-bb-type-makeapp" title="attr-bb-type-makeapp"><code>makeapp</code></dfn> - <td> <i title="attr-bb-type-makeapp-state"><a href="#the-make-application-state">make application</a></i> - </table><p>The <i>missing value default</i> state is the <i title="attr-bb-type-null-state"><a href="#attr-bb-type-null-state">null</a></i> state.<p>Each state has an <i>action</i> and a <i>relevance</i>, defined - in the following sections.<p>When the attribute is in the <dfn id="attr-bb-type-null-state" title="attr-bb-type-null-state"><i>null</i></dfn> state, the - <i>action</i> is to not do anything, and the <i>relevance</i> is - unconditionally false.<div class="impl"> - - <p>A <code><a href="#the-bb-element">bb</a></code> element whose <code title="attr-bb-type"><a href="#attr-bb-type">type</a></code> attribute is in a state whose - <i>relevance</i> is true must be enabled. Conversely, a - <code><a href="#the-bb-element">bb</a></code> element whose <code title="attr-bb-type"><a href="#attr-bb-type">type</a></code> - attribute is in a state whose <i>relevance</i> is false must be - disabled.</p> - - <p class="note">If a <code><a href="#the-bb-element">bb</a></code> element is enabled, it will - match the <code title="selector-enabled"><a href="#selector-enabled">:enabled</a></code> - pseudo-class; otherwise, it will match the <code title="selector-disabled"><a href="#selector-disabled">:disabled</a></code> pseudo-class.</p> - - <p>User agents should allow users to invoke <code><a href="#the-bb-element">bb</a></code> elements - when they are enabled. When a user invokes a <code><a href="#the-bb-element">bb</a></code> - element, its <code title="attr-bb-type"><a href="#attr-bb-type">type</a></code> attribute's - state's <i>action</i> must be invoked.</p> - - </div><p>When the element has no descendant element children and has no - descendant <a href="#text-node">text node</a> children of non-zero length, the - element <a href="#represents">represents</a> a browser button with a - user-agent-defined icon or text representing the <code title="attr-bb-type"><a href="#attr-bb-type">type</a></code> attribute's state's <i>action</i> - and <i>relevance</i> (enabled vs disabled). Otherwise, the element - <a href="#represents">represents</a> its children.<dl class="domintro"><dt><var title="">bb</var> . <code title="dom-bb-supported"><a href="#dom-bb-supported">supported</a></code></dt> - - <dd> - - <p>Returns true if the value in the <code title="attr-bb-type"><a href="#attr-bb-type">type</a></code> attribute is a value that the - user agent supports. Otherwise, returns false.</p> - - </dd> - - <dt><var title="">bb</var> . <code title="dom-bb-disabled"><a href="#dom-bb-disabled">disabled</a></code></dt> - - <dd> - - <p>Returns false if the user can invoke the element's - <i>action</i> (i.e. if the element's <i>relevance</i> is - true). Otherwise, returns true.</p> - - </dd> - - </dl><div class="impl"> - - <p>The <dfn id="dom-bb-type" title="dom-bb-type"><code>type</code></dfn> DOM - attribute must <a href="#reflect">reflect</a> the content attribute of the - same name.</p> - - <p>The <dfn id="dom-bb-supported" title="dom-bb-supported"><code>supported</code></dfn> - DOM attribute must return true if the <code title="attr-bb-type"><a href="#attr-bb-type">type</a></code> attribute is in a state other than - the <i title="attr-bb-type-null-state"><a href="#attr-bb-type-null-state">null</a></i> state and the user - agent supports that state's <i>action</i> (i.e. when the attribute's - value is one that the user agent recognizes and supports), and false - otherwise.</p> - - <p>The <dfn id="dom-bb-disabled" title="dom-bb-disabled"><code>disabled</code></dfn> DOM - attribute must return true if the element is disabled, and false - otherwise (i.e. it returns the opposite of the <code title="attr-bb-type"><a href="#attr-bb-type">type</a></code> attribute's state's - <i>relevance</i>).</p> - - </div><h5 id="browser-button-types"><span class="secno">4.11.3.1 </span>Browser button types</h5><h6 id="the-make-application-state"><span class="secno">4.11.3.1.1 </span>The <dfn title="attr-bb-type-makeapp-state"><i>make application</i></dfn> state</h6><p>Some user agents support making sites accessible as independent - applications, as if they were not Web sites at all. The <i title="attr-bb-type-makeapp-state"><a href="#the-make-application-state">make application</a></i> state exists - to allow Web pages to offer themselves to the user as targets for - this mode of operation.<p>The <i>action</i> of the <i title="attr-bb-type-makeapp-state"><a href="#the-make-application-state">make application</a></i> state is to - confirm the user's intent to use the current site in a standalone - fashion, and, provided the user's intent is confirmed, offer the - user a way to make the resource identified by <a href="#the-document-s-address">the document's - address</a> available in such a fashion.<div class="impl"> - - <p class="warning">The confirmation is needed because it is - relatively easy to trick users into activating buttons. The - confirmation could, e.g. take the form of asking the user where to - "save" the application, or non-modal information panel that is - clearly from the user agent and gives the user the opportunity to - drag an icon to their system's application launcher.</p> - - </div><p>The <i>relevance</i> of the <i title="attr-bb-type-makeapp-state"><a href="#the-make-application-state">make application</a></i> state is - false if the user agent is already handling the site in such a - fashion, or if the user agent doesn't support making the site - available in that fashion, and true otherwise.<div class="example"> - - <p>In the following example, a few links are listed on an - application's page, to allow the user perform certain actions, - including making the application standalone:</p> - - <pre><menu> - <li><a href="settings.html" onclick="panels.show('settings')">Settings</a> - <li><bb type="makeapp">Download standalone application</bb> - <li><a href="help.html" onclick="panels.show('help')">Help</a> - <li><a href="logout.html" onclick="panels.show('logout')">Sign out</a> -</menu></pre> - - <p>With the following stylesheet, it could be make to look like a - single line of text with vertical bars separating the options, with - the "make app" option disappearing when it's not supported or - relevant:</p> - - <pre>menu li { display: none; } -menu li:enabled { display: inline; } -menu li:not(:first-child)::before { content: ' | '; }</pre> - - <p>This could look like this:</p> - - <p><img alt='"Settings | Download standalone application | Help | Sign out"' src="images/sample-makeapp.png"></p> - - </div><div class="example"> - - <p>The following example shows another way to do the same thing as - the previous one, this time not relying on CSS support to hide the - "make app" link if it doesn't apply:</p> - - <pre><menu> - <a href="settings.html" onclick="panels.show('settings')">Settings</a> | - <bb type="makeapp" id="makeapp"> </bb> - <a href="help.html" onclick="panels.show('help')">Help</a> | - <a href="logout.html" onclick="panels.show('logout')">Sign out</a> -</menu> -<script> - var bb = document.getElementById('makeapp'); - if (bb.supported && bb.enabled) { - bb.parentNode.nextSibling.textContent = ' | '; - bb.textContent = 'Download standalone application'; - } else { - bb.parentNode.removeChild(bb); - } -</script></pre> - - </div><h4 id="menus"><span class="secno">4.11.4 </span>The <dfn><code>menu</code></dfn> element</h4><dl class="element"><dt>Categories</dt> + unless they <a href="#menus" title="menu">form part of a menu</a>.<h4 id="menus"><span class="secno">4.11.3 </span>The <dfn><code>menu</code></dfn> element</h4><dl class="element"><dt>Categories</dt> <dd><a href="#flow-content-0">Flow content</a>.</dd> <dd>If the element's <code title="attr-menu-type"><a href="#attr-menu-type">type</a></code> attribute is in the <a href="#tool-bar-state" title="tool bar state">tool bar</a> state: <a href="#interactive-content-0">Interactive content</a>.</dd> <dt>Contexts in which this element may be used:</dt> @@ -36076,7 +35909,7 @@ <a href="#reflect">reflect</a> the respective content attributes of the same name.</p> - </div><h5 id="menus-intro"><span class="secno">4.11.4.1 </span>Introduction</h5><p><i>This section is non-normative.</i><p class="XXX">...</p><!-- + </div><h5 id="menus-intro"><span class="secno">4.11.3.1 </span>Introduction</h5><p><i>This section is non-normative.</i><p class="XXX">...</p><!-- <pre><menu type="commands"> @@ -36172,7 +36005,7 @@ --><div class="impl"> - <h5 id="building-menus-and-tool-bars"><span class="secno">4.11.4.2 </span><dfn>Building menus and tool bars</dfn></h5> + <h5 id="building-menus-and-tool-bars"><span class="secno">4.11.3.2 </span><dfn>Building menus and tool bars</dfn></h5> <p>A menu (or tool bar) consists of a list of zero or more of the following components:</p> @@ -36248,7 +36081,7 @@ <li>Any separator at the start or end of the menu must be removed.</li> - </ol></div><h5 id="context-menus"><span class="secno">4.11.4.3 </span><dfn>Context menus</dfn></h5><p>The <dfn id="attr-contextmenu" title="attr-contextmenu"><code>contextmenu</code></dfn> + </ol></div><h5 id="context-menus"><span class="secno">4.11.3.3 </span><dfn>Context menus</dfn></h5><p>The <dfn id="attr-contextmenu" title="attr-contextmenu"><code>contextmenu</code></dfn> attribute gives the element's <a href="#context-menus" title="context menus">context menu</a>. The value must be the ID of a <code><a href="#menus">menu</a></code> element in the DOM. <span class="impl">If the node that would be obtained by @@ -36311,7 +36144,7 @@ </div><div class="impl"> - <h5 id="tool-bars"><span class="secno">4.11.4.4 </span><dfn>Tool bars</dfn></h5> + <h5 id="tool-bars"><span class="secno">4.11.3.4 </span><dfn>Tool bars</dfn></h5> <p>When a <code><a href="#menus">menu</a></code> element has a <code title="attr-menu-type"><a href="#attr-menu-type">type</a></code> attribute in the <a href="#tool-bar-state" title="tool bar state">tool bar</a> state, then the user agent must <a href="#building-menus-and-tool-bars" title="building menus and tool bars">build</a> the @@ -36322,7 +36155,7 @@ <code><a href="#menus">menu</a></code>'s DOM, by immediately <a href="#building-menus-and-tool-bars" title="building menus and tool bars">rebuilding</a> the menu.</p> - </div><h4 id="commands"><span class="secno">4.11.5 </span>Commands</h4><p>A <dfn id="concept-command" title="concept-command">command</dfn> is the abstraction + </div><h4 id="commands"><span class="secno">4.11.4 </span>Commands</h4><p>A <dfn id="concept-command" title="concept-command">command</dfn> is the abstraction behind menu items, buttons, and links.<!--v2COMMAND: Once a command is defined, other parts of the interface can refer to the same command, allowing many access points to a single feature to share @@ -36555,7 +36388,7 @@ encouraged to do this especially for commands that have <a href="#command-facet-accesskey" title="command-facet-AccessKey">Access Keys</a>, as a way to advertise those keys to the user.<div class="impl"> - <h5 id="using-the-a-element-to-define-a-command"><span class="secno">4.11.5.1 </span><dfn title="a-command">Using the <code>a</code> element to define a command</dfn></h5> + <h5 id="using-the-a-element-to-define-a-command"><span class="secno">4.11.4.1 </span><dfn title="a-command">Using the <code>a</code> element to define a command</dfn></h5> <p>An <code><a href="#the-a-element">a</a></code> element with an <code title="attr-hyperlink-href"><a href="#attr-hyperlink-href">href</a></code> attribute <a href="#concept-command" title="concept-command">defines a command</a>.</p> @@ -36601,7 +36434,7 @@ command is to <a href="#fire-a-click-event" title="fire a click event">fire a <code title="event-click">click</code> event</a> at the element.</p> - <h5 id="using-the-button-element-to-define-a-command"><span class="secno">4.11.5.2 </span><dfn title="button-command">Using the <code>button</code> element to define a command</dfn></h5> + <h5 id="using-the-button-element-to-define-a-command"><span class="secno">4.11.4.2 </span><dfn title="button-command">Using the <code>button</code> element to define a command</dfn></h5> <p>A <code><a href="#the-button-element">button</a></code> element always <a href="#concept-command" title="concept-command">defines a command</a>.</p> @@ -36613,7 +36446,7 @@ State</a> of the command mirrors the <a href="#concept-fe-disabled" title="concept-fe-disabled">disabled</a> state of the button.</p> - <h5 id="using-the-input-element-to-define-a-command"><span class="secno">4.11.5.3 </span><dfn title="input-command">Using the <code>input</code> element to define a command</dfn></h5> + <h5 id="using-the-input-element-to-define-a-command"><span class="secno">4.11.4.3 </span><dfn title="input-command">Using the <code>input</code> element to define a command</dfn></h5> <p>An <code><a href="#the-input-element">input</a></code> element whose <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in one of the <a href="#submit-button-state" title="attr-input-type-submit">Submit Button</a>, <a href="#reset-button-state" title="attr-input-type-reset">Reset Button</a>, <a href="#image-button-state" title="attr-input-type-image">Image Button</a>, <a href="#button-state" title="attr-input-type-button">Button</a>, <a href="#radio-button-state" title="attr-input-type-radio">Radio Button</a>, or <a href="#checkbox-state" title="attr-input-type-checkbox">Checkbox</a> states <a href="#concept-command" title="concept-command">defines a command</a>.</p> @@ -36684,7 +36517,7 @@ element.</p> - <h5 id="using-the-option-element-to-define-a-command"><span class="secno">4.11.5.4 </span><dfn title="option-command">Using the <code>option</code> element to define a command</dfn></h5> + <h5 id="using-the-option-element-to-define-a-command"><span class="secno">4.11.4.4 </span><dfn title="option-command">Using the <code>option</code> element to define a command</dfn></h5> <p>An <code><a href="#the-option-element">option</a></code> element with an ancestor <code><a href="#the-select-element">select</a></code> element and either no <code title="attr-option-value"><a href="#attr-option-value">value</a></code> attribute or a <code title="attr-option-value"><a href="#attr-option-value">value</a></code> attribute that is not the @@ -36737,7 +36570,7 @@ element.</p> - <h5 id="using-the-command-element-to-define-a-command"><span class="secno">4.11.5.5 </span>Using the <dfn title="command-element"><code>command</code></dfn> element to define + <h5 id="using-the-command-element-to-define-a-command"><span class="secno">4.11.4.5 </span>Using the <dfn title="command-element"><code>command</code></dfn> element to define a command</h5> <p>A <code><a href="#the-command">command</a></code> element <a href="#concept-command" title="concept-command">defines a command</a>.</p> @@ -36793,63 +36626,8 @@ - <h5 id="using-the-bb-element-to-define-a-command"><span class="secno">4.11.5.6 </span><dfn title="bb-command">Using the <code>bb</code> element to define a command</dfn></h5> - - <p>A <code><a href="#the-bb-element">bb</a></code> element always <a href="#concept-command" title="concept-command">defines a command</a>.</p> - - <p>The <a href="#command-facet-type" title="command-facet-Type">Type</a> of the command - is "command".</p> - - <p>The <a href="#command-facet-id" title="command-facet-ID">ID</a> of the command is - the value of the <code title="attr-id"><a href="#the-id-attribute">id</a></code> attribute of the - element, if the attribute is present and not empty. Otherwise the - command is an <a href="#anonymous-command">anonymous command</a>.</p> - - <p>The <a href="#command-facet-label" title="command-facet-Label">Label</a> of the command - is the string given by the element's <code>textContent</code> DOM - attribute, if that is not the empty string, or a user-agent-defined - string appropriate for the <code><a href="#the-bb-element">bb</a></code> element's <code title="attr-bb-type"><a href="#attr-bb-type">type</a></code> attribute's state.</p> - - <p>The <a href="#command-facet-hint" title="command-facet-Hint">Hint</a> of the command - is the value of the <code title="attr-title"><a href="#the-title-attribute">title</a></code> attribute - of the element. If the attribute is not present, the <a href="#command-facet-hint" title="command-facet-Hint">Hint</a> is a user-agent-defined - string appropriate for the <code><a href="#the-bb-element">bb</a></code> element's <code title="attr-bb-type"><a href="#attr-bb-type">type</a></code> attribute's state.</p> - - <p>The <a href="#command-facet-icon" title="command-facet-Icon">Icon</a> of the command - is the <a href="#absolute-url">absolute URL</a> obtained from <a href="#resolve-a-url" title="resolve - a url">resolving</a> the value of the <code title="attr-img-src"><a href="#attr-img-src">src</a></code> attribute of the first - <code><a href="#the-img-element">img</a></code> element descendant of the element, relative to that - element, if there is such an element and resolving its attribute is - successful. Otherwise, the <a href="#command-facet-icon" title="command-facet-Icon">Icon</a> is a user-agent-defined image - appropriate for the <code><a href="#the-bb-element">bb</a></code> element's <code title="attr-bb-type"><a href="#attr-bb-type">type</a></code> attribute's state.</p> - - <p>The <a href="#command-facet-accesskey" title="command-facet-AccessKey">AccessKey</a> of the - command is the element's <a href="#assigned-access-key">assigned access key</a>, if - any.</p> - - <p>The <a href="#command-facet-hiddenstate" title="command-facet-HiddenState">Hidden State</a> - facet of the command is true (hidden) if the <code><a href="#the-bb-element">bb</a></code> - element's <code title="attr-bb-type"><a href="#attr-bb-type">type</a></code> attribute's state - is <i title="attr-bb-type-null-state"><a href="#attr-bb-type-null-state">null</a></i> or if the element has - a <code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code> attribute, and false - otherwise.</p> - - <p>The <a href="#command-facet-disabledstate" title="command-facet-DisabledState">Disabled - State</a> facet of the command is true if the <code><a href="#the-bb-element">bb</a></code> - element's <code title="attr-bb-type"><a href="#attr-bb-type">type</a></code> attribute's state's - <i>relevance</i> is false, and true otherwise.</p> - - <p>The <a href="#command-facet-checkedstate" title="command-facet-CheckedState">Checked State</a> - of the command is always false. (The command is never checked.)</p> - - <p>The <a href="#command-facet-action" title="command-facet-Action">Action</a> of the - command is to perform the <i>action</i> of the <code><a href="#the-bb-element">bb</a></code> - element's <code title="attr-bb-type"><a href="#attr-bb-type">type</a></code> attribute's - state.</p> - - - <h5 id="using-the-accesskey-attribute-on-a-label-element-to-define-a-command"><span class="secno">4.11.5.7 </span><dfn title="label-command">Using the <code title="attr-accesskey">accesskey</code> attribute on a <code>label</code> element to define a command</dfn></h5> + <h5 id="using-the-accesskey-attribute-on-a-label-element-to-define-a-command"><span class="secno">4.11.4.6 </span><dfn title="label-command">Using the <code title="attr-accesskey">accesskey</code> attribute on a <code>label</code> element to define a command</dfn></h5> <p>A <code><a href="#the-label-element">label</a></code> element that has an <a href="#assigned-access-key">assigned access key</a> and a <a href="#labeled-control">labeled control</a> and whose @@ -36890,7 +36668,7 @@ - <h5 id="using-the-accesskey-attribute-on-a-legend-element-to-define-a-command"><span class="secno">4.11.5.8 </span><dfn title="legend-command">Using the <code title="attr-accesskey">accesskey</code> attribute on a <code>legend</code> element to define a command</dfn></h5> + <h5 id="using-the-accesskey-attribute-on-a-legend-element-to-define-a-command"><span class="secno">4.11.4.7 </span><dfn title="legend-command">Using the <code title="attr-accesskey">accesskey</code> attribute on a <code>legend</code> element to define a command</dfn></h5> <p>A <code><a href="#the-legend-element">legend</a></code> element that has an <a href="#assigned-access-key">assigned access key</a> and is a child of a <code><a href="#the-fieldset-element">fieldset</a></code> element that @@ -36934,7 +36712,7 @@ - <h5 id="using-the-accesskey-attribute-to-define-a-command-on-other-elements"><span class="secno">4.11.5.9 </span><dfn title="accesskey-command">Using the <code title="attr-accesskey">accesskey</code> attribute to define a command on other elements</dfn></h5> + <h5 id="using-the-accesskey-attribute-to-define-a-command-on-other-elements"><span class="secno">4.11.4.8 </span><dfn title="accesskey-command">Using the <code title="attr-accesskey">accesskey</code> attribute to define a command on other elements</dfn></h5> <p>An element that has an <a href="#assigned-access-key">assigned access key</a> <a href="#concept-command" title="concept-command">defines a command</a>.</p> @@ -37116,9 +36894,6 @@ <li><code><a href="#the-link-element">link</a></code> elements that have an <code title="attr-link-href"><a href="#attr-link-href">href</a></code> attribute</li> - <li><code><a href="#the-bb-element">bb</a></code> elements whose <code title="attr-bb-type"><a href="#attr-bb-type">type</a></code> attribute is in a state whose - <i>relevance</i> is true</li> - <li><code><a href="#the-button-element">button</a></code> elements that are not <a href="#concept-fe-disabled" title="concept-fe-disabled">disabled</a></li> <li><code><a href="#the-input-element">input</a></code> elements whose <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute is in the <a href="#submit-button-state" title="attr-input-type-submit">Submit Button</a>, <a href="#image-button-state" title="attr-input-type-image">Image Button</a>, <a href="#reset-button-state" title="attr-input-type-reset">Reset Button</a>, or <a href="#button-state" title="attr-input-type-button">Button</a> state</li> @@ -37150,9 +36925,6 @@ <li><code><a href="#the-link-element">link</a></code> elements that have an <code title="attr-link-href"><a href="#attr-link-href">href</a></code> attribute</li> - <li><code><a href="#the-bb-element">bb</a></code> elements whose <code title="attr-bb-type"><a href="#attr-bb-type">type</a></code> attribute is in a state whose - <i>relevance</i> is true</li> - <li><code><a href="#the-button-element">button</a></code> elements that are not <a href="#concept-fe-disabled" title="concept-fe-disabled">disabled</a></li> <li><code><a href="#the-input-element">input</a></code> elements whose <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute are not in the @@ -37183,10 +36955,7 @@ <p>The <code title="selector-disabled"><a href="#selector-disabled">:disabled</a></code> pseudo-class must match the following elements:</p> - <ul><li><code><a href="#the-bb-element">bb</a></code> elements whose <code title="attr-bb-type"><a href="#attr-bb-type">type</a></code> attribute is in a state whose - <i>relevance</i> is false</li> - - <li><code><a href="#the-button-element">button</a></code> elements that are <a href="#concept-fe-disabled" title="concept-fe-disabled">disabled</a></li> + <ul><li><code><a href="#the-button-element">button</a></code> elements that are <a href="#concept-fe-disabled" title="concept-fe-disabled">disabled</a></li> <li><code><a href="#the-input-element">input</a></code> elements whose <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute are not in the <a href="#hidden-state" title="attr-input-type-hidden">Hidden</a> state and that @@ -49227,9 +48996,6 @@ <li><code><a href="#the-link-element">link</a></code> elements that have an <code title="attr-link-href"><a href="#attr-link-href">href</a></code> attribute</li> - <li><code><a href="#the-bb-element">bb</a></code> elements whose <code title="attr-bb-type"><a href="#attr-bb-type">type</a></code> attribute is in a state whose - <i>relevance</i> is true</li> - <li><code><a href="#the-button-element">button</a></code> elements that are not <a href="#concept-fe-disabled" title="concept-fe-disabled">disabled</a></li> <li><code><a href="#the-input-element">input</a></code> elements whose <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute are not in the @@ -64041,7 +63807,7 @@ 'binding' property. <a href="#refsBECSS">[BECSS]</a></p> <p>The CSS snippets below set the 'binding' property to a - user-agent-defined value, represented below by keywords like <code title=""><i title="">bb</i></code>. The rules then described for + user-agent-defined value, represented below by keywords like <code title=""><i title="">button</i></code>. The rules then described for these bindings are only expected to apply if the element's 'binding' property has not been overridden (e.g. by the author) to have another value.</p> @@ -64055,21 +63821,7 @@ - <h4 id="the-bb-element-0"><span class="secno">11.4.2 </span>The <code><a href="#the-bb-element">bb</a></code> element</h4> - - <pre class="css">@namespace url(http://www.w3.org/1999/xhtml); - -bb:empty { binding: <i title="">bb</i>; }</pre> - - <p>When the <i title="">bb</i> binding applies to a <code><a href="#the-bb-element">bb</a></code> - element, the element is expected to render as an 'inline-block' box - rendered as a button, about one line high, containing text derived - from the element's <code title="attr-bb-type"><a href="#attr-bb-type">type</a></code> attribute - in a user-agent-defined (and probably locale-specific) fashion.</p> - - - - <h4 id="the-button-element-0"><span class="secno">11.4.3 </span>The <code><a href="#the-button-element">button</a></code> element</h4> + <h4 id="the-button-element-0"><span class="secno">11.4.2 </span>The <code><a href="#the-button-element">button</a></code> element</h4> <pre class="css">@namespace url(http://www.w3.org/1999/xhtml); @@ -64091,7 +63843,7 @@ filled in. --> - <h4 id="the-details-element-0"><span class="secno">11.4.4 </span>The <code><a href="#the-details-element">details</a></code> element</h4> + <h4 id="the-details-element-0"><span class="secno">11.4.3 </span>The <code><a href="#the-details-element">details</a></code> element</h4> <pre class="css">@namespace url(http://www.w3.org/1999/xhtml); @@ -64124,7 +63876,7 @@ - <h4 id="the-input-element-as-a-text-entry-widget"><span class="secno">11.4.5 </span>The <code><a href="#the-input-element">input</a></code> element as a text entry widget</h4> + <h4 id="the-input-element-as-a-text-entry-widget"><span class="secno">11.4.4 </span>The <code><a href="#the-input-element">input</a></code> element as a text entry widget</h4> <pre class="css">@namespace url(http://www.w3.org/1999/xhtml); @@ -64168,7 +63920,7 @@ - <h4 id="the-input-element-as-domain-specific-widgets"><span class="secno">11.4.6 </span>The <code><a href="#the-input-element">input</a></code> element as domain-specific widgets</h4> + <h4 id="the-input-element-as-domain-specific-widgets"><span class="secno">11.4.5 </span>The <code><a href="#the-input-element">input</a></code> element as domain-specific widgets</h4> <pre class="css">@namespace url(http://www.w3.org/1999/xhtml); @@ -64220,7 +63972,7 @@ - <h4 id="the-input-element-as-a-range-control"><span class="secno">11.4.7 </span>The <code><a href="#the-input-element">input</a></code> element as a range control</h4> + <h4 id="the-input-element-as-a-range-control"><span class="secno">11.4.6 </span>The <code><a href="#the-input-element">input</a></code> element as a range control</h4> <pre class="css">@namespace url(http://www.w3.org/1999/xhtml); @@ -64243,7 +63995,7 @@ - <h4 id="the-input-element-as-a-color-well"><span class="secno">11.4.8 </span>The <code><a href="#the-input-element">input</a></code> element as a color well</h4> + <h4 id="the-input-element-as-a-color-well"><span class="secno">11.4.7 </span>The <code><a href="#the-input-element">input</a></code> element as a color well</h4> <pre class="css">@namespace url(http://www.w3.org/1999/xhtml); @@ -64262,7 +64014,7 @@ - <h4 id="the-input-element-as-a-check-box-and-radio-button-widgets"><span class="secno">11.4.9 </span>The <code><a href="#the-input-element">input</a></code> element as a check box and radio button widgets</h4> + <h4 id="the-input-element-as-a-check-box-and-radio-button-widgets"><span class="secno">11.4.8 </span>The <code><a href="#the-input-element">input</a></code> element as a check box and radio button widgets</h4> <pre class="css">@namespace url(http://www.w3.org/1999/xhtml); @@ -64281,7 +64033,7 @@ - <h4 id="the-input-element-as-a-file-upload-control"><span class="secno">11.4.10 </span>The <code><a href="#the-input-element">input</a></code> element as a file upload control</h4> + <h4 id="the-input-element-as-a-file-upload-control"><span class="secno">11.4.9 </span>The <code><a href="#the-input-element">input</a></code> element as a file upload control</h4> <pre class="css">@namespace url(http://www.w3.org/1999/xhtml); @@ -64296,7 +64048,7 @@ - <h4 id="the-input-element-as-a-button"><span class="secno">11.4.11 </span>The <code><a href="#the-input-element">input</a></code> element as a button</h4> + <h4 id="the-input-element-as-a-button"><span class="secno">11.4.10 </span>The <code><a href="#the-input-element">input</a></code> element as a button</h4> <pre class="css">@namespace url(http://www.w3.org/1999/xhtml); @@ -64314,7 +64066,7 @@ - <h4 id="the-marquee-element"><span class="secno">11.4.12 </span>The <code><a href="#the-marquee-element-0">marquee</a></code> element</h4> + <h4 id="the-marquee-element"><span class="secno">11.4.11 </span>The <code><a href="#the-marquee-element-0">marquee</a></code> element</h4> <pre class="css">@namespace url(http://www.w3.org/1999/xhtml); @@ -64476,7 +64228,7 @@ hidden.</p> - <h4 id="the-meter-element-0"><span class="secno">11.4.13 </span>The <code><a href="#the-meter-element">meter</a></code> element</h4> + <h4 id="the-meter-element-0"><span class="secno">11.4.12 </span>The <code><a href="#the-meter-element">meter</a></code> element</h4> <pre class="css">@namespace url(http://www.w3.org/1999/xhtml); @@ -64506,7 +64258,7 @@ - <h4 id="the-progress-element-0"><span class="secno">11.4.14 </span>The <code><a href="#the-progress-element">progress</a></code> element</h4> + <h4 id="the-progress-element-0"><span class="secno">11.4.13 </span>The <code><a href="#the-progress-element">progress</a></code> element</h4> <pre class="css">@namespace url(http://www.w3.org/1999/xhtml); @@ -64542,7 +64294,7 @@ - <h4 id="the-select-element-0"><span class="secno">11.4.15 </span>The <code><a href="#the-select-element">select</a></code> element</h4> + <h4 id="the-select-element-0"><span class="secno">11.4.14 </span>The <code><a href="#the-select-element">select</a></code> element</h4> <pre class="css">@namespace url(http://www.w3.org/1999/xhtml); @@ -64598,7 +64350,7 @@ - <h4 id="the-textarea-element-0"><span class="secno">11.4.16 </span>The <code><a href="#the-textarea-element">textarea</a></code> element</h4> + <h4 id="the-textarea-element-0"><span class="secno">11.4.15 </span>The <code><a href="#the-textarea-element">textarea</a></code> element</h4> <pre class="css">@namespace url(http://www.w3.org/1999/xhtml); @@ -64647,7 +64399,7 @@ - <h4 id="the-keygen-element-0"><span class="secno">11.4.17 </span>The <code><a href="#the-keygen-element">keygen</a></code> element</h4> + <h4 id="the-keygen-element-0"><span class="secno">11.4.16 </span>The <code><a href="#the-keygen-element">keygen</a></code> element</h4> <pre class="css">@namespace url(http://www.w3.org/1999/xhtml); @@ -64660,7 +64412,7 @@ - <h4 id="the-time-element-0"><span class="secno">11.4.18 </span>The <code><a href="#the-time-element">time</a></code> element</h4> + <h4 id="the-time-element-0"><span class="secno">11.4.17 </span>The <code><a href="#the-time-element">time</a></code> element</h4> <pre class="css">@namespace url(http://www.w3.org/1999/xhtml);
Received on Friday, 14 August 2009 10:33:45 UTC