Define location.reload(). (whatwg r3220)

Define location.reload(). (whatwg r3220)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.2370&r2=1.2371&f=h
http://html5.org/tools/web-apps-tracker?from=3219&to=3220

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2370
retrieving revision 1.2371
diff -u -d -r1.2370 -r1.2371
--- Overview.html 10 Jun 2009 21:50:20 -0000 1.2370
+++ Overview.html 10 Jun 2009 23:46:35 -0000 1.2371
@@ -46152,7 +46152,7 @@
   session history.</p>
 
   <p>If the <var title="">delta</var> is zero, or if the argument is
-  omitted, then the user agent must act as if the <code title="dom-location-reload">location.reload()</code> method was
+  omitted, then the user agent must act as if the <code title="dom-location-reload"><a href="#dom-location-reload">location.reload()</a></code> method was
   called instead.</p>
 
   <p>Otherwise, if the index of the <a href="#current-entry">current entry</a> plus
@@ -46355,7 +46355,7 @@
   readonly attribute DOMString <a href="#dom-location-href" title="dom-location-href">href</a>;
   void <a href="#dom-location-assign" title="dom-location-assign">assign</a>(in DOMString url);
   void <a href="#dom-location-replace" title="dom-location-replace">replace</a>(in DOMString url);
-  void <span title="dom-location-reload">reload</span>();
+  void <a href="#dom-location-reload" title="dom-location-reload">reload</a>();
 
   // <a href="#url-decomposition-attributes">URL decomposition attributes</a> <!-- blame brendan for these "innovative" names -->
            attribute DOMString <a href="#dom-location-protocol" title="dom-location-protocol">protocol</a>;
@@ -46394,7 +46394,7 @@
 
    </dd>
 
-   <dt><var title="">location</var> . <code title="dom-location-reload">reload</code>()</dt>
+   <dt><var title="">location</var> . <code title="dom-location-reload"><a href="#dom-location-reload">reload</a></code>()</dt>
 
    <dd>
 
@@ -46458,17 +46458,37 @@
   successful, then the user agent must instead throw a
   <code><a href="#syntax_err">SYNTAX_ERR</a></code> exception.</p>
 
-<!--XXX
-  <dfn title="dom-location-reload"><code>reload()</code></dfn>
-  reload during resize event:
-  redisplay the current page (without reloading it). This
-  theoretically would have no effect but in practice can be useful to
-  work around rendering bugs.
+  <p>When the <dfn id="dom-location-reload" title="dom-location-reload"><code>reload()</code></dfn> method is
+  invoked, the user agent must run the appropriate steps from the
+  following list:</p>
 
-reload on shared Document updates all of them
+  <dl class="switch"><dt>If the currently executing <a href="#concept-task" title="concept-task">task</a> is the dispatch of a <code title="event-resize">resize</code> event in response to the user
+   resizing the <a href="#browsing-context">browsing context</a></dt>
 
-user reload must be equivalent to .reload()
--->
+   <dd><p>Repaint the <a href="#browsing-context">browsing context</a> and abort these
+   steps.</dd> <!-- this theoretically would have no effect but in
+   practice can be useful to work around rendering bugs. -->
+
+   <dt>Otherwise</dt>
+
+   <dd><p><a href="#navigate">Navigate</a> the <a href="#browsing-context">browsing context</a> to
+   the <a href="#the-document-s-current-address">the document's current address</a> with
+   <a href="#replacement-enabled">replacement enabled</a>. The <a href="#source-browsing-context">source browsing
+   context</a> must be the <a href="#browsing-context">browsing context</a> being
+   navigated.</dd> <!-- it appears that document.reload() always
+   uses GET and does not, e.g., re-POST. -->
+
+   <!-- http://software.hixie.ch/utilities/js/live-dom-viewer/saved/141 -->
+
+  </dl><p>When a user requests that the current page be reloaded through a
+  user interface element, the user agent should <a href="#navigate">navigate</a>
+  the <a href="#browsing-context">browsing context</a> to the same resource as
+  <code>Document</code>, with <a href="#replacement-enabled">replacement enabled</a>. In the
+  case of non-idempotent methods (e.g. HTTP POST), the user agent
+  should prompt the user to confirm the operation first, since
+  otherwise transactions (e.g. purchases or database modifications)
+  could be repeated. User agents may allow the user to explicitly
+  override any caches when reloading.</p>
 
   </div><p>The <code><a href="#location">Location</a></code> interface also has the complement of
   <a href="#url-decomposition-attributes">URL decomposition attributes</a>, <dfn id="dom-location-protocol" title="dom-location-protocol"><code>protocol</code></dfn>, <dfn id="dom-location-host" title="dom-location-host"><code>host</code></dfn>, <dfn id="dom-location-port" title="dom-location-port"><code>port</code></dfn>, <dfn id="dom-location-hostname" title="dom-location-hostname"><code>hostname</code></dfn>, <dfn id="dom-location-pathname" title="dom-location-pathname"><code>pathname</code></dfn>, <dfn id="dom-location-search" title="dom-location-search"><code>search</code></dfn>, and <dfn id="dom-location-hash" title="dom-location-hash"><code>hash</code></dfn>. <span class="impl">These must follow the rules given for URL decomposition

Received on Thursday, 11 June 2009 09:38:55 UTC