[html5] r2276 - [] (0) <input type=image>
whatwg at whatwg.org
whatwg at whatwg.org
Fri Oct 3 16:26:14 PDT 2008
Author: ianh
Date: 2008-10-03 16:26:13 -0700 (Fri, 03 Oct 2008)
New Revision: 2276
Modified:
index
source
Log:
[] (0) <input type=image>
Modified: index
===================================================================
--- index 2008-10-03 07:42:37 UTC (rev 2275)
+++ index 2008-10-03 23:26:13 UTC (rev 2276)
@@ -25201,6 +25201,9 @@
<code class=no-backref title=attr-input-step><a href=#attr-input-step>step</a></code>, and
<code class=no-backref title=attr-fs-target><a href=#attr-fs-target>target</a></code>.</p>
+ <p>The element's <code title=attr-input-value><a href=#attr-input-value>value</a></code>
+ attribute must be omitted.</p>
+
<p>The following DOM attributes and methods do not apply to the element:
<code class=no-backref title=dom-input-checked><a href=#dom-input-checked>checked</a></code>,
<code class=no-backref title=dom-input-list><a href=#dom-input-list>list</a></code>,
@@ -25277,19 +25280,150 @@
<p>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#image-button-state title=attr-input-type-image>Image Button</a> state, the rules
in this section apply.</p>
+ <p>The <code><a href=#the-input-element>input</a></code> element represents either an image from
+ which a user can select a coordinate and submit the form, or
+ alternatively a button from which the user can submit the form.</p>
+
+ <hr><p>The image is given by the <dfn id=attr-input-src title=attr-input-src><code>src</code></dfn> attribute. The <code title=attr-input-src><a href=#attr-input-src>src</a></code> attribute must be present, and
+ must contain a <a href=#valid-url>valid URL</a> referencing a non-interactive,
+ optionally animated, image resource that is neither paged nor
+ scripted.</p>
+
+ <p>When any of the following events occur, the user agent must
+ <a href=#fetch>fetch</a> the resource specifed by the <code title=attr-input-src><a href=#attr-input-src>src</a></code> attribute's value, unless the user
+ agent cannot support images, or its support for images has been
+ disabled, or the user agent only fetches elements on demand:</p>
+ <!-- Note how this does NOT happen when the base URL changes. -->
+
+ <ul><li>The <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is first set to the
+ <a href=#image-button-state title=attr-input-type-image>Image Button</a> state
+ (possibly when the element is first created), and the <code title=attr-input-src><a href=#attr-input-src>src</a></code> attribute is present.</li>
+
+ <li>The <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is changed back to
+ the <a href=#image-button-state title=attr-input-type-image>Image Button</a> state,
+ and the <code title=attr-input-src><a href=#attr-input-src>src</a></code> attribute is
+ present, and its value has changed since the last time the <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute was in the <a href=#image-button-state title=attr-input-type-image>Image Button</a> state.</li>
+
+ <li>The <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#image-button-state title=attr-input-type-image>Image Button</a> state, and the
+ <code title=attr-input-src><a href=#attr-input-src>src</a></code> attribute is set or
+ changed.</li> <!-- XXX define changed -->
+
+ </ul><p>Fetching the image must <a href=#delay-the-load-event>delay the <code title=event-load>load</code> event</a>.</p>
+
+ <p>If the image was successfully obtained, with no network errors,
+ and the image's type is a supported image type, and the image is a
+ valid image of that type, then the image is said to be
+ <i>available</i>. If this is true before the image is completely
+ downloaded, each <a href=#concept-task title=concept-task>task</a> that is
+ <a href=#queue-a-task title="queue a task">queued</a> by the <a href=#networking-task-source>networking
+ task source</a> while the image is being <a href=#fetch title=fetch>fetched</a> must update the presentation of the
+ image appropriately.</p>
+
+ <p>The user agents should apply the <a href=#content-type-sniffing:-image title="Content-Type
+ sniffing: image">image sniffing rules</a> to determine the type
+ of the image, with the image's <a href=#content-type-0 title=Content-Type>associated
+ Content-Type headers</a> giving the <var title="">official
+ type</var>. If these rules are not applied, then the type of the
+ image must be the type given by the image's <a href=#content-type-0 title=Content-Type>associated Content-Type headers</a>.</p>
+
+ <p>User agents must not support non-image resources with the
+ <code><a href=#the-input-element>input</a></code> element. User agents must not run executable code
+ embedded in the image resource. User agents must only display the
+ first page of a multipage resource. User agents must not allow the
+ resource to act in an interactive fashion, but should honour any
+ animation in the resource.</p>
+
+ <p>The <a href=#concept-task title=concept-task>task</a> that is <a href=#queue-a-task title="queue a task">queued</a> by the <a href=#networking-task-source>networking task
+ source</a> once the resource has been <a href=#fetch title=fetch>fetched</a>, must, if the download was successful
+ and the image is <i>available</i>, <a href=#queue-a-task>queue a task</a> to
+ <a href=#fire-a-load-event>fire a <code title=event-load>load</code> event</a> on
+ the <code><a href=#the-input-element>input</a></code> element; and otherwise, if the fetching
+ process fails without a response from the remote server, or
+ completes but the image is not a valid or supported image,
+ <a href=#queue-a-task>queue a task</a> to <a href=#fire-an-error-event>fire an <code title=event-error>error</code> event</a> on the
+ <code><a href=#the-input-element>input</a></code> element.</p>
+
+ <hr><p>The <dfn id=attr-input-alt title=attr-input-alt><code>alt</code></dfn> attribute
+ provides the textual label for the alternative button for users and
+ user agents who cannot use the image. The <code title=attr-input-alt><a href=#attr-input-alt>alt</a></code> attribute must also be present,
+ and must contain a non-empty string.</p>
+
+ <hr><p>If the <code title=attr-input-src><a href=#attr-input-src>src</a></code> attribute is set,
+ and the image is <i>available</i> and the user agent is configured
+ to display that image, then: The element represents a control for
+ selecting a <a href=#concept-input-type-image-coordinate title=concept-input-type-image-coordinate>coordinate</a> from
+ the image specified by the <code title=attr-input-src><a href=#attr-input-src>src</a></code>
+ attribute; if the element is <i title=concept-input-mutable><a href=#concept-input-mutable>mutable</a></i>, the user should allow the
+ user to select this <a href=#concept-input-type-image-coordinate title=concept-input-type-image-coordinate>coordinate</a>, at
+ which point the element's <a href=#form-owner>form owner</a>, if any, must be
+ <a href=#concept-form-submit title=concept-form-submit>submitted</a> from the
+ <code><a href=#the-input-element>input</a></code> element.</p>
+
+ <p>Otherwise, the element represents a submit button whose label is
+ given by the value of the <code title=attr-input-alt><a href=#attr-input-alt>alt</a></code>
+ attribute; if the element is <i title=concept-input-mutable><a href=#concept-input-mutable>mutable</a></i>, the user should allow the
+ user to activate the button, at which point the the <a href=#concept-input-type-image-coordinate title=concept-input-type-image-coordinate>selected
+ coordinate</a> must be set to (0,0) and the element's <a href=#form-owner>form
+ owner</a>, if any, must be <a href=#concept-form-submit title=concept-form-submit>submitted</a> from the
+ <code><a href=#the-input-element>input</a></code> element.</p>
+
+ <!-- XXX event timing; activation behavior -->
+
+ <p>The <dfn id=concept-input-type-image-coordinate title=concept-input-type-image-coordinate>selected
+ coordinate</dfn> must consist of an <var title="">x</var>-component
+ and a <var title="">y</var>-component. The <var title="">x</var>-component must be greater than or equal to zero,
+ and less than or equal to the rendered width, in CSS pixels, of the
+ image. The <var title="">y</var>-component must be greater than or
+ equal to zero, and less than or equal to the rendered height, in CSS
+ pixels, of the image.</p>
+
+ <hr><p>The following common <code><a href=#the-input-element>input</a></code> element content
+ attributes and DOM attributes apply to the element:
+ <code title=attr-fs-action><a href=#attr-fs-action>action</a></code>,
+ <code title=attr-input-alt><a href=#attr-input-alt>alt</a></code>,
+ <code title=attr-fs-enctype><a href=#attr-fs-enctype>enctype</a></code>,
+ <code title=attr-fs-method><a href=#attr-fs-method>method</a></code>,
+ <code title=attr-input-src><a href=#attr-input-src>src</a></code>, and
+ <code title=attr-fs-target><a href=#attr-fs-target>target</a></code> content attributes;
+ <code title=dom-input-value><a href=#dom-input-value>value</a></code> DOM attribute.</p>
+
+ <p>The <code title=dom-input-value><a href=#dom-input-value>value</a></code> DOM attribute is
+ in mode <a href=#dom-input-value-default title=dom-input-value-default>default</a>.</p>
+
+ <p>The following content attributes must not be specified and do not
+ apply to the element:
+ <code class=no-backref title=attr-input-accept><a href=#attr-input-accept>accept</a></code>,
+ <code class=no-backref title=attr-input-autocomplete><a href=#attr-input-autocomplete>autocomplete</a></code>,
+ <code class=no-backref title=attr-input-checked><a href=#attr-input-checked>checked</a></code>,
+ <code class=no-backref title=attr-input-list><a href=#attr-input-list>list</a></code>,
+ <code class=no-backref title=attr-input-max><a href=#attr-input-max>max</a></code>,
+ <code class=no-backref title=attr-input-maxlength><a href=#attr-input-maxlength>maxlength</a></code>,
+ <code class=no-backref title=attr-input-min><a href=#attr-input-min>min</a></code>,
+ <code class=no-backref title=attr-input-pattern><a href=#attr-input-pattern>pattern</a></code>,
+ <code class=no-backref title=attr-input-readonly><a href=#attr-input-readonly>readonly</a></code>,
+ <code class=no-backref title=attr-input-required><a href=#attr-input-required>required</a></code>
+ <code class=no-backref title=attr-input-size><a href=#attr-input-size>size</a></code>, and
+ <code class=no-backref title=attr-input-step><a href=#attr-input-step>step</a></code>.</p>
+
<p>The element's <code title=attr-input-value><a href=#attr-input-value>value</a></code>
attribute must be omitted.</p>
- <p class=XXX>...</p>
+ <p>The following DOM attributes and methods do not apply to the element:
+ <code class=no-backref title=dom-input-checked><a href=#dom-input-checked>checked</a></code>,
+ <code class=no-backref title=dom-input-list><a href=#dom-input-list>list</a></code>,
+ <code class=no-backref title=dom-input-selectedOption><a href=#dom-input-selectedoption>selectedOption</a></code>,
+ <code class=no-backref title=dom-input-valueAsDate><a href=#dom-input-valueasdate>valueAsDate</a></code> and
+ <code class=no-backref title=dom-input-valueAsNumber><a href=#dom-input-valueasnumber>valueAsNumber</a></code> DOM attributes;
+ <code class=no-backref title=dom-input-stepDown><a href=#dom-input-stepdown>stepDown()</a></code> and
+ <code class=no-backref title=dom-input-stepUp><a href=#dom-input-stepup>stepUp()</a></code> methods.</p>
- <p class=XXX>... <dfn id=attr-input-alt title=attr-input-alt><code>alt</code></dfn></p>
+ <p class=note>Many aspects of this state's behavior are similar to
+ the behavior of the <code><a href=#the-img-element>img</a></code> element. Readers are encouraged
+ to read that section, where many of the same requirements are
+ described in more detail.</p>
- <p class=XXX>... <dfn id=attr-input-src title=attr-input-src><code>src</code></dfn></p>
- <p class=XXX>... image: <dfn id=concept-input-type-image-coordinate title=concept-input-type-image-coordinate>selected coordinate</dfn></p>
-
-
<h6 id=reset-button-state><span class=secno>4.10.4.1.19 </span><dfn title=attr-input-type-reset>Reset Button</dfn> state</h6>
<p>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#reset-button-state title=attr-input-type-reset>Reset Button</a> state, the rules
@@ -26576,9 +26710,9 @@
<li><p>The <var title="">field</var> element is <var title="">submitter</var>, and before this algorithm was invoked
the user <a href=#concept-input-type-image-coordinate title=concept-input-type-image-coordinate>indicated a
- coordinate</a>. Let <var title="">x</var> be the x-component
- of the coordindate selected by the user, and let <var title="">y</var> be the y-component of the coordinate selected
- by the user.</li>
+ coordinate</a>. Let <var title="">x</var> be the <var title="">x</var>-component of the coordindate selected by the
+ user, and let <var title="">y</var> be the <var title="">y</var>-component of the coordinate selected by the
+ user.</li>
<li><p>Append an entry in the <var title="">form data set</var>
with the name <var title="">name<sub title="">x</sub></var> and
Modified: source
===================================================================
--- source 2008-10-03 07:42:37 UTC (rev 2275)
+++ source 2008-10-03 23:26:13 UTC (rev 2276)
@@ -28053,6 +28053,9 @@
<code class="no-backref" title="attr-input-step">step</code>, and
<code class="no-backref" title="attr-fs-target">target</code>.</p>
+ <p>The element's <code title="attr-input-value">value</code>
+ attribute must be omitted.</p>
+
<p>The following DOM attributes and methods do not apply to the element:
<code class="no-backref" title="dom-input-checked">checked</code>,
<code class="no-backref" title="dom-input-list">list</code>,
@@ -28135,19 +28138,187 @@
title="attr-input-type-image">Image Button</span> state, the rules
in this section apply.</p>
+ <p>The <code>input</code> element represents either an image from
+ which a user can select a coordinate and submit the form, or
+ alternatively a button from which the user can submit the form.</p>
+
+ <hr>
+
+ <p>The image is given by the <dfn
+ title="attr-input-src"><code>src</code></dfn> attribute. The <code
+ title="attr-input-src">src</code> attribute must be present, and
+ must contain a <span>valid URL</span> referencing a non-interactive,
+ optionally animated, image resource that is neither paged nor
+ scripted.</p>
+
+ <p>When any of the following events occur, the user agent must
+ <span>fetch</span> the resource specifed by the <code
+ title="attr-input-src">src</code> attribute's value, unless the user
+ agent cannot support images, or its support for images has been
+ disabled, or the user agent only fetches elements on demand:</p>
+ <!-- Note how this does NOT happen when the base URL changes. -->
+
+ <ul>
+
+ <li>The <code>input</code> element's <code
+ title="attr-input-type">type</code> attribute is first set to the
+ <span title="attr-input-type-image">Image Button</span> state
+ (possibly when the element is first created), and the <code
+ title="attr-input-src">src</code> attribute is present.</li>
+
+ <li>The <code>input</code> element's <code
+ title="attr-input-type">type</code> attribute is changed back to
+ the <span title="attr-input-type-image">Image Button</span> state,
+ and the <code title="attr-input-src">src</code> attribute is
+ present, and its value has changed since the last time the <code
+ title="attr-input-type">type</code> attribute was in the <span
+ title="attr-input-type-image">Image Button</span> state.</li>
+
+ <li>The <code>input</code> element's <code
+ title="attr-input-type">type</code> attribute is in the <span
+ title="attr-input-type-image">Image Button</span> state, and the
+ <code title="attr-input-src">src</code> attribute is set or
+ changed.</li> <!-- XXX define changed -->
+
+ </ul>
+
+ <p>Fetching the image must <span>delay the <code
+ title="event-load">load</code> event</span>.</p>
+
+ <p>If the image was successfully obtained, with no network errors,
+ and the image's type is a supported image type, and the image is a
+ valid image of that type, then the image is said to be
+ <i>available</i>. If this is true before the image is completely
+ downloaded, each <span title="concept-task">task</span> that is
+ <span title="queue a task">queued</span> by the <span>networking
+ task source</span> while the image is being <span
+ title="fetch">fetched</span> must update the presentation of the
+ image appropriately.</p>
+
+ <p>The user agents should apply the <span title="Content-Type
+ sniffing: image">image sniffing rules</span> to determine the type
+ of the image, with the image's <span title="Content-Type">associated
+ Content-Type headers</span> giving the <var title="">official
+ type</var>. If these rules are not applied, then the type of the
+ image must be the type given by the image's <span
+ title="Content-Type">associated Content-Type headers</span>.</p>
+
+ <p>User agents must not support non-image resources with the
+ <code>input</code> element. User agents must not run executable code
+ embedded in the image resource. User agents must only display the
+ first page of a multipage resource. User agents must not allow the
+ resource to act in an interactive fashion, but should honour any
+ animation in the resource.</p>
+
+ <p>The <span title="concept-task">task</span> that is <span
+ title="queue a task">queued</span> by the <span>networking task
+ source</span> once the resource has been <span
+ title="fetch">fetched</span>, must, if the download was successful
+ and the image is <i>available</i>, <span>queue a task</span> to
+ <span>fire a <code title="event-load">load</code> event</span> on
+ the <code>input</code> element; and otherwise, if the fetching
+ process fails without a response from the remote server, or
+ completes but the image is not a valid or supported image,
+ <span>queue a task</span> to <span>fire an <code
+ title="event-error">error</code> event</span> on the
+ <code>input</code> element.</p>
+
+ <hr>
+
+ <p>The <dfn title="attr-input-alt"><code>alt</code></dfn> attribute
+ provides the textual label for the alternative button for users and
+ user agents who cannot use the image. The <code
+ title="attr-input-alt">alt</code> attribute must also be present,
+ and must contain a non-empty string.</p>
+
+ <hr>
+
+ <p>If the <code title="attr-input-src">src</code> attribute is set,
+ and the image is <i>available</i> and the user agent is configured
+ to display that image, then: The element represents a control for
+ selecting a <span
+ title="concept-input-type-image-coordinate">coordinate</span> from
+ the image specified by the <code title="attr-input-src">src</code>
+ attribute; if the element is <i
+ title="concept-input-mutable">mutable</i>, the user should allow the
+ user to select this <span
+ title="concept-input-type-image-coordinate">coordinate</span>, at
+ which point the element's <span>form owner</span>, if any, must be
+ <span title="concept-form-submit">submitted</span> from the
+ <code>input</code> element.</p>
+
+ <p>Otherwise, the element represents a submit button whose label is
+ given by the value of the <code title="attr-input-alt">alt</code>
+ attribute; if the element is <i
+ title="concept-input-mutable">mutable</i>, the user should allow the
+ user to activate the button, at which point the the <span
+ title="concept-input-type-image-coordinate">selected
+ coordinate</span> must be set to (0,0) and the element's <span>form
+ owner</span>, if any, must be <span
+ title="concept-form-submit">submitted</span> from the
+ <code>input</code> element.</p>
+
+ <!-- XXX event timing; activation behavior -->
+
+ <p>The <dfn
+ title="concept-input-type-image-coordinate">selected
+ coordinate</dfn> must consist of an <var title="">x</var>-component
+ and a <var title="">y</var>-component. The <var
+ title="">x</var>-component must be greater than or equal to zero,
+ and less than or equal to the rendered width, in CSS pixels, of the
+ image. The <var title="">y</var>-component must be greater than or
+ equal to zero, and less than or equal to the rendered height, in CSS
+ pixels, of the image.</p>
+
+ <hr>
+
+ <p>The following common <code>input</code> element content
+ attributes and DOM attributes apply to the element:
+ <code title="attr-fs-action">action</code>,
+ <code title="attr-input-alt">alt</code>,
+ <code title="attr-fs-enctype">enctype</code>,
+ <code title="attr-fs-method">method</code>,
+ <code title="attr-input-src">src</code>, and
+ <code title="attr-fs-target">target</code> content attributes;
+ <code title="dom-input-value">value</code> DOM attribute.</p>
+
+ <p>The <code title="dom-input-value">value</code> DOM attribute is
+ in mode <span title="dom-input-value-default">default</span>.</p>
+
+ <p>The following content attributes must not be specified and do not
+ apply to the element:
+ <code class="no-backref" title="attr-input-accept">accept</code>,
+ <code class="no-backref" title="attr-input-autocomplete">autocomplete</code>,
+ <code class="no-backref" title="attr-input-checked">checked</code>,
+ <code class="no-backref" title="attr-input-list">list</code>,
+ <code class="no-backref" title="attr-input-max">max</code>,
+ <code class="no-backref" title="attr-input-maxlength">maxlength</code>,
+ <code class="no-backref" title="attr-input-min">min</code>,
+ <code class="no-backref" title="attr-input-pattern">pattern</code>,
+ <code class="no-backref" title="attr-input-readonly">readonly</code>,
+ <code class="no-backref" title="attr-input-required">required</code>
+ <code class="no-backref" title="attr-input-size">size</code>, and
+ <code class="no-backref" title="attr-input-step">step</code>.</p>
+
<p>The element's <code title="attr-input-value">value</code>
attribute must be omitted.</p>
- <p class="XXX">...</p>
+ <p>The following DOM attributes and methods do not apply to the element:
+ <code class="no-backref" title="dom-input-checked">checked</code>,
+ <code class="no-backref" title="dom-input-list">list</code>,
+ <code class="no-backref" title="dom-input-selectedOption">selectedOption</code>,
+ <code class="no-backref" title="dom-input-valueAsDate">valueAsDate</code> and
+ <code class="no-backref" title="dom-input-valueAsNumber">valueAsNumber</code> DOM attributes;
+ <code class="no-backref" title="dom-input-stepDown">stepDown()</code> and
+ <code class="no-backref" title="dom-input-stepUp">stepUp()</code> methods.</p>
- <p class="XXX">... <dfn title="attr-input-alt"><code>alt</code></dfn></p>
+ <p class="note">Many aspects of this state's behavior are similar to
+ the behavior of the <code>img</code> element. Readers are encouraged
+ to read that section, where many of the same requirements are
+ described in more detail.</p>
- <p class="XXX">... <dfn title="attr-input-src"><code>src</code></dfn></p>
- <p class="XXX">... image: <dfn title="concept-input-type-image-coordinate">selected coordinate</dfn></p>
-
-
<h6><dfn title="attr-input-type-reset">Reset Button</dfn> state</h6>
<p>When an <code>input</code> element's <code
@@ -29694,10 +29865,11 @@
title="">submitter</var>, and before this algorithm was invoked
the user <span
title="concept-input-type-image-coordinate">indicated a
- coordinate</span>. Let <var title="">x</var> be the x-component
- of the coordindate selected by the user, and let <var
- title="">y</var> be the y-component of the coordinate selected
- by the user.</p></li>
+ coordinate</span>. Let <var title="">x</var> be the <var
+ title="">x</var>-component of the coordindate selected by the
+ user, and let <var title="">y</var> be the <var
+ title="">y</var>-component of the coordinate selected by the
+ user.</p></li>
<li><p>Append an entry in the <var title="">form data set</var>
with the name <var title="">name<sub title="">x</sub></var> and
More information about the Commit-Watchers
mailing list