[html5] r8365 - [giow] (1) Define the source browsing context for location.reload(), though it's [...]
whatwg at whatwg.org
whatwg at whatwg.org
Wed Dec 18 10:36:34 PST 2013
Author: ianh
Date: 2013-12-18 10:36:32 -0800 (Wed, 18 Dec 2013)
New Revision: 8365
Modified:
complete.html
index
source
Log:
[giow] (1) Define the source browsing context for location.reload(), though it's mostly academic.
Affected topics: DOM APIs, HTML
Modified: complete.html
===================================================================
--- complete.html 2013-12-17 22:14:14 UTC (rev 8364)
+++ complete.html 2013-12-18 18:36:32 UTC (rev 8365)
@@ -298,7 +298,7 @@
<header class=head id=head><p><a href=http://www.whatwg.org/ class=logo><img width=101 src=/images/logo alt=WHATWG height=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 17 December 2013</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 18 December 2013</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -8413,7 +8413,8 @@
set, the <code><a href=#document>Document</a></code> also has a <dfn id=reload-override-buffer>reload override buffer</dfn> which is a Unicode
string that is used as the source of the document when it is reloaded.</p>
- <p>When the user agent is to perform <dfn id=an-overridden-reload>an overridden reload</dfn>, it must act as follows:</p>
+ <p>When the user agent is to perform <dfn id=an-overridden-reload>an overridden reload</dfn>, given a <a href=#source-browsing-context>source
+ browsing context</a>, it must act as follows:</p>
<ol><li><p>Let <var title="">source</var> be the value of the <a href=#browsing-context>browsing context</a>'s
<a href=#active-document>active document</a>'s <a href=#reload-override-buffer>reload override buffer</a>.</li>
@@ -8421,8 +8422,11 @@
<li><p>Let <var title="">address</var> be the <a href=#browsing-context>browsing context</a>'s <a href=#active-document>active
document</a>'s <a href="#the-document's-address" title="the document's address">address</a>.</li>
+<!--CLEANUP-->
<li><p><a href=#navigate>Navigate</a><!--DONAV reload after d.open()--> the <a href=#browsing-context>browsing context</a>
to a resource whose source is <var title="">source</var>, with <a href=#replacement-enabled>replacement enabled</a>.
+ The <a href=#source-browsing-context>source browsing context</a> is that given to the <a href=#an-overridden-reload title="an overridden
+ reload">overridden reload</a> algorithm.
When the <a href=#navigate>navigate</a> algorithm creates a <code><a href=#document>Document</a></code> object for this purpose,
set that <code><a href=#document>Document</a></code>'s <a href=#reload-override-flag>reload override flag</a> and set its <a href=#reload-override-buffer>reload
override buffer</a> to <var title="">source</var>.</p>
@@ -66631,7 +66635,9 @@
<dt>If the <a href=#browsing-context>browsing context</a>'s <a href=#active-document>active document</a> has its <a href=#reload-override-flag>reload
override flag</a> set</dt>
- <dd><p>Perform <a href=#an-overridden-reload>an overridden reload</a>.</dd>
+ <dd><p>Perform <a href=#an-overridden-reload>an overridden reload</a>, with the <a href=#responsible-browsing-context>responsible browsing
+ context</a> specified by the <a href=#incumbent-settings-object>incumbent settings object</a> as the <a href=#source-browsing-context>source
+ browsing context</a>.</dd>
<dt>Otherwise</dt>
@@ -66653,7 +66659,8 @@
agents may allow the user to explicitly override any caches when reloading. If <a href=#browsing-context>browsing
context</a>'s <a href=#active-document>active document</a>'s <a href=#reload-override-flag>reload override flag</a> is set, then the
user agent may instead perform <a href=#an-overridden-reload>an overridden reload</a> rather than the navigation
- described in this paragraph.</p>
+ described in this paragraph (with the <a href=#browsing-context>browsing context</a> being reloaded as the
+ <a href=#source-browsing-context>source browsing context</a>).</p>
<hr></div>
@@ -66805,20 +66812,20 @@
<h4 id=navigating-across-documents><span class=secno>6.6.1 </span>Navigating across documents</h4>
<p>Certain actions cause the <a href=#browsing-context>browsing context</a> to <i><a href=#navigate>navigate</a></i> to a new resource.
- Navigation always involves <dfn id=source-browsing-context>source browsing context</dfn>, which is the browsing context which
- was responsible for starting the navigation.</p>
+ A user agent may provide various ways for the user to explicitly cause a browsing context to
+ navigate, in addition to those defined in this specification.</p>
<p class=example>For example, <a href=#following-hyperlinks title="following hyperlinks">following a hyperlink</a>,
<a href=#concept-form-submit title=concept-form-submit>form submission</a>, and the <code title=dom-open><a href=#dom-open>window.open()</a></code> and <code title=dom-location-assign><a href=#dom-location-assign>location.assign()</a></code> methods can all cause a browsing context to
navigate.</p>
- <p>A user agent may provide various ways for the user to explicitly cause a browsing context to
- navigate, in addition to those defined in this specification.</p>
-
<p class=note>A <i>resource</i> has a URL, but that might not be the only information necessary
to identify it. For example, a form submission that uses HTTP POST would also have the HTTP method
and payload. Similarly, <a href=#an-iframe-srcdoc-document>an <code>iframe</code> <code title=attr-iframe-srcdoc>srcdoc</code> document</a> needs to know the data it is to use.</p>
+ <p>Navigation always involves <dfn id=source-browsing-context>source browsing context</dfn>, which is the browsing context which
+ was responsible for starting the navigation.</p>
+
<!-- NAVIGATE <dfn>navigate</dfn> -->
<!-- For places that _call_ this, as opposed to just referring to
it, search for "DONAV" -->
Modified: index
===================================================================
--- index 2013-12-17 22:14:14 UTC (rev 8364)
+++ index 2013-12-18 18:36:32 UTC (rev 8365)
@@ -298,7 +298,7 @@
<header class=head id=head><p><a href=http://www.whatwg.org/ class=logo><img width=101 src=/images/logo alt=WHATWG height=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 17 December 2013</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 18 December 2013</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -8413,7 +8413,8 @@
set, the <code><a href=#document>Document</a></code> also has a <dfn id=reload-override-buffer>reload override buffer</dfn> which is a Unicode
string that is used as the source of the document when it is reloaded.</p>
- <p>When the user agent is to perform <dfn id=an-overridden-reload>an overridden reload</dfn>, it must act as follows:</p>
+ <p>When the user agent is to perform <dfn id=an-overridden-reload>an overridden reload</dfn>, given a <a href=#source-browsing-context>source
+ browsing context</a>, it must act as follows:</p>
<ol><li><p>Let <var title="">source</var> be the value of the <a href=#browsing-context>browsing context</a>'s
<a href=#active-document>active document</a>'s <a href=#reload-override-buffer>reload override buffer</a>.</li>
@@ -8421,8 +8422,11 @@
<li><p>Let <var title="">address</var> be the <a href=#browsing-context>browsing context</a>'s <a href=#active-document>active
document</a>'s <a href="#the-document's-address" title="the document's address">address</a>.</li>
+<!--CLEANUP-->
<li><p><a href=#navigate>Navigate</a><!--DONAV reload after d.open()--> the <a href=#browsing-context>browsing context</a>
to a resource whose source is <var title="">source</var>, with <a href=#replacement-enabled>replacement enabled</a>.
+ The <a href=#source-browsing-context>source browsing context</a> is that given to the <a href=#an-overridden-reload title="an overridden
+ reload">overridden reload</a> algorithm.
When the <a href=#navigate>navigate</a> algorithm creates a <code><a href=#document>Document</a></code> object for this purpose,
set that <code><a href=#document>Document</a></code>'s <a href=#reload-override-flag>reload override flag</a> and set its <a href=#reload-override-buffer>reload
override buffer</a> to <var title="">source</var>.</p>
@@ -66631,7 +66635,9 @@
<dt>If the <a href=#browsing-context>browsing context</a>'s <a href=#active-document>active document</a> has its <a href=#reload-override-flag>reload
override flag</a> set</dt>
- <dd><p>Perform <a href=#an-overridden-reload>an overridden reload</a>.</dd>
+ <dd><p>Perform <a href=#an-overridden-reload>an overridden reload</a>, with the <a href=#responsible-browsing-context>responsible browsing
+ context</a> specified by the <a href=#incumbent-settings-object>incumbent settings object</a> as the <a href=#source-browsing-context>source
+ browsing context</a>.</dd>
<dt>Otherwise</dt>
@@ -66653,7 +66659,8 @@
agents may allow the user to explicitly override any caches when reloading. If <a href=#browsing-context>browsing
context</a>'s <a href=#active-document>active document</a>'s <a href=#reload-override-flag>reload override flag</a> is set, then the
user agent may instead perform <a href=#an-overridden-reload>an overridden reload</a> rather than the navigation
- described in this paragraph.</p>
+ described in this paragraph (with the <a href=#browsing-context>browsing context</a> being reloaded as the
+ <a href=#source-browsing-context>source browsing context</a>).</p>
<hr></div>
@@ -66805,20 +66812,20 @@
<h4 id=navigating-across-documents><span class=secno>6.6.1 </span>Navigating across documents</h4>
<p>Certain actions cause the <a href=#browsing-context>browsing context</a> to <i><a href=#navigate>navigate</a></i> to a new resource.
- Navigation always involves <dfn id=source-browsing-context>source browsing context</dfn>, which is the browsing context which
- was responsible for starting the navigation.</p>
+ A user agent may provide various ways for the user to explicitly cause a browsing context to
+ navigate, in addition to those defined in this specification.</p>
<p class=example>For example, <a href=#following-hyperlinks title="following hyperlinks">following a hyperlink</a>,
<a href=#concept-form-submit title=concept-form-submit>form submission</a>, and the <code title=dom-open><a href=#dom-open>window.open()</a></code> and <code title=dom-location-assign><a href=#dom-location-assign>location.assign()</a></code> methods can all cause a browsing context to
navigate.</p>
- <p>A user agent may provide various ways for the user to explicitly cause a browsing context to
- navigate, in addition to those defined in this specification.</p>
-
<p class=note>A <i>resource</i> has a URL, but that might not be the only information necessary
to identify it. For example, a form submission that uses HTTP POST would also have the HTTP method
and payload. Similarly, <a href=#an-iframe-srcdoc-document>an <code>iframe</code> <code title=attr-iframe-srcdoc>srcdoc</code> document</a> needs to know the data it is to use.</p>
+ <p>Navigation always involves <dfn id=source-browsing-context>source browsing context</dfn>, which is the browsing context which
+ was responsible for starting the navigation.</p>
+
<!-- NAVIGATE <dfn>navigate</dfn> -->
<!-- For places that _call_ this, as opposed to just referring to
it, search for "DONAV" -->
Modified: source
===================================================================
--- source 2013-12-17 22:14:14 UTC (rev 8364)
+++ source 2013-12-18 18:36:32 UTC (rev 8365)
@@ -8048,7 +8048,8 @@
set, the <code>Document</code> also has a <dfn>reload override buffer</dfn> which is a Unicode
string that is used as the source of the document when it is reloaded.</p>
- <p>When the user agent is to perform <dfn>an overridden reload</dfn>, it must act as follows:</p>
+ <p>When the user agent is to perform <dfn>an overridden reload</dfn>, given a <span>source
+ browsing context</span>, it must act as follows:</p>
<ol>
@@ -8058,8 +8059,11 @@
<li><p>Let <var data-x="">address</var> be the <span>browsing context</span>'s <span>active
document</span>'s <span data-x="the document's address">address</span>.</p></li>
+<!--CLEANUP-->
<li><p><span>Navigate</span><!--DONAV reload after d.open()--> the <span>browsing context</span>
to a resource whose source is <var data-x="">source</var>, with <span>replacement enabled</span>.
+ The <span>source browsing context</span> is that given to the <span data-x="an overridden
+ reload">overridden reload</span> algorithm.
When the <span>navigate</span> algorithm creates a <code>Document</code> object for this purpose,
set that <code>Document</code>'s <span>reload override flag</span> and set its <span>reload
override buffer</span> to <var data-x="">source</var>.</p>
@@ -74227,7 +74231,9 @@
<dt>If the <span>browsing context</span>'s <span>active document</span> has its <span>reload
override flag</span> set</dt>
- <dd><p>Perform <span>an overridden reload</span>.</p></dd>
+ <dd><p>Perform <span>an overridden reload</span>, with the <span>responsible browsing
+ context</span> specified by the <span>incumbent settings object</span> as the <span>source
+ browsing context</span>.</p></dd>
<dt>Otherwise</dt>
@@ -74251,7 +74257,8 @@
agents may allow the user to explicitly override any caches when reloading. If <span>browsing
context</span>'s <span>active document</span>'s <span>reload override flag</span> is set, then the
user agent may instead perform <span>an overridden reload</span> rather than the navigation
- described in this paragraph.</p>
+ described in this paragraph (with the <span>browsing context</span> being reloaded as the
+ <span>source browsing context</span>).</p>
<hr>
@@ -74427,8 +74434,8 @@
<h4>Navigating across documents</h4>
<p>Certain actions cause the <span>browsing context</span> to <i>navigate</i> to a new resource.
- Navigation always involves <dfn>source browsing context</dfn>, which is the browsing context which
- was responsible for starting the navigation.</p>
+ A user agent may provide various ways for the user to explicitly cause a browsing context to
+ navigate, in addition to those defined in this specification.</p>
<p class="example">For example, <span data-x="following hyperlinks">following a hyperlink</span>,
<span data-x="concept-form-submit">form submission</span>, and the <code
@@ -74436,14 +74443,14 @@
data-x="dom-location-assign">location.assign()</code> methods can all cause a browsing context to
navigate.</p>
- <p>A user agent may provide various ways for the user to explicitly cause a browsing context to
- navigate, in addition to those defined in this specification.</p>
-
<p class="note">A <i>resource</i> has a URL, but that might not be the only information necessary
to identify it. For example, a form submission that uses HTTP POST would also have the HTTP method
and payload. Similarly, <span>an <code>iframe</code> <code
data-x="attr-iframe-srcdoc">srcdoc</code> document</span> needs to know the data it is to use.</p>
+ <p>Navigation always involves <dfn>source browsing context</dfn>, which is the browsing context which
+ was responsible for starting the navigation.</p>
+
<!-- NAVIGATE <dfn>navigate</dfn> -->
<!-- For places that _call_ this, as opposed to just referring to
it, search for "DONAV" -->
More information about the Commit-Watchers
mailing list