- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 10 Sep 2008 21:44:50 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv22375
Modified Files:
Overview.html
Log Message:
WF2: Bring together 'disabled' and 'name' attributes that are common to all form controls, so we can have a single definition. Begin to specify 'successful'. Related minor editorial tweaks. (whatwg r2162)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1334
retrieving revision 1.1335
diff -u -d -r1.1334 -r1.1335
--- Overview.html 10 Sep 2008 10:41:51 -0000 1.1334
+++ Overview.html 10 Sep 2008 21:44:47 -0000 1.1335
@@ -1067,15 +1067,14 @@
<li><a href="#association"><span class=secno>4.9.12 </span>Association
of controls and forms</a>
- <li><a href="#processing1"><span class=secno>4.9.13 </span>Processing
- models</a>
- <ul class=toc>
- <li><a href="#constraint"><span class=secno>4.9.13.1.
- </span>Constraint validation</a>
+ <li><a href="#attributes1"><span class=secno>4.9.13 </span>Attributes
+ common to form controls</a>
- <li><a href="#form-submission"><span class=secno>4.9.13.2.
- </span>Form submission</a>
- </ul>
+ <li><a href="#constraint"><span class=secno>4.9.14 </span>Constraint
+ validation</a>
+
+ <li><a href="#form-submission"><span class=secno>4.9.15 </span>Form
+ submission</a>
</ul>
<li><a href="#scripting1"><span class=secno>4.10 </span>Scripting</a>
@@ -1206,7 +1205,7 @@
<li><a href="#global0"><span class=secno>4.12.5 </span>Global
attributes for data templates</a>
- <li><a href="#processing2"><span class=secno>4.12.6 </span>Processing
+ <li><a href="#processing1"><span class=secno>4.12.6 </span>Processing
model</a>
<ul class=toc>
<li><a href="#the-originalcontent"><span class=secno>4.12.6.1.
@@ -1376,7 +1375,7 @@
<li><a href="#updating1"><span class=secno>5.7.4 </span>Updating an
application cache</a>
- <li><a href="#processing3"><span class=secno>5.7.5 </span>Processing
+ <li><a href="#processing2"><span class=secno>5.7.5 </span>Processing
model</a>
<ul class=toc>
<li><a href="#changesToNetworkingModel"><span class=secno>5.7.5.1.
@@ -1495,7 +1494,7 @@
<li><a href="#errors"><span class=secno>5.10.2.5. </span>Errors</a>
- <li><a href="#processing4"><span class=secno>5.10.2.6.
+ <li><a href="#processing3"><span class=secno>5.10.2.6.
</span>Processing model</a>
</ul>
@@ -1864,7 +1863,7 @@
<li><a href="#end-tags"><span class=secno>8.1.2.2. </span>End
tags</a>
- <li><a href="#attributes1"><span class=secno>8.1.2.3.
+ <li><a href="#attributes2"><span class=secno>8.1.2.3.
</span>Attributes</a>
<li><a href="#optional"><span class=secno>8.1.2.4. </span>Optional
@@ -6702,7 +6701,7 @@
href="#applet">applet</a></code>, <code><a href="#area">area</a></code>,
<code><a href="#form">form</a></code>, <code><a
href="#img">img</a></code>, or <code><a href="#object">object</a></code>
- element with a <code title=attr-name>name</code> attribute equal to <var
+ element with a <code title="">name</code> attribute equal to <var
title="">key</var>, or,
<li>It is an <a href="#html-elements" title="HTML elements">HTML
@@ -6721,7 +6720,8 @@
<p>The <code><a
href="#htmlformcontrolscollection0">HTMLFormControlsCollection</a></code>
interface represents a <a href="#collections0"
- title=collections>collection</a> of form controls.
+ title=collections>collection</a> of <a href="#field"
+ title=category-field>field elements</a>.
<pre
class=idl>interface <dfn id=htmlformcontrolscollection0>HTMLFormControlsCollection</dfn> {
@@ -6750,14 +6750,14 @@
<ol>
<li>If, at the time the method is called, there is exactly one node in the
collection that has either an <code title=attr-id><a
- href="#id">id</a></code> attribute or a <code title=attr-name>name</code>
- attribute equal to <var title="">key</var>, then return that node and
- stop the algorithm.
+ href="#id">id</a></code> attribute or a <code title=attr-fe-name><a
+ href="#name9">name</a></code> attribute equal to <var title="">key</var>,
+ then return that node and stop the algorithm.
<li>Otherwise, if there are no nodes in the collection that have either an
<code title=attr-id><a href="#id">id</a></code> attribute or a <code
- title=attr-name>name</code> attribute equal to <var title="">key</var>,
- then return null and stop the algorithm.
+ title=attr-fe-name><a href="#name9">name</a></code> attribute equal to
+ <var title="">key</var>, then return null and stop the algorithm.
<li>Otherwise, create a <code>NodeList</code> object representing a live
view of the <code><a
@@ -6765,9 +6765,9 @@
object, further filtered so that the only nodes in the
<code>NodeList</code> object are those that have either an <code
title=attr-id><a href="#id">id</a></code> attribute or a <code
- title=attr-name>name</code> attribute equal to <var title="">key</var>.
- The nodes in the <code>NodeList</code> object must be sorted in <a
- href="#tree-order">tree order</a>.
+ title=attr-fe-name><a href="#name9">name</a></code> attribute equal to
+ <var title="">key</var>. The nodes in the <code>NodeList</code> object
+ must be sorted in <a href="#tree-order">tree order</a>.
<li>Return that <code>NodeList</code> object.
</ol>
@@ -6830,14 +6830,14 @@
<ol>
<li>If, at the time the method is called, there is exactly one node in the
collection that has either an <code title=attr-id><a
- href="#id">id</a></code> attribute or a <code title=attr-name>name</code>
- attribute equal to <var title="">key</var>, then return that node and
- stop the algorithm.
+ href="#id">id</a></code> attribute or a <code
+ title=attr-option-name>name</code> attribute equal to <var
+ title="">key</var>, then return that node and stop the algorithm.
<li>Otherwise, if there are no nodes in the collection that have either an
<code title=attr-id><a href="#id">id</a></code> attribute or a <code
- title=attr-name>name</code> attribute equal to <var title="">key</var>,
- then return null and stop the algorithm.
+ title=attr-option-name>name</code> attribute equal to <var
+ title="">key</var>, then return null and stop the algorithm.
<li>Otherwise, create a <code>NodeList</code> object representing a live
view of the <code><a
@@ -26529,14 +26529,15 @@
content attribute with a matching <code title=dom-fae-form><a
href="#form1">form</a></code> DOM attribute.
- <p>The controls that end up being submitted back to the server are in the
- <dfn id=field title=category-field>field</dfn> category.
+ <p>The controls that end up being submitted back to the server are <dfn
+ id=field title=category-field>field elements</dfn>.
<p>The controls that are exposed to the <code title=dom-form-elements><a
href="#elements3"><var title="">form</var>.elements</a></code> and <code
title=dom-fieldset-elements><a href="#elements4"><var
- title="">fieldset</var>.elements</a></code> APIs are in the <dfn id=listed
- title=category-listed-form-element>listed form element</dfn> category.
+ title="">fieldset</var>.elements</a></code> APIs are <dfn id=listed
+ title=category-listed-form-element>listed form elements</dfn>. This is a
+ superset of the <a href="#field" title=category-field>field elements</a>.
<h4 id=the-form><span class=secno>4.9.1 </span>The <dfn
id=form><code>form</code></dfn> element</h4>
@@ -26660,6 +26661,8 @@
<dd><code title=attr-fae-form><a href="#form0">form</a></code>
+ <dd><code title=attr-fe-name><a href="#name9">name</a></code>
+
<dt>DOM interface:
<dd>
@@ -26667,6 +26670,7 @@
class=idl>interface <dfn id=htmlfieldsetelement>HTMLFieldSetElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
attribute DOMString <span title=dom-fieldset-disabled>disabled</span>;
readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <a href="#form1" title=dom-fae-form>form</a>;
+ attribute DOMString <a href="#name10" title=dom-fe-name>name</a>;
readonly attribute DOMString <span title=dom-select-type>type</span>;
@@ -26703,7 +26707,7 @@
<dd><a href="#form-associated">Form-associated element</a>.
- <dd><a href="#field" title=category-field>Field</a>.
+ <dd><a href="#field" title=category-field>Field element</a>.
<dd><a href="#listed" title=category-listed-form-element>Listed form
element</a>.
@@ -26730,7 +26734,7 @@
<dd><code title=attr-input-checked>checked</code>
- <dd><code title=attr-input-disabled>disabled</code>
+ <dd><code title=attr-fe-disabled><a href="#disabled3">disabled</a></code>
<dd><code title=attr-input-enctype>enctype</code>
@@ -26748,7 +26752,7 @@
<dd><code title=attr-input-min>min</code>
- <dd><code title=attr-input-name>name</code>
+ <dd><code title=attr-fe-name><a href="#name9">name</a></code>
<dd><code title=attr-input-pattern>pattern</code>
@@ -26780,7 +26784,7 @@
attribute boolean <span title=dom-input-autofocus>autofocus</span>;
attribute boolean <span title=dom-input-defaultChecked>defaultChecked</span>;
attribute boolean <span title=dom-input-checked>checked</span>;
- attribute boolean <span title=dom-input-disabled>disabled</span>;
+ attribute boolean <a href="#disabled4" title=dom-fe-disabled>disabled</a>;
attribute DOMString <span title=dom-input-enctype>enctype</span>;
readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <a href="#form1" title=dom-fae-form>form</a>;
attribute DOMString <span title=dom-input-inputmode>inputmode</span>;
@@ -26789,7 +26793,7 @@
attribute long <span title=dom-input-maxLength>maxLength</span>;
attribute DOMString <span title=dom-input-method>method</span>;
attribute DOMString <span title=dom-input-min>min</span>;
- attribute DOMString <span title=dom-input-name>name</span>;
+ attribute DOMString <a href="#name10" title=dom-fe-name>name</a>;
attribute DOMString <span title=dom-input-pattern>pattern</span>;
attribute boolean <span title=dom-input-readOnly>readOnly</span>;
attribute boolean <span title=dom-input-required>required</span>;
@@ -26835,7 +26839,7 @@
<dd><a href="#form-associated">Form-associated element</a>.
- <dd><a href="#field" title=category-field>Field</a>.
+ <dd><a href="#field" title=category-field>Field element</a>.
<dd><a href="#listed" title=category-listed-form-element>Listed form
element</a>.
@@ -26854,7 +26858,7 @@
<dd><code title=attr-button-autofocus>autofocus</code>
- <dd><code title=attr-button-disabled>disabled</code>
+ <dd><code title=attr-fe-disabled><a href="#disabled3">disabled</a></code>
<dd><code title=attr-button-enctype>enctype</code>
@@ -26862,7 +26866,7 @@
<dd><code title=attr-button-method>method</code>
- <dd><code title=attr-button-name>name</code>
+ <dd><code title=attr-fe-name><a href="#name9">name</a></code>
<dd><code title=attr-button-target>target</code>
@@ -26877,11 +26881,11 @@
class=idl>interface <dfn id=htmlbuttonelement>HTMLButtonElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
attribute DOMString <span title=dom-button-action>action</span>;
attribute boolean <span title=dom-button-autofocus>autofocus</span>;
- attribute boolean <span title=dom-button-disabled>disabled</span>;
+ attribute boolean <a href="#disabled4" title=dom-fe-disabled>disabled</a>;
attribute DOMString <span title=dom-button-enctype>enctype</span>;
readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <a href="#form1" title=dom-fae-form>form</a>;
attribute DOMString <span title=dom-button-method>method</span>;
- attribute DOMString <span title=dom-button-name>name</span>;
+ attribute DOMString <a href="#name10" title=dom-fe-name>name</a>;
attribute DOMString <span title=dom-button-target>target</span>;
attribute DOMString <span title=dom-button-type>type</span>;
attribute DOMString <span title=dom-button-value>value</span>;
@@ -26949,7 +26953,7 @@
<dd><a href="#form-associated">Form-associated element</a>.
- <dd><a href="#field" title=category-field>Field</a>.
+ <dd><a href="#field" title=category-field>Field element</a>.
<dd><a href="#listed" title=category-listed-form-element>Listed form
element</a>.
@@ -26967,13 +26971,13 @@
<dd><code title=attr-select-autofocus>autofocus</code>
- <dd><code title=attr-select-disabled>disabled</code>
+ <dd><code title=attr-fe-disabled><a href="#disabled3">disabled</a></code>
<dd><code title=attr-fae-form><a href="#form0">form</a></code>
<dd><code title=attr-select-multiple>multiple</code>
- <dd><code title=attr-select-name>name</code>
+ <dd><code title=attr-fe-name><a href="#name9">name</a></code>
<dd><code title=attr-select-size>size</code>
@@ -26983,10 +26987,10 @@
<pre
class=idl>interface <dfn id=htmlselectelement>HTMLSelectElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
attribute boolean <span title=dom-select-autofocus>autofocus</span>;
- attribute boolean <span title=dom-select-disabled>disabled</span>;
+ attribute boolean <a href="#disabled4" title=dom-fe-disabled>disabled</a>;
readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <a href="#form1" title=dom-fae-form>form</a>;
attribute boolean <span title=dom-select-multiple>multiple</span>;
- attribute DOMString <span title=dom-select-name>name</span>;
+ attribute DOMString <a href="#name10" title=dom-fe-name>name</a>;
attribute boolean <span title=dom-select-size>size</span>;
readonly attribute DOMString <span title=dom-select-type>type</span>;
@@ -27157,7 +27161,7 @@
<dd><a href="#form-associated">Form-associated element</a>.
- <dd><a href="#field" title=category-field>Field</a>.
+ <dd><a href="#field" title=category-field>Field element</a>.
<dd><a href="#listed" title=category-listed-form-element>Listed form
element</a>.
@@ -27178,7 +27182,7 @@
<dd><code title=attr-textarea-cols>cols</code>
- <dd><code title=attr-textarea-disabled>disabled</code>
+ <dd><code title=attr-fe-disabled><a href="#disabled3">disabled</a></code>
<dd><code title=attr-fae-form><a href="#form0">form</a></code>
@@ -27186,7 +27190,7 @@
<dd><code title=attr-textarea-maxlength>maxlength</code>
- <dd><code title=attr-textarea-name>name</code>
+ <dd><code title=attr-fe-name><a href="#name9">name</a></code>
<dd><code title=attr-textarea-pattern>pattern</code>
@@ -27206,11 +27210,11 @@
attribute DOMString <span title=dom-textarea-accept>accept</span>;
attribute boolean <span title=dom-textarea-autofocus>autofocus</span>;
attribute unsigned long <span title=dom-textarea-cols>cols</span>;
- attribute boolean <span title=dom-textarea-disabled>disabled</span>;
+ attribute boolean <a href="#disabled4" title=dom-fe-disabled>disabled</a>;
readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <a href="#form1" title=dom-fae-form>form</a>;
attribute DOMString <span title=dom-textarea-inputmode>inputmode</span>;
attribute long <span title=dom-textarea-maxLength>maxLength</span>;
- attribute DOMString <span title=dom-textarea-name>name</span>;
+ attribute DOMString <a href="#name10" title=dom-fe-name>name</a>;
attribute DOMString <span title=dom-textarea-pattern>pattern</span>;
attribute boolean <span title=dom-textarea-readOnly>readOnly</span>;
attribute boolean <span title=dom-textarea-required>required</span>;
@@ -27264,7 +27268,7 @@
<dd><code title=attr-fae-form><a href="#form0">form</a></code>
- <dd><code title=attr-output-name>name</code>
+ <dd><code title=attr-fe-name><a href="#name9">name</a></code>
<dt>DOM interface:
@@ -27273,7 +27277,7 @@
class=idl>interface <dfn id=htmloutputelement>HTMLOutputElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
attribute DOMString <span title=dom-output-wrap>htmlFor</span>;
readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <a href="#form1" title=dom-fae-form>form</a>;
- attribute DOMString <span title=dom-output-name>name</span>;
+ attribute DOMString <a href="#name10" title=dom-fe-name>name</a>;
readonly attribute DOMString <span title=dom-output-type>type</span>;
attribute DOMString <span title=dom-output-defaultValue>defaultValue</span>;
@@ -27390,13 +27394,29 @@
getting, must return the element's <a href="#form-owner">form owner</a>,
or null if there isn't one.
- <h4 id=processing1><span class=secno>4.9.13 </span>Processing models</h4>
+ <h4 id=attributes1><span class=secno>4.9.13 </span>Attributes common to
+ form controls</h4>
- <h5 id=constraint><span class=secno>4.9.13.1. </span>Constraint validation</h5>
+ <p class=big-issue>... <dfn id=name9 title=attr-fe-name>name</dfn> content
+ attribute
+
+ <p class=big-issue>... <dfn id=name10 title=dom-fe-name>name</dfn> DOM
+ attribute
+
+ <p class=big-issue>... <dfn id=disabled2
+ title=concept-fe-disabled>disabled</dfn>
+
+ <p class=big-issue>... <dfn id=disabled3
+ title=attr-fe-disabled>disabled</dfn> content attribute
+
+ <p class=big-issue>... <dfn id=disabled4
+ title=dom-fe-disabled>disabled</dfn> DOM attribute
+
+ <h4 id=constraint><span class=secno>4.9.14 </span>Constraint validation</h4>
<p class=big-issue>...
- <h5 id=form-submission><span class=secno>4.9.13.2. </span>Form submission</h5>
+ <h4 id=form-submission><span class=secno>4.9.15 </span>Form submission</h4>
<p>When a form <var title="">form</var> is <dfn id=submitted
title=concept-form-submit>submitted</dfn> from an element <var
@@ -27430,8 +27450,42 @@
<li>
<p>Let <var title="">controls</var> be a list of all the <a href="#field"
- title=category-field>fields</a> whose <a href="#form-owner">form
- owner</a> is <var title="">form</var>.
+ title=category-field>field elements</a> whose <a href="#form-owner">form
+ owner</a> is <var title="">form</var>, in <a href="#tree-order">tree
+ order</a>.
+
+ <li>
+ <p>Let the <dfn id=form-data><var>form data set</var></dfn> be a list of
+ name/value pairs, initially empty.
+
+ <li>
+ <p>For each element <var title="">field</var> in <var
+ title="">controls</var>, in <a href="#tree-order">tree order</a>, run
+ the following substeps:</p>
+
+ <ol>
+ <li>
+ <p>If any of the following conditions are met, then skip these substeps
+ for this element:</p>
+
+ <ul>
+ <li>The <var title="">field</var> element has a <code><a
+ href="#datalist">datalist</a></code> element ancestor.
+
+ <li>The <var title="">field</var> element does not have a <code
+ title=attr-fe-name><a href="#name9">name</a></code> attribute
+ specified, or its <code title=attr-fe-name><a
+ href="#name9">name</a></code> attribute's value is the empty string,
+ and it is not an <code><a href="#input0">input</a></code> elements
+ whose <code title=attr-input-type>type</code> attribute is in the
+ <span>Image Button</span> state.
+
+ <li>The <var title="">field</var> element is <a href="#disabled2"
+ title=concept-fe-disabled>disabled</a>.
+
+ <li class=big-issue>...
+ </ul>
+ </ol>
<li>
<p class=big-issue>...
@@ -28433,7 +28487,7 @@
href="#multiple0">multiple</a></code>
<dd><code title=attr-datagrid-disabled><a
- href="#disabled3">disabled</a></code>
+ href="#disabled6">disabled</a></code>
<dt>DOM interface:
@@ -28443,7 +28497,7 @@
attribute <a href="#datagriddataprovider">DataGridDataProvider</a> <a href="#data2" title=dom-datagrid-data>data</a>;
readonly attribute <a href="#datagridselection">DataGridSelection</a> <a href="#selection0" title=dom-datagrid-selection>selection</a>;
attribute boolean <a href="#multiple" title=dom-datagrid-multiple>multiple</a>;
- attribute boolean <a href="#disabled2" title=dom-datagrid-disabled>disabled</a>;
+ attribute boolean <a href="#disabled5" title=dom-datagrid-disabled>disabled</a>;
void <a href="#updateeverything" title=dom-datagrid-updateEverything>updateEverything</a>();
void <a href="#updaterowschanged" title=dom-datagrid-updateRowsChanged>updateRowsChanged</a>(in <a href="#rowspecification">RowSpecification</a> row, in unsigned long count);
void <a href="#updaterowsinserted" title=dom-datagrid-updateRowsInserted>updateRowsInserted</a>(in <a href="#rowspecification">RowSpecification</a> row, in unsigned long count);
@@ -28469,18 +28523,18 @@
<p>The <code title=attr-datagrid-multiple><a
href="#multiple0">multiple</a></code> and <code
- title=attr-datagrid-disabled><a href="#disabled3">disabled</a></code>
+ title=attr-datagrid-disabled><a href="#disabled6">disabled</a></code>
attributes are <a href="#boolean0" title="boolean attribute">boolean
attributes</a>. Their effects are described in the processing model
sections below.
<p>The <dfn id=multiple
title=dom-datagrid-multiple><code>multiple</code></dfn> and <dfn
- id=disabled2 title=dom-datagrid-disabled><code>disabled</code></dfn> DOM
+ id=disabled5 title=dom-datagrid-disabled><code>disabled</code></dfn> DOM
attributes must <a href="#reflect">reflect</a> the <code
title=attr-datagrid-multiple><a href="#multiple0">multiple</a></code> and
<code title=attr-datagrid-disabled><a
- href="#disabled3">disabled</a></code> content attributes respectively.
+ href="#disabled6">disabled</a></code> content attributes respectively.
<h5 id=the-datagrid><span class=secno>4.11.2.1. </span>The <code><a
href="#datagrid0">datagrid</a></code> data model</h5>
@@ -28513,7 +28567,7 @@
<p>The <code><a href="#datagrid0">datagrid</a></code> element can be
disabled entirely by setting the <code title=attr-datagrid-disabled><a
- href="#disabled3">disabled</a></code> attribute.</p>
+ href="#disabled6">disabled</a></code> attribute.</p>
<!--XXXDND
<p class="big-issue">selection draggable [normative definitions are
in the interactive part below]</p>
@@ -30235,7 +30289,7 @@
<p><em>This section only applies to interactive user agents.</em>
<p>If the <code><a href="#datagrid0">datagrid</a></code> element has a <dfn
- id=disabled3 title=attr-datagrid-disabled><code>disabled</code></dfn>
+ id=disabled6 title=attr-datagrid-disabled><code>disabled</code></dfn>
attribute, then the user agent must disable the <code><a
href="#datagrid0">datagrid</a></code>, preventing the user from
interacting with it. The <code><a href="#datagrid0">datagrid</a></code>
@@ -30502,7 +30556,7 @@
<dd><code title=attr-command-icon><a href="#icon">icon</a></code>
<dd><code title=attr-command-disabled><a
- href="#disabled4">disabled</a></code>
+ href="#disabled7">disabled</a></code>
<dd><code title=attr-command-checked><a
href="#checked0">checked</a></code>
@@ -30525,7 +30579,7 @@
attribute DOMString <a href="#type14" title=dom-command-type>type</a>;
attribute DOMString <a href="#label1" title=dom-command-label>label</a>;
attribute DOMString <a href="#icon0" title=dom-command-icon>icon</a>;
- attribute boolean <a href="#disabled5" title=dom-command-disabled>disabled</a>;
+ attribute boolean <a href="#disabled8" title=dom-command-disabled>disabled</a>;
attribute boolean <a href="#checked1" title=dom-command-checked>checked</a>;
attribute DOMString <a href="#radiogroup0" title=dom-command-radiogroup>radiogroup</a>;
attribute boolean <a href="#default3" title=dom-command-default>default</a>;
@@ -30562,13 +30616,13 @@
specified, the attribute's value must contain a <a href="#valid8">valid
URL</a>.
- <p>The <dfn id=disabled4
+ <p>The <dfn id=disabled7
title=attr-command-disabled><code>disabled</code></dfn> attribute is a <a
href="#boolean0">boolean attribute</a> that, if present, indicates that
the command is not available in the current state.
<p class=note>The distinction between <code title=attr-command-disabled><a
- href="#disabled4">disabled</a></code> and <code title=attr-hidden><a
+ href="#disabled7">disabled</a></code> and <code title=attr-hidden><a
href="#hidden1">hidden</a></code> is subtle. A command should be disabled
if, in the same context, it could be enabled if only certain aspects of
the situation were changed. A command should be marked as hidden if, in
@@ -30609,7 +30663,7 @@
<p>The <dfn id=type14 title=dom-command-type><code>type</code></dfn>, <dfn
id=label1 title=dom-command-label><code>label</code></dfn>, <dfn id=icon0
- title=dom-command-icon><code>icon</code></dfn>, <dfn id=disabled5
+ title=dom-command-icon><code>icon</code></dfn>, <dfn id=disabled8
title=dom-command-disabled><code>disabled</code></dfn>, <dfn id=checked1
title=dom-command-checked><code>checked</code></dfn>, <dfn id=radiogroup0
title=dom-command-radiogroup><code>radiogroup</code></dfn>, and <dfn
@@ -30706,9 +30760,9 @@
<dd>
<pre
class=idl>interface <dfn id=htmlbrowserbuttonelement>HTMLBrowserButtonElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
- attribute DOMString <a href="#type14" title=dom-command-type>type</a>;
- readonly attribute boolean <span title=dom-command-supported>supported</span>;
- readonly attribute boolean <a href="#disabled5" title=dom-command-disabled>disabled</a>;
+ attribute DOMString <a href="#type16" title=dom-bb-type>type</a>;
+ readonly attribute boolean <a href="#supported" title=dom-bb-supported>supported</a>;
+ readonly attribute boolean <a href="#disabled9" title=dom-bb-disabled>disabled</a>;
};</pre>
<p>The <code title=command-ro><a href="#command2">Command</a></code>
@@ -30789,9 +30843,9 @@
value is one that the user agent recognises and supports), and false
otherwise.
- <p>The <dfn id=disabled6 title=dom-bb-><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
+ <p>The <dfn id=disabled9 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="#type15">type</a></code> attribute's state's <i>relevance</i>).
<h5 id=browser><span class=secno>4.11.4.1. </span>Browser button types</h5>
@@ -31303,7 +31357,7 @@
<dd>Whether the command is hidden or not (basically, whether it should be
shown in menus).
- <dt><dfn id=disabled7 title=command-facet-DisabledState>Disabled
+ <dt><dfn id=disabled10 title=command-facet-DisabledState>Disabled
State</dfn>
<dd>Whether the command is relevant and can be triggered or not.
@@ -31345,7 +31399,7 @@
readonly attribute DOMString <a href="#title7" title=dom-command-ro-title>title</a>;
readonly attribute DOMString <a href="#icon2" title=dom-command-ro-icon>icon</a>;
readonly attribute boolean <a href="#hidden0" title=dom-command-ro-hidden>hidden</a>;
- readonly attribute boolean <a href="#disabled8" title=dom-command-ro-disabled>disabled</a>;
+ readonly attribute boolean <a href="#disabled11" title=dom-command-ro-disabled>disabled</a>;
readonly attribute boolean <a href="#checked3" title=dom-command-ro-checked>checked</a>;
void <a href="#click0" title=dom-command-ro-click>click</a>();
readonly attribute <a href="#htmlcollection0">HTMLCollection</a> <a href="#triggers0" title=dom-command-ro-triggers>triggers</a>;
@@ -31415,9 +31469,9 @@
href="#hidden2">hidden</a></code> DOM attribute on the <code><a
href="#htmlelement">HTMLElement</a></code> interface.
- <p>The <dfn id=disabled8
+ <p>The <dfn id=disabled11
title=dom-command-ro-disabled><code>disabled</code></dfn> attribute must
- return true if the command's <a href="#disabled7"
+ return true if the command's <a href="#disabled10"
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="#hidden"
@@ -31507,7 +31561,7 @@
title=attr-hidden><a href="#hidden1">hidden</a></code> attribute, and
false otherwise.
- <p>The <a href="#disabled7" title=command-facet-DisabledState>Disabled
+ <p>The <a href="#disabled10" title=command-facet-DisabledState>Disabled
State</a> facet of the command is always false. (The command is always
enabled.)
@@ -31536,13 +31590,13 @@
<a href="#using5" title=a-command>as for <code>a</code> elements</a> (see
the previous section).
- <p>The <a href="#disabled7" title=command-facet-DisabledState>Disabled
- State</a> of the command mirrors the disabled state of the button.
- Typically this is given by the element's <code
- title=attr-button-disabled>disabled</code> attribute, but certain button
- types become disabled at other times too (for example, the
- <code>move-up</code> button type is disabled when it would have no
- effect).
+ <p>The <a href="#disabled10" title=command-facet-DisabledState>Disabled
+ State</a> of the command mirrors the <a href="#disabled2"
+ title=concept-fe-disabled>disabled</a> state of the button. Typically this
+ is given by the element's <code title=attr-fe-disabled><a
+ href="#disabled3">disabled</a></code> attribute, but certain button types
+ become disabled at other times too (for example, the <code>move-up</code>
+ button type is disabled when it would have no effect).
<h5 id=using1><span class=secno>4.11.6.3. </span><dfn id=using7
title=input-command>Using the <code>input</code> element to define a
@@ -31599,12 +31653,13 @@
title=attr-hidden><a href="#hidden1">hidden</a></code> attribute, and
false otherwise.
- <p>The <a href="#disabled7" title=command-facet-DisabledState>Disabled
- State</a> of the command mirrors the disabled state of the control.
- Typically this is given by the element's <code
- title=attr-input-disabled>disabled</code> attribute, but certain input
- types become disabled at other times too (for example, the
- <code>move-up</code> input type is disabled when it would have no effect).
+ <p>The <a href="#disabled10" title=command-facet-DisabledState>Disabled
+ State</a> of the command mirrors the <a href="#disabled2"
+ title=concept-fe-disabled>disabled</a> state of the control. Typically
+ this is given by the element's <code title=attr-fe-disabled><a
+ href="#disabled3">disabled</a></code> attribute, but certain input types
+ become disabled at other times too (for example, the <code>move-up</code>
+ input type is disabled when it would have no effect).
<p>The <a href="#checked2" title=command-facet-CheckedState>Checked
State</a> of the command is true if the command is of <a href="#type19"
@@ -31660,7 +31715,7 @@
title=attr-hidden><a href="#hidden1">hidden</a></code> attribute, and
false otherwise.
- <p>The <a href="#disabled7" title=command-facet-DisabledState>Disabled
+ <p>The <a href="#disabled10" title=command-facet-DisabledState>Disabled
State</a> of the command is true (disabled) if the element has a <code
title=attr-option-disabled>disabled</code> attribute, and false otherwise.
@@ -31723,9 +31778,9 @@
title=attr-hidden><a href="#hidden1">hidden</a></code> attribute, and
false otherwise.
- <p>The <a href="#disabled7" title=command-facet-DisabledState>Disabled
+ <p>The <a href="#disabled10" title=command-facet-DisabledState>Disabled
State</a> of the command is true (disabled) if the element has a <code
- title=attr-command-disabled><a href="#disabled4">disabled</a></code>
+ title=attr-command-disabled><a href="#disabled7">disabled</a></code>
attribute, and false otherwise.
<p>The <a href="#checked2" title=command-facet-CheckedState>Checked
@@ -31790,7 +31845,7 @@
element has a <code title=attr-hidden><a href="#hidden1">hidden</a></code>
attribute, and false otherwise.
- <p>The <a href="#disabled7" title=command-facet-DisabledState>Disabled
+ <p>The <a href="#disabled10" title=command-facet-DisabledState>Disabled
State</a> facet of the command is true if the <code><a
href="#bb">bb</a></code> element's <code title=attr-bb-type><a
href="#type15">type</a></code> attribute's state's <i>relevance</i> is
@@ -32047,7 +32102,7 @@
title=attr-registrationmark><a
href="#registrationmark">registrationmark</a></code> content attribute.
- <h4 id=processing2><span class=secno>4.12.6 </span>Processing model</h4>
+ <h4 id=processing1><span class=secno>4.12.6 </span>Processing model</h4>
<!-- ua side -->
<p>The <a href="#task-source">task source</a> for all <a href="#tasks"
@@ -33221,7 +33276,7 @@
// the current browsing context
readonly attribute <a href="#window">Window</a> <a href="#window0" title=dom-window>window</a>;
readonly attribute <a href="#window">Window</a> <a href="#self" title=dom-self>self</a>;
- attribute DOMString <a href="#name9" title=dom-name>name</a>;
+ attribute DOMString <a href="#name11" title=dom-name>name</a>;
[PutForwards=href] readonly attribute <a href="#location2">Location</a> <a href="#location0" title=dom-document-location>location</a>;
readonly attribute <a href="#history3">History</a> <a href="#history2" title=dom-history>history</a>;
readonly attribute <a href="#undomanager">UndoManager</a> <a href="#undomanager0" title=dom-undoManager>undoManager</a>;
@@ -33425,7 +33480,7 @@
context</a> that was navigated, or null if no browsing context was
navigated.
- <p>The <dfn id=name9 title=dom-name><code>name</code></dfn> attribute of
+ <p>The <dfn id=name11 title=dom-name><code>name</code></dfn> attribute of
the <code><a href="#window">Window</a></code> object must, on getting,
return the current name of the <a href="#browsing1">browsing context</a>,
and, on setting, set the name of the <a href="#browsing1">browsing
@@ -36519,7 +36574,7 @@
progress. Abort the update process.
</ol>
- <h4 id=processing3><span class=secno>5.7.5 </span>Processing model</h4>
+ <h4 id=processing2><span class=secno>5.7.5 </span>Processing model</h4>
<p>The processing model of application caches for offline support in Web
applications is part of the <a href="#navigate"
@@ -39276,7 +39331,7 @@
return an error message describing the error encountered. The message
should be localized to the user's language.
- <h5 id=processing4><span class=secno>5.10.2.6. </span>Processing model</h5>
+ <h5 id=processing3><span class=secno>5.10.2.6. </span>Processing model</h5>
<p>The <dfn id=transaction0>transaction steps</dfn> are as follows. These
steps must be run asynchronously. These steps are invoked with a
@@ -46487,13 +46542,13 @@
characters</a>.
<li>Then, the start tag may have a number of attributes, the <a
- href="#attributes2" title=syntax-attributes>syntax for which</a> is
+ href="#attributes3" title=syntax-attributes>syntax for which</a> is
described below. Attributes may be separated from each other by one or
more <a href="#space" title="space character">space characters</a>.
<li>After the attributes, there may be one or more <a href="#space"
title="space character">space characters</a>. (Some attributes are
- required to be followed by a space. See the <a href="#attributes2"
+ required to be followed by a space. See the <a href="#attributes3"
title=syntax-attributes>attributes section</a> below.)
<li>Then, if the element is one of the <a href="#void-elements">void
@@ -46528,9 +46583,9 @@
(<code>></code>) character.
</ol>
- <h5 id=attributes1><span class=secno>8.1.2.3. </span>Attributes</h5>
+ <h5 id=attributes2><span class=secno>8.1.2.3. </span>Attributes</h5>
- <p><dfn id=attributes2 title=syntax-attributes>Attributes</dfn> for an
+ <p><dfn id=attributes3 title=syntax-attributes>Attributes</dfn> for an
element are expressed inside the element's start tag.
<p>Attributes have a name and a value. <dfn id=attribute3
@@ -46561,9 +46616,9 @@
name</a>.</p>
<div class=example>
- <p>In the following example, the <code
- title=attr-input-disabled>disabled</code> attribute is given with the
- empty attribute syntax:</p>
+ <p>In the following example, the <code title=attr-fe-disabled><a
+ href="#disabled3">disabled</a></code> attribute is given with the empty
+ attribute syntax:</p>
<pre><input <em>disabled</em>></pre>
</div>
Received on Wednesday, 10 September 2008 21:45:27 UTC