- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 21 Aug 2008 10:25:04 +0000
- To: public-html-commits@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.</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 UTC