Skip to content

Commit

Permalink
[e] (0) more notes for the upcoming URL revolution
Browse files Browse the repository at this point in the history
git-svn-id: http://svn.whatwg.org/webapps@1782 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
Hixie committed Jun 17, 2008
1 parent 2967d58 commit cc49b3b
Show file tree
Hide file tree
Showing 2 changed files with 36 additions and 19 deletions.
33 changes: 21 additions & 12 deletions index
Expand Up @@ -14736,8 +14736,7 @@ the time Marco had stuck his tongue out...&lt;/p></pre>

<p>The <dfn id=src3 title=attr-embed-src><code>src</code></dfn> attribute
gives the address of the resource being embedded. The attribute must be
present and contain a valid URI (or IRI).</p>
<!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -->
present and contain a valid URI (or IRI).

<p>If the <code title=attr-embed-src><a href="#src3">src</a></code>
attribute is missing, then the <code><a href="#embed">embed</a></code>
Expand Down Expand Up @@ -16085,6 +16084,8 @@ the time Marco had stuck his tongue out...&lt;/p></pre>
<li>
<p>Let the <var title="">chosen resource's pixel ratio override</var> be
<i>none</i>.
</li>
<!-- XXXURL pass the attribute value to the last step -->

<li>
<p>If the <a href="#media7">media element</a> has a <code
Expand Down Expand Up @@ -16134,7 +16135,7 @@ the time Marco had stuck his tongue out...&lt;/p></pre>

<p>...then the <var title="">candidate</var> is not suitable; go to the
next step.</p>

<!-- XXXURL pass the attribute value to the last step -->
<p>Otherwise, the address given in that <var title="">candidate</var>
element's <code title=attr-source-src><a href="#src5">src</a></code>
attribute is the address of the <a href="#media10">media resource</a>;
Expand All @@ -16152,6 +16153,9 @@ the time Marco had stuck his tongue out...&lt;/p></pre>

<li>
<p>There is no <a href="#media10">media resource</a>. Abort these steps.
</li>
<!-- XXXURL resolve the url of the attribute value passed to this step here -->
<!-- XXXURL define "address of the chosen media resource" and make sure the next paragraph uses it -->

<li>
<p>Let the address of the <dfn id=chosen>chosen media resource</dfn> be
Expand All @@ -16165,8 +16169,8 @@ the time Marco had stuck his tongue out...&lt;/p></pre>
must return the empty string if the <a href="#media7">media element</a>'s
<code title=dom-media-networkState><a
href="#networkstate">networkState</a></code> has the value <a
href="#empty" title=dom-media-EMPTY>EMPTY</a>, and the absolute URI of the
<a href="#chosen">chosen media resource</a> otherwise.
href="#empty" title=dom-media-EMPTY>EMPTY</a>, and the address of the <a
href="#chosen">chosen media resource</a> otherwise.

<h5 id=network0><span class=secno>3.11.10.3. </span>Network states</h5>

Expand Down Expand Up @@ -18306,19 +18310,22 @@ the time Marco had stuck his tongue out...&lt;/p></pre>
occur if a method was called with the wrong number of arguments).

<p class=note>A future version of this specification will probably define a
<code>3d</code> context (probably based on the OpenGL ES API).
<code>3d</code> context (probably based on the OpenGL ES API).</p>
<!-- XXXURL data: URIs? -->

<p>The <dfn id=todataurl
title=dom-canvas-toDataURL><code>toDataURL()</code></dfn> method must,
when called with no arguments, return a <code title="">data:</code> URI
containing a representation of the image as a PNG file. <a
href="#refsPNG">[PNG]</a>.
href="#refsPNG">[PNG]</a>.</p>
<!-- XXXURL data: URIs? -->

<p>If the canvas has no pixels (i.e. either its horizontal dimension or its
vertical dimension is zero) then the method must return the string "<code
title="">data:,</code>". (This is the shortest <code title="">data:</code>
URI; it represents the empty string in a <code title="">text/plain</code>
resource.)
resource.)</p>
<!-- XXXURL data: URIs? -->

