- <h2class="no-num no-toc">Draft Standard —8 March 2010</h2>
+ <h2class="no-num no-toc">Draft Standard —9 March 2010</h2>
</hgroup><p>You can take part in this work. <ahref=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
<p><strong>Web designers!</strong> We have a <ahref=http://blog.whatwg.org/faq/>FAQ</a>, a <ahref=http://forums.whatwg.org/>forum</a>, and a <ahref=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
<!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
<p>The term <dfnid=html-mime-type>HTML MIME type</dfn> is used to refer to the <ahref=#mime-typetitle="MIME type">MIME types</a> <code><ahref=#text/html>text/html</a></code> and
<p>The destination of the link(s) is given by the <dfn id=attr-link-href title=attr-link-href><code>href</code></dfn> attribute, which must
- be present and must contain a <a href=#valid-url>valid URL</a>. <span class=impl>If the <code title=attr-link-href><a href=#attr-link-href>href</a></code>
- attribute is absent, then the element does not define a
- link.</span></p>
+ be present and must contain a <a href=#valid-non-empty-url>valid non-empty
+ URL</a>. <span class=impl>If the <code title=attr-link-href><a href=#attr-link-href>href</a></code> attribute is absent, then the
+ element does not define a link.</span></p>
<p>A <code><a href=#the-link-element>link</a></code> element must have either a <code title=attr-link-rel><a href=#attr-link-rel>rel</a></code> attribute, or an <code title=attr-itemprop><a href=#names:-the-itemprop-attribute>itemprop</a></code> attribute, or both.</p>
+ </ol><p>User agents may opt to only try to obtain such resources when
+ they are needed, instead of pro-actively <a href=#fetch title=fetch>fetching</a> all the external resources that are
+ not applied.</p>
+
<p>The semantics of the protocol used (e.g. HTTP) must be followed
when fetching external resources. (For example, redirects will be
followed and 404 responses will cause the external resource to not
be applied.)</p>
<!-- the next few paragraph are similar to text in the <style> section -->
- <p>Once the attempts to obtain the resource and its critical
- subresources are complete, the user agent must, if the loads were
- successful, <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple
+ <p>Once the attempts to obtain the resource and its <a href=#critical-subresources>critical
+ subresources</a> are complete, the user agent must, if the loads
+ were successful, <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple
event</a> named <code title=event-load>load</code> at the
<code><a href=#the-link-element>link</a></code> element, or, if the resource or one of its
- critical subresources failed to completely load for any reason
- (e.g. DNS error, HTTP 404 response, a connection being prematurely
- closed, unsupported Content-Type), <a href=#queue-a-task>queue a task</a> to
- <a href=#fire-a-simple-event>fire a simple event</a> named <code title=event-error>error</code> at the <code><a href=#the-link-element>link</a></code>
+ <a href=#critical-subresources>critical subresources</a> failed to completely load for any
+ reason (e.g. DNS error, HTTP 404 response, a connection being
+ prematurely closed, unsupported Content-Type), <a href=#queue-a-task>queue a
+ task</a> to <a href=#fire-a-simple-event>fire a simple event</a> named <code title=event-error>error</code> at the <code><a href=#the-link-element>link</a></code>
element. Non-network errors in processing the resource or its
subresources (e.g. CSS parse errors, PNG decoding errors) are not
failures for the purposes of this paragraph.</p>
- <p>The <a href=#task-source>task source</a> for these <a href=#concept-task title=concept-task>tasks</a> is the <a href=#dom-manipulation-task-source>DOM manipulation
- task source</a>.</p>
+ <p>The <a href=#task-source>task source</a> for these <a href=#concept-task title=concept-task>tasks</a> is the <a href=#dom-manipulation-task-source>DOM manipulation task
+ source</a>.</p>
<p>The element must <a href=#delay-the-load-event>delay the load event</a> of the
element's document until all the attempts to obtain the resource and
- its critical subresources are complete. (Resources that the user
- agent has not yet attempted to obtain, e.g. because it is waiting
- for the resource to be needed, do not <a href=#delay-the-load-event>delay the load
+ its <a href=#critical-subresources>critical subresources</a> are complete. (Resources that
+ the user agent has not yet attempted to obtain, e.g. because it is
+ waiting for the resource to be needed, do not <a href=#delay-the-load-event>delay the load
event</a>.)</p>
- <p>Which resources are considered critical or not is defined by the
- relevant specification. For CSS resources, only <code title="">@import</code> rules introduce critical subresources; other
- resources, e.g. fonts or backgrounds, are not.</p>
-
<hr><p id=linkui>Interactive user agents may provide users with a
means to <a href=#following-hyperlinks title="following hyperlinks">follow the
hyperlinks</a> created using the <code><a href=#the-link-element>link</a></code> element,
<!-- the next few paragraph are similar to text in the <style> section -->
- <p>Once the attempts to obtain the style sheet's critical
- subresources, if any, are complete, or, if the style sheet has no
- critical subresources, once the style sheet has been parsed and
- processed, the user agent must, if the loads were successful or
- there were none, <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple
- event</a> named <code title=event-load>load</code> at the
- <code><a href=#the-style-element>style</a></code> element, or, if one of the style sheet's critical
- subresources failed to completely load for any reason (e.g. DNS
- error, HTTP 404 response, a connection being prematurely closed,
- unsupported Content-Type), <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a
- simple event</a> named <code title=event-error>error</code> at
- the <code><a href=#the-style-element>style</a></code> element. Non-network errors in processing the
+ <p>Once the attempts to obtain the style sheet's <a href=#critical-subresources>critical
+ subresources</a>, if any, are complete, or, if the style sheet
+ has no <a href=#critical-subresources>critical subresources</a>, once the style sheet has
+ been parsed and processed, the user agent must, if the loads were
+ successful or there were none, <a href=#queue-a-task>queue a task</a> to
+ <a href=#fire-a-simple-event>fire a simple event</a> named <code title=event-load>load</code> at the <code><a href=#the-style-element>style</a></code> element,
+ or, if one of the style sheet's <a href=#critical-subresources>critical subresources</a>
+ failed to completely load for any reason (e.g. DNS error, HTTP 404
+ response, a connection being prematurely closed, unsupported
+ Content-Type), <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple
+ event</a> named <code title=event-error>error</code> at the
+ <code><a href=#the-style-element>style</a></code> element. Non-network errors in processing the
style sheet or its subresources (e.g. CSS parse errors, PNG decoding
errors) are not failures for the purposes of this paragraph.</p>
<p>The <code title=attr-img-src><a href=#attr-img-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. If the <i>base URI of the element</i> is the
- same as <a href="#the-document's-address">the document's address</a>, then the <code title=attr-img-src><a href=#attr-img-src>src</a></code> attribute's value must not be the
- empty string.</p>
+ present, and must contain a <a href=#valid-non-empty-url>valid non-empty URL</a>
+ referencing a non-interactive, optionally animated, image resource
+ that is neither paged nor scripted.</p>
<p class=note>Images can thus be static bitmaps (e.g. PNGs, GIFs,
JPEGs), single-page vector documents (single-page PDFs, XML files
<hr><p>Unless the user agent cannot support images, or its support for
images has been disabled, or the user agent only fetches elements on
demand, or the element's <code title=attr-img-src><a href=#attr-img-src>src</a></code>
- attribute has a value that is an <i>ignored self-reference</i>,
- then, when an <code><a href=#the-img-element>img</a></code> is created with a <code title=attr-img-src><a href=#attr-img-src>src</a></code> attribute, and whenever the <code title=attr-img-src><a href=#attr-img-src>src</a></code> attribute is set subsequently, the
+ attribute's value is the empty string, then, when an
+ <code><a href=#the-img-element>img</a></code> is created with a <code title=attr-img-src><a href=#attr-img-src>src</a></code> attribute, and whenever the <code title=attr-img-src><a href=#attr-img-src>src</a></code> attribute is set subsequently, the
user agent must <a href=#resolve-a-url title="resolve a url">resolve</a> the value
of that attribute, relative to the element, and if that is
successful must then <a href=#fetch>fetch</a> that resource.</p> <!-- Note
how this does NOT happen when the base URL changes. --> <!--
http-origin privacy sensitive -->
- <p>The <code title=attr-img-src><a href=#attr-img-src>src</a></code> attribute's value is an
- <i>ignored self-reference</i> if its value is the empty string, and
- the <i>base URI of the element</i> is the same as <a href="#the-document's-address">the
- document's address</a>.</p>
-
<!-- same text in <input type=image> section and similar text elsewhere -->
<p>Fetching the image must <a href=#delay-the-load-event>delay the load event</a> of the
element's document until the <a href=#concept-task title=concept-task>task</a>
<ul class=brief><li>The element is <a href=#in-a-document title="in a document">in a <code>Document</code></a>.</li>
<li>The element's <code><a href=#document>Document</a></code> is <a href=#fully-active>fully active</a>.</li>
<li>The element has either a <code title=attr-embed-src><a href=#attr-embed-src>src</a></code> attribute set or a <code title=attr-embed-type><a href=#attr-embed-type>type</a></code> attribute set (or both).</li>
+ <li>The element's <code title=attr-embed-src><a href=#attr-embed-src>src</a></code> attribute is either absent or its value is the empty string.</li>
<li>The element is not in a <code><a href=#document>Document</a></code> whose <a href=#browsing-context>browsing context</a> had the <a href=#sandboxed-plugins-browsing-context-flag>sandboxed plugins browsing context flag</a> set when the <code><a href=#document>Document</a></code> was created (unless this has been overrriden as described above).</li>
<li>The element's <code><a href=#document>Document</a></code> was not parsed from a resource whose <a href=#content-type-sniffing-0 title="Content-Type sniffing">sniffed type</a> as determined during <a href=#navigate title=navigate>navigation</a> is <code><a href=#text/html-sandboxed>text/html-sandboxed</a></code> (unless this has been overrriden as described above).</li>
<li>The element is not a descendant of a <a href=#media-element>media element</a>.</li>
<li><p>If the <code title=attr-object-data><a href=#attr-object-data>data</a></code> attribute
is absent but the <code title=attr-object-type><a href=#attr-object-type>type</a></code>
- attribute is present, <a href=#sandboxPluginObject>plugins
- aren't being sandboxed</a>, and the user agent can find a <a href=#plugin>plugin</a>
- suitable according to the value of the <code title=attr-object-type><a href=#attr-object-type>type</a></code> attribute, then that <a href=#plugin>plugin</a>
- <a href=#object-plugin>should be used</a>. If no suitable <a href=#plugin>plugin</a>
- can be found, or if the <a href=#plugin>plugin</a> reports an error, jump to the next
- step (fallback).</li>
+ attribute is present, <a href=#sandboxPluginObject>plugins aren't
+ being sandboxed</a>, and the user agent can find a
+ <a href=#plugin>plugin</a> suitable according to the value of the <code title=attr-object-type><a href=#attr-object-type>type</a></code> attribute, then that
+ <a href=#plugin>plugin</a> <a href=#object-plugin>should be used</a>. If
+ no suitable <a href=#plugin>plugin</a> can be found, or if the
+ <a href=#plugin>plugin</a> reports an error, jump to the next step
+ (fallback).</li>
<li><p>(Fallback.) The <code><a href=#the-object-element>object</a></code> element
<a href=#represents>represents</a> the element's children, ignoring any
@@ -21612,12 +21636,11 @@ <h4 id=video><span class=secno>4.8.6 </span>The <dfn><code>video</code></dfn> el
attribute on <a href=#media-element title="media element">media elements</a> gives
the address of the media resource (video, audio) to show. The
- attribute, if present, must contain a <a href=#valid-url>valid URL</a>.</p>
+ attribute, if present, must contain a <a href=#valid-non-empty-url>valid non-empty
+ URL</a>.</p>
<div class=impl>
@@ -22696,7 +22721,11 @@ <h5 id=loading-the-media-resource><span class=secno>4.8.9.5 </span>Loading the m
<p>If <var title="">mode</var> is <i title="">attribute</i>, then
run these substeps:</p>
- <ol><li><p>⌛ Let <var title="">absolute URL</var> be the
+ <ol><li><p>⌛ <i>Process candidate</i>: If the <code title=attr-media-src><a href=#attr-media-src>src</a></code> attribute's value is the empty
+ string, then end the <a href=#synchronous-section>synchronous section</a>, and jump
+ down to the <i title="">failed</i> step below.</li>
+
+ <li><p>⌛ Let <var title="">absolute URL</var> be the
<a href=#absolute-url>absolute URL</a> that would have resulted from <a href=#resolve-a-url title="resolve a url">resolving</a> the <a href=#url>URL</a>
specified by the <code title=attr-media-src><a href=#attr-media-src>src</a></code>
attribute's value relative to the <a href=#media-element>media element</a> when
@@ -22716,9 +22745,9 @@ <h5 id=loading-the-media-resource><span class=secno>4.8.9.5 </span>Loading the m
algorithm returns without aborting <em>this</em> one, then the
load failed.</li>
- <li><p>Reaching this step indicates that the media resource
- failed to load or that the given <a href=#url>URL</a> could not be
- <a href=#resolve-a-url title="resolve a url">resolved</a>. Set the <code title=dom-media-error><a href=#dom-media-error>error</a></code> attribute to a new
+ <li><p><i>Failed</i>: Reaching this step indicates that the media
+ resource failed to load or that the given <a href=#url>URL</a> could
+ not be <a href=#resolve-a-url title="resolve a url">resolved</a>. Set the <code title=dom-media-error><a href=#dom-media-error>error</a></code> attribute to a new
<code><a href=#mediaerror>MediaError</a></code> object whose <code title=dom-MediaError-code><a href=#dom-mediaerror-code>code</a></code> attribute is set to <code title=dom-MediaError-MEDIA_ERR_SRC_NOT_SUPPORTED><a href=#dom-mediaerror-media_err_src_not_supported>MEDIA_ERR_SRC_NOT_SUPPORTED</a></code>.</li>
<li><p>Set the element's <code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code> attribute to
@@ -22783,8 +22812,9 @@ <h5 id=loading-the-media-resource><span class=secno>4.8.9.5 </span>Loading the m
</li>
- <li><p>⌛ <i>Process candidate</i>: If <var title="">candidate</var> does not have a <code title=attr-source-src><a href=#attr-source-src>src</a></code> attribute, then end the
- <a href=#synchronous-section>synchronous section</a>, and jump down to the <i title="">failed</i> step below.</li>
+ <li><p>⌛ <i>Process candidate</i>: If <var title="">candidate</var> does not have a <code title=attr-source-src><a href=#attr-source-src>src</a></code> attribute, or if its <code title=attr-source-src><a href=#attr-source-src>src</a></code> attribute's value is the empty
+ string, then end the <a href=#synchronous-section>synchronous section</a>, and jump
+ down to the <i title="">failed</i> step below.</li>
<li><p>⌛ Let <var title="">absolute URL</var> be the
<a href=#absolute-url>absolute URL</a> that would have resulted from <a href=#resolve-a-url title="resolve a url">resolving</a> the <a href=#url>URL</a>
<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>
+ must contain a <a href=#valid-non-empty-url>valid non-empty URL</a> referencing a
+ non-interactive, optionally animated, image resource that is neither
+ paged nor scripted.</p>
<div class=impl>
<p>When any of the following events occur, unless the user agent
cannot support images, or its support for images has been disabled,
- or the user agent only fetches elements on demand, the user agent
- must <a href=#resolve-a-url title="resolve a url">resolve</a> the value of the
- <code title=attr-input-src><a href=#attr-input-src>src</a></code> attribute, relative to the
+ or the user agent only fetches elements on demand, or the <code title=attr-input-src><a href=#attr-input-src>src</a></code> attribute's value is the empty
+ string, the user agent must <a href=#resolve-a-url title="resolve a
+ url">resolve</a> the value of the <code title=attr-input-src><a href=#attr-input-src>src</a></code> attribute, relative to the
element, and if that is successful, must <a href=#fetch>fetch</a> the
resulting <a href=#absolute-url>absolute URL</a>:</p> <!-- Note how this does NOT
happen when the base URL changes. --> <!-- http-origin privacy
attribute gives a picture that represents the command. If the
attribute is specified, the attribute's value must contain a
- <a href=#valid-url>valid URL</a>. <span class=impl>To obtain the
- <a href=#absolute-url>absolute URL</a> of the icon, the attribute's value must be
- <a href=#resolve-a-url title="resolve a url">resolved</a> relative to the
- element.</span></p> <!-- this is affected by the base URL being
+ <a href=#valid-non-empty-url>valid non-empty URL</a>. <span class=impl>To obtain the
+ <a href=#absolute-url>absolute URL</a> of the icon when the attribute's value is
+ not the empty string, the attribute's value must be <a href=#resolve-a-url title="resolve a url">resolved</a> relative to the element. When
+ the attribute is absent, or its value is the empty string, or <a href=#resolve-a-url title="resolve a url">resolving</a> its value fails, there is no
+ icon.</span></p> <!-- this is affected by the base URL being
changed, so users of this should cache the image once they've
fetched it once, at least until the relative url changes again -->
<p>If the root element, as parsed according to the XML
specifications cited above, is found to be an <code><a href=#the-html-element-0>html</a></code>
- element with an attribute <code title=attr-html-manifest><a href=#attr-html-manifest>manifest</a></code>, then, as soon as the
- element is <a href=#insert-an-element-into-a-document title="insert an element into a document">inserted
- into the document</a>, the user agent must <a href=#resolve-a-url title="resolve a
- url">resolve</a> the value of that attribute relative to that
- element, and if that is successful, must run the <a href=#concept-appcache-init title=concept-appcache-init>application cache selection
- algorithm</a> with the resulting <a href=#absolute-url>absolute URL</a> with
- any <a href=#url-fragment title=url-fragment><fragment></a> component
- removed as the manifest URL, and passing in the newly-created
- <code><a href=#document>Document</a></code>. Otherwise, if the attribute is absent or
- resolving it fails, then as soon as the root element is <a href=#insert-an-element-into-a-document title="insert an element into a document">inserted into the
- document</a>, the user agent must run the <a href=#concept-appcache-init title=concept-appcache-init>application cache selection
+ element with an attribute <code title=attr-html-manifest><a href=#attr-html-manifest>manifest</a></code> whose value is not the
+ empty string, then, as soon as the element is <a href=#insert-an-element-into-a-document title="insert an
+ element into a document">inserted into the document</a>, the user
+ agent must <a href=#resolve-a-url title="resolve a url">resolve</a> the value of
+ that attribute relative to that element, and if that is successful,
+ must run the <a href=#concept-appcache-init title=concept-appcache-init>application cache
+ selection algorithm</a> with the resulting <a href=#absolute-url>absolute
+ URL</a> with any <a href=#url-fragment title=url-fragment><fragment></a> component removed as
+ the manifest URL, and passing in the newly-created
+ <code><a href=#document>Document</a></code>. Otherwise, if the attribute is absent, its
+ value is the empty string, or resolving its value fails, then as
+ soon as the root element is <a href=#insert-an-element-into-a-document title="insert an element into a
+ document">inserted into the document</a>, the user agent must run
+ the <a href=#concept-appcache-init title=concept-appcache-init>application cache selection
algorithm</a> with no manifest, and passing in the
<code><a href=#document>Document</a></code>.</p>
@@ -76270,16 +76301,17 @@ <h5 id=the-initial-insertion-mode><span class=secno>12.2.5.4 </span>The "<dfn ti
<p id=parser-appcache>If the <code><a href=#document>Document</a></code> is being
loaded as part of <a href=#navigate title=navigate>navigation</a> of a
<a href=#browsing-context>browsing context</a>, then: if the newly created element
- has a <code title=attr-html-manifest><a href=#attr-html-manifest>manifest</a></code> attribute,
- then <a href=#resolve-a-url title="resolve a url">resolve</a> the value of that
- attribute to an <a href=#absolute-url>absolute URL</a>, relative to the newly
- created element, and if that is successful, run the <a href=#concept-appcache-init title=concept-appcache-init>application cache selection
+ has a <code title=attr-html-manifest><a href=#attr-html-manifest>manifest</a></code> attribute
+ whose value is not the empty string, then <a href=#resolve-a-url title="resolve a
+ url">resolve</a> the value of that attribute to an
+ <a href=#absolute-url>absolute URL</a>, relative to the newly created element,
+ and if that is successful, run the <a href=#concept-appcache-init title=concept-appcache-init>application cache selection
algorithm</a> with the resulting <a href=#absolute-url>absolute URL</a> with
any <a href=#url-fragment title=url-fragment><fragment></a> component
- removed; otherwise, if there is no such attribute or resolving it
- fails, run the <a href=#concept-appcache-init title=concept-appcache-init>application
- cache selection algorithm</a> with no manifest. The algorithm
- must be passed the <code><a href=#document>Document</a></code> object.</p>
+ removed; otherwise, if there is no such attribute, or its value is
+ the empty string, or resolving its value fails, run the <a href=#concept-appcache-init title=concept-appcache-init>application cache selection
+ algorithm</a> with no manifest. The algorithm must be passed
+ the <code><a href=#document>Document</a></code> object.</p>
<p>Switch the <a href=#insertion-mode>insertion mode</a> to "<a href=#the-before-head-insertion-mode title="insertion mode: before head">before head</a>".</p>
<hgroup><h1>HTML5 (including next generation additions still in development)</h1>
- <h2 class="no-num no-toc">Draft Standard — 8 March 2010</h2>
+ <h2 class="no-num no-toc">Draft Standard — 9 March 2010</h2>
</hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
<p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
<!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
@@ -1906,6 +1906,14 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d
<p>The term <dfn id=html-mime-type>HTML MIME type</dfn> is used to refer to the <a href=#mime-type title="MIME type">MIME types</a> <code><a href=#text/html>text/html</a></code> and
only <a href=#concept-appcache-init title=concept-appcache-init>has an effect</a> during
@@ -10923,9 +10934,9 @@ gave me some of the songs they wrote. I love sharing my music.</p>
document to other resources.</p>
<p>The destination of the link(s) is given by the <dfn id=attr-link-href title=attr-link-href><code>href</code></dfn> attribute, which must
- be present and must contain a <a href=#valid-url>valid URL</a>. <span class=impl>If the <code title=attr-link-href><a href=#attr-link-href>href</a></code>
- attribute is absent, then the element does not define a
- link.</span></p>
+ be present and must contain a <a href=#valid-non-empty-url>valid non-empty
+ URL</a>. <span class=impl>If the <code title=attr-link-href><a href=#attr-link-href>href</a></code> attribute is absent, then the
+ element does not define a link.</span></p>
<p>A <code><a href=#the-link-element>link</a></code> element must have either a <code title=attr-link-rel><a href=#attr-link-rel>rel</a></code> attribute, or an <code title=attr-itemprop><a href=#names:-the-itemprop-attribute>itemprop</a></code> attribute, or both.</p>
@@ -10961,52 +10972,60 @@ gave me some of the songs they wrote. I love sharing my music.</p>
<p>The exact behavior for links to external resources depends on the
exact relationship, as defined for the relevant link type. Some of
the attributes control whether or not the external resource is to be
- applied (as defined below). <span class=impl>For external
- resources that are represented in the DOM (for example, style
- sheets), the DOM representation must be made available even if the
- resource is not applied. To <dfn id=concept-link-obtain title=concept-link-obtain>obtain
- the resource</dfn>, the user agent must <a href=#resolve-a-url title="resolve a
- url">resolve</a> the <a href=#url>URL</a> given by the <code title=attr-link-href><a href=#attr-link-href>href</a></code> attribute, relative to the
- element, and then <a href=#fetch>fetch</a> the resulting <a href=#absolute-url>absolute
- URL</a>. User agents may opt to only try to obtain such resources
- when they are needed, instead of pro-actively <a href=#fetch title=fetch>fetching</a> all the external resources that are
- not applied.</span></p> <!-- http-origin privacy sensitive -->
+ applied (as defined below).</p>
<div class=impl>
+ <p>For external resources that are represented in the
+ DOM (for example, style sheets), the DOM representation must be made
+ available even if the resource is not applied. To <dfn id=concept-link-obtain title=concept-link-obtain>obtain the resource</dfn>, the user
+ agent must run the following steps:</p>
+
+ <ol><li><p>If the <code title=attr-link-href><a href=#attr-link-href>href</a></code> attribute's
+ value is the empty string, then abort these steps.</li>
+
+ <li><p><a href=#resolve-a-url title="resolve a url">Resolve</a> the
+ <a href=#url>URL</a> given by the <code title=attr-link-href><a href=#attr-link-href>href</a></code> attribute, relative to the
+ element.</li>
+
+ <li><p>If the previous step fails, then abort these steps.</li>
+
+ <li><p><a href=#fetch>Fetch</a> the resulting <a href=#absolute-url>absolute
+ </ol><p>User agents may opt to only try to obtain such resources when
+ they are needed, instead of pro-actively <a href=#fetch title=fetch>fetching</a> all the external resources that are
+ not applied.</p>
+
<p>The semantics of the protocol used (e.g. HTTP) must be followed
when fetching external resources. (For example, redirects will be
followed and 404 responses will cause the external resource to not
be applied.)</p>
<!-- the next few paragraph are similar to text in the <style> section -->
- <p>Once the attempts to obtain the resource and its critical
- subresources are complete, the user agent must, if the loads were
- successful, <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple
+ <p>Once the attempts to obtain the resource and its <a href=#critical-subresources>critical
+ subresources</a> are complete, the user agent must, if the loads
+ were successful, <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple
event</a> named <code title=event-load>load</code> at the
<code><a href=#the-link-element>link</a></code> element, or, if the resource or one of its
- critical subresources failed to completely load for any reason
- (e.g. DNS error, HTTP 404 response, a connection being prematurely
- closed, unsupported Content-Type), <a href=#queue-a-task>queue a task</a> to
- <a href=#fire-a-simple-event>fire a simple event</a> named <code title=event-error>error</code> at the <code><a href=#the-link-element>link</a></code>
+ <a href=#critical-subresources>critical subresources</a> failed to completely load for any
+ reason (e.g. DNS error, HTTP 404 response, a connection being
+ prematurely closed, unsupported Content-Type), <a href=#queue-a-task>queue a
+ task</a> to <a href=#fire-a-simple-event>fire a simple event</a> named <code title=event-error>error</code> at the <code><a href=#the-link-element>link</a></code>
element. Non-network errors in processing the resource or its
subresources (e.g. CSS parse errors, PNG decoding errors) are not
failures for the purposes of this paragraph.</p>
- <p>The <a href=#task-source>task source</a> for these <a href=#concept-task title=concept-task>tasks</a> is the <a href=#dom-manipulation-task-source>DOM manipulation
- task source</a>.</p>
+ <p>The <a href=#task-source>task source</a> for these <a href=#concept-task title=concept-task>tasks</a> is the <a href=#dom-manipulation-task-source>DOM manipulation task
+ source</a>.</p>
<p>The element must <a href=#delay-the-load-event>delay the load event</a> of the
element's document until all the attempts to obtain the resource and
- its critical subresources are complete. (Resources that the user
- agent has not yet attempted to obtain, e.g. because it is waiting
- for the resource to be needed, do not <a href=#delay-the-load-event>delay the load
+ its <a href=#critical-subresources>critical subresources</a> are complete. (Resources that
+ the user agent has not yet attempted to obtain, e.g. because it is
+ waiting for the resource to be needed, do not <a href=#delay-the-load-event>delay the load
event</a>.)</p>
- <p>Which resources are considered critical or not is defined by the
- relevant specification. For CSS resources, only <code title="">@import</code> rules introduce critical subresources; other
- resources, e.g. fonts or backgrounds, are not.</p>
-
<hr><p id=linkui>Interactive user agents may provide users with a
means to <a href=#following-hyperlinks title="following hyperlinks">follow the
hyperlinks</a> created using the <code><a href=#the-link-element>link</a></code> element,
@@ -12215,18 +12234,18 @@ c-end = "-->"</pre>
URL don't affect the CSS --></p>
<!-- the next few paragraph are similar to text in the <style> section -->
- <p>Once the attempts to obtain the style sheet's critical
- subresources, if any, are complete, or, if the style sheet has no
- critical subresources, once the style sheet has been parsed and
- processed, the user agent must, if the loads were successful or
- there were none, <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple
- event</a> named <code title=event-load>load</code> at the
- <code><a href=#the-style-element>style</a></code> element, or, if one of the style sheet's critical
- subresources failed to completely load for any reason (e.g. DNS
- error, HTTP 404 response, a connection being prematurely closed,
- unsupported Content-Type), <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a
- simple event</a> named <code title=event-error>error</code> at
- the <code><a href=#the-style-element>style</a></code> element. Non-network errors in processing the
+ <p>Once the attempts to obtain the style sheet's <a href=#critical-subresources>critical
+ subresources</a>, if any, are complete, or, if the style sheet
+ has no <a href=#critical-subresources>critical subresources</a>, once the style sheet has
+ been parsed and processed, the user agent must, if the loads were
+ successful or there were none, <a href=#queue-a-task>queue a task</a> to
+ <a href=#fire-a-simple-event>fire a simple event</a> named <code title=event-load>load</code> at the <code><a href=#the-style-element>style</a></code> element,
+ or, if one of the style sheet's <a href=#critical-subresources>critical subresources</a>
+ failed to completely load for any reason (e.g. DNS error, HTTP 404
+ response, a connection being prematurely closed, unsupported
+ Content-Type), <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple
+ event</a> named <code title=event-error>error</code> at the
+ <code><a href=#the-style-element>style</a></code> element. Non-network errors in processing the
style sheet or its subresources (e.g. CSS parse errors, PNG decoding
errors) are not failures for the purposes of this paragraph.</p>
@@ -12235,11 +12254,8 @@ c-end = "-->"</pre>
<p>The element must <a href=#delay-the-load-event>delay the load event</a> of the
element's document until all the attempts to obtain the style
- sheet's critical subresources, if any, are complete.</p>
-
- <p>Which resources are considered critical or not is defined by the
- relevant specification. For CSS resources, only <code title="">@import</code> rules introduce critical subresources; other
- resources, e.g. fonts or backgrounds, are not.</p>
+ sheet's <a href=#critical-subresources>critical subresources</a>, if any, are
<p>The <code title=attr-img-src><a href=#attr-img-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. If the <i>base URI of the element</i> is the
- same as <a href="#the-document's-address">the document's address</a>, then the <code title=attr-img-src><a href=#attr-img-src>src</a></code> attribute's value must not be the
- empty string.</p>
+ present, and must contain a <a href=#valid-non-empty-url>valid non-empty URL</a>
+ referencing a non-interactive, optionally animated, image resource
+ that is neither paged nor scripted.</p>
<p class=note>Images can thus be static bitmaps (e.g. PNGs, GIFs,
JPEGs), single-page vector documents (single-page PDFs, XML files
<hr><p>Unless the user agent cannot support images, or its support for
images has been disabled, or the user agent only fetches elements on
demand, or the element's <code title=attr-img-src><a href=#attr-img-src>src</a></code>
- attribute has a value that is an <i>ignored self-reference</i>,
- then, when an <code><a href=#the-img-element>img</a></code> is created with a <code title=attr-img-src><a href=#attr-img-src>src</a></code> attribute, and whenever the <code title=attr-img-src><a href=#attr-img-src>src</a></code> attribute is set subsequently, the
+ attribute's value is the empty string, then, when an
+ <code><a href=#the-img-element>img</a></code> is created with a <code title=attr-img-src><a href=#attr-img-src>src</a></code> attribute, and whenever the <code title=attr-img-src><a href=#attr-img-src>src</a></code> attribute is set subsequently, the
user agent must <a href=#resolve-a-url title="resolve a url">resolve</a> the value
of that attribute, relative to the element, and if that is
successful must then <a href=#fetch>fetch</a> that resource.</p> <!-- Note
how this does NOT happen when the base URL changes. --> <!--
http-origin privacy sensitive -->
- <p>The <code title=attr-img-src><a href=#attr-img-src>src</a></code> attribute's value is an
- <i>ignored self-reference</i> if its value is the empty string, and
- the <i>base URI of the element</i> is the same as <a href="#the-document's-address">the
- document's address</a>.</p>
-
<!-- same text in <input type=image> section and similar text elsewhere -->
<p>Fetching the image must <a href=#delay-the-load-event>delay the load event</a> of the
element's document until the <a href=#concept-task title=concept-task>task</a>
@@ -19780,7 +19802,7 @@ href="?audio">audio</a> test instead.)</p></pre>
attribute, if present, gives the <a href=#mime-type>MIME type</a> by which the
@@ -20590,6 +20611,7 @@ href="?audio">audio</a> test instead.)</p></pre>
<ul class=brief><li>The element is <a href=#in-a-document title="in a document">in a <code>Document</code></a>.</li>
<li>The element's <code><a href=#document>Document</a></code> is <a href=#fully-active>fully active</a>.</li>
<li>The element has either a <code title=attr-embed-src><a href=#attr-embed-src>src</a></code> attribute set or a <code title=attr-embed-type><a href=#attr-embed-type>type</a></code> attribute set (or both).</li>
+ <li>The element's <code title=attr-embed-src><a href=#attr-embed-src>src</a></code> attribute is either absent or its value is the empty string.</li>
<li>The element is not in a <code><a href=#document>Document</a></code> whose <a href=#browsing-context>browsing context</a> had the <a href=#sandboxed-plugins-browsing-context-flag>sandboxed plugins browsing context flag</a> set when the <code><a href=#document>Document</a></code> was created (unless this has been overrriden as described above).</li>
<li>The element's <code><a href=#document>Document</a></code> was not parsed from a resource whose <a href=#content-type-sniffing-0 title="Content-Type sniffing">sniffed type</a> as determined during <a href=#navigate title=navigate>navigation</a> is <code><a href=#text/html-sandboxed>text/html-sandboxed</a></code> (unless this has been overrriden as described above).</li>
<li>The element is not a descendant of a <a href=#media-element>media element</a>.</li>
@@ -20825,7 +20847,8 @@ href="?audio">audio</a> test instead.)</p></pre>
attribute, if present, specifies the type of the resource. If
@@ -21211,12 +21234,13 @@ href="?audio">audio</a> test instead.)</p></pre>
<li><p>If the <code title=attr-object-data><a href=#attr-object-data>data</a></code> attribute
is absent but the <code title=attr-object-type><a href=#attr-object-type>type</a></code>
- attribute is present, <a href=#sandboxPluginObject>plugins
- aren't being sandboxed</a>, and the user agent can find a <a href=#plugin>plugin</a>
- suitable according to the value of the <code title=attr-object-type><a href=#attr-object-type>type</a></code> attribute, then that <a href=#plugin>plugin</a>
- <a href=#object-plugin>should be used</a>. If no suitable <a href=#plugin>plugin</a>
- can be found, or if the <a href=#plugin>plugin</a> reports an error, jump to the next
- step (fallback).</li>
+ attribute is present, <a href=#sandboxPluginObject>plugins aren't
+ being sandboxed</a>, and the user agent can find a
+ <a href=#plugin>plugin</a> suitable according to the value of the <code title=attr-object-type><a href=#attr-object-type>type</a></code> attribute, then that
+ <a href=#plugin>plugin</a> <a href=#object-plugin>should be used</a>. If
+ no suitable <a href=#plugin>plugin</a> can be found, or if the
+ <a href=#plugin>plugin</a> reports an error, jump to the next step
+ (fallback).</li>
<li><p>(Fallback.) The <code><a href=#the-object-element>object</a></code> element
<a href=#represents>represents</a> the element's children, ignoring any
@@ -21514,12 +21538,11 @@ href="?audio">audio</a> test instead.)</p></pre>
<p>If <var title="">mode</var> is <i title="">attribute</i>, then
run these substeps:</p>
- <ol><li><p>⌛ Let <var title="">absolute URL</var> be the
+ <ol><li><p>⌛ <i>Process candidate</i>: If the <code title=attr-media-src><a href=#attr-media-src>src</a></code> attribute's value is the empty
+ string, then end the <a href=#synchronous-section>synchronous section</a>, and jump
+ down to the <i title="">failed</i> step below.</li>
+
+ <li><p>⌛ Let <var title="">absolute URL</var> be the
<a href=#absolute-url>absolute URL</a> that would have resulted from <a href=#resolve-a-url title="resolve a url">resolving</a> the <a href=#url>URL</a>
specified by the <code title=attr-media-src><a href=#attr-media-src>src</a></code>
attribute's value relative to the <a href=#media-element>media element</a> when
algorithm returns without aborting <em>this</em> one, then the
load failed.</li>
- <li><p>Reaching this step indicates that the media resource
- failed to load or that the given <a href=#url>URL</a> could not be
- <a href=#resolve-a-url title="resolve a url">resolved</a>. Set the <code title=dom-media-error><a href=#dom-media-error>error</a></code> attribute to a new
+ <li><p><i>Failed</i>: Reaching this step indicates that the media
+ resource failed to load or that the given <a href=#url>URL</a> could
+ not be <a href=#resolve-a-url title="resolve a url">resolved</a>. Set the <code title=dom-media-error><a href=#dom-media-error>error</a></code> attribute to a new
<code><a href=#mediaerror>MediaError</a></code> object whose <code title=dom-MediaError-code><a href=#dom-mediaerror-code>code</a></code> attribute is set to <code title=dom-MediaError-MEDIA_ERR_SRC_NOT_SUPPORTED><a href=#dom-mediaerror-media_err_src_not_supported>MEDIA_ERR_SRC_NOT_SUPPORTED</a></code>.</li>
<li><p>Set the element's <code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code> attribute to
- <li><p>⌛ <i>Process candidate</i>: If <var title="">candidate</var> does not have a <code title=attr-source-src><a href=#attr-source-src>src</a></code> attribute, then end the
- <a href=#synchronous-section>synchronous section</a>, and jump down to the <i title="">failed</i> step below.</li>
+ <li><p>⌛ <i>Process candidate</i>: If <var title="">candidate</var> does not have a <code title=attr-source-src><a href=#attr-source-src>src</a></code> attribute, or if its <code title=attr-source-src><a href=#attr-source-src>src</a></code> attribute's value is the empty
+ string, then end the <a href=#synchronous-section>synchronous section</a>, and jump
+ down to the <i title="">failed</i> step below.</li>
<li><p>⌛ Let <var title="">absolute URL</var> be the
<a href=#absolute-url>absolute URL</a> that would have resulted from <a href=#resolve-a-url title="resolve a url">resolving</a> the <a href=#url>URL</a>
@@ -26748,11 +26778,11 @@ notes on what would need to be defined for dashed lines:
where some glyphs like आ are anchored, the middle is half-way
between the top of the em square and the bottom of the em square,
the alphabetic baseline is where characters like Á, ÿ,
- f, and Ω are anchored, the ideographic baseline is
+ " src=images/baselines.png>x0066;, and Ω are anchored, the ideographic baseline is
where glyphs like 私 and 達 are anchored, and the bottom
of the em square is roughly at the bottom of the glyphs in a
font. The top and bottom of the bounding box can be far from these
- baselines, due to glyphs extending far outside the em square." src=images/baselines.png></p>
+ baselines, due to glyphs extending far outside the em square."></p>
<p>The keywords map to these alignment points as follows:</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>
+ must contain a <a href=#valid-non-empty-url>valid non-empty URL</a> referencing a
+ non-interactive, optionally animated, image resource that is neither
+ paged nor scripted.</p>
<div class=impl>
<p>When any of the following events occur, unless the user agent
cannot support images, or its support for images has been disabled,
- or the user agent only fetches elements on demand, the user agent
- must <a href=#resolve-a-url title="resolve a url">resolve</a> the value of the
- <code title=attr-input-src><a href=#attr-input-src>src</a></code> attribute, relative to the
+ or the user agent only fetches elements on demand, or the <code title=attr-input-src><a href=#attr-input-src>src</a></code> attribute's value is the empty
+ string, the user agent must <a href=#resolve-a-url title="resolve a
+ url">resolve</a> the value of the <code title=attr-input-src><a href=#attr-input-src>src</a></code> attribute, relative to the
element, and if that is successful, must <a href=#fetch>fetch</a> the
resulting <a href=#absolute-url>absolute URL</a>:</p> <!-- Note how this does NOT
happen when the base URL changes. --> <!-- http-origin privacy
attribute gives a picture that represents the command. If the
attribute is specified, the attribute's value must contain a
- <a href=#valid-url>valid URL</a>. <span class=impl>To obtain the
- <a href=#absolute-url>absolute URL</a> of the icon, the attribute's value must be
- <a href=#resolve-a-url title="resolve a url">resolved</a> relative to the
- element.</span></p> <!-- this is affected by the base URL being
+ <a href=#valid-non-empty-url>valid non-empty URL</a>. <span class=impl>To obtain the
+ <a href=#absolute-url>absolute URL</a> of the icon when the attribute's value is
+ not the empty string, the attribute's value must be <a href=#resolve-a-url title="resolve a url">resolved</a> relative to the element. When
+ the attribute is absent, or its value is the empty string, or <a href=#resolve-a-url title="resolve a url">resolving</a> its value fails, there is no
+ icon.</span></p> <!-- this is affected by the base URL being
changed, so users of this should cache the image once they've
fetched it once, at least until the relative url changes again -->
<p>If the root element, as parsed according to the XML
specifications cited above, is found to be an <code><a href=#the-html-element-0>html</a></code>
- element with an attribute <code title=attr-html-manifest><a href=#attr-html-manifest>manifest</a></code>, then, as soon as the
- element is <a href=#insert-an-element-into-a-document title="insert an element into a document">inserted
- into the document</a>, the user agent must <a href=#resolve-a-url title="resolve a
- url">resolve</a> the value of that attribute relative to that
- element, and if that is successful, must run the <a href=#concept-appcache-init title=concept-appcache-init>application cache selection
- algorithm</a> with the resulting <a href=#absolute-url>absolute URL</a> with
- any <a href=#url-fragment title=url-fragment><fragment></a> component
- removed as the manifest URL, and passing in the newly-created
- <code><a href=#document>Document</a></code>. Otherwise, if the attribute is absent or
- resolving it fails, then as soon as the root element is <a href=#insert-an-element-into-a-document title="insert an element into a document">inserted into the
- document</a>, the user agent must run the <a href=#concept-appcache-init title=concept-appcache-init>application cache selection
+ element with an attribute <code title=attr-html-manifest><a href=#attr-html-manifest>manifest</a></code> whose value is not the
+ empty string, then, as soon as the element is <a href=#insert-an-element-into-a-document title="insert an
+ element into a document">inserted into the document</a>, the user
+ agent must <a href=#resolve-a-url title="resolve a url">resolve</a> the value of
+ that attribute relative to that element, and if that is successful,
+ must run the <a href=#concept-appcache-init title=concept-appcache-init>application cache
+ selection algorithm</a> with the resulting <a href=#absolute-url>absolute
+ URL</a> with any <a href=#url-fragment title=url-fragment><fragment></a> component removed as
+ the manifest URL, and passing in the newly-created
+ <code><a href=#document>Document</a></code>. Otherwise, if the attribute is absent, its
+ value is the empty string, or resolving its value fails, then as
+ soon as the root element is <a href=#insert-an-element-into-a-document title="insert an element into a
+ document">inserted into the document</a>, the user agent must run
+ the <a href=#concept-appcache-init title=concept-appcache-init>application cache selection
algorithm</a> with no manifest, and passing in the
<p id=parser-appcache>If the <code><a href=#document>Document</a></code> is being
loaded as part of <a href=#navigate title=navigate>navigation</a> of a
<a href=#browsing-context>browsing context</a>, then: if the newly created element
- has a <code title=attr-html-manifest><a href=#attr-html-manifest>manifest</a></code> attribute,
- then <a href=#resolve-a-url title="resolve a url">resolve</a> the value of that
- attribute to an <a href=#absolute-url>absolute URL</a>, relative to the newly
- created element, and if that is successful, run the <a href=#concept-appcache-init title=concept-appcache-init>application cache selection
+ has a <code title=attr-html-manifest><a href=#attr-html-manifest>manifest</a></code> attribute
+ whose value is not the empty string, then <a href=#resolve-a-url title="resolve a
+ url">resolve</a> the value of that attribute to an
+ <a href=#absolute-url>absolute URL</a>, relative to the newly created element,
+ and if that is successful, run the <a href=#concept-appcache-init title=concept-appcache-init>application cache selection
algorithm</a> with the resulting <a href=#absolute-url>absolute URL</a> with
any <a href=#url-fragment title=url-fragment><fragment></a> component
- removed; otherwise, if there is no such attribute or resolving it
- fails, run the <a href=#concept-appcache-init title=concept-appcache-init>application
- cache selection algorithm</a> with no manifest. The algorithm
- must be passed the <code><a href=#document>Document</a></code> object.</p>
+ removed; otherwise, if there is no such attribute, or its value is
+ the empty string, or resolving its value fails, run the <a href=#concept-appcache-init title=concept-appcache-init>application cache selection
+ algorithm</a> with no manifest. The algorithm must be passed
+ the <code><a href=#document>Document</a></code> object.</p>
<p>Switch the <a href=#insertion-mode>insertion mode</a> to "<a href=#the-before-head-insertion-mode title="insertion mode: before head">before head</a>".</p>
attribute, if present, gives the <span>MIME type</span> by which the
@@ -22034,6 +22055,7 @@ href="?audio">audio</a> test instead.)</p></pre>
<li>The element is <span title="in a document">in a <code>Document</code></span>.</li>
<li>The element's <code>Document</code> is <span>fully active</span>.</li>
<li>The element has either a <code title="attr-embed-src">src</code> attribute set or a <code title="attr-embed-type">type</code> attribute set (or both).</li>
+ <li>The element's <code title="attr-embed-src">src</code> attribute is either absent or its value is the empty string.</li>
<li>The element is not in a <code>Document</code> whose <span>browsing context</span> had the <span>sandboxed plugins browsing context flag</span> set when the <code>Document</code> was created (unless this has been overrriden as described above).</li>
<li>The element's <code>Document</code> was not parsed from a resource whose <span title="Content-Type sniffing">sniffed type</span> as determined during <span title="navigate">navigation</span> is <code>text/html-sandboxed</code> (unless this has been overrriden as described above).</li>
<li>The element is not a descendant of a <span>media element</span>.</li>
@@ -22299,7 +22321,8 @@ href="?audio">audio</a> test instead.)</p></pre>
0 comments on commit
67e1bdc