[html5] r1783 - /
whatwg at whatwg.org
whatwg at whatwg.org
Tue Jun 17 20:37:27 PDT 2008
Author: ianh
Date: 2008-06-17 20:37:26 -0700 (Tue, 17 Jun 2008)
New Revision: 1783
Modified:
index
source
Log:
[e] (0) more notes for the upcoming url rework
Modified: index
===================================================================
--- index 2008-06-17 23:06:58 UTC (rev 1782)
+++ index 2008-06-18 03:37:26 UTC (rev 1783)
@@ -25,7 +25,7 @@
<h1 id=html-5>HTML 5</h1>
- <h2 class="no-num no-toc" id=draft>Draft Recommendation — 17 June
+ <h2 class="no-num no-toc" id=draft>Draft Recommendation — 18 June
2008</h2>
<p>You can take part in this work. <a
@@ -24110,7 +24110,7 @@
<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.</p>
- <!--XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -->
+ <!-- XXXURL refer to new algorithms -->
<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
@@ -24119,7 +24119,8 @@
href="#addeventsource">addEventSource()</a></code> method on the <code><a
href="#event-source">event-source</a></code> element had been invoked with
the URI resulting from resolving the <code title=attr-event-source-src><a
- href="#src11">src</a></code> attribute's value to an absolute URI.
+ href="#src11">src</a></code> attribute's value to an absolute URI.</p>
+ <!-- XXXURL refer to new algorithms -->
<p>While the element is in a document, if its <code
title=attr-event-source-src><a href="#src11">src</a></code> attribute is
@@ -24133,7 +24134,8 @@
href="#addeventsource">addEventSource()</a></code> method on the element
had been invoked with the URI resulting from resolving the <em>new</em>
value of the <code title=attr-event-source-src><a
- href="#src11">src</a></code> attribute to an absolute URI.
+ href="#src11">src</a></code> attribute to an absolute URI.</p>
+ <!-- XXXURL refer to new algorithms -->
<p>When the element is removed from the document, if it has the <code
title=attr-event-source-src><a href="#src11">src</a></code> attribute
@@ -24551,7 +24553,8 @@
<dt><dfn id=getrowimage
title=dom-provider-getRowImage><code>getRowImage(<var
- title="">row</var>)</code></dfn>
+ title="">row</var>)</code></dfn></dt>
+ <!-- XXXURL just say "the URL of" -->
<dd>Must return a URI to an image that represents row <var
title="">row</var>, or the empty string if there is no applicable image.
@@ -25026,7 +25029,8 @@
<p class=note>The <code>colspan</code> and <code>rowspan</code>
attributes are <a href="#ignored" title=ignore>ignored</a> by this
algorithm.</p>
-
+ <!-- XXXURL take the string from the <img> and absolutify it and return that. -->
+
<p><strong><code title=dom-provider-getRowImage><a
href="#getrowimage">getRowImage(<var
title="">i</var>)</a></code></strong>: If the row's first cell's element
@@ -25279,7 +25283,7 @@
<var title="">position</var>)</a></code> must return <var
title="">position</var>. (The generic default data provider does not
support sorting the data grid.)</p>
-
+ <!-- XXXURL absolutify the URL here -->
<p><code title=dom-provider-getRowImage><a
href="#getrowimage">getRowImage(<var title="">i</var>)</a></code> must
return the URI of the image given by the first <code><a
@@ -25287,7 +25291,7 @@
row's element, that is not also a descendant of another element in the
filtered view that is a descendant of the row's element.</p>
- <div class=example>
+ <div class=example> <!-- XXXURL change to URL -->
<p>In the following example, the row with path "1,0" returns
"http://example.com/a" as its image URI, and the other rows (including
the row with path "1") return the empty string:</p>
@@ -25797,8 +25801,10 @@
provide the user with a method for requesting that the row be
deleted.</dd>
-->
+ <!-- XXXURL change to URL? -->
- <dt>To obtain a URI to an image representing a row
+ <dt>To obtain a URI to an image representing a row</dt>
+ <!-- XXXURL define how to absolutify -->
<dd>Invoke the <code title=dom-provider-getRowImage><a
href="#getrowimage">getRowImage()</a></code> method with a <code><a
@@ -26929,7 +26935,8 @@
<dt><dfn id=icon1 title=command-facet-Icon>Icon</dfn>
- <dd>A graphical image that represents the action.
+ <dd>A graphical image that represents the action.</dd>
+ <!-- XXXURL define it to be an asbolute URL? -->
<dt><dfn id=hidden1 title=command-facet-HiddenState>Hidden State</dfn>
@@ -26950,7 +26957,8 @@
<dd>Whether the command is checked or not.
- <dt><dfn id=action title=command-facet-Action>Action</dfn>
+ <dt><dfn id=action title=command-facet-Action>Action</dfn></dt>
+ <!-- XXXURL change to URL -->
<dd>The actual effect that triggering the command will have. This could be
a scripted event handler, a URI to which to navigate, or a form
@@ -27031,7 +27039,8 @@
a command or does not specify a <a href="#hint"
title=command-facet-Hint>Hint</a>. This attribute will be shadowed by the
<code title=dom-title><a href="#title0">title</a></code> DOM attribute on
- the <code><a href="#htmlelement">HTMLElement</a></code> interface.
+ the <code><a href="#htmlelement">HTMLElement</a></code> interface.</p>
+ <!-- XXXURL "must return the absolute URL of the command's icon"? -->
<p>The <dfn id=icon2 title=dom-command-ro-icon><code>icon</code></dfn>
attribute must return an absolute URI to the command's <a href="#icon1"
@@ -27125,7 +27134,8 @@
the value of the <code title=attr-title><a href="#title">title</a></code>
attribute of the <code><a href="#a">a</a></code> element. If the attribute
is not present, the <a href="#hint" title=command-facet-Hint>Hint</a> is
- the empty string.
+ the empty string.</p>
+ <!-- XXXURL refer to the URL algorithms -->
<p>The <a href="#icon1" title=command-facet-Icon>Icon</a> of the command is
the absolute URI of the first image in the element. Specifically, in a
@@ -27344,7 +27354,8 @@
<p>The <a href="#hint" title=command-facet-Hint>Hint</a> of the command is
the string given by the element's <code title=attr-command-title><a
href="#title6">title</a></code> attribute, if any, and the empty string if
- the attribute is absent.
+ the attribute is absent.</p>
+ <!-- XXXURL refer to the URL algorithms -->
<p>The <a href="#icon1" title=command-facet-Icon>Icon</a> for the command
is the absolute URI resulting from resolving the value of the element's
@@ -27377,6 +27388,7 @@
interface.</p>
<!-- XXX update to
point to dom-click when we remove dom-command-click -->
+ <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -->
<h3 id=datatemplate><span class=secno>3.16 </span>Data Templates</h3>
Modified: source
===================================================================
--- source 2008-06-17 23:06:58 UTC (rev 1782)
+++ source 2008-06-18 03:37:26 UTC (rev 1783)
@@ -21907,8 +21907,7 @@
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 -->
-
+ <!-- XXXURL refer to new algorithms -->
<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
@@ -21918,6 +21917,7 @@
title="attr-event-source-src">src</code> attribute's value to an
absolute URI.</p>
+ <!-- XXXURL refer to new algorithms -->
<p>While the element is in a document, if its <code
title="attr-event-source-src">src</code> attribute is mutated, the
user agent must act as if first the <code
@@ -21931,6 +21931,7 @@
title="attr-event-source-src">src</code> attribute to an absolute
URI.</p>
+ <!-- XXXURL refer to new algorithms -->
<p>When the element is removed from the document, if it has the
<code title="attr-event-source-src">src</code> attribute specified,
or, when the <code title="attr-event-source-src">src</code>
@@ -22298,6 +22299,7 @@
<dt><dfn title="dom-provider-getRowImage"><code>getRowImage(<var title="">row</var>)</code></dfn></dt>
+ <!-- XXXURL just say "the URL of" -->
<dd>Must return a URI to an image that represents row <var
title="">row</var>, or the empty string if there is no applicable
image. May be omitted if no rows have associated images. If the
@@ -22701,6 +22703,7 @@
attributes are <span title="ignore">ignored</span> by this
algorithm.</p>
+ <!-- XXXURL take the string from the <img> and absolutify it and return that. -->
<p><strong><code title="dom-provider-getRowImage">getRowImage(<var
title="">i</var>)</code></strong>: If the row's first cell's
element has an <code>img</code> element child, then the URI of the
@@ -22957,6 +22960,7 @@
return <var title="">position</var>. (The generic default data
provider does not support sorting the data grid.)</p>
+ <!-- XXXURL absolutify the URL here -->
<p><code title="dom-provider-getRowImage">getRowImage(<var
title="">i</var>)</code> must return the URI of the image given by
the first <code>img</code> element descendant (in the real DOM) of
@@ -22966,6 +22970,7 @@
<div class="example">
+ <!-- XXXURL change to URL -->
<p>In the following example, the row with path "1,0" returns
"http://example.com/a" as its image URI, and the other rows
(including the row with path "1") return the empty string:</p>
@@ -23495,8 +23500,11 @@
provide the user with a method for requesting that the row be
deleted.</dd>
-->
+
+ <!-- XXXURL change to URL? -->
<dt>To obtain a URI to an image representing a row</dt>
+ <!-- XXXURL define how to absolutify -->
<dd>Invoke the <code
title="dom-provider-getRowImage">getRowImage()</code> method with a
<code>RowSpecification</code> object representing the row in
@@ -24577,7 +24585,7 @@
<dt><dfn title="command-facet-Icon">Icon</dfn></dt>
- <dd>A graphical image that represents the action.</dd>
+ <dd>A graphical image that represents the action.</dd> <!-- XXXURL define it to be an asbolute URL? -->
<dt><dfn title="command-facet-HiddenState">Hidden State</dfn></dt>
@@ -24600,6 +24608,7 @@
<dt><dfn title="command-facet-Action">Action</dfn></dt>
+ <!-- XXXURL change to URL -->
<dd>The actual effect that triggering the command will have. This
could be a scripted event handler, a URI to which to navigate, or a
form submission.</dd>
@@ -24682,6 +24691,7 @@
shadowed by the <code title="dom-title">title</code> DOM attribute
on the <code>HTMLElement</code> interface.</p>
+ <!-- XXXURL "must return the absolute URL of the command's icon"? -->
<p>The <dfn title="dom-command-ro-icon"><code>icon</code></dfn>
attribute must return an absolute URI to the command's <span
title="command-facet-Icon">Icon</span>. If the element does not
@@ -24777,6 +24787,7 @@
<span title="command-facet-Hint">Hint</span> is the empty
string.</p>
+ <!-- XXXURL refer to the URL algorithms -->
<p>The <span title="command-facet-Icon">Icon</span> of the command
is the absolute URI of the first image in the element. Specifically,
in a depth-first search of the children of the element, the first
@@ -24995,6 +25006,7 @@
title="attr-command-title">title</code> attribute, if any, and the
empty string if the attribute is absent.</p>
+ <!-- XXXURL refer to the URL algorithms -->
<p>The <span title="command-facet-Icon">Icon</span> for the command
is the absolute URI resulting from resolving the value of the
element's <code title="attr-command-icon">icon</code> attribute as a
@@ -25025,7 +25037,9 @@
point to dom-click when we remove dom-command-click -->
+<!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -->
+
<h3 id="datatemplate">Data Templates</h3>
<h4>Introduction</h4>
More information about the Commit-Watchers
mailing list