HTML Standard Tracker

Filter

File a bug

SVNBugCommentTime (UTC)
2068Define window.frameElement.2008-08-13 00:41
@@ -28792,28 +28792,30 @@ never reset. This is nice and consistent.)
 
   </dl>
 
 
   <h4>Nested browsing contexts</h4>
 
   <p>Certain elements (for example, <code>iframe</code> elements) can
   instantiate further <span title="browsing context">browsing
   contexts</span>. These are called <dfn title="nested browsing
   context">nested browsing contexts</dfn>. If a browsing context <var
-  title="">P</var> has an element in one of its <code>Document</code>s
-  <var title="">D</var> that nests another browsing context <var
-  title="">C</var> inside it, then <var title="">P</var> is said to be
-  the <dfn>parent browsing context</dfn> of <var title="">C</var>,
-  <var title="">C</var> is said to be a <dfn>child browsing
-  context</dfn> of <var title="">P</var>, and <var title="">C</var> is
-  said to be <dfn title="browsing context nested through">nested
-  through</dfn> <var title="">D</var>.</p>
+  title="">P</var> has an element <var title="">E</var> in one of its
+  <code>Document</code>s <var title="">D</var> that nests another
+  browsing context <var title="">C</var> inside it, then <var
+  title="">P</var> is said to be the <dfn>parent browsing
+  context</dfn> of <var title="">C</var>, <var title="">C</var> is
+  said to be a <dfn>child browsing context</dfn> of <var
+  title="">P</var>, <var title="">C</var> is said to be <dfn
+  title="browsing context nested through">nested through</dfn> <var
+  title="">D</var>, and <var title="">E</var> is said to be the
+  <dfn>browsing context container</dfn> of <var title="">C</var>.</p>
 
   <p>A browsing context <var title="">A</var> is said to be an
   ancestor of a browsing context <var title="">B</var> if there exists
   a browsing context <var title="">A'</var> that is a <span>child
   browsing context</span> of <var title="">A</var> and that is itself
   an ancestor of <var title="">B</var>, or if there is a browsing
   context <var title="">P</var> that is a <span>child browsing
   context</span> of <var title="">A</var> and that is the <span>parent
   browsing context</span> of <var title="">B</var>.</p>
 
@@ -28849,30 +28851,53 @@ never reset. This is nice and consistent.)
   <code>iframe</code> element with a <code
   title="attr-iframe-seamless">seamless</code> attribute.</p>
 
   <p>The <dfn title="dom-top"><code>top</code></dfn> DOM attribute on
   the <code>Window</code> object of a <span>browsing context</span>
   <var title="">b</var> must return the <code>Window</code> object of
   its <span>top-level browsing context</span> (which would be its own
   <code>Window</code> object if it was a <span>top-level browsing
   context</span> itself).</p>
 
+  <hr>
+
   <p>The <dfn title="dom-parent"><code>parent</code></dfn> DOM
   attribute on the <code>Window</code> object of a <span>browsing
   context</span> <var title="">b</var> must return the
   <code>Window</code> object of the <span>parent browsing
   context</span>, if there is one (i.e. if <var title="">b</var> is a
   <span>child browsing context</span>), or the <code>Window</code>
   object of the <span>browsing context</span> <var title="">b</var>
   itself, otherwise (i.e. if it is a <span>top-level browsing
   context</span>).</p>
 
+  <p>The <dfn title="dom-frameElement"><code>frameElement</code></dfn>
+  DOM attribute on the <code>Window</code> object of a <span>browsing
+  context</span> <var title="">b</var>, on getting, must run the
+  following algorithm:</p>
+
+  <ol>
+
+   <li><p>If <var title="">b</var> is not a <span>child browsing
+   context</span>, return null and abort these steps.</p></li>
+
+   <li><p>If the <span>parent browsing context</span>'s <span>active
+   document</span> does not have the <span>same</span> <span>effective
+   origin</span> as the script that is accessing the <code
+   title="dom-frameElement">frameElement</code> attribute, then throw
+   a <span>security exception</span>.</p></li>
+
+   <li><p>Otherwise, return the <span>browsing context
+   container</span> for <var title="">b</var>.</p></li>
+
+  </ol>
+
 
   <h4>Auxiliary browsing contexts</h4>
 
   <p>It is possible to create new browsing contexts that are related
   to a <span>top level browsing context</span> without being nested
   through an element. Such browsing contexts are called <dfn
   title="auxiliary browsing context">auxiliary browsing
   contexts</dfn>. Auxiliary browsing contexts are always <span
   title="top-level browsing context">top-level browsing
   contexts</span>.</p>
