W3C home > Mailing lists > Public > public-html-commits@w3.org > October 2008

html5/spec Overview.html,1.1448,1.1449

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Fri, 03 Oct 2008 23:26:20 +0000
To: public-html-commits@w3.org
Message-Id: <E1Klu2O-0002w8-Mh@lionel-hutz.w3.org>

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv11274

Modified Files:
	Overview.html 
Log Message:
<input type=image> (whatwg r2276)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1448
retrieving revision 1.1449
diff -u -d -r1.1448 -r1.1449
--- Overview.html	3 Oct 2008 07:42:42 -0000	1.1448
+++ Overview.html	3 Oct 2008 23:26:17 -0000	1.1449
@@ -20366,7 +20366,8 @@
   <code class=no-backref title=attr-input-size><a href=#attr-input-size>size</a></code>,
   <code class=no-backref title=attr-input-src><a href=#attr-input-src>src</a></code>,
   <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>The following DOM attributes and methods do not apply to the element:
+  <code class=no-backref title=attr-fs-target><a href=#attr-fs-target>target</a></code>.<p>The element's <code title=attr-input-value><a href=#attr-input-value>value</a></code>
+  attribute must be omitted.<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>,
@@ -20411,8 +20412,110 @@
   <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.<h6 id=image-button-state><span class=secno>4.10.4.1.18 </span><dfn title=attr-input-type-image>Image 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=#image-button-state title=attr-input-type-image>Image Button</a> state, the rules
-  in this section apply.<p>The element's <code title=attr-input-value><a href=#attr-input-value>value</a></code>
-  attribute must be omitted.<p class=XXX>...<p class=XXX>... <dfn id=attr-input-alt title=attr-input-alt><code>alt</code></dfn><p class=XXX>... <dfn id=attr-input-src title=attr-input-src><code>src</code></dfn><p class=XXX>... image: <dfn id=concept-input-type-image-coordinate title=concept-input-type-image-coordinate>selected coordinate</dfn><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
+  in this section apply.<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>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>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>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>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>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>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>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>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>The element's <code title=attr-input-value><a href=#attr-input-value>value</a></code>
+  attribute must be omitted.<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 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.<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
   in this section apply.<p>The <code><a href=#the-input-element>input</a></code> element represents a button that, when
   activated, resets the form. If the element has a <code title=attr-input-value><a href=#attr-input-value>value</a></code> attribute, the button's label
   must be the value of that attribute; otherwise, it must be an
@@ -21288,9 +21391,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
Received on Friday, 3 October 2008 23:26:54 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 9 October 2008 20:33:00 GMT