HTML Standard Tracker

Diff (omit for latest revision)
Filter

Short URL: http://html5.org/r/2068

File a bug

SVNBugCommentTime (UTC)
2068Define window.frameElement.2008-08-13 00:41
Index: source
===================================================================
--- source	(revision 2067)
+++ source	(revision 2068)
@@ -28799,14 +28799,16 @@
   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
@@ -28856,6 +28858,8 @@
   <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
@@ -28866,7 +28870,28 @@
   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
@@ -29131,6 +29156,7 @@
   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);
@@ -29247,6 +29273,7 @@
 
 
 
+
   <h4>APIs for creating and navigating browsing contexts by name</h4>
 
   <p>The <dfn title="dom-open"><code>open()</code></dfn> method on
@@ -50201,10 +50228,10 @@
   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

|