Short URL: http://html5.org/r/2068
| SVN | Bug | Comment | Time (UTC) |
|---|---|---|---|
| 2068 | Define 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, 黒澤剛志 (KUROSAWA Takeshi), Kristof Zelechovski, Lachlan Hunt, Larry Page, Lars Gunther, Laura L. Carlson, Laura Wisewell, Laurens Holst, Lee