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

html5/spec Overview.html,1.1269,1.1270

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Thu, 21 Aug 2008 10:25:04 +0000
To: public-html-commits@w3.org
Message-Id: <E1KW7Lk-0007cg-3o@lionel-hutz.w3.org>

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

Modified Files:
	Overview.html 
Log Message:
More thoroughly make the <img> processing model work with the new fetching and event loop definitions. (whatwg r2097)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1269
retrieving revision 1.1270
diff -u -d -r1.1269 -r1.1270
--- Overview.html	21 Aug 2008 10:06:32 -0000	1.1269
+++ Overview.html	21 Aug 2008 10:25:01 -0000	1.1270
@@ -16064,16 +16064,16 @@
    title=origin>cross-origin</a> access control policies that mitigate this
    attack.
 
-  <p>Once the resource has been fetched, if the image is a valid and
-   supported image, then the image is said to be <i>available</i>; the user
-   agent must <a href="#firing4">fire a <code title=event-load>load</code>
-   event</a> on the <code><a href="#img">img</a></code> element (this happens
-   after <code title=dom-img-complete><a href="#complete">complete</a></code>
-   starts returning true). If the fetching process fails without a response
-   from the remote server, or it completes but the image is not a valid or
-   supported image, the user agent must <a href="#firing5">fire an <code
-   title=event-error>error</code> event</a> on the <code><a
-   href="#img">img</a></code> element.
+  <p>If 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> (this
+   affects exactly what the element represents, as defined below). This can
+   be true even before the image is completely downloaded, if the user agent
+   supports incremental rendering of images; in such cases, each <a
+   href="#tasks" title=concept-task>task</a> that is <a href="#queue"
+   title="queue a task">queued</a> by the <a href="#networking">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>Whether the image is fetched successfully or not (e.g. whether the
    response code was a 2xx code or equivalent) must be ignored when
@@ -16102,6 +16102,20 @@
   <p>This specification does not specify which image types are to be
    supported.
 
+  <p>The <a href="#tasks" title=concept-task>task</a> that is <a
+   href="#queue" title="queue a task">queued</a> by the <a
+   href="#networking">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">queue a
+   task</a> to <a href="#firing4">fire a <code title=event-load>load</code>
+   event</a> on the <code><a href="#img">img</a></code> element (this happens
+   after <code title=dom-img-complete><a href="#complete">complete</a></code>
+   starts returning true); 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">queue a task</a> to <a
+   href="#firing5">fire an <code title=event-error>error</code> event</a> on
+   the <code><a href="#img">img</a></code> element.
+
   <hr>
 
   <p>What an <code><a href="#img">img</a></code> element represents depends
@@ -16117,9 +16131,9 @@
     <p>The image is either decorative or supplemental to the rest of the
      content, redundant with some other information in the document.</p>
 
-    <p>If the image is available and the user agent is configured to display
-     that image, then the element represents the image specified by the <code
-     title=attr-img-src><a href="#src">src</a></code> attribute.</p>
+    <p>If the image is <i>available</i> and the user agent is configured to
+     display that image, then the element represents the image specified by
+     the <code title=attr-img-src><a href="#src">src</a></code> attribute.</p>
 
     <p>Otherwise, the element represents nothing, and may be omitted
      completely from the rendering. User agents may provide the user with a
@@ -16142,14 +16156,15 @@
      title="">{}</code>"), then even the kind of image being shown is not
      known.</p>
 
-    <p>If the image is available, the element represents the image specified
-     by the <code title=attr-img-src><a href="#src">src</a></code> attribute.</p>
+    <p>If the image is <i>available</i>, the element represents the image
+     specified by the <code title=attr-img-src><a href="#src">src</a></code>
+     attribute.</p>
 
-    <p>If the image is not available or if the user agent is not configured
-     to display the image, then the user agent should display some sort of
-     indicator that the image is not being rendered, and, if possible,
-     provide to the user the information regarding the kind of image that is
-     (as derived from the <code title=attr-img-alt><a
+    <p>If the image is not <i>available</i> or if the user agent is not
+     configured to display the image, then the user agent should display some
+     sort of indicator that the image is not being rendered, and, if
+     possible, provide to the user the information regarding the kind of
+     image that is (as derived from the <code title=attr-img-alt><a
      href="#alt0">alt</a></code> attribute).</p>
 
    <dt>If the <code title=attr-img-src><a href="#src">src</a></code>
@@ -16163,9 +16178,9 @@
      title=attr-img-alt><a href="#alt0">alt</a></code> attribute gives a
      textual equivalent or replacement for the image.</p>
 
-    <p>If the image is available and the user agent is configured to display
-     that image, then the element represents the image specified by the <code
-     title=attr-img-src><a href="#src">src</a></code> attribute.</p>
+    <p>If the image is <i>available</i> and the user agent is configured to
+     display that image, then the element represents the image specified by
+     the <code title=attr-img-src><a href="#src">src</a></code> attribute.</p>
 
     <p>Otherwise, the element represents the text given by the <code
      title=attr-img-alt><a href="#alt0">alt</a></code> attribute. User agents
@@ -16179,12 +16194,13 @@
    <dd>
     <p>The image's role in the document is unknown.</p>
 
-    <p>If the image is available, the element represents the image specified
-     by the <code title=attr-img-src><a href="#src">src</a></code> attribute.</p>
+    <p>If the image is <i>available</i>, the element represents the image
+     specified by the <code title=attr-img-src><a href="#src">src</a></code>
+     attribute.</p>
 
-    <p>If the image is not available or if the user agent is not configured
-     to display the image, then the user agent may display some sort of
-     indicator that the image is not being rendered.</p>
+    <p>If the image is not <i>available</i> or if the user agent is not
+     configured to display the image, then the user agent may display some
+     sort of indicator that the image is not being rendered.</p>
 
    <dt>If the <code title=attr-img-src><a href="#src">src</a></code>
     attribute is not set and the <code title=attr-img-alt><a
@@ -16266,9 +16282,9 @@
    title=dom-img-height><code>height</code></dfn> must return the rendered
    width and height of the image, in CSS pixels, if the image is being
    rendered, and is being rendered to a visual medium; or else the intrinsic
-   with and height of the image, in CSS pixels, if the image is available but
-   not being rendered to a visual medium; or else 0, if the image is not
-   available or its dimensions are not known. <a
+   with and height of the image, in CSS pixels, if the image is
+   <i>available</i> but not being rendered to a visual medium; or else 0, if
+   the image is not <i>available</i> or its dimensions are not known. <a
    href="#references">[CSS21]</a>
 
   <p>The DOM attribute <dfn id=complete
@@ -16620,9 +16636,9 @@
 at least that would look good on the cover of a blue book.&lt;/p></pre>
 
    <p>This example shows how the alternative text should be written such that
-    if the image isn't available, and the text is used instead, the text
-    flows seamlessly into the surrounding text, as if the image had never
-    been there in the first place.</p>
+    if the image isn't <i>available</i>, and the text is used instead, the
+    text flows seamlessly into the surrounding text, as if the image had
+    never been there in the first place.</p>
   </div>
 
   <h6 id=text-that><span class=secno>4.7.2.1.4. </span>Text that has been
Received on Thursday, 21 August 2008 10:25:39 GMT

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