@@ -29124,20 +29149,21 @@ never reset. This is nice and consistent.)
   readonly attribute <span>UndoManager</span> <span title="dom-undoManager">undoManager</span>;
   <span>Selection</span> <span title="dom-getSelection">getSelection</span>();
 
   // other browsing contexts
   readonly attribute <span>Window</span> <span title="dom-frames">frames</span>;
   readonly attribute unsigned long <span title="dom-length">length</span>;
   [IndexGetter] <span>Window</span> <span title="dom-XXX4">XXX4</span>(in unsigned long index); <!-- XXX DOMB -->
   readonly attribute <span>Window</span> <span title="dom-top">top</span>;
   readonly attribute <span>Window</span> <span title="dom-opener">opener</span>;
   readonly attribute <span>Window</span> <span title="dom-parent">parent</span>;
+  readonly attribute <span>Element</span> <span title="dom-frameElement">frameElement</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);
 
   // the user agent
   readonly attribute <span>ClientInformation</span> <span title="dom-navigator">navigator</span>; <!-- XXX IE6 also has window.clientInformation pointing to this same object -->
   readonly attribute <span>Storage</span> <span title="dom-localStorage">localStorage</span>;
   readonly attribute <span>Storage</span> <span title="dom-sessionStorage">sessionStorage</span>;
@@ -29240,20 +29266,21 @@ never reset. This is nice and consistent.)
 
    <li>The <code title="dom-XXX4">XXX4</code> method
 
   </ul>
 
   <p>User agents must not allow scripts to override the <code
   title="dom-location">location</code> object's setter.</p>
 
 
 
+
   <h4>APIs for creating and navigating browsing contexts by name</h4>
 
   <p>The <dfn title="dom-open"><code>open()</code></dfn> method on
   <code>Window</code> objects provides a mechanism for <span
   title="navigate">navigating</span> an existing <span>browsing
   context</span> or opening and navigating an <span>auxiliary browsing
   context</span>.</p>
 
   <p>The method has four arguments, though they are all optional.</p>
 
@@ -50194,24 +50221,24 @@ interface <dfn>TimeoutHandler</dfn> {
   dolphinling, Doron Rosenberg, Doug Kramer, Edward O'Connor, Eira
   Monstad, Elliotte Harold, Eric Law, Erik Arvidsson, Evan Martin,
   Evan Prodromou, fantasai, Felix Sasaki, Franck 'Shift'
   Qu&eacute;lain, Garrett Smith, Geoffrey Garen, Geoffrey Sneddon,
   H&aring;kon Wium Lie, Henri Sivonen, Henrik Lied, Henry Mason, Hugh
   Winkler, Ignacio Javier, Ivo Emanuel Gon&ccedil;alves, J. King,
   Jacques Distler, James Graham, James Justin Harrell, James M Snell,
   James Perrett, Jan-Klaas Kollhof, Jason White, Jasper Bryant-Greene,
   Jeff Cutsinger, Jeff Schiller, Jeff Walden, Jens Bannmann, Jens
   Fendler, Jeroen van der Meer, Jim Jewett, Jim Meehan, Joe Clark,
-  Jjgod Jiang, Joel Spolsky, Johan Herland, John Boyer, John
-  Bussjaeger, John Harding, Johnny Stenback, Jon Perlow, Jonathan
-  Worent, Jorgen Horstink, Josh Levenberg, Joshua Randall, Jukka
-  K. Korpela, Julian Reschke, Kai Hendry, <!-- Keryx Web, = Lars
+  Joseph Kesselman, Jjgod Jiang, Joel Spolsky, Johan Herland, John
+  Boyer, John Bussjaeger, John Harding, Johnny Stenback, Jon Perlow,
+  Jonathan Worent, Jorgen Horstink, Josh Levenberg, Joshua Randall,
+  Jukka K. Korpela, Julian Reschke, Kai Hendry, <!-- Keryx Web, = Lars
   Gunther --> Kornel Lesinski, &#x9ed2;&#x6fa4;&#x525b;&#x5fd7;
   (KUROSAWA Takeshi), Kristof Zelechovski, Lachlan Hunt, Larry Page,
   Lars Gunther, Laura L. Carlson, Laura Wisewell, Laurens Holst, Lee
   Kowalkowski, Leif Halvard Silli, Lenny Domnitser, L&eacute;onard
   Bouchet, Leons Petrazickis, Logan<!-- on moz irc -->, Loune, Maciej
   Stachowiak, Magnus Kristiansen<!-- Dashiva -->, Malcolm Rowe, Mark
   Nottingham, Mark Rowe<!--bdash-->, Mark Schenk, Martijn Wargers,
   Martin Atkins, Martin D&uuml;rst, Martin Honnen, Masataka Yakura,
   Mathieu Henri, Matthew Mastracci, Matthew Raymond, Matthew Thomas,
   Mattias Waldau, Max Romantschuk, Michael 'Ratt' Iannarelli, Michael

|