Skip to content

Commit

Permalink
[] (0) More thoroughly make the <img> processing model work with the …
Browse files Browse the repository at this point in the history 
…new fetching and event loop definitions.

git-svn-id: http://svn.whatwg.org/webapps@2097 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Aug 21, 2008
1 parent 0ec7d80 commit 9ee5851
Show file tree
Hide file tree
Showing 2 changed files with 83 additions and 53 deletions.
84 changes: 50 additions & 34 deletions index
View file
Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand All @@ -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
Expand All @@ -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>
Expand All @@ -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
Expand All @@ -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
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand Down
52 changes: 33 additions & 19 deletions source
View file
Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand All @@ -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>
Expand Down Expand Up @@ -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
Expand All @@ -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>
Expand All @@ -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>

Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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>

Expand Down

0 comments on commit 9ee5851

Please sign in to comment.