HTML Standard Tracker

Filter

File a bug

SVNBugCommentTime (UTC)
668fix 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
@@ -1280,29 +1280,28 @@
    title="attr-id">id</code> attribute equal to <var
    title="">key</var>. (Non-HTML elements, even if they have IDs, are
    not searched for the purposes of <code
    title="dom-HTMLCollection-namedItem">namedItem()</code>.)</li>
 
   </ul>
 
   <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>
 
 
 
   <h5>HTMLFormControlsCollection</h5>
 
   <p>The <code>HTMLFormControlsCollection</code> interface represents
   a <span>collection</span> of form controls.</p>
 
   <pre class="idl">interface <dfn>HTMLFormControlsCollection</dfn> {
   readonly attribute unsigned long <span title="dom-HTMLFormControlsCollection-length">length</span>;
@@ -19124,29 +19123,46 @@ JSURI: http://ietfreport.isoc.org/all-ids/draft-hoehrmann-javascript-scheme-00.t
   title="attr-hyperlink-href">href</code> attribute of that hyperlink
   relative to the hyperlink's element. In the case of server-side
   image maps, the URI of the hyperlink must further have its
   <var>hyperlink suffix</var> appended to it.</p>
 
   <p>If the user indicated a specific browsing context when following
   the hyperlink, or if the user agent is configured to follow
   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
   context name</span>, using the value of the <code
   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>
 
 
 
   <h5>Hyperlink auditing</h5>
 
   <p>If an <code>a</code> or <code>area</code> hyperlink element has a
   <code title="attr-hyperlink-ping">ping</code> attribute and the user
@@ -19810,20 +19826,24 @@ mpt says:
   <p>The <code title="rel-sidebar">sidebar</code> keyword may be used
   with <code>link</code>, <code>a</code>, and <code>area</code>
   elements. For <code>link</code> elements, it creates a <span
   title="hyperlink link">hyperlink</span>.</p>
 
   <p>The <code title="rel-sidebar">sidebar</code> keyword indicates
   that the referenced document, if retrieved, is intended to be shown
   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
   with <code>link</code>, <code>a</code>, and <code>area</code>
   elements. For <code>link</code> elements, it creates a <span
   title="hyperlink link">hyperlink</span>.</p>
 
   <p>The <code title="rel-tag">tag</code> keyword indicates that the
   <em>tag</em> that the referenced document represents applies to the
@@ -20706,27 +20726,31 @@ mpt says:
 
   // defined in other sections
            attribute <span title="dom-Object">Object</span> <span>onerror</span>;
 
   // modal user prompts
   void <span title="dom-alert">alert</span>(in DOMString message);
   boolean <span title="dom-confirm">confirm</span>(in DOMString message);
   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
           http://msdn.microsoft.com/workshop/author/dhtml/reference/objects/obj_window.asp
           http://www.mozilla.org/docs/dom/domref/dom_window_ref.html
           http://lxr.mozilla.org/mozilla/source/dom/public/idl/base/nsIDOMWindow.idl
    -->
 
   <p>The <code>WindowHTML</code> object must provide the following
   constructors:</p>
@@ -20754,20 +20778,23 @@ mpt says:
    <dt><dfn title="dom-option"><code>Option()</code></dfn></dt>
    <dt><dfn title="dom-option-n"><code>Option(in DOMString <var title="">name</var>)</code></dfn></dt>
    <dt><dfn title="dom-option-nv"><code>Option(in DOMString <var title="">name</var>, in DOMString <var title="">value</var>)</code></dfn></dt>
 
    <dd><p>Constructs an <code>HTMLOptionElement</code> object (a new
    <code>option</code> element). <span class="big-issue">need to
    define argument processing</span></p></dd>
 
   </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>
 
   <!-- XXX would be nice to have an intro paragraph that DFNed session
   history instead of having the header do it -->
 
   <p><code>History</code> objects provide a representation of the
   pages in the session history of their <code>Window</code> object's
@@ -22782,22 +22809,48 @@ MAYBE WANT
   title="dom-open">window.open()</code> API to open a page in an
   iframe, but, while doing so, holds the control key down, the user
   agent could override the selection of the target browsing context to
   instead target a new tab.</p>
 
   <p>Then, the user agent must <span>navigate</span> the selected
   browsing context to the URI given in <var title="">url</var>. If the
   <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
   not start with a U+005F LOW LINE character, or, a string 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>

|