<p>The <dfn id=todataurl0
title=dom-canvas-toDataURL-type><code>toDataURL(<var
Expand All @@ -18332,13 +18339,14 @@ the time Marco had stuck his tongue out...&lt;/p></pre>

<p>Only support for <code>image/png</code> is required. User agents may
support other types. If the user agent does not support the requested
type, it must return the image using the PNG format.
type, it must return the image using the PNG format.</p>
<!-- XXXURL data: URIs? -->

<p>User agents must convert the provided type to lower case before
establishing if they support that type and before creating the <code
title="">data:</code> URI.</p>
<!-- XXX define "convert to lower case"
-->
<!-- XXX define "convert to lower
case" -->

<p class=note>When trying to use types other than <code>image/png</code>,
authors can check if the image was really returned in the requested format
Expand Down Expand Up @@ -24101,7 +24109,8 @@ function AddCloud(data, x, y) { ... }</pre>

<p>The <dfn id=src11 title=attr-event-source-src><code>src</code></dfn>
attribute, if specified, must give a valid URI (or IRI) pointing to a
resource that uses the <code>text/event-stream</code> format.
resource that uses the <code>text/event-stream</code> format.</p>
<!--XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -->

<p>When the element is inserted into the document, if it has the <code
title=attr-event-source-src><a href="#src11">src</a></code> attribute
Expand Down
22 changes: 15 additions & 7 deletions source
Expand Up @@ -12670,8 +12670,6 @@ the time Marco had stuck his tongue out...&lt;/p></pre>
gives the address of the resource being embedded. The attribute must
be present and contain a valid URI (or IRI).</p>

<!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -->

<p>If the <code title="attr-embed-src">src</code> attribute is
missing, then the <code>embed</code> element must be ignored (it
represents nothing).</p>
Expand Down Expand Up @@ -13954,6 +13952,7 @@ the time Marco had stuck his tongue out...&lt;/p></pre>
<li><p>Let the <var title="">chosen resource's pixel ratio
override</var> be <i>none</i>.</p></li>

<!-- XXXURL pass the attribute value to the last step -->
<li><p>If the <span>media element</span> has a <code
title="attr-media-src">src</code>, then the address given in that
attribute is the address of the <span>media resource</span>; jump
Expand Down Expand Up @@ -14003,6 +14002,7 @@ the time Marco had stuck his tongue out...&lt;/p></pre>
<p>...then the <var title="">candidate</var> is not suitable; go
to the next step.</p>

<!-- XXXURL pass the attribute value to the last step -->
<p>Otherwise, the address given in that <var
title="">candidate</var> element's <code
title="attr-source-src">src</code> attribute is the address of the
Expand All @@ -14021,6 +14021,8 @@ the time Marco had stuck his tongue out...&lt;/p></pre>
<li><p>There is no <span>media resource</span>. Abort these
steps.</p></li>

<!-- XXXURL resolve the url of the attribute value passed to this step here -->
<!-- XXXURL define "address of the chosen media resource" and make sure the next paragraph uses it -->
<li><p>Let the address of the <dfn>chosen media resource</dfn> be
the one that was found before jumping to this step, and let its
<dfn>pixel ratio override</dfn> be the value of the <var
Expand All @@ -14033,8 +14035,8 @@ the time Marco had stuck his tongue out...&lt;/p></pre>
attribute must return the empty string if the <span>media
element</span>'s <code
title="dom-media-networkState">networkState</code> has the value
<span title="dom-media-EMPTY">EMPTY</span>, and the absolute URI of
the <span>chosen media resource</span> otherwise.</p>
<span title="dom-media-EMPTY">EMPTY</span>, and the address of the
<span>chosen media resource</span> otherwise.</p>



Expand Down Expand Up @@ -15907,18 +15909,21 @@ the time Marco had stuck his tongue out...&lt;/p></pre>
API).</p>


<!-- XXXURL data: URIs? -->
<p>The <dfn
title="dom-canvas-toDataURL"><code>toDataURL()</code></dfn> method
must, when called with no arguments, return a <code
title="">data:</code> URI containing a representation of the image
as a PNG file. <a href="#refsPNG">[PNG]</a>.</p>

<!-- XXXURL data: URIs? -->
<p>If the canvas has no pixels (i.e. either its horizontal dimension
or its vertical dimension is zero) then the method must return the
string "<code title="">data:,</code>". (This is the shortest <code
title="">data:</code> URI; it represents the empty string in a <code
title="">text/plain</code> resource.)</p>

<!-- XXXURL data: URIs? -->
<p>The <dfn title="dom-canvas-toDataURL-type"><code>toDataURL(<var
title="">type</var>)</code></dfn> method (when called with one
<em>or more</em> arguments) must return a <code title="">data:</code> URI
Expand All @@ -15933,10 +15938,11 @@ the time Marco had stuck his tongue out...&lt;/p></pre>
may support other types. If the user agent does not support the
requested type, it must return the image using the PNG format.</p>

<!-- XXXURL data: URIs? -->
<p>User agents must convert the provided type to lower case before
establishing if they support that type and before creating the
<code title="">data:</code> URI.</p> <!-- XXX define "convert to lower case"
-->
establishing if they support that type and before creating the <code
title="">data:</code> URI.</p> <!-- XXX define "convert to lower
case" -->

<p class="note">When trying to use types other than
<code>image/png</code>, authors can check if the image was really
Expand Down Expand Up @@ -21901,6 +21907,8 @@ function AddCloud(data, x, y) { ... }</pre>
attribute, if specified, must give a valid URI (or IRI) pointing to
a resource that uses the <code>text/event-stream</code> format.</p>

<!--XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -->

<p>When the element is inserted into the document, if it has the
<code title="attr-event-source-src">src</code> attribute specified,
the user agent must act as if the <code
Expand Down

0 comments on commit cc49b3b

Please sign in to comment.