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

html5/spec browsers.html,1.1022,1.1023 spec.html,1.1340,1.1341

From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
Date: Thu, 02 Dec 2010 07:46:42 +0000
To: public-html-commits@w3.org
Message-Id: <E1PO3sI-0004Ch-5P@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv16133

Modified Files:
	browsers.html spec.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)

[updated by splitter]


Index: browsers.html
===================================================================
RCS file: /sources/public/html5/spec/browsers.html,v
retrieving revision 1.1022
retrieving revision 1.1023
diff -u -d -r1.1022 -r1.1023
--- browsers.html	29 Nov 2010 23:46:39 -0000	1.1022
+++ browsers.html	2 Dec 2010 07:46:39 -0000	1.1023
@@ -445,28 +445,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.html#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="infrastructure.html#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><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><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><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="infrastructure.html#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="infrastructure.html#in-a-document" title="in a
+  Document">in</a> the <code><a href="infrastructure.html#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><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><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><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><p>The <dfn id="list-of-the-descendant-browsing-contexts">list of the descendant browsing contexts</dfn> of a
-  <code><a href="infrastructure.html#document">Document</a></code> <var title="">d</var> is the list returned by
-  the following algorithm:</p><ol><li><p>Let <var title="">list</var> be an empty list.</p></li>
+  context</a> gives the list of <a href="#ancestor-browsing-context" title="ancestor browsing
+  context">ancestor browsing contexts</a>.</p><p>The <dfn id="list-of-the-descendant-browsing-contexts">list of the descendant browsing contexts</dfn> of a
+  <code><a href="infrastructure.html#document">Document</a></code> <var title="">d</var> is the (ordered) list
+  returned by the following algorithm:</p><ol><li><p>Let <var title="">list</var> be an empty list.</p></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="infrastructure.html#in-a-document" title="in a
@@ -479,12 +486,13 @@
 
    <li><p>Return the constructed <var title="">list</var>.</p></li>
 
-  </ol><hr><p>A <code><a href="infrastructure.html#document">Document</a></code> is said to be <dfn id="fully-active">fully active</dfn>
+  </ol><p>A <code><a href="infrastructure.html#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="infrastructure.html#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><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="infrastructure.html#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><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="infrastructure.html#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
@@ -492,7 +500,21 @@
   of elements that are in <code><a href="infrastructure.html#document">Document</a></code>s that are not
   themselves <a href="#fully-active">fully active</a>.</p><p>A <a href="#nested-browsing-context">nested browsing context</a> can have a <a href="the-iframe-element.html#seamless-browsing-context-flag">seamless
   browsing context flag</a> set, if it is embedded through an
-  <code><a href="the-iframe-element.html#the-iframe-element">iframe</a></code> element with a <code title="attr-iframe-seamless"><a href="the-iframe-element.html#attr-iframe-seamless">seamless</a></code> attribute.</p><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.html#the-iframe-element">iframe</a></code> element with a <code title="attr-iframe-seamless"><a href="the-iframe-element.html#attr-iframe-seamless">seamless</a></code> attribute.</p><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.html#the-iframe-element">iframe</a></code> element is removed from its
+  <code><a href="infrastructure.html#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="infrastructure.html#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="infrastructure.html#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.html#the-iframe-element">iframe</a></code>) is moved to another <code><a href="infrastructure.html#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.</p><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>
 

Index: spec.html
===================================================================
RCS file: /sources/public/html5/spec/spec.html,v
retrieving revision 1.1340
retrieving revision 1.1341
diff -u -d -r1.1340 -r1.1341
--- spec.html	2 Dec 2010 04:46:38 -0000	1.1340
+++ spec.html	2 Dec 2010 07:46:40 -0000	1.1341
@@ -385,7 +385,7 @@
     <a href="Overview.html">single page HTML</a>,
     <a href="spec.html">multipage HTML</a>,
     <a href="author/">web developer edition</a>.
-This is revision 1.4565.
+This is revision 1.4566.
    </p> 
      <p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
    &#169; 2010 <a href="http://www.w3.org/"><abbr title="World Wide
Received on Thursday, 2 December 2010 07:46:44 GMT

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