- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 03 Sep 2008 01:57:57 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv16338
Modified Files:
Overview.html
Log Message:
WF2: <form> element summary. (whatwg r2142)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1314
retrieving revision 1.1315
diff -u -d -r1.1314 -r1.1315
--- Overview.html 3 Sep 2008 00:54:09 -0000 1.1314
+++ Overview.html 3 Sep 2008 01:57:54 -0000 1.1315
@@ -6697,10 +6697,10 @@
<ul>
<li>It is an <code><a href="#a">a</a></code>, <code><a
href="#applet">applet</a></code>, <code><a href="#area">area</a></code>,
- <code>form</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 title="">key</var>,
- or,
+ <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
+ title="">key</var>, or,
<li>It is an <a href="#html-elements" title="HTML elements">HTML
element</a> of any kind with an <code title=attr-id><a
@@ -7509,8 +7509,8 @@
<p>The <dfn id=forms0 title=dom-document-forms><code>forms</code></dfn>
attribute must return an <code><a
href="#htmlcollection0">HTMLCollection</a></code> rooted at the
- <code>Document</code> node, whose filter matches only <code>form</code>
- elements.
+ <code>Document</code> node, whose filter matches only <code><a
+ href="#form">form</a></code> elements.
<p>The <dfn id=anchors
title=dom-document-anchors><code>anchors</code></dfn> attribute must
@@ -7532,16 +7532,17 @@
title="">name</var>)</code></dfn> method takes a string <var
title="">name</var>, and must return a live <code>NodeList</code>
containing all the <code><a href="#a">a</a></code>, <code><a
- href="#applet">applet</a></code>, <code>button</code>, <code>form</code>,
- <!-- frame? frameset?
- XXX--><code><a href="#iframe">iframe</a></code>,
- <code><a href="#img">img</a></code>, <code>input</code>, <code><a
- href="#map">map</a></code>, <code><a href="#meta0">meta</a></code>,
- <code><a href="#object">object</a></code>,<!-- param?
- XXX-->
- <code>select</code>, and <code>textarea</code> elements in that document
- that have a <code title="">name</code> attribute whose value is equal to
- the <var title="">name</var> argument (in a <a
+ href="#applet">applet</a></code>, <code>button</code>, <code><a
+ href="#form">form</a></code>, <!-- frame? frameset?
+ XXX--><code><a
+ href="#iframe">iframe</a></code>, <code><a href="#img">img</a></code>,
+ <code>input</code>, <code><a href="#map">map</a></code>, <code><a
+ href="#meta0">meta</a></code>, <code><a
+ href="#object">object</a></code>,<!-- param?
+ XXX--> <code>select</code>,
+ and <code>textarea</code> elements in that document that have a <code
+ title="">name</code> attribute whose value is equal to the <var
+ title="">name</var> argument (in a <a
href="#case-sensitive">case-sensitive</a> manner), in <a
href="#tree-order">tree order</a>.
@@ -26499,18 +26500,65 @@
title=concept-table>table</a>.
<h3 id=forms><span class=secno>4.9 </span>Forms</h3>
- <!-- XXX everything in WF2 -->
- <p class=big-issue>This section will contain definitions of the
- <code>form</code> element and so forth.
+ <h4 id=the-form><span class=secno>4.9.1 </span>The <dfn
+ id=form><code>form</code></dfn> element</h4>
- <p class=big-issue>This section will be a rewrite of the HTML4 Forms and
- Web Forms 2.0 specifications, with hopefully no normative changes.</p>
- <!-- From HTML4: BUTTON FIELDSET FORM INPUT LABEL OPTGROUP OPTION
- SELECT TEXTAREA -->
+ <dl class=element>
+ <dt>Categories
- <h4 id=the-form><span class=secno>4.9.1 </span>The <code>form</code>
- element</h4>
+ <dd><a href="#flow-content0">Flow content</a>.
+
+ <dt>Contexts in which this element may be used:
+
+ <dd>Where <a href="#flow-content0">flow content</a> is expected.
+
+ <dt>Content model:
+
+ <dd><a href="#flow-content0">Flow content</a>, but with no <code><a
+ href="#form">form</a></code> element descendants.
+
+ <dt>Element-specific attributes:
+
+ <dd><code title=attr-form-accept-charset>accept-charset</code>
+
+ <dd><code title=attr-form-action>action</code>
+
+ <dd><code title=attr-form-enctype>enctype</code>
+
+ <dd><code title=attr-form-method>method</code>
+
+ <dd><code title=attr-form-name>name</code>
+
+ <dd><code title=attr-form-target>target</code>
+
+ <dt>DOM interface:
+
+ <dd>
+ <pre
+ class=idl>interface <dfn id=htmlformelement>HTMLFormElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
+ attribute DOMString <span title=dom-form-accept-charset>accept-charset</span>;
+ attribute DOMString <span title=dom-form-action>action</span>;
+ attribute DOMString <span title=dom-form-enctype>enctype</span>;
+ attribute DOMString <span title=dom-form-method>method</span>;
+ attribute DOMString <span title=dom-form-name>name</span>;
+ attribute DOMString <span title=dom-form-target>target</span>;
+
+ readonly attribute <a href="#htmlformcontrolscollection0">HTMLFormControlsCollection</a> <span title=dom-form-elements>elements</span>;
+ readonly attribute long <span title=dom-form-length>length</span>;
+ [IndexGetter] <a href="#htmlelement">HTMLElement</a> <span title=dom-form-XXX7>XXX7</span>(in unsigned long index);
+ [NameGetter] Object <span title=dom-form-XXX8>XXX8</span>(in DOMString name);
+
+ void <span title=dom-form-submit>submit</span>();
+ void <span title=dom-form-reset>reset</span>();
+ boolean <span title=dom-form-checkValidity>checkValidity</span>();
+
+ void <span title=dom-form-dispatchFormInput>dispatchFormInput</span>();
+ void <span title=dom-form-dispatchFormChange>dispatchFormChange</span>();
+};</pre>
+ </dl>
+
+ <p class=big-issue>...
<h4 id=the-fieldset><span class=secno>4.9.2 </span>The
<code>fieldset</code> element</h4>
@@ -31861,7 +31909,7 @@
<dl class=element>
<dt>Categories
- <dd>None.
+ <dd><a href="#flow-content0">Flow content</a>.
<dt>Contexts in which this element may be used:
@@ -33343,8 +33391,9 @@
context</a>, its new value must be interpreted as the body of an anonymous
function with a single argument called <code>event</code>, with the new
function's scope chain being linked from the activation object of the
- handler, to the element, to the element's <code>form</code> element if it
- is a form control, to the <code>Document</code> object, to the <code><a
+ handler, to the element, to the element's <code><a
+ href="#form">form</a></code> element if it is a form control, to the
+ <code>Document</code> object, to the <code><a
href="#window">Window</a></code> object of the <a
href="#browsing1">browsing context</a> of that <code>Document</code>. The
function's <code>this</code> parameter must be the <code>Element</code>
@@ -45856,8 +45905,8 @@
href="#datagrid0">datagrid</a></code>, <code><a
href="#dialog">dialog</a></code>, <code>dir</code>, <code><a
href="#div">div</a></code>, <code><a href="#dl">dl</a></code>,
- <code>fieldset</code>, <code><a href="#footer">footer</a></code>,
- <code>form</code>, <code><a href="#h1">h1</a></code>, <code><a
+ <code>fieldset</code>, <code><a href="#footer">footer</a></code>, <code><a
+ href="#form">form</a></code>, <code><a href="#h1">h1</a></code>, <code><a
href="#h2">h2</a></code>, <code><a href="#h3">h3</a></code>, <code><a
href="#h4">h4</a></code>, <code><a href="#h5">h5</a></code>, <code><a
href="#h6">h6</a></code>, <code><a href="#header">header</a></code>,
@@ -47223,14 +47272,14 @@
href="#dt">dt</a></code>, <code><a href="#embed">embed</a></code>,
<code><a href="#eventsource">eventsource</a></code>
<code>fieldset</code>, <code><a href="#figure">figure</a></code>,
- <code><a href="#footer">footer</a></code>, <code>form</code>,
- <code>frame</code>, <code>frameset</code>, <code><a
- href="#h1">h1</a></code>, <code><a href="#h2">h2</a></code>, <code><a
- href="#h3">h3</a></code>, <code><a href="#h4">h4</a></code>, <code><a
- href="#h5">h5</a></code>, <code><a href="#h6">h6</a></code>, <code><a
- href="#head">head</a></code>, <code><a href="#header">header</a></code>,
- <code><a href="#hr">hr</a></code>, <code><a
- href="#iframe">iframe</a></code>, <!-- <code>image</code>,
+ <code><a href="#footer">footer</a></code>, <code><a
+ href="#form">form</a></code>, <code>frame</code>, <code>frameset</code>,
+ <code><a href="#h1">h1</a></code>, <code><a href="#h2">h2</a></code>,
+ <code><a href="#h3">h3</a></code>, <code><a href="#h4">h4</a></code>,
+ <code><a href="#h5">h5</a></code>, <code><a href="#h6">h6</a></code>,
+ <code><a href="#head">head</a></code>, <code><a
+ href="#header">header</a></code>, <code><a href="#hr">hr</a></code>,
+ <code><a href="#iframe">iframe</a></code>, <!-- <code>image</code>,
(commented out because this isn't an element that can end up on the
stack, so it doesn't matter) -->
<code><a href="#img">img</a></code>, <code>input</code>,
@@ -47472,10 +47521,10 @@
title="">head</code> element pointer</a> gets set to point to this node.
<p>The <a href="#form-element"><code title="">form</code> element
- pointer</a> points to the last <code>form</code> element that was opened
- and whose end tag has not yet been seen. It is used to make form controls
- associate with forms in the face of dramatically bad markup, for
- historical reasons.
+ pointer</a> points to the last <code><a href="#form">form</a></code>
+ element that was opened and whose end tag has not yet been seen. It is
+ used to make form controls associate with forms in the face of
+ dramatically bad markup, for historical reasons.
<h5 id=the-scripting><span class=secno>8.2.3.5. </span>The scripting state</h5>
@@ -50634,8 +50683,8 @@
seen.</p>
<p><a href="#insert0">Insert an HTML element</a> for the token, and set
- the <code title=form>form</code> element pointer to point to the element
- created.</p>
+ the <code title=form><a href="#form">form</a></code> element pointer to
+ point to the element created.</p>
</dd>
<!-- as normal, but imply </li> when there's another <li> open in weird cases -->
@@ -51155,9 +51204,9 @@
<p>If the <a href="#form-element"><code title="">form</code> element
pointer</a> is not null, then <span>associate</span><!--XXX xref! -->
- the <code>button</code> element with the <code>form</code> element
- pointed to by the <a href="#form-element"><code title="">form</code>
- element pointer</a>.</p>
+ the <code>button</code> element with the <code><a
+ href="#form">form</a></code> element pointed to by the <a
+ href="#form-element"><code title="">form</code> element pointer</a>.</p>
<p>Insert a marker at the end of the <a href="#list-of4">list of active
formatting elements</a>.</p>
@@ -51293,9 +51342,9 @@
<p>If the <a href="#form-element"><code title="">form</code> element
pointer</a> is not null, then <span>associate</span><!--XXX xref! -->
- the newly created <code>input</code> element with the <code>form</code>
- element pointed to by the <a href="#form-element"><code
- title="">form</code> element pointer</a>.</p>
+ the newly created <code>input</code> element with the <code><a
+ href="#form">form</a></code> element pointed to by the <a
+ href="#form-element"><code title="">form</code> element pointer</a>.</p>
<dt id=isindex>A start tag whose tag name is "isindex"
@@ -51318,9 +51367,9 @@
<p>Act as if a start tag token with the tag name "form" had been seen.</p>
<p>If the token has an attribute called "action", set the <code
- title=attr-form-action>action</code> attribute on the resulting
- <code>form</code> element to the value of the "action" attribute of the
- token.</p>
+ title=attr-form-action>action</code> attribute on the resulting <code><a
+ href="#form">form</a></code> element to the value of the "action"
+ attribute of the token.</p>
<p>Act as if a start tag token with the tag name "hr" had been seen.</p>
@@ -51377,8 +51426,8 @@
<p>If the <a href="#form-element"><code title="">form</code> element
pointer</a> is not null, then <span>associate</span><!--XXX xref! -->
- the newly created <code>textarea</code> element with the
- <code>form</code> element pointed to by the <a
+ the newly created <code>textarea</code> element with the <code><a
+ href="#form">form</a></code> element pointed to by the <a
href="#form-element"><code title="">form</code> element pointer</a>.</p>
<p>Switch the tokeniser's <a href="#content4">content model flag</a> to
@@ -51421,9 +51470,9 @@
<p>If the <a href="#form-element"><code title="">form</code> element
pointer</a> is not null, then <span>associate</span><!--XXX xref! -->
- the <code>select</code> element with the <code>form</code> element
- pointed to by the <a href="#form-element"><code title="">form</code>
- element pointer</a>.</p>
+ the <code>select</code> element with the <code><a
+ href="#form">form</a></code> element pointed to by the <a
+ href="#form-element"><code title="">form</code> element pointer</a>.</p>
<p>If the <span>insertion mode</span> is one of <a href="#in-table"
title="insertion mode: in table">in table</a>", "<a href="#in-caption"
@@ -51880,9 +51929,9 @@
<p>If the <a href="#form-element"><code title="">form</code> element
pointer</a> is not null, then <span>associate</span><!--XXX
xref! -->
- the <code>input</code> element with the <code>form</code> element
- pointed to by the <a href="#form-element"><code title="">form</code>
- element pointer</a>.</p>
+ the <code>input</code> element with the <code><a
+ href="#form">form</a></code> element pointed to by the <a
+ href="#form-element"><code title="">form</code> element pointer</a>.</p>
<p>Pop that <code>input</code> element off the <a href="#stack">stack of
open elements</a>.</p>
@@ -53192,8 +53241,9 @@
<i><a href="#quirks">quirks mode</a></i>
<li>The association between form controls and forms that aren't their
- nearest <code>form</code> element ancestor (use of the <a
- href="#form-element"><code>form</code> element pointer</a> in the parser)
+ nearest <code><a href="#form">form</a></code> element ancestor (use of
+ the <a href="#form-element"><code>form</code> element pointer</a> in the
+ parser)
</ul>
<p class=note>The mutations allowed by this section apply <em>after</em>
@@ -53507,10 +53557,10 @@
<li>
<p>Set the parser's <a href="#form-element"><code>form</code> element
pointer</a> to the nearest node to the <var title="">context</var>
- element that is a <code>form</code> element (going straight up the
- ancestor chain, and including the element itself, if it is a
- <code>form</code> element), or, if there is no such <code>form</code>
- element, to null.</p>
+ element that is a <code><a href="#form">form</a></code> element (going
+ straight up the ancestor chain, and including the element itself, if it
+ is a <code><a href="#form">form</a></code> element), or, if there is no
+ such <code><a href="#form">form</a></code> element, to null.</p>
<li>
<p>Place into the <a href="#input0">input stream</a> for the <a
Received on Wednesday, 3 September 2008 01:58:32 UTC