W3C home > Mailing lists > Public > public-html-commits@w3.org > December 2010

html5/spec Overview.html,1.4565,1.4566

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Thu, 02 Dec 2010 07:15:44 +0000
To: public-html-commits@w3.org
Message-Id: <E1PO3OK-0003HJ-IF@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv12580

Modified Files:
	Overview.html 
Log Message:
make sure the definitions of 'nested browsing context' make sense when you consider that iframes can be removed from a document (whatwg r5699)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4565
retrieving revision 1.4566
diff -u -d -r1.4565 -r1.4566
--- Overview.html	2 Dec 2010 04:29:01 -0000	1.4565
+++ Overview.html	2 Dec 2010 07:15:40 -0000	1.4566
@@ -41311,28 +41311,35 @@
   </div><h4 id="nested-browsing-contexts"><span class="secno">5.1.1 </span>Nested browsing contexts</h4><p>Certain elements (for example, <code><a href="#the-iframe-element">iframe</a></code> elements) can
   instantiate further <a href="#browsing-context" title="browsing context">browsing
   contexts</a>. These are called <dfn id="nested-browsing-context" title="nested browsing
-  context">nested browsing contexts</dfn>. If a browsing context <var title="">P</var> has an element <var title="">E</var> in one of its
-  <code><a href="#document">Document</a></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 id="parent-browsing-context">parent browsing
-  context</dfn> of <var title="">C</var>, <var title="">C</var> is
-  said to be a <dfn id="child-browsing-context">child browsing context</dfn> of <var title="">P</var>, <var title="">C</var> is said to be <dfn id="browsing-context-nested-through" title="browsing context nested through">nested through</dfn> <var title="">D</var>, and <var title="">E</var> is said to be the
-  <dfn id="browsing-context-container">browsing context container</dfn> of <var title="">C</var>.<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 <a href="#child-browsing-context">child
-  browsing context</a> 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 <a href="#child-browsing-context">child browsing
-  context</a> of <var title="">A</var> and that is the <a href="#parent-browsing-context">parent
-  browsing context</a> of <var title="">B</var>.<p>The browsing context with no <a href="#parent-browsing-context">parent browsing context</a>
-  is the <dfn id="top-level-browsing-context">top-level browsing context</dfn> of all the browsing
-  contexts <a href="#nested-browsing-context" title="nested browsing context">nested</a> within
-  it (either directly or indirectly through other nested browsing
-  contexts).<p>The transitive closure of <a href="#parent-browsing-context" title="parent browsing
+  context">nested browsing contexts</dfn>. If a browsing context <var title="">P</var> has a <code><a href="#document">Document</a></code>s <var title="">D</var>
+  with an element <var title="">E</var> that nests another browsing
+  context <var title="">C</var> inside it, then <var title="">C</var>
+  is said to be <dfn id="browsing-context-nested-through" title="browsing context nested through">nested
+  through</dfn> <var title="">D</var>, and <var title="">E</var> is
+  said to be the <dfn id="browsing-context-container">browsing context container</dfn> of <var title="">C</var>. If the <a href="#browsing-context-container">browsing context container</a>
+  element <var title="">E</var> is <a href="#in-a-document" title="in a
+  Document">in</a> the <code><a href="#document">Document</a></code> <var title="">D</var>,
+  then <var title="">P</var> is said to be the <dfn id="parent-browsing-context">parent browsing
+  context</dfn> of <var title="">C</var> and <var title="">C</var> is
+  said to be a <dfn id="child-browsing-context">child browsing context</dfn> of <var title="">P</var>. Otherwise, the <a href="#nested-browsing-context">nested browsing
+  context</a> <var title="">C</var> has no <a href="#parent-browsing-context">parent browsing
+  context</a>.<p>A browsing context <var title="">A</var> is said to be an <dfn id="ancestor-browsing-context" title="ancestor browsing context">ancestor</dfn> of a browsing
+  context <var title="">B</var> if there exists a browsing context
+  <var title="">A'</var> that is a <a href="#child-browsing-context">child browsing context</a>
+  of <var title="">A</var> and that is itself an <a href="#ancestor-browsing-context" title="ancestor
+  browsing context">ancestor</a> of <var title="">B</var>, or if
+  there is a browsing context <var title="">P</var> that is a
+  <a href="#child-browsing-context">child browsing context</a> of <var title="">A</var> and
+  that is the <a href="#parent-browsing-context">parent browsing context</a> of <var title="">B</var>.<p>A browsing context that is not a <a href="#nested-browsing-context">nested browsing
+  context</a> has no <a href="#parent-browsing-context">parent browsing context</a>, and is
+  the <dfn id="top-level-browsing-context">top-level browsing context</dfn> of all the browsing
+  contexts for which it is an <a href="#ancestor-browsing-context">ancestor browsing
+  context</a>.<p>The transitive closure of <a href="#parent-browsing-context" title="parent browsing
   context">parent browsing contexts</a> for a <a href="#nested-browsing-context">nested browsing
