Changeset 264 for Dev/branches/rest-dojo-ui/client/rft

Timestamp:

02/16/12 15:00:23 (13 years ago)

Author:

hendrikvanantwerpen

Message:

• [Client] Added comments on content handling, added leave blocking on test3 and minor bugfix in hash if leaving is blocked.

File:

• Dev/branches/rest-dojo-ui/client/rft/content.js (modified) (2 diffs)

Dev/branches/rest-dojo-ui/client/rft/content.js

@@ +1 @@
+/** rft/ui/content - Load page content
+ *
+ * The rft/ui/content module is responsible for loading content in the app.
+ * Content is loaded by calling:
+ *    content.goTo('pageId');
+ * The page is then loaded from pages/pageId.html. This should contain one top node.
+ * This top node gets a _Page widget instantiated on it. The template should not
+ * specify another widget on the topnode. A page controller can be specified by
+ * the data-rft-mixin attribute to a class inherited from _PageController.
+ * You can also specify methods in the template in script tags as:
+ *     <script type="rft/method" data-rft-method-name="onVisit|onLeave">
+ *        // code
+ *     </script>
+ * The two relevant events are onVisit and onLeave. After loading and starting
+ * the complete page onVisit is called. Use this to link widgets together and
+ * load any dynamic content not handled by widget logic already.
+ * The event onLeave is called before navigating to another page. If false is 
+ * returned from this function, the navigation will be cancelled. You can use 
+ * this e.g. to ask confirmation of changed values are not saved.
+ */
 define(['dojo/_base/declare','dojo/_base/connect','dojo/_base/xhr',
     'dojo/_base/lang','dojo/_base/Deferred','dojo/hash',
@@ -67 +87 @@
                 if ( currentPage ) {
                     if ( currentPage.onLeave() === false ) {
+                        // restore hash if changed by hand or back button
+                        hash(currentHash);
                         dfd.reject();
                         return dfd.promise;