[html5] r2142 - [] (0) WF2: <form> element summary.

whatwg at whatwg.org whatwg at whatwg.org
Tue Sep 2 18:58:29 PDT 2008


Author: ianh
Date: 2008-09-02 18:58:26 -0700 (Tue, 02 Sep 2008)
New Revision: 2142

Modified:
   index
   source
Log:
[] (0) WF2: <form> element summary.

Modified: index
===================================================================
--- index	2008-09-03 00:54:42 UTC (rev 2141)
+++ index	2008-09-03 01:58:26 UTC (rev 2142)
@@ -6689,10 +6689,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
@@ -7501,8 +7501,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
@@ -7524,16 +7524,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>.
 
@@ -26491,19 +26492,66 @@
    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>
 
@@ -31853,7 +31901,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:
 
@@ -33335,8 +33383,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>
@@ -45848,8 +45897,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>,
@@ -47215,14 +47264,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>,
@@ -47464,10 +47513,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>
 
@@ -50626,8 +50675,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 -->
 
@@ -51147,9 +51196,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>
@@ -51285,9 +51334,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"
 
@@ -51310,9 +51359,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>
 
@@ -51369,8 +51418,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
@@ -51413,9 +51462,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"
@@ -51872,9 +51921,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>
@@ -53184,8 +53233,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>
@@ -53499,10 +53549,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

Modified: source
===================================================================
--- source	2008-09-03 00:54:42 UTC (rev 2141)
+++ source	2008-09-03 01:58:26 UTC (rev 2142)
@@ -23882,20 +23882,51 @@
 
 
   <h3 id="forms">Forms</h3>
-  <!-- XXX everything in WF2 -->
 
-  <p class="big-issue">This section will contain definitions of the
-  <code>form</code> element and so forth.</p>
+  <h4>The <dfn><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>
+  <dl class="element">
+   <dt>Categories</dt>
+   <dd><span>Flow content</span>.</dd>
+   <dt>Contexts in which this element may be used:</dt>
+   <dd>Where <span>flow content</span> is expected.</dd>
+   <dt>Content model:</dt>
+   <dd><span>Flow content</span>, but with no <code>form</code> element descendants.</dd>
+   <dt>Element-specific attributes:</dt>
+   <dd><code title="attr-form-accept-charset">accept-charset</code></dd>
+   <dd><code title="attr-form-action">action</code></dd>
+   <dd><code title="attr-form-enctype">enctype</code></dd>
+   <dd><code title="attr-form-method">method</code></dd>
+   <dd><code title="attr-form-name">name</code></dd>
+   <dd><code title="attr-form-target">target</code></dd>
+   <dt>DOM interface:</dt>
+   <dd>
+<pre class="idl">interface <dfn>HTMLFormElement</dfn> : <span>HTMLElement</span> {
+           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>;
 
-  <!-- From HTML4: BUTTON FIELDSET FORM INPUT LABEL OPTGROUP OPTION
-  SELECT TEXTAREA -->
+  readonly attribute <span>HTMLFormControlsCollection</span> <span title="dom-form-elements">elements</span>;
+  readonly attribute long <span title="dom-form-length">length</span>;
+  [IndexGetter] <span>HTMLElement</span> <span title="dom-form-XXX7">XXX7</span>(in unsigned long index);
+  [NameGetter] Object <span title="dom-form-XXX8">XXX8</span>(in DOMString name);
 
-  <h4>The <code>form</code> element</h4>
+  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>
+   </dd> 
+  </dl>
+
+  <p class="big-issue">...</p>
+
+
   <h4>The <code>fieldset</code> element</h4>
 
   <h4>The <code>input</code> element</h4>
@@ -29067,7 +29098,7 @@
 
   <dl class="element">
    <dt>Categories</dt>
-   <dd>None.</dd>
+   <dd><span>Flow content</span>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <span>flow content</span> is expected.</dd>
    <dt>Content model:</dt>




More information about the Commit-Watchers mailing list