<p>Returns the form control in the form with the given <a href=#concept-id title=concept-id>ID</a> or <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> (excluding image buttons for
historical reasons).</p>
<p>Returns the form control (or, if there are several, a
<code><a href=#nodelist>NodeList</a></code> of the form controls) in the form with the
given <a href=#concept-id title=concept-id>ID</a> or <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> (excluding image buttons for
historical reasons); or, if there are none, returns the
<code><a href=#the-img-element>img</a></code> element with the given ID.</p>
<p>Once an element has been referenced using a particular name,
that name will continue being available as a way to reference that
the <code title=dom-form-elements><a href=#dom-form-elements>elements</a></code> collection, when
invoked with the given index as its argument.</p>
<p>Each <code><a href=#the-form-element>form</a></code> element has a mapping of names to elements
<hr><!-- Welcome to crazy town. Population: The Web. --><p>Each <code><a href=#the-form-element>form</a></code> element has a mapping of names to elements
called the <dfn id=past-names-map>past names map</dfn>. It is used to persist names of
controls even when they change names.</p>
<p>The <a href=#supported-property-names>supported property names</a> are the union of the
names currently supported by the object returned by the <code title=dom-form-elements><a href=#dom-form-elements>elements</a></code> attribute, and the names
currently in the <a href=#past-names-map>past names map</a>.</p>
<p>The <a href=#supported-property-names>supported property names</a> consist of the values
of all the <code title=attr-id><a href=#the-id-attribute>id</a></code> and <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> attributes of all the <a href=#category-listed title=category-listed>listed elements</a> and <code><a href=#the-img-element>img</a></code>
elements that are descendants of the <code><a href=#the-form-element>form</a></code> element, and
all the names currently in the <a href=#past-names-map>past names map</a>.</p>
<p>When a <code><a href=#the-form-element>form</a></code> element is <dfn id=dom-form-nameditem title=dom-form-namedItem>indexed for named property
retrieval</dfn>, the user agent must run the following steps:</p>
<ol><li>
<ol><li><p>Let <var title="">candidates</var> be a <a href=#live>live</a>
<code><a href=#nodelist>NodeList</a></code> object containing all the <a href=#category-listed title=category-listed>listed elements</a> that are descendants
of the <code><a href=#the-form-element>form</a></code> element and that have either an <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute or a <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> attribute equal to <var title="">name</var>, in <a href=#tree-order>tree order</a>.</li>
<p>If <var title="">name</var> is one of the <a href=#supported-property-names>supported
property names</a> of the object returned by the <code title=dom-form-elements><a href=#dom-form-elements>elements</a></code> attribute, then run
these substeps:</p>
<li><p>If <var title="">candidates</var> is empty, let <var title="">candidates</var> be a <a href=#live>live</a>
<code><a href=#nodelist>NodeList</a></code> object containing all the <code><a href=#the-img-element>img</a></code>
elements that are descendants of the <code><a href=#the-form-element>form</a></code> element and
that have either an <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute or a
<code title=attr-img-name><a href=#attr-img-name>name</a></code> attribute equal to <var title="">name</var>, in <a href=#tree-order>tree order</a>.</li>
<ol><li><p>Let <var title="">candidate</var> be the object returned
by the <code title=dom-HTMLFormControlsCollection-namedItem><a href=#dom-htmlformcontrolscollection-nameditem>namedItem()</a></code>
method on the object returned by the <code title=dom-form-elements><a href=#dom-form-elements>elements</a></code> attribute when passed
the <var title="">name</var> argument.</li>
<li><p>If <var title="">candidates</var> is empty, <var title="">name</var> is the name of one of the entries in the
<code><a href=#the-form-element>form</a></code> element's <a href=#past-names-map>past names map</a>: return the
object associated with <var title="">name</var> in that
map.</li>
<li><p>If <var title="">candidate</var> is an element, then add a
mapping from <var title="">name</var> to <var title="">candidate</var> in the <code><a href=#the-form-element>form</a></code> element's
<a href=#past-names-map>past names map</a>, replacing the previous entry with
the same name, if any.</li>
<li><p>If <var title="">candidates</var> contains more than one
node, return <var title="">candidates</var> and abort these
steps.</li>
<li><p>Return <var title="">candidate</var> and abort these
method, when invoked, must <a href=#concept-form-submit title=concept-form-submit>submit</a> the <code><a href=#the-form-element>form</a></code>
element from the <code><a href=#the-form-element>form</a></code> element itself, with the <var title="">submitted from <code title=dom-form-submit><a href=#dom-form-submit>submit()</a></code> method</var> flag set.</p>
<p>Returns the form control in the form with the given <a href=#concept-id title=concept-id>ID</a> or <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> (excluding image buttons for
historical reasons).</p>
<p>Returns the form control (or, if there are several, a
<code><a href=#nodelist>NodeList</a></code> of the form controls) in the form with the
given <a href=#concept-id title=concept-id>ID</a> or <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> (excluding image buttons for
historical reasons); or, if there are none, returns the
<code><a href=#the-img-element>img</a></code> element with the given ID.</p>
<p>Once an element has been referenced using a particular name,
that name will continue being available as a way to reference that
the <code title=dom-form-elements><a href=#dom-form-elements>elements</a></code> collection, when
invoked with the given index as its argument.</p>
<p>Each <code><a href=#the-form-element>form</a></code> element has a mapping of names to elements
<hr><!-- Welcome to crazy town. Population: The Web. --><p>Each <code><a href=#the-form-element>form</a></code> element has a mapping of names to elements
called the <dfn id=past-names-map>past names map</dfn>. It is used to persist names of
controls even when they change names.</p>
<p>The <a href=#supported-property-names>supported property names</a> are the union of the
names currently supported by the object returned by the <code title=dom-form-elements><a href=#dom-form-elements>elements</a></code> attribute, and the names
currently in the <a href=#past-names-map>past names map</a>.</p>
<p>The <a href=#supported-property-names>supported property names</a> consist of the values
of all the <code title=attr-id><a href=#the-id-attribute>id</a></code> and <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> attributes of all the <a href=#category-listed title=category-listed>listed elements</a> and <code><a href=#the-img-element>img</a></code>
elements that are descendants of the <code><a href=#the-form-element>form</a></code> element, and
all the names currently in the <a href=#past-names-map>past names map</a>.</p>
<p>When a <code><a href=#the-form-element>form</a></code> element is <dfn id=dom-form-nameditem title=dom-form-namedItem>indexed for named property
retrieval</dfn>, the user agent must run the following steps:</p>
<ol><li>
<ol><li><p>Let <var title="">candidates</var> be a <a href=#live>live</a>
<code><a href=#nodelist>NodeList</a></code> object containing all the <a href=#category-listed title=category-listed>listed elements</a> that are descendants
of the <code><a href=#the-form-element>form</a></code> element and that have either an <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute or a <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> attribute equal to <var title="">name</var>, in <a href=#tree-order>tree order</a>.</li>
<p>If <var title="">name</var> is one of the <a href=#supported-property-names>supported
property names</a> of the object returned by the <code title=dom-form-elements><a href=#dom-form-elements>elements</a></code> attribute, then run
these substeps:</p>
<li><p>If <var title="">candidates</var> is empty, let <var title="">candidates</var> be a <a href=#live>live</a>
<code><a href=#nodelist>NodeList</a></code> object containing all the <code><a href=#the-img-element>img</a></code>
elements that are descendants of the <code><a href=#the-form-element>form</a></code> element and
that have either an <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute or a
<code title=attr-img-name><a href=#attr-img-name>name</a></code> attribute equal to <var title="">name</var>, in <a href=#tree-order>tree order</a>.</li>
<ol><li><p>Let <var title="">candidate</var> be the object returned
by the <code title=dom-HTMLFormControlsCollection-namedItem><a href=#dom-htmlformcontrolscollection-nameditem>namedItem()</a></code>
method on the object returned by the <code title=dom-form-elements><a href=#dom-form-elements>elements</a></code> attribute when passed
the <var title="">name</var> argument.</li>
<li><p>If <var title="">candidates</var> is empty, <var title="">name</var> is the name of one of the entries in the
<code><a href=#the-form-element>form</a></code> element's <a href=#past-names-map>past names map</a>: return the
object associated with <var title="">name</var> in that
map.</li>
<li><p>If <var title="">candidate</var> is an element, then add a
mapping from <var title="">name</var> to <var title="">candidate</var> in the <code><a href=#the-form-element>form</a></code> element's
<a href=#past-names-map>past names map</a>, replacing the previous entry with
the same name, if any.</li>
<li><p>If <var title="">candidates</var> contains more than one
node, return <var title="">candidates</var> and abort these
steps.</li>
<li><p>Return <var title="">candidate</var> and abort these
method, when invoked, must <a href=#concept-form-submit title=concept-form-submit>submit</a> the <code><a href=#the-form-element>form</a></code>
element from the <code><a href=#the-form-element>form</a></code> element itself, with the <var title="">submitted from <code title=dom-form-submit><a href=#dom-form-submit>submit()</a></code> method</var> flag set.</p>