[html5] r1470 - /
whatwg at whatwg.org
whatwg at whatwg.org
Sun Apr 20 19:46:47 PDT 2008
Author: ianh
Date: 2008-04-20 19:46:46 -0700 (Sun, 20 Apr 2008)
New Revision: 1470
Modified:
index
source
Log:
[acio] (2) Introduce <object name> and <iframe name> to allow <a target> to load stuff in them.
Modified: index
===================================================================
--- index 2008-04-20 22:22:30 UTC (rev 1469)
+++ index 2008-04-21 02:46:46 UTC (rev 1470)
@@ -24,7 +24,7 @@
<h1 id=html-5>HTML 5</h1>
- <h2 class="no-num no-toc" id=working>Working Draft — 20 April 2008</h2>
+ <h2 class="no-num no-toc" id=working>Working Draft — 21 April 2008</h2>
<p>You can take part in this work. <a
href="http://www.whatwg.org/mailing-list">Join the working group's
@@ -7291,8 +7291,8 @@
the first are ignored.
<p>The <dfn id=target title=attr-base-target><code>target</code></dfn>
- attribute, if specified, must contain a <a href="#valid8">valid browsing
- context name</a>. User agents use this name when <a
+ attribute, if specified, must contain a <a href="#valid9">valid browsing
+ context name or keyword</a>. User agents use this name when <a
href="#following0">following hyperlinks</a>.
<p>A <code><a href="#base">base</a></code> element, if it has a <code
@@ -13615,12 +13615,15 @@
<dd><code title=attr-iframe-src><a href="#src1">src</a></code>
+ <dd><code title=attr-iframe-name><a href="#name1">name</a></code>
+
<dt>DOM interface:
<dd>
<pre
class=idl>interface <dfn id=htmliframeelement>HTMLIFrameElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
- attribute DOMString <a href="#src2" title=dom-iframe-src>src</a>;<!--
+ attribute DOMString <a href="#src2" title=dom-iframe-src>src</a>;
+ attribute DOMString <span title=dom-iframe-name>name</span>;<!--
readonly attribute Document <span title="dom-iframe-contentDocument">contentDocument</span>;
readonly attribute <span>Window</span> <span title="dom-iframe-contentWindow">contentWindow</span>;-->
};</pre>
@@ -13655,6 +13658,20 @@
attribute is not set when the element is created, the browsing context
will remain at the initial <code>about:blank</code><!-- XXX xref --> page.
+ <p>The <dfn id=name1 title=attr-iframe-name><code>name</code></dfn>
+ attribute, if present, must be a <a href="#valid8">valid browsing context
+ name</a>. When the browsing context is created, if the attribute is
+ present, the <a href="#browsing1">browsing context name</a> must be set to
+ the value of this attribute; otherwise, the <a href="#browsing1">browsing
+ context name</a> must be set to the empty string.
+
+ <p>Whenever the <code title=attr-iframe-name><a
+ href="#name1">name</a></code> attribute is set, the nested <a
+ href="#browsing0">browsing context</a>'s <a href="#browsing1"
+ title="browsing context name">name</a> must be changed to the new value.
+ If the attribute is removed, the <a href="#browsing1">browsing context
+ name</a> must be set to the empty string.
+
<p>When content loads in an <code><a href="#iframe">iframe</a></code>,
after any <code title=event-load><a href="#load0">load</a></code> events
are fired within the content itself, the user agent must <a
@@ -13907,6 +13924,10 @@
href="#data">data</a></code> and <code title=attr-object-type><a
href="#type6">type</a></code> attributes must be present.
+ <p>The <dfn id=name2 title=attr-object-name><code>name</code></dfn>
+ attribute, if present, must be a <a href="#valid8">valid browsing context
+ name</a>.
+
<p>Whenever the <code title=attr-object-data><a
href="#data">data</a></code> attribute changes, or, if the <code
title=attr-object-data><a href="#data">data</a></code> attribute is not
@@ -14023,6 +14044,12 @@
updated if the browsing context gets further navigated to other
locations.)</p>
+ <p>If the <code title=attr-object-name><a
+ href="#name2">name</a></code> attribute is present, the <a
+ href="#browsing1">browsing context name</a> must be set to the value
+ of this attribute; otherwise, the <a href="#browsing1">browsing
+ context name</a> must be set to the empty string.</p>
+
<p class=big-issue>navigation might end up treating it as something
else, because it can do sniffing. how should we handle that?</p>
@@ -14071,10 +14098,9 @@
<li>
<p>(Fallback.) The <code><a href="#object">object</a></code> element
- doesn't represent anything except what the element's contents represent,
- ignoring any leading <code><a href="#param">param</a></code> element
- children. This is the element's <a href="#fallback">fallback
- content</a>.
+ represents what the element's contents represent, ignoring any leading
+ <code><a href="#param">param</a></code> element children. This is the
+ element's <a href="#fallback">fallback content</a>.
</ol>
<p>In the absence of other factors (such as style sheets), user agents must
@@ -14087,6 +14113,16 @@
nested inside each other, targeting multiple user agents with different
capabilities, with the user agent picking the best one it supports.
+ <p>Whenever the <code title=attr-object-name><a
+ href="#name2">name</a></code> attribute is set, if the <code><a
+ href="#object">object</a></code> element has a nested <a
+ href="#browsing0">browsing context</a>, its <a href="#browsing1"
+ title="browsing context name">name</a> must be changed to the new value.
+ If the attribute is removed, if the <code><a
+ href="#object">object</a></code> element has a <a
+ href="#browsing0">browsing context</a>, the <a href="#browsing1">browsing
+ context name</a> must be set to the empty string.
+
<p>The <code title=attr-hyperlink-usemap><a
href="#usemap1">usemap</a></code> attribute, if present while the <code><a
href="#object">object</a></code> element represents an image, can indicate
@@ -14123,7 +14159,7 @@
<dt>Element-specific attributes:
- <dd><code title=attr-param-name><a href="#name1">name</a></code>
+ <dd><code title=attr-param-name><a href="#name3">name</a></code>
<dd><code title=attr-param-value><a href="#value5">value</a></code>
@@ -14132,7 +14168,7 @@
<dd>
<pre
class=idl>interface <dfn id=htmlparamelement>HTMLParamElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
- attribute DOMString <a href="#name2" title=dom-param-name>name</a>;
+ attribute DOMString <a href="#name4" title=dom-param-name>name</a>;
attribute DOMString <a href="#value6" title=dom-param-value>value</a>;
};</pre>
</dl>
@@ -14141,7 +14177,7 @@
for handlers invoked by <code><a href="#object">object</a></code>
elements.
- <p>The <dfn id=name1 title=attr-param-name><code>name</code></dfn>
+ <p>The <dfn id=name3 title=attr-param-name><code>name</code></dfn>
attribute gives the name of the parameter.
<p>The <dfn id=value5 title=attr-param-value><code>value</code></dfn>
@@ -14155,7 +14191,7 @@
id=parameter title=concept-param-parameters>parameter</dfn> with the given
name/value pair.
- <p>The DOM attributes <dfn id=name2
+ <p>The DOM attributes <dfn id=name4
title=dom-param-name><code>name</code></dfn> and <dfn id=value6
title=dom-param-value><code>value</code></dfn> must both <a
href="#reflect">reflect</a> the respective content attributes of the same
@@ -26415,13 +26451,16 @@
name</dfn>. By default, a browsing context has no name (its name is not
set).
- <p>A <dfn id=valid8>valid browsing context name</dfn> is any string that
- does not start with a U+005F LOW LINE character, or, a string that
- case-insensitively <!-- ASCII --> matches one of: <!--<code
+ <p>A <dfn id=valid8>valid browsing context name</dfn> is any string with at
+ least one character that does not start with a U+005F LOW LINE character.
+ (Names starting with an underscore are reserved for special keywords.)
+
+ <p>A <dfn id=valid9>valid browsing context name or keyword</dfn> is any
+ string that is either a <a href="#valid8">valid browsing context name</a>
+ or that case-insensitively <!-- ASCII --> matches one of: <!--<code
title="">_blank</code>,-->
<code title="">_self</code>, <code title="">_parent</code>, or <code
- title="">_top</code>. (Names starting with an underscore are reserved for
- special keywords.)
+ title="">_top</code>.
<p><dfn id=the-rules>The rules for chosing a browsing context given a
browsing context name</dfn> are as follows. The rules assume that they are
@@ -26519,7 +26558,7 @@
// the current browsing context
readonly attribute <a href="#window">Window</a> <a href="#window0" title=dom-window>window</a>;
readonly attribute <a href="#window">Window</a> <a href="#self" title=dom-self>self</a>;
- attribute DOMString <a href="#name3" title=dom-name>name</a>;
+ attribute DOMString <a href="#name5" title=dom-name>name</a>;
[PutForwards=href] readonly attribute <a href="#location2">Location</a> <a href="#location0" title=dom-document-location>location</a>;
readonly attribute <a href="#history1">History</a> <a href="#history0" title=dom-history>history</a>;
readonly attribute <a href="#undomanager">UndoManager</a> <a href="#undomanager0" title=dom-undoManager>undoManager</a>;
@@ -26711,9 +26750,9 @@
<p>The second argument, <var title="">target</var>, specifies the <a
href="#browsing1" title="browsing context name">name</a> of the browsing
- context that is to be navigated. It must be a <a href="#valid8">valid
- browsing context name</a>. If fewer than two arguments are provided, then
- the <var title="">name</var> argument defaults to the value
+ context that is to be navigated. It must be a <a href="#valid9">valid
+ browsing context name or keyword</a>. If fewer than two arguments are
+ provided, then the <var title="">name</var> argument defaults to the value
"<code>_blank</code>".
<p>The third argument, <var title="">features</var>, has no effect and is
@@ -26759,7 +26798,7 @@
context</a> that was navigated, or null if no browsing context was
navigated.
- <p>The <dfn id=name3 title=dom-name><code>name</code></dfn> attribute of
+ <p>The <dfn id=name5 title=dom-name><code>name</code></dfn> attribute of
the <code><a href="#window">Window</a></code> object must, on getting,
return the current name of the <a href="#browsing0">browsing context</a>,
and, on setting, set the name of the <a href="#browsing0">browsing
@@ -32530,8 +32569,9 @@
<p>The <dfn id=target3
title=attr-hyperlink-target><code>target</code></dfn> attribute, if
- present, must be a <a href="#valid8">valid browsing context name</a>. User
- agents use this name when <a href="#following0">following hyperlinks</a>.
+ present, must be a <a href="#valid9">valid browsing context name or
+ keyword</a>. User agents use this name when <a
+ href="#following0">following hyperlinks</a>.
<p>The <dfn id=ping title=attr-hyperlink-ping><code>ping</code></dfn>
attribute, if present, gives the URIs of the resources that are interested
Modified: source
===================================================================
--- source 2008-04-20 22:22:30 UTC (rev 1469)
+++ source 2008-04-21 02:46:46 UTC (rev 1470)
@@ -5735,8 +5735,8 @@
<p>The <dfn title="attr-base-target"><code>target</code></dfn>
attribute, if specified, must contain a <span>valid browsing context
- name</span>. User agents use this name when <span>following
- hyperlinks</span>.</p>
+ name or keyword</span>. User agents use this name when
+ <span>following hyperlinks</span>.</p>
<p>A <code>base</code> element, if it has a <code
title="attr-base-target">target</code> attribute, must come before
@@ -11629,10 +11629,12 @@
<dd>Text that conforms to the requirements given in the prose.</dd>
<dt>Element-specific attributes:</dt>
<dd><code title="attr-iframe-src">src</code></dd>
+ <dd><code title="attr-iframe-name">name</code></dd>
<dt>DOM interface:</dt>
<dd>
<pre class="idl">interface <dfn>HTMLIFrameElement</dfn> : <span>HTMLElement</span> {
- attribute DOMString <span title="dom-iframe-src">src</span>;<!--
+ attribute DOMString <span title="dom-iframe-src">src</span>;
+ attribute DOMString <span title="dom-iframe-name">name</span>;<!--
readonly attribute Document <span title="dom-iframe-contentDocument">contentDocument</span>;
readonly attribute <span>Window</span> <span title="dom-iframe-contentWindow">contentWindow</span>;-->
};</pre>
@@ -11665,6 +11667,19 @@
set when the element is created, the browsing context will remain at
the initial <code>about:blank</code><!-- XXX xref --> page.</p>
+ <p>The <dfn title="attr-iframe-name"><code>name</code></dfn>
+ attribute, if present, must be a <span>valid browsing context
+ name</span>. When the browsing context is created, if the attribute
+ is present, the <span>browsing context name</span> must be set to
+ the value of this attribute; otherwise, the <span>browsing context
+ name</span> must be set to the empty string.</p>
+
+ <p>Whenever the <code title="attr-iframe-name">name</code> attribute
+ is set, the nested <span>browsing context</span>'s <span
+ title="browsing context name">name</span> must be changed to the new
+ value. If the attribute is removed, the <span>browsing context
+ name</span> must be set to the empty string.</p>
+
<p>When content loads in an <code>iframe</code>, after any <code
title="event-load">load</code> events are fired within the content
itself, the user agent must <span>fire a <code
@@ -11890,6 +11905,10 @@
<code title="attr-object-type">type</code> attributes must be
present.</p>
+ <p>The <dfn title="attr-object-name"><code>name</code></dfn>
+ attribute, if present, must be a <span>valid browsing context
+ name</span>.</p>
+
<p>Whenever the <code title="attr-object-data">data</code> attribute
changes, or, if the <code title="attr-object-data">data</code>
attribute is not present, whenever the <code
@@ -12016,6 +12035,11 @@
browsing context gets further navigated to other
locations.)</p>
+ <p>If the <code title="attr-object-name">name</code> attribute
+ is present, the <span>browsing context name</span> must be set
+ to the value of this attribute; otherwise, the <span>browsing
+ context name</span> must be set to the empty string.</p>
+
<p class="big-issue">navigation might end up treating it as
something else, because it can do sniffing. how should we
handle that?</p>
@@ -12073,10 +12097,10 @@
<span>browsing context</span>. If no suitable handler can be found,
jump to the next step (fallback).</p></li>
- <li><p>(Fallback.) The <code>object</code> element doesn't
- represent anything except what the element's contents represent,
- ignoring any leading <code>param</code> element children. This is
- the element's <span>fallback content</span>.</li>
+ <li><p>(Fallback.) The <code>object</code> element represents what
+ the element's contents represent, ignoring any leading
+ <code>param</code> element children. This is the element's
+ <span>fallback content</span>.</li>
</ol>
@@ -12090,6 +12114,14 @@
different capabilities, with the user agent picking the best one it
supports.</p>
+ <p>Whenever the <code title="attr-object-name">name</code> attribute
+ is set, if the <code>object</code> element has a nested
+ <span>browsing context</span>, its <span title="browsing context
+ name">name</span> must be changed to the new value. If the attribute
+ is removed, if the <code>object</code> element has a <span>browsing
+ context</span>, the <span>browsing context name</span> must be set
+ to the empty string.</p>
+
<p>The <code title="attr-hyperlink-usemap">usemap</code> attribute,
if present while the <code>object</code> element represents an
image, can indicate that the object has an associated <span>image
@@ -24096,12 +24128,16 @@
<p>Browsing contexts can have a <dfn>browsing context name</dfn>. By
default, a browsing context has no name (its name is not set).</p>
- <p>A <dfn>valid browsing context name</dfn> is any string that does
- not start with a U+005F LOW LINE character, or, a string that
+ <p>A <dfn>valid browsing context name</dfn> is any string with at
+ least one character that does not start with a U+005F LOW LINE
+ character. (Names starting with an underscore are reserved for
+ special keywords.)</p>
+
+ <p>A <dfn>valid browsing context name or keyword</dfn> is any string
+ that is either a <span>valid browsing context name</span> or that
case-insensitively <!-- ASCII --> matches one of: <!--<code
title="">_blank</code>,--> <code title="">_self</code>, <code
- title="">_parent</code>, or <code title="">_top</code>. (Names
- starting with an underscore are reserved for special keywords.)</p>
+ title="">_parent</code>, or <code title="">_top</code>.</p>
<p><dfn>The rules for chosing a browsing context given a browsing
context name</dfn> are as follows. The rules assume that they are
@@ -24401,9 +24437,9 @@
<p>The second argument, <var title="">target</var>, specifies the
<span title="browsing context name">name</span> of the browsing
context that is to be navigated. It must be a <span>valid browsing
- context name</span>. If fewer than two arguments are provided, then
- the <var title="">name</var> argument defaults to the value
- "<code>_blank</code>".</p>
+ context name or keyword</span>. If fewer than two arguments are
+ provided, then the <var title="">name</var> argument defaults to the
+ value "<code>_blank</code>".</p>
<p>The third argument, <var title="">features</var>, has no effect
and is supported for historical reasons only.</p>
@@ -30252,8 +30288,8 @@
</div>
<p>The <dfn title="attr-hyperlink-target"><code>target</code></dfn>
- attribute, if present, must be a <span>valid browsing context
- name</span>. User agents use this name when <span>following
+ attribute, if present, must be a <span>valid browsing context name
+ or keyword</span>. User agents use this name when <span>following
hyperlinks</span>.</p>
<p>The <dfn id="ping"
More information about the Commit-Watchers
mailing list