Short URL: http://html5.org/r/668
| SVN | Bug | Comment | Time (UTC) |
|---|---|---|---|
| 668 | fix how we talk about objects that implement the [] syntax. grammar fix. support rel=sidebar and <base>; window, frames, self; length, opener, window[]. all very much WIP. | 2007-03-06 06:23 |
Index: source =================================================================== --- source (revision 667) +++ source (revision 668) @@ -1287,15 +1287,14 @@ <p>If no such elements are found, then the method must return null.</p> - <p>In the ECMAScript DOM binding, objects implementing the - <code>HTMLCollection</code> interface must support being - dereferenced using the square bracket notation, such that - dereferencing with an integer index is equivalent to invoking the - <code title="dom-HTMLCollection-item">item()</code> method with that - index, and such that dereferencing with a string index is equivalent - to invoking the <code - title="dom-HTMLCollection-namedItem">namedItem()</code> method with - that index.</p> + <p>In ECMAScript implementations, objects that implement the + <code>HTMLCollection</code> interface must also have a [[Get]] + method that, when invoked with a property name that is a number, + acts like the <code title="dom-HTMLCollection-item">item()</code> + method would when invoked with that argument, and when invoked with + a property name that is a string, acts like the <code + title="dom-HTMLCollection-namedItem">namedItem()</code> method would + when invoked with that argument.</p> @@ -19131,8 +19130,8 @@ hyperlinks by navigating a particular browsing context, then that is the browsing context that must be navigated.</p> - <p>Otherwise, if the hyperlink element is a <code>a</code> or - <code>area</code> element and has a <code + <p>Otherwise, if the hyperlink element is an <code>a</code> or + <code>area</code> element that has a <code title="attr-hyperlink-target">target</code> attribute, then the browsing context that is navigated must be chosen by applying <span>the rules for chosing a browsing context given a browsing @@ -19140,6 +19139,23 @@ title="attr-hyperlink-target">target</code> attribute as the browsing context name.</p> + <p>Otherwise, if the hyperlink element is a <span + title="rel-sidebar-hyperlink">sidebar hyperlink</span> and the user + agent implements a feature that can be considered a secondary + browsing context, such a secondary browsing context may be selected + as the browsing context to be navigated.</p> + + <p>Otherwise, if the hyperlink element is an <code>a</code> or + <code>area</code> element with no <code + title="attr-hyperlink-target">target</code> attribute, but there is + a <code>base</code> element with a <code + title="attr-base-target">target</code> attribute in the document, + then the browsing context that is navigated must be chosen by + applying <span>the rules for chosing a browsing context given a + browsing context name</span>, using the value of the <code + title="attr-base-target">target</code> attribute of the first such + <code>base</code> element as the browsing context name.</p> + <p>Otherwise, the browsing context that must be navigated is the same browsing context as the one which the hyperlink element itself is in.</p> @@ -19817,7 +19833,11 @@ in a secondary browsing context (if possible), instead of in the current browsing context.</p> + <p>A <span title="hyperlink">hyperlink element</span> with with the + <code title="rel-sidebar">sidebar</code> keyword specified is a <dfn + title="rel-sidebar-hyperlink">sidebar hyperlink</dfn>.</p> + <h5>Link type "<dfn title="rel-tag"><code>tag</code></dfn>"</h5> <p>The <code title="rel-tag">tag</code> keyword may be used @@ -20713,13 +20733,17 @@ DOMString <span title="dom-prompt">prompt</span>(in DOMString message); DOMString <span title="dom-prompt">prompt</span>(in DOMString message, in DOMString default); - // auxillary browsing contexts + // browsing contexts + readonly attribute <span>Window</span> <span title="dom-window">window</span>; + readonly attribute <span>Window</span> <span title="dom-frames">frames</span>; + readonly attribute <span>Window</span> <span title="dom-self">self</span>; + readonly attribute unsigned long <span title="dom-length">length</span>; + readonly attribute <span>Window</span> <span title="dom-opener">opener</span>; <span>Window</span> <span title="dom-open">open</span>(); <span>Window</span> <span title="dom-open">open</span>(in DOMString url); <span>Window</span> <span title="dom-open">open</span>(in DOMString url, in DOMString target); <span>Window</span> <span title="dom-open">open</span>(in DOMString url, in DOMString target, in DOMString features); <span>Window</span> <span title="dom-open">open</span>(in DOMString url, in DOMString target, in DOMString features, in DOMString replace); - readonly attribute <span>Window</span> <span title="dom-opener">opener</span>; };</pre> <!-- XXX XMLHttpRequest @@ -20761,7 +20785,10 @@ </dl> + <p class="note"><code>Window</code> objects also <span + title="dom-item">have an implicit [[Get]] method</span>.</p> + <h3 id="history">Session history and navigation</h3> <h4>The <dfn>session history</dfn> of browsing contexts</h4> @@ -22789,10 +22816,36 @@ <var title="">replace</var> is true, then <span title="replacement enabled">replacement must be enabled</span>.</p> - <p class="big-issue">The <dfn - title="dom-opener"><code>opener</code></dfn> DOM attribute...</p> + <h4>Accessing other browsing contexts</h4> + + <p>The <dfn title="dom-opener"><code>opener</code></dfn> DOM + attribute on the <code>Window</code> object must return the + <code>Window</code> object of the browsing context from which the + current browsing context was created, if there is one and it is + still available.</p> + + <p>In ECMAScript implementations, objects that implement the + <code>WindowHTML</code> interface must also have a <dfn + title="dom-item">[[Get]]</dfn> method that, when invoked with a + property name that is a number <var title="">i</var>, returns the + <var title="">i</var>th <span>child browsing context</span><!-- XXX + xref --> of the current <code>Document</code>.</p> + + <p>The <dfn title="dom-length"><code>length</code></dfn> DOM + attribute on the <code>WindowHTML</code> interface must return the + number of <span title="child browsing context">child browsing + contexts</span><!-- XXX xref --> of the current + <code>Document</code>.</p> + + <p>The <dfn title="dom-window"><code>window</code></dfn>, <dfn + title="dom-frames"><code>frames</code></dfn>, <dfn + title="dom-self"><code>self</code></dfn> DOM attributes must all + return the <code>Window</code> object itself.</p> + + + <h4>Browsing context names</h4> <p>A <dfn>valid browsing context name</dfn> is any string that does