TartJS

Source: mvc/MobileRenderer.js

  1. // Copyright 2011 Tart. All Rights Reserved.
  2. //
  3. // Licensed under the Apache License, Version 2.0 (the "License");
  4. // you may not use this file except in compliance with the License.
  5. // You may obtain a copy of the License at
  6. //
  7. //      http://www.apache.org/licenses/LICENSE-2.0
  8. //
  9. // Unless required by applicable law or agreed to in writing, software
  10. // distributed under the License is distributed on an "AS-IS" BASIS,
  11. // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12. // See the License for the specific language governing permissions and
  13. // limitations under the License.
  15. goog.provide('tart.mvc.MobileRenderer');
  17. goog.require('tart.mvc.MobileAction');
  18. goog.require('tart.mvc.Renderer');
  22. /**
  23.  * @constructor
  24.  * @extends {tart.mvc.Renderer}
  25.  * @param {tart.mvc.LayoutTemplate} layout The default layout of the application. This layout will be used when an
  26.  * action chooses not to set its own layout.
  27.  * @param {Element} dom DOM element this renderer will render the application in.
  28.  */
  29. tart.mvc.MobileRenderer = function(layout, dom) {
  30.     goog.base(this, layout, dom);
  31. };
  32. goog.inherits(tart.mvc.MobileRenderer, tart.mvc.Renderer);
  35. /**
  36.  * Renders the final view; executing the action and putting the resulting view script in a related layout.
  37.  * @param {tart.mvc.uri.Router} router Application's router.
  38.  */
  39. tart.mvc.MobileRenderer.prototype.render = function(router) {
  40.     var oldLayout = this.currentLayout,
  41.         oldLayoutContext = this.currentLayoutContext,
  42.         oldViewScript = this.currentViewScript,
  43.         oldAction = this.currentAction,
  44.         viewMarkup,
  45.         layout,
  46.         view = new tart.mvc.View(),
  47.         controller = new (router.getController())(),
  48.         action = this.currentAction = new tart.mvc.MobileAction(router.getParams(), this.defaultLayout, view,
  49.             controller);
  51.     // if there is an action already executed and it has a deconstructor, call it.
  52.     if (oldAction)
  53.         goog.typeOf(oldAction.deconstructor) == 'function' && oldAction.deconstructor();
  55.     if (this.currentLayout && this.currentLayout.beforeViewRender)
  56.         goog.typeOf(this.currentLayout.beforeViewRender) == 'function' &&
  57.         this.currentLayout.beforeViewRender.call(layout);
  59.     // execute the action
  60.     var actionResult = router.getAction().call(action);
  62.     if (actionResult instanceof tart.mvc.uri.Redirection) {
  63.         return;
  64.     }
  68.     this.currentViewScript = action.view;
  69.     // generate the view markup
  70.     viewMarkup = action.getViewScript().call(action.view);
  71.     if (viewMarkup instanceof tart.mvc.uri.Redirection) {
  72.         return;
  73.     }
  74.     // instantiate the layout, set its content and then markup.
  75.     layout = new tart.mvc.Layout(action.view);
  76.     layout.setContent(viewMarkup);
  78.     this.currentLayout = action.getLayout();
  80.     // have to reset the layout if the action's layout is different than the previous one
  81.     if (this.currentLayout != oldLayout) {
  82.         layout.resetLayout = true;
  84.         // if there is a layout already rendered and it has a deconstructor, call it.
  85.         if (oldLayoutContext)
  86.             goog.typeOf(oldLayout.deconstructor) == 'function' && oldLayout.deconstructor.call(oldLayoutContext);
  88.         this.currentLayout.call(layout);
  89.     }
  91.     var isSameView = oldAction && oldAction.getViewScript() == action.getViewScript();
  94.     // if there is an action already executed and it has a deconstructor, call it.
  95.     if ((!isSameView || (isSameView && action.refresh != false)) && oldViewScript)
  96.         goog.typeOf(oldViewScript.deconstructor) == 'function' && oldViewScript.deconstructor();
  98.     if (!isSameView || (isSameView && action.refresh != false) || !oldViewScript)
  99.         layout.render(this.dom_);
  104.     // call respective render callback functions; if there are any. These let the developers
  105.     // watch out for rendering events.
  106.     goog.typeOf(action.view.onRender) == 'function' && action.view.onRender();
  107.     if (this.currentLayout.onViewRender)
  108.         goog.typeOf(this.currentLayout.onViewRender) == 'function' && this.currentLayout.onViewRender.call(layout);
  110.     this.currentLayoutContext = layout;
  111. };