-  context</a> gives the list of <dfn id="ancestor-browsing-context" title="ancestor browsing
-  context">ancestor browsing contexts</dfn>.<p>The <dfn id="list-of-the-descendant-browsing-contexts">list of the descendant browsing contexts</dfn> of a
-  <code><a href="#document">Document</a></code> <var title="">d</var> is the list returned by
-  the following algorithm:<ol><li><p>Let <var title="">list</var> be an empty list.</li>
+  context</a> gives the list of <a href="#ancestor-browsing-context" title="ancestor browsing
+  context">ancestor browsing contexts</a>.<p>The <dfn id="list-of-the-descendant-browsing-contexts">list of the descendant browsing contexts</dfn> of a
+  <code><a href="#document">Document</a></code> <var title="">d</var> is the (ordered) list
+  returned by the following algorithm:<ol><li><p>Let <var title="">list</var> be an empty list.</li>
 
    <li><p>For each <a href="#child-browsing-context">child browsing context</a> of <var title="">d</var> that is <a href="#browsing-context-nested-through" title="browsing context nested
    through">nested through</a> an element that is <a href="#in-a-document" title="in a
@@ -41345,12 +41352,13 @@
 
    <li><p>Return the constructed <var title="">list</var>.</li>
 
-  </ol><hr><p>A <code><a href="#document">Document</a></code> is said to be <dfn id="fully-active">fully active</dfn>
+  </ol><p>A <code><a href="#document">Document</a></code> is said to be <dfn id="fully-active">fully active</dfn>
   when it is the <a href="#active-document">active document</a> of its <a href="#browsing-context">browsing
   context</a>, and either its browsing context is a <a href="#top-level-browsing-context">top-level
-  browsing context</a>, or the <code><a href="#document">Document</a></code> <a href="#browsing-context-nested-through" title="browsing context nested through">through which</a> that
-  browsing context is <a href="#nested-browsing-context" title="nested browsing
-  context">nested</a> is itself <a href="#fully-active">fully active</a>.<p>Because they are nested through an element, <a href="#child-browsing-context" title="child
+  browsing context</a>, or it has a <a href="#parent-browsing-context">parent browsing
+  context</a> and the <code><a href="#document">Document</a></code> <a href="#browsing-context-nested-through" title="browsing
+  context nested through">through which</a> it is <a href="#nested-browsing-context" title="nested browsing context">nested</a> is itself <a href="#fully-active">fully
+  active</a>.<p>Because they are nested through an element, <a href="#child-browsing-context" title="child
   browsing context">child browsing contexts</a> are always tied to
   a specific <code><a href="#document">Document</a></code> in their <a href="#parent-browsing-context">parent browsing
   context</a>. User agents must not allow the user to interact with
@@ -41358,7 +41366,21 @@
   of elements that are in <code><a href="#document">Document</a></code>s that are not
   themselves <a href="#fully-active">fully active</a>.<p>A <a href="#nested-browsing-context">nested browsing context</a> can have a <a href="#seamless-browsing-context-flag">seamless
   browsing context flag</a> set, if it is embedded through an
-  <code><a href="#the-iframe-element">iframe</a></code> element with a <code title="attr-iframe-seamless"><a href="#attr-iframe-seamless">seamless</a></code> attribute.<h5 id="navigating-nested-browsing-contexts-in-the-dom"><span class="secno">5.1.1.1 </span>Navigating nested browsing contexts in the DOM</h5><dl class="domintro"><dt><var title="">window</var> . <code title="dom-top"><a href="#dom-top">top</a></code></dt>
+  <code><a href="#the-iframe-element">iframe</a></code> element with a <code title="attr-iframe-seamless"><a href="#attr-iframe-seamless">seamless</a></code> attribute.<p class="note">A <a href="#nested-browsing-context">nested browsing context</a> can in some
+  cases be taken out of its <a href="#parent-browsing-context">parent browsing context</a> (e.g.
+  if an <code><a href="#the-iframe-element">iframe</a></code> element is removed from its
+  <code><a href="#document">Document</a></code>). In such a situation, the <a href="#nested-browsing-context">nested
+  browsing context</a> has no <a href="#parent-browsing-context">parent browsing context</a>,
+  but it still has the same <a href="#browsing-context-container">browsing context container</a>
+  and is still <a href="#browsing-context-nested-through" title="browsing context nested through">nested
+  through</a> that element's <code><a href="#document">Document</a></code>. Such a
+  <a href="#nested-browsing-context">nested browsing context</a> is <em>not</em> a
+  <a href="#top-level-browsing-context">top-level browsing context</a>, and cannot contain
+  <code><a href="#document">Document</a></code>s that are <a href="#fully-active">fully active</a>.
+  Furthermore, if a <a href="#browsing-context-container">browsing context container</a> (such as
+  an <code><a href="#the-iframe-element">iframe</a></code>) is moved to another <code><a href="#document">Document</a></code>,
+  then the <a href="#parent-browsing-context">parent browsing context</a> of its <a href="#nested-browsing-context">nested
+  browsing context</a> will change.<h5 id="navigating-nested-browsing-contexts-in-the-dom"><span class="secno">5.1.1.1 </span>Navigating nested browsing contexts in the DOM</h5><dl class="domintro"><dt><var title="">window</var> . <code title="dom-top"><a href="#dom-top">top</a></code></dt>
 
    <dd>
 
Received on Thursday, 2 December 2010 07:15:46 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 2 December 2010 07:15:48 GMT