Permalink
Browse files

[] (0) More thoroughly make the <img> processing model work with the …

…new fetching and event loop definitions.

git-svn-id: http://svn.whatwg.org/webapps@2097 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information...
1 parent 0ec7d80 commit 9ee5851e6f12ea6317d4667cf5b0735cd92c38dd @Hixie Hixie committed Aug 21, 2008
Showing with 83 additions and 53 deletions.
  1. +50 −34 index
  2. +33 −19 source
View
84 index
@@ -16056,16 +16056,16 @@ interface <dfn id=htmlimageelement>HTMLImageElement</dfn> : <a href="#htmlelemen
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
@@ -16094,6 +16094,20 @@ interface <dfn id=htmlimageelement>HTMLImageElement</dfn> : <a href="#htmlelemen
<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
@@ -16109,9 +16123,9 @@ interface <dfn id=htmlimageelement>HTMLImageElement</dfn> : <a href="#htmlelemen
<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
@@ -16134,14 +16148,15 @@ interface <dfn id=htmlimageelement>HTMLImageElement</dfn> : <a href="#htmlelemen
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>
@@ -16155,9 +16170,9 @@ interface <dfn id=htmlimageelement>HTMLImageElement</dfn> : <a href="#htmlelemen
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
@@ -16171,12 +16186,13 @@ interface <dfn id=htmlimageelement>HTMLImageElement</dfn> : <a href="#htmlelemen
<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
@@ -16258,9 +16274,9 @@ interface <dfn id=htmlimageelement>HTMLImageElement</dfn> : <a href="#htmlelemen
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="#refsCSS21">[CSS21]</a>
<p>The DOM attribute <dfn id=complete
@@ -16612,9 +16628,9 @@ rounded squares with varying shades of green and bold white outlines,
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
View
52 source
@@ -13541,16 +13541,16 @@ interface <dfn>HTMLImageElement</dfn> : <span>HTMLElement</span> {
<span title="origin">cross-origin</span> access control policies
that mitigate this attack.</p>
- <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 <span>fire a <code title="event-load">load</code>
- event</span> on the <code>img</code> element (this happens after
- <code title="dom-img-complete">complete</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 <span>fire an <code
- title="event-error">error</code> event</span> on the
- <code>img</code> element.</p>
+ <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 <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>Whether the image is fetched successfully or not (e.g. whether
the response code was a 2xx code or equivalent) must be ignored when
@@ -13579,6 +13579,20 @@ interface <dfn>HTMLImageElement</dfn> : <span>HTMLElement</span> {
<p>This specification does not specify which image types are to be
supported.</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>img</code> element (this happens after <code
+ title="dom-img-complete">complete</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, <span>queue a task</span> to <span>fire an <code
+ title="event-error">error</code> event</span> on the
+ <code>img</code> element.</p>
+
<hr>
<p>What an <code>img</code> element represents depends on the <code
@@ -13597,7 +13611,7 @@ interface <dfn>HTMLImageElement</dfn> : <span>HTMLElement</span> {
the content, redundant with some other information in the
document.</p>
- <p>If the image is available and the user agent is configured to
+ <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">src</code>
attribute.</p>
@@ -13626,11 +13640,11 @@ interface <dfn>HTMLImageElement</dfn> : <span>HTMLElement</span> {
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
+ <p>If the image is <i>available</i>, the element represents the image
specified by the <code title="attr-img-src">src</code>
attribute.</p>
- <p>If the image is not available or if the user agent is not
+ <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
@@ -13650,7 +13664,7 @@ interface <dfn>HTMLImageElement</dfn> : <span>HTMLElement</span> {
title="attr-img-alt">alt</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
+ <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">src</code>
attribute.</p>
@@ -13669,11 +13683,11 @@ interface <dfn>HTMLImageElement</dfn> : <span>HTMLElement</span> {
<p>The image's role in the document is unknown.</p>
- <p>If the image is available, the element represents the image
+ <p>If the image is <i>available</i>, the element represents the image
specified by the <code title="attr-img-src">src</code>
attribute.</p>
- <p>If the image is not available or if the user agent is not
+ <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>
@@ -13769,8 +13783,8 @@ interface <dfn>HTMLImageElement</dfn> : <span>HTMLElement</span> {
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
+ 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="#refsCSS21">[CSS21]</a></p>
<p>The DOM attribute <dfn
@@ -14147,7 +14161,7 @@ rounded squares with varying shades of green and bold white outlines,
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
+ such that 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>

0 comments on commit 9ee5851

Please sign in to comment.