` tag for views. @type String @default null */ // We leave this null by default so we can tell the difference between // the default case and a user-specified tag. tagName: null, /** The WAI-ARIA role of the control represented by this view. For example, a button may have a role of type 'button', or a pane may have a role of type 'alertdialog'. This property is used by assistive software to help visually challenged users navigate rich web applications. The full list of valid WAI-ARIA roles is available at: http://www.w3.org/TR/wai-aria/roles#roles_categorization @type String @default null */ ariaRole: null, /** Standard CSS class names to apply to the view's outer element. This property automatically inherits any class names defined by the view's superclasses as well. @type Array @default ['ember-view'] */ classNames: ['ember-view'], /** A list of properties of the view to apply as class names. If the property is a string value, the value of that string will be applied as a class name. // Applies the 'high' class to the view element Ember.View.create({ classNameBindings: ['priority'] priority: 'high' }); If the value of the property is a Boolean, the name of that property is added as a dasherized class name. // Applies the 'is-urgent' class to the view element Ember.View.create({ classNameBindings: ['isUrgent'] isUrgent: true }); If you would prefer to use a custom value instead of the dasherized property name, you can pass a binding like this: // Applies the 'urgent' class to the view element Ember.View.create({ classNameBindings: ['isUrgent:urgent'] isUrgent: true }); This list of properties is inherited from the view's superclasses as well. @type Array @default [] */ classNameBindings: [], /** A list of properties of the view to apply as attributes. If the property is a string value, the value of that string will be applied as the attribute. // Applies the type attribute to the element // with the value "button", like

Ember.View.create({ attributeBindings: ['type'], type: 'button' }); If the value of the property is a Boolean, the name of that property is added as an attribute. // Renders something like

Ember.View.create({ attributeBindings: ['enabled'], enabled: true }); */ attributeBindings: [], state: 'preRender', // ....................................................... // CORE DISPLAY METHODS // /** @private Setup a view, but do not finish waking it up. - configure childViews - register the view with the global views hash, which is used for event dispatch */ init: function() { this._super(); // Register the view for event handling. This hash is used by // Ember.RootResponder to dispatch incoming events. Ember.View.views[get(this, 'elementId')] = this; var childViews = get(this, '_childViews').slice(); // setup child views. be sure to clone the child views array first set(this, '_childViews', childViews); Ember.assert("Only arrays are allowed for 'classNameBindings'", Ember.typeOf(this.classNameBindings) === 'array'); this.classNameBindings = Ember.A(this.classNameBindings.slice()); Ember.assert("Only arrays are allowed for 'classNames'", Ember.typeOf(this.classNames) === 'array'); this.classNames = Ember.A(this.classNames.slice()); var viewController = get(this, 'viewController'); if (viewController) { viewController = Ember.getPath(viewController); if (viewController) { set(viewController, 'view', this); } } }, appendChild: function(view, options) { return this.invokeForState('appendChild', view, options); }, /** Removes the child view from the parent view. @param {Ember.View} view @returns {Ember.View} receiver */ removeChild: function(view) { // If we're destroying, the entire subtree will be // freed, and the DOM will be handled separately, // so no need to mess with childViews. if (this.isDestroying) { return; } // update parent node set(view, '_parentView', null); // remove view from childViews array. var childViews = get(this, '_childViews'); Ember.ArrayUtils.removeObject(childViews, view); this.propertyDidChange('childViews'); return this; }, /** Removes all children from the parentView. @returns {Ember.View} receiver */ removeAllChildren: function() { return this.mutateChildViews(function(view) { this.removeChild(view); }); }, destroyAllChildren: function() { return this.mutateChildViews(function(view) { view.destroy(); }); }, /** Removes the view from its parentView, if one is found. Otherwise does nothing. @returns {Ember.View} receiver */ removeFromParent: function() { var parent = get(this, '_parentView'); // Remove DOM element from parent this.remove(); if (parent) { parent.removeChild(this); } return this; }, /** You must call `destroy` on a view to destroy the view (and all of its child views). This will remove the view from any parent node, then make sure that the DOM element managed by the view can be released by the memory manager. */ willDestroy: function() { // calling this._super() will nuke computed properties and observers, // so collect any information we need before calling super. var childViews = get(this, '_childViews'), parent = get(this, '_parentView'), elementId = get(this, 'elementId'), childLen; // destroy the element -- this will avoid each child view destroying // the element over and over again... if (!this.removedFromDOM) { this.destroyElement(); } // remove from non-virtual parent view if viewName was specified if (this.viewName) { var nonVirtualParentView = get(this, 'parentView'); if (nonVirtualParentView) { set(nonVirtualParentView, this.viewName, null); } } // remove from parent if found. Don't call removeFromParent, // as removeFromParent will try to remove the element from // the DOM again. if (parent) { parent.removeChild(this); } this.state = 'destroyed'; childLen = get(childViews, 'length'); for (var i=childLen-1; i>=0; i--) { childViews[i].removedFromDOM = true; childViews[i].destroy(); } // next remove view from global hash delete Ember.View.views[get(this, 'elementId')]; }, /** Instantiates a view to be added to the childViews array during view initialization. You generally will not call this method directly unless you are overriding createChildViews(). Note that this method will automatically configure the correct settings on the new view instance to act as a child of the parent. @param {Class} viewClass @param {Hash} [attrs] Attributes to add @returns {Ember.View} new instance @test in createChildViews */ createChildView: function(view, attrs) { var coreAttrs, templateData; if (Ember.View.detect(view)) { coreAttrs = { _parentView: this, templateData: get(this, 'templateData') }; if (attrs) { view = view.create(coreAttrs, attrs); } else { view = view.create(coreAttrs); } var viewName = view.viewName; // don't set the property on a virtual view, as they are invisible to // consumers of the view API if (viewName) { set(get(this, 'concreteView'), viewName, view); } } else { Ember.assert('You must pass instance or subclass of View', view instanceof Ember.View); Ember.assert("You can only pass attributes when a class is provided", !attrs); if (!get(view, 'templateData')) { set(view, 'templateData', get(this, 'templateData')); } set(view, '_parentView', this); } return view; }, becameVisible: Ember.K, becameHidden: Ember.K, /** @private When the view's `isVisible` property changes, toggle the visibility element of the actual DOM element. */ _isVisibleDidChange: Ember.observer(function() { var isVisible = get(this, 'isVisible'); this.$().toggle(isVisible); if (this._isAncestorHidden()) { return; } if (isVisible) { this._notifyBecameVisible(); } else { this._notifyBecameHidden(); } }, 'isVisible'), _notifyBecameVisible: function() { this.fire('becameVisible'); this.forEachChildView(function(view) { var isVisible = get(view, 'isVisible'); if (isVisible || isVisible === null) { view._notifyBecameVisible(); } }); }, _notifyBecameHidden: function() { this.fire('becameHidden'); this.forEachChildView(function(view) { var isVisible = get(view, 'isVisible'); if (isVisible || isVisible === null) { view._notifyBecameHidden(); } }); }, _isAncestorHidden: function() { var parent = get(this, 'parentView'); while (parent) { if (get(parent, 'isVisible') === false) { return true; } parent = get(parent, 'parentView'); } return false; }, clearBuffer: function() { this.invokeRecursively(function(view) { this.buffer = null; }); }, transitionTo: function(state, children) { this.state = state; if (children !== false) { this.forEachChildView(function(view) { view.transitionTo(state); }); } }, /** @private Override the default event firing from Ember.Evented to also call methods with the given name. */ fire: function(name) { if (this[name]) { this[name].apply(this, [].slice.call(arguments, 1)); } this._super.apply(this, arguments); }, // ....................................................... // EVENT HANDLING // /** @private Handle events from `Ember.EventDispatcher` */ handleEvent: function(eventName, evt) { return this.invokeForState('handleEvent', eventName, evt); } }); /** Describe how the specified actions should behave in the various states that a view can exist in. Possible states: * preRender: when a view is first instantiated, and after its element was destroyed, it is in the preRender state * inBuffer: once a view has been rendered, but before it has been inserted into the DOM, it is in the inBuffer state * inDOM: once a view has been inserted into the DOM it is in the inDOM state. A view spends the vast majority of its existence in this state. * destroyed: once a view has been destroyed (using the destroy method), it is in this state. No further actions can be invoked on a destroyed view. */ // in the destroyed state, everything is illegal // before rendering has begun, all legal manipulations are noops. // inside the buffer, legal manipulations are done on the buffer // once the view has been inserted into the DOM, legal manipulations // are done on the DOM element. /** @private */ var DOMManager = { prepend: function(view, childView) { childView._insertElementLater(function() { var element = view.$(); element.prepend(childView.$()); }); }, after: function(view, nextView) { nextView._insertElementLater(function() { var element = view.$(); element.after(nextView.$()); }); }, replace: function(view) { var element = get(view, 'element'); set(view, 'element', null); view._insertElementLater(function() { Ember.$(element).replaceWith(get(view, 'element')); }); }, remove: function(view) { var elem = get(view, 'element'); set(view, 'element', null); view._lastInsert = null; Ember.$(elem).remove(); }, empty: function(view) { view.$().empty(); } }; Ember.View.reopen({ states: Ember.View.states, domManager: DOMManager }); // Create a global view hash. Ember.View.views = {}; // If someone overrides the child views computed property when // defining their class, we want to be able to process the user's // supplied childViews and then restore the original computed property // at view initialization time. This happens in Ember.ContainerView's init // method. Ember.View.childViewsProperty = childViewsProperty; Ember.View.applyAttributeBindings = function(elem, name, value) { var type = Ember.typeOf(value); var currentValue = elem.attr(name); // if this changes, also change the logic in ember-handlebars/lib/helpers/binding.js if ((type === 'string' || (type === 'number' && !isNaN(value))) && value !== currentValue) { elem.attr(name, value); } else if (value && type === 'boolean') { elem.attr(name, name); } else if (!value) { elem.removeAttr(name); } }; })(); (function() { // ========================================================================== // Project: Ember - JavaScript Application Framework // Copyright: ©2006-2011 Strobe Inc. and contributors. // Portions ©2008-2011 Apple Inc. All rights reserved. // License: Licensed under MIT license (see license.js) // ========================================================================== var get = Ember.get, set = Ember.set; Ember.View.states = { _default: { // appendChild is only legal while rendering the buffer. appendChild: function() { throw "You can't use appendChild outside of the rendering process"; }, $: function() { return Ember.$(); }, getElement: function() { return null; }, // Handle events from `Ember.EventDispatcher` handleEvent: function() { return true; // continue event propagation }, destroyElement: function(view) { set(view, 'element', null); view._lastInsert = null; return view; } } }; Ember.View.reopen({ states: Ember.View.states }); })(); (function() { // ========================================================================== // Project: Ember - JavaScript Application Framework // Copyright: ©2006-2011 Strobe Inc. and contributors. // Portions ©2008-2011 Apple Inc. All rights reserved. // License: Licensed under MIT license (see license.js) // ========================================================================== Ember.View.states.preRender = { parentState: Ember.View.states._default, // a view leaves the preRender state once its element has been // created (createElement). insertElement: function(view, fn) { if (view._lastInsert !== Ember.guidFor(fn)){ return; } view.createElement(); view._notifyWillInsertElement(); // after createElement, the view will be in the hasElement state. fn.call(view); view.transitionTo('inDOM'); view._notifyDidInsertElement(); }, empty: Ember.K, setElement: function(view, value) { view.beginPropertyChanges(); view.invalidateRecursively('element'); if (value !== null) { view.transitionTo('hasElement'); } view.endPropertyChanges(); return value; } }; })(); (function() { // ========================================================================== // Project: Ember - JavaScript Application Framework // Copyright: ©2006-2011 Strobe Inc. and contributors. // Portions ©2008-2011 Apple Inc. All rights reserved. // License: Licensed under MIT license (see license.js) // ========================================================================== var get = Ember.get, set = Ember.set, meta = Ember.meta; Ember.View.states.inBuffer = { parentState: Ember.View.states._default, $: function(view, sel) { // if we don't have an element yet, someone calling this.$() is // trying to update an element that isn't in the DOM. Instead, // rerender the view to allow the render method to reflect the // changes. view.rerender(); return Ember.$(); }, // when a view is rendered in a buffer, rerendering it simply // replaces the existing buffer with a new one rerender: function(view) { Ember.deprecate("Something you did caused a view to re-render after it rendered but before it was inserted into the DOM. Because this is avoidable and the cause of significant performance issues in applications, this behavior is deprecated. If you want to use the debugger to find out what caused this, you can set ENV.RAISE_ON_DEPRECATION to true."); view._notifyWillRerender(); view.clearRenderedChildren(); view.renderToBuffer(view.buffer, 'replaceWith'); }, // when a view is rendered in a buffer, appending a child // view will render that view and append the resulting // buffer into its buffer. appendChild: function(view, childView, options) { var buffer = view.buffer; childView = this.createChildView(childView, options); get(view, '_childViews').push(childView); childView.renderToBuffer(buffer); view.propertyDidChange('childViews'); return childView; }, // when a view is rendered in a buffer, destroying the // element will simply destroy the buffer and put the // state back into the preRender state. destroyElement: function(view) { view.clearBuffer(); view._notifyWillDestroyElement(); view.transitionTo('preRender'); return view; }, empty: function() { Ember.assert("Emptying a view in the inBuffer state is not allowed and should not happen under normal circumstances. Most likely there is a bug in your application. This may be due to excessive property change notifications."); }, // It should be impossible for a rendered view to be scheduled for // insertion. insertElement: function() { throw "You can't insert an element that has already been rendered"; }, setElement: function(view, value) { view.invalidateRecursively('element'); if (value === null) { view.transitionTo('preRender'); } else { view.clearBuffer(); view.transitionTo('hasElement'); } return value; } }; })(); (function() { // ========================================================================== // Project: Ember - JavaScript Application Framework // Copyright: ©2006-2011 Strobe Inc. and contributors. // Portions ©2008-2011 Apple Inc. All rights reserved. // License: Licensed under MIT license (see license.js) // ========================================================================== var get = Ember.get, set = Ember.set, meta = Ember.meta; Ember.View.states.hasElement = { parentState: Ember.View.states._default, $: function(view, sel) { var elem = get(view, 'element'); return sel ? Ember.$(sel, elem) : Ember.$(elem); }, getElement: function(view) { var parent = get(view, 'parentView'); if (parent) { parent = get(parent, 'element'); } if (parent) { return view.findElementInParentElement(parent); } return Ember.$("#" + get(view, 'elementId'))[0]; }, setElement: function(view, value) { if (value === null) { view.invalidateRecursively('element'); view.transitionTo('preRender'); } else { throw "You cannot set an element to a non-null value when the element is already in the DOM."; } return value; }, // once the view has been inserted into the DOM, rerendering is // deferred to allow bindings to synchronize. rerender: function(view) { view._notifyWillRerender(); view.clearRenderedChildren(); view.domManager.replace(view); return view; }, // once the view is already in the DOM, destroying it removes it // from the DOM, nukes its element, and puts it back into the // preRender state if inDOM. destroyElement: function(view) { view._notifyWillDestroyElement(); view.domManager.remove(view); return view; }, empty: function(view) { var _childViews = get(view, '_childViews'), len, idx; if (_childViews) { len = get(_childViews, 'length'); for (idx = 0; idx < len; idx++) { _childViews[idx]._notifyWillDestroyElement(); } } view.domManager.empty(view); }, // Handle events from `Ember.EventDispatcher` handleEvent: function(view, eventName, evt) { var handler = view[eventName]; if (Ember.typeOf(handler) === 'function') { return handler.call(view, evt); } else { return true; // continue event propagation } } }; Ember.View.states.inDOM = { parentState: Ember.View.states.hasElement, insertElement: function(view, fn) { if (view._lastInsert !== Ember.guidFor(fn)){ return; } throw "You can't insert an element into the DOM that has already been inserted"; } }; })(); (function() { // ========================================================================== // Project: Ember - JavaScript Application Framework // Copyright: ©2006-2011 Strobe Inc. and contributors. // Portions ©2008-2011 Apple Inc. All rights reserved. // License: Licensed under MIT license (see license.js) // ========================================================================== var destroyedError = "You can't call %@ on a destroyed view", fmt = Ember.String.fmt; Ember.View.states.destroyed = { parentState: Ember.View.states._default, appendChild: function() { throw fmt(destroyedError, ['appendChild']); }, rerender: function() { throw fmt(destroyedError, ['rerender']); }, destroyElement: function() { throw fmt(destroyedError, ['destroyElement']); }, empty: function() { throw fmt(destroyedError, ['empty']); }, setElement: function() { throw fmt(destroyedError, ["set('element', ...)"]); }, // Since element insertion is scheduled, don't do anything if // the view has been destroyed between scheduling and execution insertElement: Ember.K }; })(); (function() { // ========================================================================== // Project: Ember - JavaScript Application Framework // Copyright: ©2006-2011 Strobe Inc. and contributors. // Portions ©2008-2011 Apple Inc. All rights reserved. // License: Licensed under MIT license (see license.js) // ========================================================================== })(); (function() { // ========================================================================== // Project: Ember - JavaScript Application Framework // Copyright: ©2006-2011 Strobe Inc. and contributors. // Portions ©2008-2011 Apple Inc. All rights reserved. // License: Licensed under MIT license (see license.js) // ========================================================================== var get = Ember.get, set = Ember.set, meta = Ember.meta; var forEach = Ember.ArrayUtils.forEach; var childViewsProperty = Ember.computed(function() { return get(this, '_childViews'); }).property('_childViews').cacheable(); /** @class A `ContainerView` is an `Ember.View` subclass that allows for manual or programatic management of a view's `childViews` array that will correctly update the `ContainerView` instance's rendered DOM representation. ## Setting Initial Child Views The initial array of child views can be set in one of two ways. You can provide a `childViews` property at creation time that contains instance of `Ember.View`: aContainer = Ember.ContainerView.create({ childViews: [Ember.View.create(), Ember.View.create()] }) You can also provide a list of property names whose values are instances of `Ember.View`: aContainer = Ember.ContainerView.create({ childViews: ['aView', 'bView', 'cView'], aView: Ember.View.create(), bView: Ember.View.create() cView: Ember.View.create() }) The two strategies can be combined: aContainer = Ember.ContainerView.create({ childViews: ['aView', Ember.View.create()], aView: Ember.View.create() }) Each child view's rendering will be inserted into the container's rendered HTML in the same order as its position in the `childViews` property. ## Adding and Removing Child Views The views in a container's `childViews` array should be added and removed by manipulating the `childViews` property directly. To remove a view pass that view into a `removeObject` call on the container's `childViews` property. Given an empty `` the following code aContainer = Ember.ContainerView.create({ classNames: ['the-container'], childViews: ['aView', 'bView'], aView: Ember.View.create({ template: Ember.Handlebars.compile("A") }), bView: Ember.View.create({ template: Ember.Handlebars.compile("B") }) }) aContainer.appendTo('body') Results in the HTML

Removing a view aContainer.get('childViews') // [aContainer.aView, aContainer.bView] aContainer.get('childViews').removeObject(aContainer.get('bView')) aContainer.get('childViews') // [aContainer.aView] Will result in the following HTML

Similarly, adding a child view is accomplished by adding `Ember.View` instances to the container's `childViews` property. Given an empty `` the following code aContainer = Ember.ContainerView.create({ classNames: ['the-container'], childViews: ['aView', 'bView'], aView: Ember.View.create({ template: Ember.Handlebars.compile("A") }), bView: Ember.View.create({ template: Ember.Handlebars.compile("B") }) }) aContainer.appendTo('body') Results in the HTML

Adding a view AnotherViewClass = Ember.View.extend({ template: Ember.Handlebars.compile("Another view") }) aContainer.get('childViews') // [aContainer.aView, aContainer.bView] aContainer.get('childViews').pushObject(AnotherViewClass.create()) aContainer.get('childViews') // [aContainer.aView, ] Will result in the following HTML

Another view

Direct manipulation of childViews presence or absence in the DOM via calls to `remove` or `removeFromParent` or calls to a container's `removeChild` may not behave correctly. Calling `remove()` on a child view will remove the view's HTML, but it will remain as part of its container's `childView`s property. Calling `removeChild()` on the container will remove the passed view instance from the container's `childView`s but keep its HTML within the container's rendered view. Calling `removeFromParent()` behaves as expected but should be avoided in favor of direct manipulation of a container's `childViews` property. aContainer = Ember.ContainerView.create({ classNames: ['the-container'], childViews: ['aView', 'bView'], aView: Ember.View.create({ template: Ember.Handlebars.compile("A") }), bView: Ember.View.create({ template: Ember.Handlebars.compile("B") }) }) aContainer.appendTo('body') Results in the HTML

Calling `aContainer.get('aView').removeFromParent()` will result in the following HTML

And the `Ember.View` instance stored in `aContainer.aView` will be removed from `aContainer`'s `childViews` array. ## Templates and Layout A `template`, `templateName`, `defaultTemplate`, `layout`, `layoutName` or `defaultLayout` property on a container view will not result in the template or layout being rendered. The HTML contents of a `Ember.ContainerView`'s DOM representation will only be the rendered HTML of its child views. ## Binding a View to Display If you would like to display a single view in your ContainerView, you can set its `currentView` property. When the `currentView` property is set to a view instance, it will be added to the ContainerView's `childViews` array. If the `currentView` property is later changed to a different view, the new view will replace the old view. If `currentView` is set to `null`, the last `currentView` will be removed. This functionality is useful for cases where you want to bind the display of a ContainerView to a controller or state manager. For example, you can bind the `currentView` of a container to a controller like this: // Controller App.appController = Ember.Object.create({ view: Ember.View.create({ templateName: 'person_template' }) }); // Handlebars template {{view Ember.ContainerView currentViewBinding="App.appController.view"}} @extends Ember.View */ Ember.ContainerView = Ember.View.extend({ init: function() { var childViews = get(this, 'childViews'); Ember.defineProperty(this, 'childViews', childViewsProperty); this._super(); var _childViews = get(this, '_childViews'); forEach(childViews, function(viewName, idx) { var view; if ('string' === typeof viewName) { view = get(this, viewName); view = this.createChildView(view); set(this, viewName, view); } else { view = this.createChildView(viewName); } _childViews[idx] = view; }, this); // Make the _childViews array observable Ember.A(_childViews); // Sets up an array observer on the child views array. This // observer will detect when child views are added or removed // and update the DOM to reflect the mutation. get(this, 'childViews').addArrayObserver(this, { willChange: 'childViewsWillChange', didChange: 'childViewsDidChange' }); }, /** Instructs each child view to render to the passed render buffer. @param {Ember.RenderBuffer} buffer the buffer to render to @private */ render: function(buffer) { this.forEachChildView(function(view) { view.renderToBuffer(buffer); }); }, /** When the container view is destroyed, tear down the child views array observer. @private */ willDestroy: function() { get(this, 'childViews').removeArrayObserver(this, { willChange: 'childViewsWillChange', didChange: 'childViewsDidChange' }); this._super(); }, /** When a child view is removed, destroy its element so that it is removed from the DOM. The array observer that triggers this action is set up in the `renderToBuffer` method. @private @param {Ember.Array} views the child views array before mutation @param {Number} start the start position of the mutation @param {Number} removed the number of child views removed **/ childViewsWillChange: function(views, start, removed) { if (removed === 0) { return; } var changedViews = views.slice(start, start+removed); this.initializeViews(changedViews, null, null); this.invokeForState('childViewsWillChange', views, start, removed); }, /** When a child view is added, make sure the DOM gets updated appropriately. If the view has already rendered an element, we tell the child view to create an element and insert it into the DOM. If the enclosing container view has already written to a buffer, but not yet converted that buffer into an element, we insert the string representation of the child into the appropriate place in the buffer. @private @param {Ember.Array} views the array of child views afte the mutation has occurred @param {Number} start the start position of the mutation @param {Number} removed the number of child views removed @param {Number} the number of child views added */ childViewsDidChange: function(views, start, removed, added) { var len = get(views, 'length'); // No new child views were added; bail out. if (added === 0) return; var changedViews = views.slice(start, start+added); this.initializeViews(changedViews, this, get(this, 'templateData')); // Let the current state handle the changes this.invokeForState('childViewsDidChange', views, start, added); }, initializeViews: function(views, parentView, templateData) { forEach(views, function(view) { set(view, '_parentView', parentView); if (!get(view, 'templateData')) { set(view, 'templateData', templateData); } }); }, /** Schedules a child view to be inserted into the DOM after bindings have finished syncing for this run loop. @param {Ember.View} view the child view to insert @param {Ember.View} prev the child view after which the specified view should be inserted @private */ _scheduleInsertion: function(view, prev) { if (prev) { prev.domManager.after(prev, view); } else { this.domManager.prepend(this, view); } }, currentView: null, _currentViewWillChange: Ember.beforeObserver(function() { var childViews = get(this, 'childViews'), currentView = get(this, 'currentView'); if (currentView) { childViews.removeObject(currentView); } }, 'currentView'), _currentViewDidChange: Ember.observer(function() { var childViews = get(this, 'childViews'), currentView = get(this, 'currentView'); if (currentView) { childViews.pushObject(currentView); } }, 'currentView') }); // Ember.ContainerView extends the default view states to provide different // behavior for childViewsWillChange and childViewsDidChange. Ember.ContainerView.states = { parent: Ember.View.states, inBuffer: { childViewsDidChange: function(parentView, views, start, added) { var buffer = parentView.buffer, startWith, prev, prevBuffer, view; // Determine where to begin inserting the child view(s) in the // render buffer. if (start === 0) { // If views were inserted at the beginning, prepend the first // view to the render buffer, then begin inserting any // additional views at the beginning. view = views[start]; startWith = start + 1; view.renderToBuffer(buffer, 'prepend'); } else { // Otherwise, just insert them at the same place as the child // views mutation. view = views[start - 1]; startWith = start; } for (var i=startWith; i` and the following code: someItemsView = Ember.CollectionView.create({ classNames: ['a-collection'], content: ['A','B','C'], itemViewClass: Ember.View.extend({ template: Ember.Handlebars.compile("the letter: {{content}}") }) }) someItemsView.appendTo('body') Will result in the following HTML structure

the letter: A

the letter: B

the letter: C

## Automatic matching of parent/child tagNames Setting the `tagName` property of a `CollectionView` to any of "ul", "ol", "table", "thead", "tbody", "tfoot", "tr", or "select" will result in the item views receiving an appropriately matched `tagName` property. Given an empty `` and the following code: anUndorderedListView = Ember.CollectionView.create({ tagName: 'ul', content: ['A','B','C'], itemViewClass: Ember.View.extend({ template: Ember.Handlebars.compile("the letter: {{content}}") }) }) anUndorderedListView.appendTo('body') Will result in the following HTML structure

the letter: A
the letter: B
the letter: C

Additional tagName pairs can be provided by adding to `Ember.CollectionView.CONTAINER_MAP ` Ember.CollectionView.CONTAINER_MAP['article'] = 'section' ## Empty View You can provide an `Ember.View` subclass to the `Ember.CollectionView` instance as its `emptyView` property. If the `content` property of a `CollectionView` is set to `null` or an empty array, an instance of this view will be the `CollectionView`s only child. aListWithNothing = Ember.CollectionView.create({ classNames: ['nothing'] content: null, emptyView: Ember.View.extend({ template: Ember.Handlebars.compile("The collection is empty") }) }) aListWithNothing.appendTo('body') Will result in the following HTML structure

The collection is empty

## Adding and Removing items The `childViews` property of a `CollectionView` should not be directly manipulated. Instead, add, remove, replace items from its `content` property. This will trigger appropriate changes to its rendered HTML. ## Use in templates via the `{{collection}}` Ember.Handlebars helper Ember.Handlebars provides a helper specifically for adding `CollectionView`s to templates. See `Ember.Handlebars.collection` for more details @since Ember 0.9 @extends Ember.ContainerView */ Ember.CollectionView = Ember.ContainerView.extend( /** @scope Ember.CollectionView.prototype */ { /** A list of items to be displayed by the Ember.CollectionView. @type Ember.Array @default null */ content: null, /** @private This provides metadata about what kind of empty view class this collection would like if it is being instantiated from another system (like Handlebars) */ emptyViewClass: Ember.View, /** An optional view to display if content is set to an empty array. @type Ember.View @default null */ emptyView: null, /** @type Ember.View @default Ember.View */ itemViewClass: Ember.View, /** @private */ init: function() { var ret = this._super(); this._contentDidChange(); return ret; }, _contentWillChange: Ember.beforeObserver(function() { var content = this.get('content'); if (content) { content.removeArrayObserver(this); } var len = content ? get(content, 'length') : 0; this.arrayWillChange(content, 0, len); }, 'content'), /** @private Check to make sure that the content has changed, and if so, update the children directly. This is always scheduled asynchronously, to allow the element to be created before bindings have synchronized and vice versa. */ _contentDidChange: Ember.observer(function() { var content = get(this, 'content'); if (content) { Ember.assert(fmt("an Ember.CollectionView's content must implement Ember.Array. You passed %@", [content]), Ember.Array.detect(content)); content.addArrayObserver(this); } var len = content ? get(content, 'length') : 0; this.arrayDidChange(content, 0, null, len); }, 'content'), willDestroy: function() { var content = get(this, 'content'); if (content) { content.removeArrayObserver(this); } this._super(); }, arrayWillChange: function(content, start, removedCount) { // If the contents were empty before and this template collection has an // empty view remove it now. var emptyView = get(this, 'emptyView'); if (emptyView && emptyView instanceof Ember.View) { emptyView.removeFromParent(); } // Loop through child views that correspond with the removed items. // Note that we loop from the end of the array to the beginning because // we are mutating it as we go. var childViews = get(this, 'childViews'), childView, idx, len; len = get(childViews, 'length'); var removingAll = removedCount === len; if (removingAll) { this.invokeForState('empty'); } for (idx = start + removedCount - 1; idx >= start; idx--) { childView = childViews[idx]; if (removingAll) { childView.removedFromDOM = true; } childView.destroy(); } }, /** Called when a mutation to the underlying content array occurs. This method will replay that mutation against the views that compose the Ember.CollectionView, ensuring that the view reflects the model. This array observer is added in contentDidChange. @param {Array} addedObjects the objects that were added to the content @param {Array} removedObjects the objects that were removed from the content @param {Number} changeIndex the index at which the changes occurred */ arrayDidChange: function(content, start, removed, added) { var itemViewClass = get(this, 'itemViewClass'), childViews = get(this, 'childViews'), addedViews = [], view, item, idx, len, itemTagName; if ('string' === typeof itemViewClass) { itemViewClass = Ember.getPath(itemViewClass); } Ember.assert(fmt("itemViewClass must be a subclass of Ember.View, not %@", [itemViewClass]), Ember.View.detect(itemViewClass)); len = content ? get(content, 'length') : 0; if (len) { for (idx = start; idx < start+added; idx++) { item = content.objectAt(idx); view = this.createChildView(itemViewClass, { content: item, contentIndex: idx }); addedViews.push(view); } } else { var emptyView = get(this, 'emptyView'); if (!emptyView) { return; } emptyView = this.createChildView(emptyView); addedViews.push(emptyView); set(this, 'emptyView', emptyView); } childViews.replace(start, 0, addedViews); }, createChildView: function(view, attrs) { view = this._super(view, attrs); var itemTagName = get(view, 'tagName'); var tagName = (itemTagName === null || itemTagName === undefined) ? Ember.CollectionView.CONTAINER_MAP[get(this, 'tagName')] : itemTagName; set(view, 'tagName', tagName); return view; } }); /** @static A map of parent tags to their default child tags. You can add additional parent tags if you want collection views that use a particular parent tag to default to a child tag. @type Hash @constant */ Ember.CollectionView.CONTAINER_MAP = { ul: 'li', ol: 'li', table: 'tr', thead: 'tr', tbody: 'tr', tfoot: 'tr', tr: 'td', select: 'option' }; })(); (function() { // ========================================================================== // Project: Ember - JavaScript Application Framework // Copyright: ©2006-2011 Strobe Inc. and contributors. // Portions ©2008-2011 Apple Inc. All rights reserved. // License: Licensed under MIT license (see license.js) // ========================================================================== })(); (function() { // ========================================================================== // Project: Ember - JavaScript Application Framework // Copyright: ©2006-2011 Strobe Inc. and contributors. // Portions ©2008-2011 Apple Inc. All rights reserved. // License: Licensed under MIT license (see license.js) // ========================================================================== /*globals jQuery*/ })(); (function() { var get = Ember.get, set = Ember.set, getPath = Ember.getPath; Ember.State = Ember.Object.extend(Ember.Evented, { isState: true, parentState: null, start: null, name: null, path: Ember.computed(function() { var parentPath = getPath(this, 'parentState.path'), path = get(this, 'name'); if (parentPath) { path = parentPath + '.' + path; } return path; }).property().cacheable(), /** @private Override the default event firing from Ember.Evented to also call methods with the given name. */ fire: function(name) { if (this[name]) { this[name].apply(this, [].slice.call(arguments, 1)); } this._super.apply(this, arguments); }, init: function() { var states = get(this, 'states'), foundStates; set(this, 'childStates', Ember.A()); var name; // As a convenience, loop over the properties // of this state and look for any that are other // Ember.State instances or classes, and move them // to the `states` hash. This avoids having to // create an explicit separate hash. if (!states) { states = {}; for (name in this) { if (name === "constructor") { continue; } this.setupChild(states, name, this[name]); } set(this, 'states', states); } else { for (name in states) { this.setupChild(states, name, states[name]); } } set(this, 'routes', {}); }, setupChild: function(states, name, value) { if (!value) { return false; } if (Ember.State.detect(value)) { value = value.create({ name: name }); } else if (value.isState) { set(value, 'name', name); } if (value.isState) { set(value, 'parentState', this); get(this, 'childStates').pushObject(value); states[name] = value; } }, /** A Boolean value indicating whether the state is a leaf state in the state hierarchy. This is false if the state has child states; otherwise it is true. @property {Boolean} */ isLeaf: Ember.computed(function() { return !get(this, 'childStates').length; }).cacheable(), setupControllers: Ember.K, enter: Ember.K, exit: Ember.K }); })(); (function() { var get = Ember.get, set = Ember.set, getPath = Ember.getPath, fmt = Ember.String.fmt; /** @class StateManager is part of Ember's implementation of a finite state machine. A StateManager instance manages a number of properties that are instances of `Ember.State`, tracks the current active state, and triggers callbacks when states have changed. ## Defining States The states of StateManager can be declared in one of two ways. First, you can define a `states` property that contains all the states: managerA = Ember.StateManager.create({ states: { stateOne: Ember.State.create(), stateTwo: Ember.State.create() } }) managerA.get('states') // { // stateOne: Ember.State.create(), // stateTwo: Ember.State.create() // } You can also add instances of `Ember.State` (or an `Ember.State` subclass) directly as properties of a StateManager. These states will be collected into the `states` property for you. managerA = Ember.StateManager.create({ stateOne: Ember.State.create(), stateTwo: Ember.State.create() }) managerA.get('states') // { // stateOne: Ember.State.create(), // stateTwo: Ember.State.create() // } ## The Initial State When created a StateManager instance will immediately enter into the state defined as its `start` property or the state referenced by name in its `initialState` property: managerA = Ember.StateManager.create({ start: Ember.State.create({}) }) managerA.getPath('currentState.name') // 'start' managerB = Ember.StateManager.create({ initialState: 'beginHere', beginHere: Ember.State.create({}) }) managerB.getPath('currentState.name') // 'beginHere' Because it is a property you may also provided a computed function if you wish to derive an `initialState` programmatically: managerC = Ember.StateManager.create({ initialState: function(){ if (someLogic) { return 'active'; } else { return 'passive'; } }.property(), active: Ember.State.create({}), passive: Ember.State.create({}) }) ## Moving Between States A StateManager can have any number of Ember.State objects as properties and can have a single one of these states as its current state. Calling `goToState` transitions between states: robotManager = Ember.StateManager.create({ initialState: 'poweredDown', poweredDown: Ember.State.create({}), poweredUp: Ember.State.create({}) }) robotManager.getPath('currentState.name') // 'poweredDown' robotManager.goToState('poweredUp') robotManager.getPath('currentState.name') // 'poweredUp' Before transitioning into a new state the existing `currentState` will have its `exit` method called with the StateManager instance as its first argument and an object representing the transition as its second argument. After transitioning into a new state the new `currentState` will have its `enter` method called with the StateManager instance as its first argument and an object representing the transition as its second argument. robotManager = Ember.StateManager.create({ initialState: 'poweredDown', poweredDown: Ember.State.create({ exit: function(stateManager, transition){ console.log("exiting the poweredDown state") } }), poweredUp: Ember.State.create({ enter: function(stateManager, transition){ console.log("entering the poweredUp state. Destroy all humans.") } }) }) robotManager.getPath('currentState.name') // 'poweredDown' robotManager.goToState('poweredUp') // will log // 'exiting the poweredDown state' // 'entering the poweredUp state. Destroy all humans.' Once a StateManager is already in a state, subsequent attempts to enter that state will not trigger enter or exit method calls. Attempts to transition into a state that the manager does not have will result in no changes in the StateManager's current state: robotManager = Ember.StateManager.create({ initialState: 'poweredDown', poweredDown: Ember.State.create({ exit: function(stateManager, transition){ console.log("exiting the poweredDown state") } }), poweredUp: Ember.State.create({ enter: function(stateManager, transition){ console.log("entering the poweredUp state. Destroy all humans.") } }) }) robotManager.getPath('currentState.name') // 'poweredDown' robotManager.goToState('poweredUp') // will log // 'exiting the poweredDown state' // 'entering the poweredUp state. Destroy all humans.' robotManager.goToState('poweredUp') // no logging, no state change robotManager.goToState('someUnknownState') // silently fails robotManager.getPath('currentState.name') // 'poweredUp' Each state property may itself contain properties that are instances of Ember.State. The StateManager can transition to specific sub-states in a series of goToState method calls or via a single goToState with the full path to the specific state. The StateManager will also keep track of the full path to its currentState robotManager = Ember.StateManager.create({ initialState: 'poweredDown', poweredDown: Ember.State.create({ charging: Ember.State.create(), charged: Ember.State.create() }), poweredUp: Ember.State.create({ mobile: Ember.State.create(), stationary: Ember.State.create() }) }) robotManager.getPath('currentState.name') // 'poweredDown' robotManager.goToState('poweredUp') robotManager.getPath('currentState.name') // 'poweredUp' robotManager.goToState('mobile') robotManager.getPath('currentState.name') // 'mobile' // transition via a state path robotManager.goToState('poweredDown.charging') robotManager.getPath('currentState.name') // 'charging' robotManager.getPath('currentState.get.path') // 'poweredDown.charging' Enter transition methods will be called for each state and nested child state in their hierarchical order. Exit methods will be called for each state and its nested states in reverse hierarchical order. Exit transitions for a parent state are not called when entering into one of its child states, only when transitioning to a new section of possible states in the hierarchy. robotManager = Ember.StateManager.create({ initialState: 'poweredDown', poweredDown: Ember.State.create({ enter: function(){}, exit: function(){ console.log("exited poweredDown state") }, charging: Ember.State.create({ enter: function(){}, exit: function(){} }), charged: Ember.State.create({ enter: function(){ console.log("entered charged state") }, exit: function(){ console.log("exited charged state") } }) }), poweredUp: Ember.State.create({ enter: function(){ console.log("entered poweredUp state") }, exit: function(){}, mobile: Ember.State.create({ enter: function(){ console.log("entered mobile state") }, exit: function(){} }), stationary: Ember.State.create({ enter: function(){}, exit: function(){} }) }) }) robotManager.get('currentState.get.path') // 'poweredDown' robotManager.goToState('charged') // logs 'entered charged state' // but does *not* log 'exited poweredDown state' robotManager.getPath('currentState.name') // 'charged robotManager.goToState('poweredUp.mobile') // logs // 'exited charged state' // 'exited poweredDown state' // 'entered poweredUp state' // 'entered mobile state' During development you can set a StateManager's `enableLogging` property to `true` to receive console messages of state transitions. robotManager = Ember.StateManager.create({ enableLogging: true }) ## Managing currentState with Actions To control which transitions between states are possible for a given state, StateManager can receive and route action messages to its states via the `send` method. Calling to `send` with an action name will begin searching for a method with the same name starting at the current state and moving up through the parent states in a state hierarchy until an appropriate method is found or the StateManager instance itself is reached. If an appropriately named method is found it will be called with the state manager as the first argument and an optional `context` object as the second argument. managerA = Ember.StateManager.create({ initialState: 'stateOne.substateOne.subsubstateOne', stateOne: Ember.State.create({ substateOne: Ember.State.create({ anAction: function(manager, context){ console.log("an action was called") }, subsubstateOne: Ember.State.create({}) }) }) }) managerA.getPath('currentState.name') // 'subsubstateOne' managerA.send('anAction') // 'stateOne.substateOne.subsubstateOne' has no anAction method // so the 'anAction' method of 'stateOne.substateOne' is called // and logs "an action was called" // with managerA as the first argument // and no second argument someObject = {} managerA.send('anAction', someObject) // the 'anAction' method of 'stateOne.substateOne' is called again // with managerA as the first argument and // someObject as the second argument. If the StateManager attempts to send an action but does not find an appropriately named method in the current state or while moving upwards through the state hierarchy it will throw a new Ember.Error. Action detection only moves upwards through the state hierarchy from the current state. It does not search in other portions of the hierarchy. managerB = Ember.StateManager.create({ initialState: 'stateOne.substateOne.subsubstateOne', stateOne: Ember.State.create({ substateOne: Ember.State.create({ subsubstateOne: Ember.State.create({}) }) }), stateTwo: Ember.State.create({ anAction: function(manager, context){ // will not be called below because it is // not a parent of the current state } }) }) managerB.getPath('currentState.name') // 'subsubstateOne' managerB.send('anAction') // Error: could not // respond to event anAction in state stateOne.substateOne.subsubstateOne. Inside of an action method the given state should delegate `goToState` calls on its StateManager. robotManager = Ember.StateManager.create({ initialState: 'poweredDown.charging', poweredDown: Ember.State.create({ charging: Ember.State.create({ chargeComplete: function(manager, context){ manager.goToState('charged') } }), charged: Ember.State.create({ boot: function(manager, context){ manager.goToState('poweredUp') } }) }), poweredUp: Ember.State.create({ beginExtermination: function(manager, context){ manager.goToState('rampaging') }, rampaging: Ember.State.create() }) }) robotManager.getPath('currentState.name') // 'charging' robotManager.send('boot') // throws error, no boot action // in current hierarchy robotManager.getPath('currentState.name') // remains 'charging' robotManager.send('beginExtermination') // throws error, no beginExtermination // action in current hierarchy robotManager.getPath('currentState.name') // remains 'charging' robotManager.send('chargeComplete') robotManager.getPath('currentState.name') // 'charged' robotManager.send('boot') robotManager.getPath('currentState.name') // 'poweredUp' robotManager.send('beginExtermination', allHumans) robotManager.getPath('currentState.name') // 'rampaging' **/ Ember.StateManager = Ember.State.extend( /** @scope Ember.StateManager.prototype */ { /** When creating a new statemanager, look for a default state to transition into. This state can either be named `start`, or can be specified using the `initialState` property. */ init: function() { this._super(); set(this, 'stateMeta', Ember.Map.create()); var initialState = get(this, 'initialState'); if (!initialState && getPath(this, 'states.start')) { initialState = 'start'; } if (initialState) { this.goToState(initialState); } }, currentState: null, /** If set to true, `errorOnUnhandledEvents` will cause an exception to be raised if you attempt to send an event to a state manager that is not handled by the current state or any of its parent states. @property {Boolean} */ errorOnUnhandledEvent: true, send: function(event, context) { this.sendRecursively(event, get(this, 'currentState'), context); }, sendRecursively: function(event, currentState, context) { var log = this.enableLogging; var action = currentState[event]; // Test to see if the action is a method that // can be invoked. Don't blindly check just for // existence, because it is possible the state // manager has a child state of the given name, // and we should still raise an exception in that // case. if (typeof action === 'function') { if (log) { Ember.Logger.log(fmt("STATEMANAGER: Sending event '%@' to state %@.", [event, get(currentState, 'path')])); } action.call(currentState, this, context); } else { var parentState = get(currentState, 'parentState'); if (parentState) { this.sendRecursively(event, parentState, context); } else if (get(this, 'errorOnUnhandledEvent')) { throw new Ember.Error(this.toString() + " could not respond to event " + event + " in state " + getPath(this, 'currentState.path') + "."); } } }, findStatesByRoute: function(state, route) { if (!route || route === "") { return undefined; } var r = route.split('.'), ret = []; for (var i=0, len = r.length; i < len; i += 1) { var states = get(state, 'states') ; if (!states) { return undefined; } var s = get(states, r[i]); if (s) { state = s; ret.push(s); } else { return undefined; } } return ret; }, goToState: function() { // not deprecating this yet so people don't constantly need to // make trivial changes for little reason. return this.transitionTo.apply(this, arguments); }, pathForSegments: function(array) { return Ember.ArrayUtils.map(array, function(tuple) { Ember.assert("A segment passed to transitionTo must be an Array", Ember.typeOf(tuple) === "array"); return tuple[0]; }).join("."); }, transitionTo: function(name, context) { // 1. Normalize arguments // 2. Ensure that we are in the correct state // 3. Map provided path to context objects and send // appropriate setupControllers events if (Ember.empty(name)) { return; } var segments; if (Ember.typeOf(name) === "array") { segments = Array.prototype.slice.call(arguments); } else { segments = [[name, context]]; } var path = this.pathForSegments(segments); var currentState = get(this, 'currentState') || this, state, newState; var exitStates = [], enterStates, resolveState; state = currentState; if (state.routes[path]) { // cache hit var route = state.routes[path]; exitStates = route.exitStates; enterStates = route.enterStates; state = route.futureState; resolveState = route.resolveState; } else { // cache miss newState = this.findStatesByRoute(currentState, path); while (state && !newState) { exitStates.unshift(state); state = get(state, 'parentState'); if (!state) { newState = this.findStatesByRoute(this, path); if (!newState) { return; } } newState = this.findStatesByRoute(state, path); } resolveState = state; enterStates = newState.slice(0); exitStates = exitStates.slice(0); if (enterStates.length > 0) { state = enterStates[enterStates.length - 1]; while (enterStates.length > 0 && enterStates[0] === exitStates[0]) { enterStates.shift(); exitStates.shift(); } } currentState.routes[path] = { exitStates: exitStates, enterStates: enterStates, futureState: state, resolveState: resolveState }; } this.enterState(exitStates, enterStates, state); this.triggerSetupContext(resolveState, segments); }, triggerSetupContext: function(root, segments) { var state = root; Ember.ArrayUtils.forEach(segments, function(tuple) { var path = tuple[0], context = tuple[1]; state = this.findStatesByRoute(state, path); state = state[state.length-1]; state.fire('setupControllers', this, context); }, this); //getPath(root, path).setupControllers(this, context); }, getState: function(name) { var state = get(this, name), parentState = get(this, 'parentState'); if (state) { return state; } else if (parentState) { return parentState.getState(name); } }, asyncEach: function(list, callback, doneCallback) { var async = false, self = this; if (!list.length) { if (doneCallback) { doneCallback.call(this); } return; } var head = list[0]; var tail = list.slice(1); var transition = { async: function() { async = true; }, resume: function() { self.asyncEach(tail, callback, doneCallback); } }; callback.call(this, head, transition); if (!async) { transition.resume(); } }, enterState: function(exitStates, enterStates, state) { var log = this.enableLogging; var stateManager = this; exitStates = exitStates.slice(0).reverse(); this.asyncEach(exitStates, function(state, transition) { state.fire('exit', stateManager, transition); }, function() { this.asyncEach(enterStates, function(state, transition) { if (log) { Ember.Logger.log("STATEMANAGER: Entering " + get(state, 'path')); } state.fire('enter', stateManager, transition); }, function() { var startState = state, enteredState, initialState; initialState = get(startState, 'initialState'); if (!initialState) { initialState = 'start'; } // right now, start states cannot be entered asynchronously while (startState = get(get(startState, 'states'), initialState)) { enteredState = startState; if (log) { Ember.Logger.log("STATEMANAGER: Entering " + get(startState, 'path')); } startState.fire('enter', stateManager); initialState = get(startState, 'initialState'); if (!initialState) { initialState = 'start'; } } set(this, 'currentState', enteredState || state); }); }); } }); })(); (function() { var escapeForRegex = function(text) { return text.replace(/[\-\[\]{}()*+?.,\\\^\$|#\s]/g, "\\$&"); }; Ember._RouteMatcher = Ember.Object.extend({ state: null, init: function() { var route = this.route, identifiers = [], count = 1, escaped; // Strip off leading slash if present if (route.charAt(0) === '/') { route = this.route = route.substr(1); } escaped = escapeForRegex(route); var regex = escaped.replace(/:([a-z_]+)(?=$|\/)/gi, function(match, id) { identifiers[count++] = id; return "([^/]+)"; }); this.identifiers = identifiers; this.regex = new RegExp("^/?" + regex); }, match: function(path) { var match = path.match(this.regex); if (match) { var identifiers = this.identifiers, hash = {}; for (var i=1, l=identifiers.length; iPeople') }) PhotoListView = Ember.View.extend({ classNames: ['my-photos-css-class'], template: Ember.Handlebars.compile('

Photos

') }) viewStates = Ember.StateManager.create({ showingPeople: Ember.ViewState.create({ view: ContactListView }), showingPhotos: Ember.ViewState.create({ view: PhotoListView }) }) viewStates.goToState('showingPeople') The above code will change the rendered HTML from to

People

Changing the current state via `goToState` from `showingPeople` to `showingPhotos` will remove the `showingPeople` view and add the `showingPhotos` view: viewStates.goToState('showingPhotos') will change the rendered HTML to

Photos

When entering nested `ViewState`s, each state's view will be draw into the the StateManager's `rootView` or `rootElement` as siblings. ContactListView = Ember.View.extend({ classNames: ['my-contacts-css-class'], template: Ember.Handlebars.compile('

People

') }) EditAContactView = Ember.View.extend({ classNames: ['editing-a-contact-css-class'], template: Ember.Handlebars.compile('Editing...') }) viewStates = Ember.StateManager.create({ showingPeople: Ember.ViewState.create({ view: ContactListView, withEditingPanel: Ember.ViewState.create({ view: EditAContactView }) }) }) viewStates.goToState('showingPeople.withEditingPanel') Will result in the following rendered HTML:

People

Editing...

ViewState views are added and removed from their StateManager's view via their `enter` and `exit` methods. If you need to override these methods, be sure to call `_super` to maintain the adding and removing behavior: viewStates = Ember.StateManager.create({ aState: Ember.ViewState.create({ view: Ember.View.extend({}), enter: function(manager, transition){ // calling _super ensures this view will be // properly inserted this._super(manager, transition); // now you can do other things } }) }) ## Managing Multiple Sections of A Page With States Multiple StateManagers can be combined to control multiple areas of an application's rendered views. Given the following HTML body:

You could separately manage view state for each section with two StateManagers navigationStates = Ember.StateManager.create({ rootElement: '#sidebar-nav', userAuthenticated: Em.ViewState.create({ view: Ember.View.extend({}) }), userNotAuthenticated: Em.ViewState.create({ view: Ember.View.extend({}) }) }) contentStates = Ember.StateManager.create({ rootElement: '#content-area', books: Em.ViewState.create({ view: Ember.View.extend({}) }), music: Em.ViewState.create({ view: Ember.View.extend({}) }) }) If you prefer to start with an empty body and manage state programmatically you can also take advantage of StateManager's `rootView` property and the ability of `Ember.ContainerView`s to manually manage their child views. dashboard = Ember.ContainerView.create({ childViews: ['navigationAreaView', 'contentAreaView'], navigationAreaView: Ember.ContainerView.create({}), contentAreaView: Ember.ContainerView.create({}) }) navigationStates = Ember.StateManager.create({ rootView: dashboard.get('navigationAreaView'), userAuthenticated: Em.ViewState.create({ view: Ember.View.extend({}) }), userNotAuthenticated: Em.ViewState.create({ view: Ember.View.extend({}) }) }) contentStates = Ember.StateManager.create({ rootView: dashboard.get('contentAreaView'), books: Em.ViewState.create({ view: Ember.View.extend({}) }), music: Em.ViewState.create({ view: Ember.View.extend({}) }) }) dashboard.appendTo('body') ## User Manipulation of State via `{{action}}` Helpers The Handlebars `{{action}}` helper is StateManager-aware and will use StateManager action sending to connect user interaction to action-based state transitions. Given the following body and handlebars template And application code App = Ember.Application.create() App.appStates = Ember.StateManager.create({ initialState: 'aState', aState: Ember.State.create({ anAction: function(manager, context){} }), bState: Ember.State.create({}) }) A user initiated click or touch event on "Go" will trigger the 'anAction' method of `App.appStates.aState` with `App.appStates` as the first argument and a `jQuery.Event` object as the second object. The `jQuery.Event` will include a property `view` that references the `Ember.View` object that was interacted with. **/ Ember.StateManager.reopen( /** @scope Ember.StateManager.prototype */ { /** If the current state is a view state or the descendent of a view state, this property will be the view associated with it. If there is no view state active in this state manager, this value will be null. @property */ currentView: Ember.computed(function() { var currentState = get(this, 'currentState'), view; while (currentState) { if (get(currentState, 'isViewState')) { view = get(currentState, 'view'); if (view) { return view; } } currentState = get(currentState, 'parentState'); } return null; }).property('currentState').cacheable() }); })(); (function() { var get = Ember.get, set = Ember.set; Ember.ViewState = Ember.State.extend({ isViewState: true, enter: function(stateManager) { var view = get(this, 'view'), root, childViews; if (view) { if (Ember.View.detect(view)) { view = view.create(); set(this, 'view', view); } Ember.assert('view must be an Ember.View', view instanceof Ember.View); root = stateManager.get('rootView'); if (root) { childViews = get(root, 'childViews'); childViews.pushObject(view); } else { root = stateManager.get('rootElement') || 'body'; view.appendTo(root); } } }, exit: function(stateManager) { var view = get(this, 'view'); if (view) { // If the view has a parent view, then it is // part of a view hierarchy and should be removed // from its parent. if (get(view, 'parentView')) { view.removeFromParent(); } else { // Otherwise, the view is a "root view" and // was appended directly to the DOM. view.remove(); } } } }); })(); (function() { // ========================================================================== // Project: Ember Statecharts // Copyright: ©2011 Living Social Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== })(); (function() { // ========================================================================== // Project: metamorph // Copyright: ©2011 My Company Inc. All rights reserved. // ========================================================================== (function(window) { var K = function(){}, guid = 0, document = window.document, // Feature-detect the W3C range API, the extended check is for IE9 which only partially supports ranges supportsRange = ('createRange' in document) && (typeof Range !== 'undefined') && Range.prototype.createContextualFragment, // Internet Explorer prior to 9 does not allow setting innerHTML if the first element // is a "zero-scope" element. This problem can be worked around by making // the first node an invisible text node. We, like Modernizr, use needsShy = (function(){ var testEl = document.createElement('div'); testEl.innerHTML = "

"; testEl.firstChild.innerHTML = ""; return testEl.firstChild.innerHTML === ''; })(); // Constructor that supports either Metamorph('foo') or new // Metamorph('foo'); // // Takes a string of HTML as the argument. var Metamorph = function(html) { var self; if (this instanceof Metamorph) { self = this; } else { self = new K(); } self.innerHTML = html; var myGuid = 'metamorph-'+(guid++); self.start = myGuid + '-start'; self.end = myGuid + '-end'; return self; }; K.prototype = Metamorph.prototype; var rangeFor, htmlFunc, removeFunc, outerHTMLFunc, appendToFunc, afterFunc, prependFunc, startTagFunc, endTagFunc; outerHTMLFunc = function() { return this.startTag() + this.innerHTML + this.endTag(); }; startTagFunc = function() { return ""; }; endTagFunc = function() { return ""; }; // If we have the W3C range API, this process is relatively straight forward. if (supportsRange) { // Get a range for the current morph. Optionally include the starting and // ending placeholders. rangeFor = function(morph, outerToo) { var range = document.createRange(); var before = document.getElementById(morph.start); var after = document.getElementById(morph.end); if (outerToo) { range.setStartBefore(before); range.setEndAfter(after); } else { range.setStartAfter(before); range.setEndBefore(after); } return range; }; htmlFunc = function(html, outerToo) { // get a range for the current metamorph object var range = rangeFor(this, outerToo); // delete the contents of the range, which will be the // nodes between the starting and ending placeholder. range.deleteContents(); // create a new document fragment for the HTML var fragment = range.createContextualFragment(html); // insert the fragment into the range range.insertNode(fragment); }; removeFunc = function() { // get a range for the current metamorph object including // the starting and ending placeholders. var range = rangeFor(this, true); // delete the entire range. range.deleteContents(); }; appendToFunc = function(node) { var range = document.createRange(); range.setStart(node); range.collapse(false); var frag = range.createContextualFragment(this.outerHTML()); node.appendChild(frag); }; afterFunc = function(html) { var range = document.createRange(); var after = document.getElementById(this.end); range.setStartAfter(after); range.setEndAfter(after); var fragment = range.createContextualFragment(html); range.insertNode(fragment); }; prependFunc = function(html) { var range = document.createRange(); var start = document.getElementById(this.start); range.setStartAfter(start); range.setEndAfter(start); var fragment = range.createContextualFragment(html); range.insertNode(fragment); }; } else { /** * This code is mostly taken from jQuery, with one exception. In jQuery's case, we * have some HTML and we need to figure out how to convert it into some nodes. * * In this case, jQuery needs to scan the HTML looking for an opening tag and use * that as the key for the wrap map. In our case, we know the parent node, and * can use its type as the key for the wrap map. **/ var wrapMap = { select: [ 1, "" ], fieldset: [ 1, "

", "

" ], table: [ 1, "", "

" ], tbody: [ 2, "", "

" ], tr: [ 3, "", "

" ], colgroup: [ 2, "", "

" ], map: [ 1, "", "" ], _default: [ 0, "", "" ] }; /** * Given a parent node and some HTML, generate a set of nodes. Return the first * node, which will allow us to traverse the rest using nextSibling. * * We need to do this because innerHTML in IE does not really parse the nodes. **/ var firstNodeFor = function(parentNode, html) { var arr = wrapMap[parentNode.tagName.toLowerCase()] || wrapMap._default; var depth = arr[0], start = arr[1], end = arr[2]; if (needsShy) { html = ''+html; } var element = document.createElement('div'); element.innerHTML = start + html + end; for (var i=0; i<=depth; i++) { element = element.firstChild; } // Look for to remove it. if (needsShy) { var shyElement = element; // Sometimes we get nameless elements with the shy inside while (shyElement.nodeType === 1 && !shyElement.nodeName) { shyElement = shyElement.firstChild; } // At this point it's the actual unicode character. if (shyElement.nodeType === 3 && shyElement.nodeValue.charAt(0) === "\u00AD") { shyElement.nodeValue = shyElement.nodeValue.slice(1); } } return element; }; /** * In some cases, Internet Explorer can create an anonymous node in * the hierarchy with no tagName. You can create this scenario via: * * div = document.createElement("div"); * div.innerHTML = "

"; * div.firstChild.firstChild.tagName //=> "" * * If our script markers are inside such a node, we need to find that * node and use *it* as the marker. **/ var realNode = function(start) { while (start.parentNode.tagName === "") { start = start.parentNode; } return start; }; /** * When automatically adding a tbody, Internet Explorer inserts the * tbody immediately before the first . Other browsers create it * before the first node, no matter what. * * This means the the following code: * * div = document.createElement("div"); * div.innerHTML = "

* * Generates the following DOM in IE: * * + div * + table * - script id='first' * + tbody * + tr * + td * - "hi" * - script id='last' * * Which means that the two script tags, even though they were * inserted at the same point in the hierarchy in the original * HTML, now have different parents. * * This code reparents the first script tag by making it the tbody's * first child. **/ var fixParentage = function(start, end) { if (start.parentNode !== end.parentNode) { end.parentNode.insertBefore(start, end.parentNode.firstChild); } }; htmlFunc = function(html, outerToo) { // get the real starting node. see realNode for details. var start = realNode(document.getElementById(this.start)); var end = document.getElementById(this.end); var parentNode = end.parentNode; var node, nextSibling, last; // make sure that the start and end nodes share the same // parent. If not, fix it. fixParentage(start, end); // remove all of the nodes after the starting placeholder and // before the ending placeholder. node = start.nextSibling; while (node) { nextSibling = node.nextSibling; last = node === end; // if this is the last node, and we want to remove it as well, // set the `end` node to the next sibling. This is because // for the rest of the function, we insert the new nodes // before the end (note that insertBefore(node, null) is // the same as appendChild(node)). // // if we do not want to remove it, just break. if (last) { if (outerToo) { end = node.nextSibling; } else { break; } } node.parentNode.removeChild(node); // if this is the last node and we didn't break before // (because we wanted to remove the outer nodes), break // now. if (last) { break; } node = nextSibling; } // get the first node for the HTML string, even in cases like // tables and lists where a simple innerHTML on a div would // swallow some of the content. node = firstNodeFor(start.parentNode, html); // copy the nodes for the HTML between the starting and ending // placeholder. while (node) { nextSibling = node.nextSibling; parentNode.insertBefore(node, end); node = nextSibling; } }; // remove the nodes in the DOM representing this metamorph. // // this includes the starting and ending placeholders. removeFunc = function() { var start = realNode(document.getElementById(this.start)); var end = document.getElementById(this.end); this.html(''); start.parentNode.removeChild(start); end.parentNode.removeChild(end); }; appendToFunc = function(parentNode) { var node = firstNodeFor(parentNode, this.outerHTML()); while (node) { nextSibling = node.nextSibling; parentNode.appendChild(node); node = nextSibling; } }; afterFunc = function(html) { // get the real starting node. see realNode for details. var end = document.getElementById(this.end); var insertBefore = end.nextSibling; var parentNode = end.parentNode; var nextSibling; var node; // get the first node for the HTML string, even in cases like // tables and lists where a simple innerHTML on a div would // swallow some of the content. node = firstNodeFor(parentNode, html); // copy the nodes for the HTML between the starting and ending // placeholder. while (node) { nextSibling = node.nextSibling; parentNode.insertBefore(node, insertBefore); node = nextSibling; } }; prependFunc = function(html) { var start = document.getElementById(this.start); var parentNode = start.parentNode; var nextSibling; var node; node = firstNodeFor(parentNode, html); var insertBefore = start.nextSibling; while (node) { nextSibling = node.nextSibling; parentNode.insertBefore(node, insertBefore); node = nextSibling; } } } Metamorph.prototype.html = function(html) { this.checkRemoved(); if (html === undefined) { return this.innerHTML; } htmlFunc.call(this, html); this.innerHTML = html; }; Metamorph.prototype.replaceWith = function(html) { this.checkRemoved(); htmlFunc.call(this, html, true); }; Metamorph.prototype.remove = removeFunc; Metamorph.prototype.outerHTML = outerHTMLFunc; Metamorph.prototype.appendTo = appendToFunc; Metamorph.prototype.after = afterFunc; Metamorph.prototype.prepend = prependFunc; Metamorph.prototype.startTag = startTagFunc; Metamorph.prototype.endTag = endTagFunc; Metamorph.prototype.isRemoved = function() { var before = document.getElementById(this.start); var after = document.getElementById(this.end); return !before || !after; }; Metamorph.prototype.checkRemoved = function() { if (this.isRemoved()) { throw new Error("Cannot perform operations on a Metamorph that is not in the DOM."); } }; window.Metamorph = Metamorph; })(this); })(); (function() { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== /*globals Handlebars */ /** @namespace @name Handlebars @private */ /** @namespace @name Handlebars.helpers @description Helpers for Handlebars templates */ /** @class Prepares the Handlebars templating library for use inside Ember's view system. The Ember.Handlebars object is the standard Handlebars library, extended to use Ember's get() method instead of direct property access, which allows computed properties to be used inside templates. To create an Ember.Handlebars template, call Ember.Handlebars.compile(). This will return a function that can be used by Ember.View for rendering. */ Ember.Handlebars = Ember.create(Handlebars); Ember.Handlebars.helpers = Ember.create(Handlebars.helpers); /** Override the the opcode compiler and JavaScript compiler for Handlebars. */ Ember.Handlebars.Compiler = function() {}; Ember.Handlebars.Compiler.prototype = Ember.create(Handlebars.Compiler.prototype); Ember.Handlebars.Compiler.prototype.compiler = Ember.Handlebars.Compiler; Ember.Handlebars.JavaScriptCompiler = function() {}; Ember.Handlebars.JavaScriptCompiler.prototype = Ember.create(Handlebars.JavaScriptCompiler.prototype); Ember.Handlebars.JavaScriptCompiler.prototype.compiler = Ember.Handlebars.JavaScriptCompiler; Ember.Handlebars.JavaScriptCompiler.prototype.namespace = "Ember.Handlebars"; Ember.Handlebars.JavaScriptCompiler.prototype.initializeBuffer = function() { return "''"; }; /** Override the default buffer for Ember Handlebars. By default, Handlebars creates an empty String at the beginning of each invocation and appends to it. Ember's Handlebars overrides this to append to a single shared buffer. @private */ Ember.Handlebars.JavaScriptCompiler.prototype.appendToBuffer = function(string) { return "data.buffer.push("+string+");"; }; /** Rewrite simple mustaches from {{foo}} to {{bind "foo"}}. This means that all simple mustaches in Ember's Handlebars will also set up an observer to keep the DOM up to date when the underlying property changes. @private */ Ember.Handlebars.Compiler.prototype.mustache = function(mustache) { if (mustache.params.length || mustache.hash) { return Handlebars.Compiler.prototype.mustache.call(this, mustache); } else { var id = new Handlebars.AST.IdNode(['_triageMustache']); // Update the mustache node to include a hash value indicating whether the original node // was escaped. This will allow us to properly escape values when the underlying value // changes and we need to re-render the value. if(mustache.escaped) { mustache.hash = mustache.hash || new Handlebars.AST.HashNode([]); mustache.hash.pairs.push(["escaped", new Handlebars.AST.StringNode("true")]); } mustache = new Handlebars.AST.MustacheNode([id].concat([mustache.id]), mustache.hash, !mustache.escaped); return Handlebars.Compiler.prototype.mustache.call(this, mustache); } }; /** Used for precompilation of Ember Handlebars templates. This will not be used during normal app execution. @param {String} string The template to precompile */ Ember.Handlebars.precompile = function(string) { var ast = Handlebars.parse(string); var options = { data: true, stringParams: true }; var environment = new Ember.Handlebars.Compiler().compile(ast, options); return new Ember.Handlebars.JavaScriptCompiler().compile(environment, options, undefined, true); }; /** The entry point for Ember Handlebars. This replaces the default Handlebars.compile and turns on template-local data and String parameters. @param {String} string The template to compile */ Ember.Handlebars.compile = function(string) { var ast = Handlebars.parse(string); var options = { data: true, stringParams: true }; var environment = new Ember.Handlebars.Compiler().compile(ast, options); var templateSpec = new Ember.Handlebars.JavaScriptCompiler().compile(environment, options, undefined, true); return Handlebars.template(templateSpec); }; /** If a path starts with a reserved keyword, returns the root that should be used. @private */ var normalizePath = Ember.Handlebars.normalizePath = function(root, path, data) { var keywords = (data && data.keywords) || {}, keyword, isKeyword; // Get the first segment of the path. For example, if the // path is "foo.bar.baz", returns "foo". keyword = path.split('.', 1)[0]; // Test to see if the first path is a keyword that has been // passed along in the view's data hash. If so, we will treat // that object as the new root. if (keywords.hasOwnProperty(keyword)) { // Look up the value in the template's data hash. root = keywords[keyword]; isKeyword = true; // Handle cases where the entire path is the reserved // word. In that case, return the object itself. if (path === keyword) { path = ''; } else { // Strip the keyword from the path and look up // the remainder from the newly found root. path = path.substr(keyword.length); } } return { root: root, path: path, isKeyword: isKeyword }; }; /** Lookup both on root and on window. If the path starts with a keyword, the corresponding object will be looked up in the template's data hash and used to resolve the path. @param {Object} root The object to look up the property on @param {String} path The path to be lookedup @param {Object} options The template's option hash */ Ember.Handlebars.getPath = function(root, path, options) { var data = options && options.data, normalizedPath = normalizePath(root, path, data), value; // In cases where the path begins with a keyword, change the // root to the value represented by that keyword, and ensure // the path is relative to it. root = normalizedPath.root; path = normalizedPath.path; value = Ember.getPath(root, path); if (value === undefined && root !== window && Ember.isGlobalPath(path)) { value = Ember.getPath(window, path); } return value; }; /** Registers a helper in Handlebars that will be called if no property with the given name can be found on the current context object, and no helper with that name is registered. This throws an exception with a more helpful error message so the user can track down where the problem is happening. @name Handlebars.helpers.helperMissing @param {String} path @param {Hash} options */ Ember.Handlebars.registerHelper('helperMissing', function(path, options) { var error, view = ""; error = "%@ Handlebars error: Could not find property '%@' on object %@."; if (options.data){ view = options.data.view; } throw new Ember.Error(Ember.String.fmt(error, [view, path, this])); }); })(); (function() { Ember.String.htmlSafe = function(str) { return new Handlebars.SafeString(str); }; var htmlSafe = Ember.String.htmlSafe; if (Ember.EXTEND_PROTOTYPES) { /** @see Ember.String.htmlSafe */ String.prototype.htmlSafe = function() { return htmlSafe(this); }; } })(); (function() { /*jshint newcap:false*/ var set = Ember.set, get = Ember.get, getPath = Ember.getPath; var DOMManager = { remove: function(view) { var morph = view.morph; if (morph.isRemoved()) { return; } set(view, 'element', null); view._lastInsert = null; morph.remove(); }, prepend: function(view, childView) { childView._insertElementLater(function() { var morph = view.morph; morph.prepend(childView.outerHTML); childView.outerHTML = null; }); }, after: function(view, nextView) { nextView._insertElementLater(function() { var morph = view.morph; morph.after(nextView.outerHTML); nextView.outerHTML = null; }); }, replace: function(view) { var morph = view.morph; view.transitionTo('preRender'); view.clearRenderedChildren(); var buffer = view.renderToBuffer(); Ember.run.schedule('render', this, function() { if (get(view, 'isDestroyed')) { return; } view.invalidateRecursively('element'); view._notifyWillInsertElement(); morph.replaceWith(buffer.string()); view.transitionTo('inDOM'); view._notifyDidInsertElement(); }); }, empty: function(view) { view.morph.html(""); } }; // The `morph` and `outerHTML` properties are internal only // and not observable. Ember._Metamorph = Ember.Mixin.create({ isVirtual: true, tagName: '', init: function() { this._super(); this.morph = Metamorph(); }, beforeRender: function(buffer) { buffer.push(this.morph.startTag()); }, afterRender: function(buffer) { buffer.push(this.morph.endTag()); }, createElement: function() { var buffer = this.renderToBuffer(); this.outerHTML = buffer.string(); this.clearBuffer(); }, domManager: DOMManager }); Ember._MetamorphView = Ember.View.extend(Ember._Metamorph); })(); (function() { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== /*globals Handlebars */ var get = Ember.get, set = Ember.set, getPath = Ember.Handlebars.getPath; /** @ignore @private @class Ember._HandlebarsBoundView is a private view created by the Handlebars `{{bind}}` helpers that is used to keep track of bound properties. Every time a property is bound using a `{{mustache}}`, an anonymous subclass of Ember._HandlebarsBoundView is created with the appropriate sub-template and context set up. When the associated property changes, just the template for this view will re-render. */ Ember._HandlebarsBoundView = Ember._MetamorphView.extend({ /** @scope Ember._HandlebarsBoundView.prototype */ /** The function used to determine if the `displayTemplate` or `inverseTemplate` should be rendered. This should be a function that takes a value and returns a Boolean. @type Function @default null */ shouldDisplayFunc: null, /** Whether the template rendered by this view gets passed the context object of its parent template, or gets passed the value of retrieving `path` from the `pathRoot`. For example, this is true when using the `{{#if}}` helper, because the template inside the helper should look up properties relative to the same object as outside the block. This would be false when used with `{{#with foo}}` because the template should receive the object found by evaluating `foo`. @type Boolean @default false */ preserveContext: false, /** If `preserveContext` is true, this is the object that will be used to render the template. @type Object */ previousContext: null, /** The template to render when `shouldDisplayFunc` evaluates to true. @type Function @default null */ displayTemplate: null, /** The template to render when `shouldDisplayFunc` evaluates to false. @type Function @default null */ inverseTemplate: null, /** The path to look up on `pathRoot` that is passed to `shouldDisplayFunc` to determine which template to render. In addition, if `preserveContext` is false, the object at this path will be passed to the template when rendering. @type String @default null */ path: null, /** The object from which the `path` will be looked up. Sometimes this is the same as the `previousContext`, but in cases where this view has been generated for paths that start with a keyword such as `view` or `controller`, the path root will be that resolved object. @type Object */ pathRoot: null, normalizedValue: Ember.computed(function() { var path = get(this, 'path'), pathRoot = get(this, 'pathRoot'), valueNormalizer = get(this, 'valueNormalizerFunc'), result, templateData; // Use the pathRoot as the result if no path is provided. This // happens if the path is `this`, which gets normalized into // a `pathRoot` of the current Handlebars context and a path // of `''`. if (path === '') { result = pathRoot; } else { templateData = get(this, 'templateData'); result = getPath(pathRoot, path, { data: templateData }); } return valueNormalizer ? valueNormalizer(result) : result; }).property('path', 'pathRoot', 'valueNormalizerFunc').volatile(), rerenderIfNeeded: function() { if (!get(this, 'isDestroyed') && get(this, 'normalizedValue') !== this._lastNormalizedValue) { this.rerender(); } }, /** Determines which template to invoke, sets up the correct state based on that logic, then invokes the default Ember.View `render` implementation. This method will first look up the `path` key on `pathRoot`, then pass that value to the `shouldDisplayFunc` function. If that returns true, the `displayTemplate` function will be rendered to DOM. Otherwise, `inverseTemplate`, if specified, will be rendered. For example, if this Ember._BindableSpan represented the {{#with foo}} helper, it would look up the `foo` property of its context, and `shouldDisplayFunc` would always return true. The object found by looking up `foo` would be passed to `displayTemplate`. @param {Ember.RenderBuffer} buffer */ render: function(buffer) { // If not invoked via a triple-mustache ({{{foo}}}), escape // the content of the template. var escape = get(this, 'isEscaped'); var shouldDisplay = get(this, 'shouldDisplayFunc'), preserveContext = get(this, 'preserveContext'), context = get(this, 'previousContext'); var inverseTemplate = get(this, 'inverseTemplate'), displayTemplate = get(this, 'displayTemplate'); var result = get(this, 'normalizedValue'); this._lastNormalizedValue = result; // First, test the conditional to see if we should // render the template or not. if (shouldDisplay(result)) { set(this, 'template', displayTemplate); // If we are preserving the context (for example, if this // is an #if block, call the template with the same object. if (preserveContext) { set(this, '_templateContext', context); } else { // Otherwise, determine if this is a block bind or not. // If so, pass the specified object to the template if (displayTemplate) { set(this, '_templateContext', result); } else { // This is not a bind block, just push the result of the // expression to the render context and return. if (result === null || result === undefined) { result = ""; } else if (!(result instanceof Handlebars.SafeString)) { result = String(result); } if (escape) { result = Handlebars.Utils.escapeExpression(result); } buffer.push(result); return; } } } else if (inverseTemplate) { set(this, 'template', inverseTemplate); if (preserveContext) { set(this, '_templateContext', context); } else { set(this, '_templateContext', result); } } else { set(this, 'template', function() { return ''; }); } return this._super(buffer); } }); })(); (function() { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== var get = Ember.get, getPath = Ember.getPath, set = Ember.set, fmt = Ember.String.fmt; var normalizePath = Ember.Handlebars.normalizePath; var forEach = Ember.ArrayUtils.forEach; var EmberHandlebars = Ember.Handlebars, helpers = EmberHandlebars.helpers; // Binds a property into the DOM. This will create a hook in DOM that the // KVO system will look for and update if the property changes. var bind = function(property, options, preserveContext, shouldDisplay, valueNormalizer) { var data = options.data, fn = options.fn, inverse = options.inverse, view = data.view, currentContext = this, pathRoot, path, normalized; normalized = normalizePath(currentContext, property, data); pathRoot = normalized.root; path = normalized.path; // Set up observers for observable objects if ('object' === typeof this) { // Create the view that will wrap the output of this template/property // and add it to the nearest view's childViews array. // See the documentation of Ember._HandlebarsBoundView for more. var bindView = view.createChildView(Ember._HandlebarsBoundView, { preserveContext: preserveContext, shouldDisplayFunc: shouldDisplay, valueNormalizerFunc: valueNormalizer, displayTemplate: fn, inverseTemplate: inverse, path: path, pathRoot: pathRoot, previousContext: currentContext, isEscaped: options.hash.escaped, templateData: options.data }); view.appendChild(bindView); /** @private */ var observer = function() { Ember.run.once(bindView, 'rerenderIfNeeded'); }; // Observes the given property on the context and // tells the Ember._BindableSpan to re-render. If property // is an empty string, we are printing the current context // object ({{this}}) so updating it is not our responsibility. if (path !== '') { Ember.addObserver(pathRoot, path, observer); } } else { // The object is not observable, so just render it out and // be done with it. data.buffer.push(getPath(pathRoot, path, options)); } }; /** '_triageMustache' is used internally select between a binding and helper for the given context. Until this point, it would be hard to determine if the mustache is a property reference or a regular helper reference. This triage helper resolves that. This would not be typically invoked by directly. @private @name Handlebars.helpers._triageMustache @param {String} property Property/helperID to triage @param {Function} fn Context to provide for rendering @returns {String} HTML string */ EmberHandlebars.registerHelper('_triageMustache', function(property, fn) { Ember.assert("You cannot pass more than one argument to the _triageMustache helper", arguments.length <= 2); if (helpers[property]) { return helpers[property].call(this, fn); } else { return helpers.bind.apply(this, arguments); } }); /** `bind` can be used to display a value, then update that value if it changes. For example, if you wanted to print the `title` property of `content`: {{bind "content.title"}} This will return the `title` property as a string, then create a new observer at the specified path. If it changes, it will update the value in DOM. Note that if you need to support IE7 and IE8 you must modify the model objects properties using Ember.get() and Ember.set() for this to work as it relies on Ember's KVO system. For all other browsers this will be handled for you automatically. @private @name Handlebars.helpers.bind @param {String} property Property to bind @param {Function} fn Context to provide for rendering @returns {String} HTML string */ EmberHandlebars.registerHelper('bind', function(property, fn) { Ember.assert("You cannot pass more than one argument to the bind helper", arguments.length <= 2); var context = (fn.contexts && fn.contexts[0]) || this; return bind.call(context, property, fn, false, function(result) { return !Ember.none(result); }); }); /** Use the `boundIf` helper to create a conditional that re-evaluates whenever the bound value changes. {{#boundIf "content.shouldDisplayTitle"}} {{content.title}} {{/boundIf}} @private @name Handlebars.helpers.boundIf @param {String} property Property to bind @param {Function} fn Context to provide for rendering @returns {String} HTML string */ EmberHandlebars.registerHelper('boundIf', function(property, fn) { var context = (fn.contexts && fn.contexts[0]) || this; var func = function(result) { if (Ember.typeOf(result) === 'array') { return get(result, 'length') !== 0; } else { return !!result; } }; return bind.call(context, property, fn, true, func, func); }); /** @name Handlebars.helpers.with @param {Function} context @param {Hash} options @returns {String} HTML string */ EmberHandlebars.registerHelper('with', function(context, options) { if (arguments.length === 4) { var keywordName, path; Ember.assert("If you pass more than one argument to the with helper, it must be in the form #with foo as bar", arguments[1] === "as"); options = arguments[3]; keywordName = arguments[2]; path = arguments[0]; Ember.assert("You must pass a block to the with helper", options.fn && options.fn !== Handlebars.VM.noop); // This is a workaround for the fact that you cannot bind separate objects // together. When we implement that functionality, we should use it here. var contextKey = Ember.$.expando + Ember.guidFor(this); options.data.keywords[contextKey] = this; Ember.bind(options.data.keywords, keywordName, contextKey + '.' + path); return bind.call(this, path, options.fn, true, function(result) { return !Ember.none(result); }); } else { Ember.assert("You must pass exactly one argument to the with helper", arguments.length === 2); Ember.assert("You must pass a block to the with helper", options.fn && options.fn !== Handlebars.VM.noop); return helpers.bind.call(options.contexts[0], context, options); } }); /** @name Handlebars.helpers.if @param {Function} context @param {Hash} options @returns {String} HTML string */ EmberHandlebars.registerHelper('if', function(context, options) { Ember.assert("You must pass exactly one argument to the if helper", arguments.length === 2); Ember.assert("You must pass a block to the if helper", options.fn && options.fn !== Handlebars.VM.noop); return helpers.boundIf.call(options.contexts[0], context, options); }); /** @name Handlebars.helpers.unless @param {Function} context @param {Hash} options @returns {String} HTML string */ EmberHandlebars.registerHelper('unless', function(context, options) { Ember.assert("You must pass exactly one argument to the unless helper", arguments.length === 2); Ember.assert("You must pass a block to the unless helper", options.fn && options.fn !== Handlebars.VM.noop); var fn = options.fn, inverse = options.inverse; options.fn = inverse; options.inverse = fn; return helpers.boundIf.call(options.contexts[0], context, options); }); /** `bindAttr` allows you to create a binding between DOM element attributes and Ember objects. For example: imageTitle

@name Handlebars.helpers.bindAttr @param {Hash} options @returns {String} HTML string */ EmberHandlebars.registerHelper('bindAttr', function(options) { var attrs = options.hash; Ember.assert("You must specify at least one hash argument to bindAttr", !!Ember.keys(attrs).length); var view = options.data.view; var ret = []; var ctx = this; // Generate a unique id for this element. This will be added as a // data attribute to the element so it can be looked up when // the bound property changes. var dataId = ++Ember.$.uuid; // Handle classes differently, as we can bind multiple classes var classBindings = attrs['class']; if (classBindings !== null && classBindings !== undefined) { var classResults = EmberHandlebars.bindClasses(this, classBindings, view, dataId, options); ret.push('class="' + Handlebars.Utils.escapeExpression(classResults.join(' ')) + '"'); delete attrs['class']; } var attrKeys = Ember.keys(attrs); // For each attribute passed, create an observer and emit the // current value of the property as an attribute. forEach(attrKeys, function(attr) { var path = attrs[attr], pathRoot, normalized; Ember.assert(fmt("You must provide a String for a bound attribute, not %@", [path]), typeof path === 'string'); normalized = normalizePath(ctx, path, options.data); pathRoot = normalized.root; path = normalized.path; var value = (path === 'this') ? pathRoot : getPath(pathRoot, path, options), type = Ember.typeOf(value); Ember.assert(fmt("Attributes must be numbers, strings or booleans, not %@", [value]), value === null || value === undefined || type === 'number' || type === 'string' || type === 'boolean'); var observer, invoker; /** @private */ observer = function observer() { var result = getPath(pathRoot, path, options); Ember.assert(fmt("Attributes must be numbers, strings or booleans, not %@", [result]), result === null || result === undefined || typeof result === 'number' || typeof result === 'string' || typeof result === 'boolean'); var elem = view.$("[data-bindattr-" + dataId + "='" + dataId + "']"); // If we aren't able to find the element, it means the element // to which we were bound has been removed from the view. // In that case, we can assume the template has been re-rendered // and we need to clean up the observer. if (elem.length === 0) { Ember.removeObserver(pathRoot, path, invoker); return; } Ember.View.applyAttributeBindings(elem, attr, result); }; /** @private */ invoker = function() { Ember.run.once(observer); }; // Add an observer to the view for when the property changes. // When the observer fires, find the element using the // unique data id and update the attribute to the new value. if (path !== 'this') { Ember.addObserver(pathRoot, path, invoker); } // if this changes, also change the logic in ember-views/lib/views/view.js if ((type === 'string' || (type === 'number' && !isNaN(value)))) { ret.push(attr + '="' + Handlebars.Utils.escapeExpression(value) + '"'); } else if (value && type === 'boolean') { // The developer controls the attr name, so it should always be safe ret.push(attr + '="' + attr + '"'); } }, this); // Add the unique identifier // NOTE: We use all lower-case since Firefox has problems with mixed case in SVG ret.push('data-bindattr-' + dataId + '="' + dataId + '"'); return new EmberHandlebars.SafeString(ret.join(' ')); }); /** Helper that, given a space-separated string of property paths and a context, returns an array of class names. Calling this method also has the side effect of setting up observers at those property paths, such that if they change, the correct class name will be reapplied to the DOM element. For example, if you pass the string "fooBar", it will first look up the "fooBar" value of the context. If that value is true, it will add the "foo-bar" class to the current element (i.e., the dasherized form of "fooBar"). If the value is a string, it will add that string as the class. Otherwise, it will not add any new class name. @param {Ember.Object} context The context from which to lookup properties @param {String} classBindings A string, space-separated, of class bindings to use @param {Ember.View} view The view in which observers should look for the element to update @param {Srting} bindAttrId Optional bindAttr id used to lookup elements @returns {Array} An array of class names to add */ EmberHandlebars.bindClasses = function(context, classBindings, view, bindAttrId, options) { var ret = [], newClass, value, elem; // Helper method to retrieve the property from the context and // determine which class string to return, based on whether it is // a Boolean or not. var classStringForPath = function(root, path, className, options) { var val = path !== '' ? getPath(root, path, options) : true; // If the value is truthy and we're using the colon syntax, // we should return the className directly if (!!val && className) { return className; // If value is a Boolean and true, return the dasherized property // name. } else if (val === true) { // Normalize property path to be suitable for use // as a class name. For exaple, content.foo.barBaz // becomes bar-baz. var parts = path.split('.'); return Ember.String.dasherize(parts[parts.length-1]); // If the value is not false, undefined, or null, return the current // value of the property. } else if (val !== false && val !== undefined && val !== null) { return val; // Nothing to display. Return null so that the old class is removed // but no new class is added. } else { return null; } }; // For each property passed, loop through and setup // an observer. forEach(classBindings.split(' '), function(binding) { // Variable in which the old class value is saved. The observer function // closes over this variable, so it knows which string to remove when // the property changes. var oldClass; var observer, invoker; var split = binding.split(':'), path = split[0], className = split[1], pathRoot = context, normalized; if (path !== '') { normalized = normalizePath(context, path, options.data); pathRoot = normalized.root; path = normalized.path; } // Set up an observer on the context. If the property changes, toggle the // class name. /** @private */ observer = function() { // Get the current value of the property newClass = classStringForPath(pathRoot, path, className, options); elem = bindAttrId ? view.$("[data-bindattr-" + bindAttrId + "='" + bindAttrId + "']") : view.$(); // If we can't find the element anymore, a parent template has been // re-rendered and we've been nuked. Remove the observer. if (elem.length === 0) { Ember.removeObserver(pathRoot, path, invoker); } else { // If we had previously added a class to the element, remove it. if (oldClass) { elem.removeClass(oldClass); } // If necessary, add a new class. Make sure we keep track of it so // it can be removed in the future. if (newClass) { elem.addClass(newClass); oldClass = newClass; } else { oldClass = null; } } }; /** @private */ invoker = function() { Ember.run.once(observer); }; if (path !== '') { Ember.addObserver(pathRoot, path, invoker); } // We've already setup the observer; now we just need to figure out the // correct behavior right now on the first pass through. value = classStringForPath(pathRoot, path, className, options); if (value) { ret.push(value); // Make sure we save the current value so that it can be removed if the // observer fires. oldClass = value; } }); return ret; }; })(); (function() { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== /*globals Handlebars */ // TODO: Don't require the entire module var get = Ember.get, set = Ember.set; var indexOf = Ember.ArrayUtils.indexOf; var PARENT_VIEW_PATH = /^parentView\./; var EmberHandlebars = Ember.Handlebars; /** @private */ EmberHandlebars.ViewHelper = Ember.Object.create({ viewClassFromHTMLOptions: function(viewClass, options, thisContext) { var hash = options.hash, data = options.data; var extensions = {}, classes = hash['class'], dup = false; if (hash.id) { extensions.elementId = hash.id; dup = true; } if (classes) { classes = classes.split(' '); extensions.classNames = classes; dup = true; } if (hash.classBinding) { extensions.classNameBindings = hash.classBinding.split(' '); dup = true; } if (hash.classNameBindings) { extensions.classNameBindings = hash.classNameBindings.split(' '); dup = true; } if (hash.attributeBindings) { Ember.assert("Setting 'attributeBindings' via Handlebars is not allowed. Please subclass Ember.View and set it there instead."); extensions.attributeBindings = null; dup = true; } if (dup) { hash = Ember.$.extend({}, hash); delete hash.id; delete hash['class']; delete hash.classBinding; } // Look for bindings passed to the helper and, if they are // local, make them relative to the current context instead of the // view. var path, normalized; for (var prop in hash) { if (!hash.hasOwnProperty(prop)) { continue; } // Test if the property ends in "Binding" if (Ember.IS_BINDING.test(prop)) { path = hash[prop]; normalized = Ember.Handlebars.normalizePath(null, path, data); if (normalized.isKeyword) { hash[prop] = 'templateData.keywords.'+path; } else if (!Ember.isGlobalPath(path)) { if (path === 'this') { hash[prop] = 'bindingContext'; } else { hash[prop] = 'bindingContext.'+path; } } } } // Make the current template context available to the view // for the bindings set up above. extensions.bindingContext = thisContext; return viewClass.extend(hash, extensions); }, helper: function(thisContext, path, options) { var inverse = options.inverse, data = options.data, view = data.view, fn = options.fn, hash = options.hash, newView; if ('string' === typeof path) { newView = EmberHandlebars.getPath(thisContext, path, options); Ember.assert("Unable to find view at path '" + path + "'", !!newView); } else { newView = path; } Ember.assert(Ember.String.fmt('You must pass a view class to the #view helper, not %@ (%@)', [path, newView]), Ember.View.detect(newView)); newView = this.viewClassFromHTMLOptions(newView, options, thisContext); var currentView = data.view; var viewOptions = { templateData: options.data }; if (fn) { Ember.assert("You cannot provide a template block if you also specified a templateName", !get(viewOptions, 'templateName') && !get(newView.proto(), 'templateName')); viewOptions.template = fn; } currentView.appendChild(newView, viewOptions); } }); /** `{{view}}` inserts a new instance of `Ember.View` into a template passing its options to the `Ember.View`'s `create` method and using the supplied block as the view's own template. An empty `` and the following template: Will result in HTML structure:

A span: Hello.

### parentView setting The `parentView` property of the new `Ember.View` instance created through `{{view}}` will be set to the `Ember.View` instance of the template where `{{view}}` was called. aView = Ember.View.create({ template: Ember.Handlebars.compile("{{#view}} my parent: {{parentView.elementId}} {{/view}}") }) aView.appendTo('body') Will result in HTML structure:

my parent: ember1

### Setting CSS id and class attributes The HTML `id` attribute can be set on the `{{view}}`'s resulting element with the `id` option. This option will _not_ be passed to `Ember.View.create`. Results in the following HTML structure:

hello.

The HTML `class` attribute can be set on the `{{view}}`'s resulting element with the `class` or `classNameBindings` options. The `class` option will directly set the CSS `class` attribute and will not be passed to `Ember.View.create`. `classNameBindings` will be passed to `create` and use `Ember.View`'s class name binding functionality: Results in the following HTML structure:

hello.

### Supplying a different view class `{{view}}` can take an optional first argument before its supplied options to specify a path to a custom view class. The first argument can also be a relative path. Ember will search for the view class starting at the `Ember.View` of the template where `{{view}}` was used as the root object: MyApp = Ember.Application.create({}) MyApp.OuterView = Ember.View.extend({ innerViewClass: Ember.View.extend({ classNames: ['a-custom-view-class-as-property'] }), template: Ember.Handlebars.compile('{{#view "innerViewClass"}} hi {{/view}}') }) MyApp.OuterView.create().appendTo('body') Will result in the following HTML:

### Blockless use If you supply a custom `Ember.View` subclass that specifies its own template or provide a `templateName` option to `{{view}}` it can be used without supplying a block. Attempts to use both a `templateName` option and supply a block will throw an error. ### viewName property You can supply a `viewName` option to `{{view}}`. The `Ember.View` instance will be referenced as a property of its parent view by this name. aView = Ember.View.create({ template: Ember.Handlebars.compile('{{#view viewName="aChildByName"}} hi {{/view}}') }) aView.appendTo('body') aView.get('aChildByName') // the instance of Ember.View created by {{view}} helper @name Handlebars.helpers.view @param {String} path @param {Hash} options @returns {String} HTML string */ EmberHandlebars.registerHelper('view', function(path, options) { Ember.assert("The view helper only takes a single argument", arguments.length <= 2); // If no path is provided, treat path param as options. if (path && path.data && path.data.isRenderData) { options = path; path = "Ember.View"; } return EmberHandlebars.ViewHelper.helper(this, path, options); }); })(); (function() { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== /*globals Handlebars */ // TODO: Don't require all of this module var get = Ember.get, getPath = Ember.Handlebars.getPath, fmt = Ember.String.fmt; /** `{{collection}}` is a `Ember.Handlebars` helper for adding instances of `Ember.CollectionView` to a template. See `Ember.CollectionView` for additional information on how a `CollectionView` functions. `{{collection}}`'s primary use is as a block helper with a `contentBinding` option pointing towards an `Ember.Array`-compatible object. An `Ember.View` instance will be created for each item in its `content` property. Each view will have its own `content` property set to the appropriate item in the collection. The provided block will be applied as the template for each item's view. Given an empty `` the following template: And the following application code App = Ember.Application.create() App.items = [ Ember.Object.create({name: 'Dave'}), Ember.Object.create({name: 'Mary'}), Ember.Object.create({name: 'Sara'}) ] Will result in the HTML structure below

Hi Dave

Hi Mary

Hi Sara

### Blockless Use If you provide an `itemViewClass` option that has its own `template` you can omit the block. The following template: And application code App = Ember.Application.create() App.items = [ Ember.Object.create({name: 'Dave'}), Ember.Object.create({name: 'Mary'}), Ember.Object.create({name: 'Sara'}) ] App.AnItemView = Ember.View.extend({ template: Ember.Handlebars.compile("Greetings {{content.name}}") }) Will result in the HTML structure below

Greetings Dave

Greetings Mary

Greetings Sara

### Specifying a CollectionView subclass By default the `{{collection}}` helper will create an instance of `Ember.CollectionView`. You can supply a `Ember.CollectionView` subclass to the helper by passing it as the first argument: ### Forwarded `item.*`-named Options As with the `{{view}}`, helper options passed to the `{{collection}}` will be set on the resulting `Ember.CollectionView` as properties. Additionally, options prefixed with `item` will be applied to the views rendered for each item (note the camelcasing): Will result in the following HTML structure:

Howdy Dave

Howdy Mary

Howdy Sara

@name Handlebars.helpers.collection @param {String} path @param {Hash} options @returns {String} HTML string */ Ember.Handlebars.registerHelper('collection', function(path, options) { // If no path is provided, treat path param as options. if (path && path.data && path.data.isRenderData) { options = path; path = undefined; Ember.assert("You cannot pass more than one argument to the collection helper", arguments.length === 1); } else { Ember.assert("You cannot pass more than one argument to the collection helper", arguments.length === 2); } var fn = options.fn; var data = options.data; var inverse = options.inverse; // If passed a path string, convert that into an object. // Otherwise, just default to the standard class. var collectionClass; collectionClass = path ? getPath(this, path, options) : Ember.CollectionView; Ember.assert(fmt("%@ #collection: Could not find %@", data.view, path), !!collectionClass); var hash = options.hash, itemHash = {}, match; // Extract item view class if provided else default to the standard class var itemViewClass, itemViewPath = hash.itemViewClass; var collectionPrototype = collectionClass.proto(); delete hash.itemViewClass; itemViewClass = itemViewPath ? getPath(collectionPrototype, itemViewPath, options) : collectionPrototype.itemViewClass; Ember.assert(fmt("%@ #collection: Could not find %@", data.view, itemViewPath), !!itemViewClass); // Go through options passed to the {{collection}} helper and extract options // that configure item views instead of the collection itself. for (var prop in hash) { if (hash.hasOwnProperty(prop)) { match = prop.match(/^item(.)(.*)$/); if(match) { // Convert itemShouldFoo -> shouldFoo itemHash[match[1].toLowerCase() + match[2]] = hash[prop]; // Delete from hash as this will end up getting passed to the // {{view}} helper method. delete hash[prop]; } } } var tagName = hash.tagName || collectionPrototype.tagName; if (fn) { itemHash.template = fn; delete options.fn; } if (inverse && inverse !== Handlebars.VM.noop) { var emptyViewClass = get(collectionPrototype, 'emptyViewClass'); hash.emptyView = emptyViewClass.extend({ template: inverse, tagName: itemHash.tagName }); } if (hash.eachHelper === 'each') { itemHash._templateContext = Ember.computed(function() { return get(this, 'content'); }).property('content'); delete hash.eachHelper; } hash.itemViewClass = Ember.Handlebars.ViewHelper.viewClassFromHTMLOptions(itemViewClass, { data: data, hash: itemHash }, this); return Ember.Handlebars.helpers.view.call(this, collectionClass, options); }); })(); (function() { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== /*globals Handlebars */ var getPath = Ember.Handlebars.getPath; /** `unbound` allows you to output a property without binding. *Important:* The output will not be updated if the property changes. Use with caution.

@name Handlebars.helpers.unbound @param {String} property @returns {String} HTML string */ Ember.Handlebars.registerHelper('unbound', function(property, fn) { var context = (fn.contexts && fn.contexts[0]) || this; return getPath(context, property, fn); }); })(); (function() { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== /*jshint debug:true*/ var getPath = Ember.getPath; /** `log` allows you to output the value of a value in the current rendering context. {{log myVariable}} @name Handlebars.helpers.log @param {String} property */ Ember.Handlebars.registerHelper('log', function(property, fn) { var context = (fn.contexts && fn.contexts[0]) || this; Ember.Logger.log(getPath(context, property)); }); /** The `debugger` helper executes the `debugger` statement in the current context. {{debugger}} @name Handlebars.helpers.debugger @param {String} property */ Ember.Handlebars.registerHelper('debugger', function() { debugger; }); })(); (function() { var get = Ember.get, set = Ember.set; Ember.Handlebars.EachView = Ember.CollectionView.extend(Ember._Metamorph, { itemViewClass: Ember._MetamorphView, emptyViewClass: Ember._MetamorphView, createChildView: function(view, attrs) { view = this._super(view, attrs); // At the moment, if a container view subclass wants // to insert keywords, it is responsible for cloning // the keywords hash. This will be fixed momentarily. var keyword = get(this, 'keyword'); if (keyword) { var data = get(view, 'templateData'); data = Ember.copy(data); data.keywords = view.cloneKeywords(); set(view, 'templateData', data); var content = get(view, 'content'); // In this case, we do not bind, because the `content` of // a #each item cannot change. data.keywords[keyword] = content; } return view; } }); Ember.Handlebars.registerHelper('each', function(path, options) { if (arguments.length === 4) { Ember.assert("If you pass more than one argument to the each helper, it must be in the form #each foo in bar", arguments[1] === "in"); var keywordName = arguments[0]; options = arguments[3]; path = arguments[2]; options.hash.keyword = keywordName; } else { options.hash.eachHelper = 'each'; } Ember.assert("You must pass a block to the each helper", options.fn && options.fn !== Handlebars.VM.noop); options.hash.contentBinding = path; // Set up emptyView as a metamorph with no tag //options.hash.emptyViewClass = Ember._MetamorphView; return Ember.Handlebars.helpers.collection.call(this, 'Ember.Handlebars.EachView', options); }); })(); (function() { /** `template` allows you to render a template from inside another template. This allows you to re-use the same template in multiple places. For example: This helper looks for templates in the global Ember.TEMPLATES hash. If you add <script> tags to your page with the `data-template-name` attribute set, they will be compiled and placed in this hash automatically. You can also manually register templates by adding them to the hash: Ember.TEMPLATES["my_cool_template"] = Ember.Handlebars.compile('{{user}}'); @name Handlebars.helpers.template @param {String} templateName the template to render */ Ember.Handlebars.registerHelper('template', function(name, options) { var template = Ember.TEMPLATES[name]; Ember.assert("Unable to find template with name '"+name+"'.", !!template); Ember.TEMPLATES[name](this, { data: options.data }); }); })(); (function() { var EmberHandlebars = Ember.Handlebars, getPath = EmberHandlebars.getPath, get = Ember.get; var ActionHelper = EmberHandlebars.ActionHelper = { registeredActions: {} }; ActionHelper.registerAction = function(actionName, eventName, target, view, context) { var actionId = (++Ember.$.uuid).toString(); ActionHelper.registeredActions[actionId] = { eventName: eventName, handler: function(event) { event.view = view; event.context = context; // Check for StateManager (or compatible object) if (target.isState && typeof target.send === 'function') { return target.send(actionName, event); } else { return target[actionName].call(target, event); } } }; view.on('willRerender', function() { delete ActionHelper.registeredActions[actionId]; }); return actionId; }; /** The `{{action}}` helper registers an HTML element within a template for DOM event handling. User interaction with that element will call the method on the template's associated `Ember.View` instance that has the same name as the first provided argument to `{{action}}`: Given the following Handlebars template on the page And application code AView = Ember.View.extend({ templateName; 'a-template', anActionName: function(event){} }) aView = AView.create() aView.appendTo('body') Will results in the following rendered HTML

click me

Clicking "click me" will trigger the `anActionName` method of the `aView` object with a `jQuery.Event` object as its argument. The `jQuery.Event` object will be extended to include a `view` property that is set to the original view interacted with (in this case the `aView` object). ### Specifying an Action Target A `target` option can be provided to change which object will receive the method call. This option must be a string representing a path to an object: Clicking "click me" in the rendered HTML of the above template will trigger the `anActionName` method of the object at `MyApplication.someObject`. The first argument to this method will be a `jQuery.Event` extended to include a `view` property that is set to the original view interacted with. A path relative to the template's `Ember.View` instance can also be used as a target: Clicking "click me" in the rendered HTML of the above template will trigger the `anActionName` method of the view's parent view. The `{{action}}` helper is `Ember.StateManager` aware. If the target of the action is an `Ember.StateManager` instance `{{action}}` will use the `send` functionality of StateManagers. The documentation for `Ember.StateManager` has additional information about this use. If an action's target does not implement a method that matches the supplied action name an error will be thrown. With the following application code AView = Ember.View.extend({ templateName; 'a-template', // note: no method 'aMethodNameThatIsMissing' anActionName: function(event){} }) aView = AView.create() aView.appendTo('body') Will throw `Uncaught TypeError: Cannot call method 'call' of undefined` when "click me" is clicked. ### Specifying DOM event type By default the `{{action}}` helper registers for DOM `click` events. You can supply an `on` option to the helper to specify a different DOM event name: See `Ember.EventDispatcher` for a list of acceptable DOM event names. Because `{{action}}` depends on Ember's event dispatch system it will only function if an `Ember.EventDispatcher` instance is available. An `Ember.EventDispatcher` instance will be created when a new `Ember.Application` is created. Having an instance of `Ember.Application` will satisfy this requirement. ### Specifying a context By default the `{{action}}` helper passes the current Handlebars context along in the `jQuery.Event` object. You may specify an alternative object to pass as the context by providing a property path: @name Handlebars.helpers.action @param {String} actionName @param {Hash} options */ EmberHandlebars.registerHelper('action', function(actionName, options) { var hash = options.hash || {}, eventName = hash.on || "click", view = options.data.view, target, context, controller; if (view.isVirtual) { view = view.get('parentView'); } if (hash.target) { target = getPath(this, hash.target, options); } else if (controller = options.data.keywords.controller) { target = get(controller, 'target'); } target = target || view; context = hash.context ? getPath(this, hash.context, options) : options.contexts[0]; var actionId = ActionHelper.registerAction(actionName, eventName, target, view, context); return new EmberHandlebars.SafeString('data-ember-action="' + actionId + '"'); }); })(); (function() { var get = Ember.get, set = Ember.set; /** When used in a Handlebars template that is assigned to an `Ember.View` instance's `layout` property Ember will render the layout template first, inserting the view's own rendered output at the `{{ yield }}` location. An empty `` and the following application code: AView = Ember.View.extend({ classNames: ['a-view-with-layout'], layout: Ember.Handlebars.compile('

'), template: Ember.Handlebars.compile('I am wrapped') }) aView = AView.create() aView.appendTo('body') Will result in the following HTML output:

I am wrapped

The yield helper cannot be used outside of a template assigned to an `Ember.View`'s `layout` property and will throw an error if attempted. BView = Ember.View.extend({ classNames: ['a-view-with-layout'], template: Ember.Handlebars.compile('{{yield}}') }) bView = BView.create() bView.appendTo('body') // throws // Uncaught Error: assertion failed: You called yield in a template that was not a layout @name Handlebars.helpers.yield @param {Hash} options @returns {String} HTML string */ Ember.Handlebars.registerHelper('yield', function(options) { var view = options.data.view, template; while (view && !get(view, 'layout')) { view = get(view, 'parentView'); } Ember.assert("You called yield in a template that was not a layout", !!view); template = get(view, 'template'); if (template) { template(this, options); } }); })(); (function() { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== })(); (function() { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== })(); (function() { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== var set = Ember.set, get = Ember.get; /** @class Creates an HTML input view in one of two formats. If a `title` property or binding is provided the input will be wrapped in a `div` and `label` tag. View properties like `classNames` will be applied to the outermost `div`. This behavior is deprecated and will issue a warning in development. {{view Ember.Checkbox classNames="applicaton-specific-checkbox" title="Some title"}}

Some title

If `title` isn't provided the view will render as an input element of the 'checkbox' type and HTML related properties will be applied directly to the input. {{view Ember.Checkbox classNames="applicaton-specific-checkbox"}} You can add a `label` tag yourself in the template where the Ember.Checkbox is being used. Some Title {{view Ember.Checkbox classNames="applicaton-specific-checkbox"}} The `checked` attribute of an Ember.Checkbox object should always be set through the Ember object or by interacting with its rendered element representation via the mouse, keyboard, or touch. Updating the value of the checkbox via jQuery will result in the checked value of the object and its element losing synchronization. */ Ember.Checkbox = Ember.View.extend({ classNames: ['ember-checkbox'], tagName: 'input', attributeBindings: ['type', 'checked', 'disabled'], type: "checkbox", checked: false, disabled: false, /** @deprecated */ title: null, value: Ember.computed(function(propName, value){ Ember.deprecate("Ember.Checkbox's 'value' property has been renamed to 'checked' to match the html element attribute name"); if (value !== undefined) { return set(this, 'checked', value); } else { return get(this, 'checked'); } }).property('checked').volatile(), change: function() { Ember.run.once(this, this._updateElementValue); // returning false will cause IE to not change checkbox state }, /** @private */ _updateElementValue: function() { var input = get(this, 'title') ? this.$('input:checkbox') : this.$(); set(this, 'checked', input.prop('checked')); }, init: function() { if (get(this, 'title') || get(this, 'titleBinding')) { Ember.deprecate("Automatically surrounding Ember.Checkbox inputs with a label by providing a 'title' property is deprecated"); this.tagName = undefined; this.attributeBindings = []; this.defaultTemplate = Ember.Handlebars.compile('{{title}}'); } this._super(); } }); })(); (function() { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== var get = Ember.get, set = Ember.set; /** @class */ Ember.TextSupport = Ember.Mixin.create( /** @scope Ember.TextSupport.prototype */ { value: "", attributeBindings: ['placeholder', 'disabled', 'maxlength'], placeholder: null, disabled: false, maxlength: null, insertNewline: Ember.K, cancel: Ember.K, focusOut: function(event) { this._elementValueDidChange(); }, change: function(event) { this._elementValueDidChange(); }, keyUp: function(event) { this.interpretKeyEvents(event); }, /** @private */ interpretKeyEvents: function(event) { var map = Ember.TextSupport.KEY_EVENTS; var method = map[event.keyCode]; this._elementValueDidChange(); if (method) { return this[method](event); } }, _elementValueDidChange: function() { set(this, 'value', this.$().val()); } }); Ember.TextSupport.KEY_EVENTS = { 13: 'insertNewline', 27: 'cancel' }; })(); (function() { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== var get = Ember.get, set = Ember.set; /** @class The `Ember.TextField` view class renders a text [input](https://developer.mozilla.org/en/HTML/Element/Input) element. It allows for binding Ember properties to the text field contents (`value`), live-updating as the user inputs text. Example: {{view Ember.TextField valueBinding="firstName"}} @extends Ember.TextSupport */ Ember.TextField = Ember.View.extend(Ember.TextSupport, /** @scope Ember.TextField.prototype */ { classNames: ['ember-text-field'], tagName: "input", attributeBindings: ['type', 'value', 'size'], /** The value attribute of the input element. As the user inputs text, this property is updated live. @type String @default "" */ value: "", /** The type attribute of the input element. @type String @default "text" */ type: "text", /** The size of the text field in characters. @type String @default null */ size: null }); })(); (function() { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== var get = Ember.get, set = Ember.set; Ember.Button = Ember.View.extend(Ember.TargetActionSupport, { classNames: ['ember-button'], classNameBindings: ['isActive'], tagName: 'button', propagateEvents: false, attributeBindings: ['type', 'disabled', 'href'], /** @private Overrides TargetActionSupport's targetObject computed property to use Handlebars-specific path resolution. */ targetObject: Ember.computed(function() { var target = get(this, 'target'), root = get(this, 'templateContext'), data = get(this, 'templateData'); if (typeof target !== 'string') { return target; } return Ember.Handlebars.getPath(root, target, { data: data }); }).property('target').cacheable(), // Defaults to 'button' if tagName is 'input' or 'button' type: Ember.computed(function(key, value) { var tagName = this.get('tagName'); if (value !== undefined) { this._type = value; } if (this._type !== undefined) { return this._type; } if (tagName === 'input' || tagName === 'button') { return 'button'; } }).property('tagName').cacheable(), disabled: false, // Allow 'a' tags to act like buttons href: Ember.computed(function() { return this.get('tagName') === 'a' ? '#' : null; }).property('tagName').cacheable(), mouseDown: function() { if (!get(this, 'disabled')) { set(this, 'isActive', true); this._mouseDown = true; this._mouseEntered = true; } return get(this, 'propagateEvents'); }, mouseLeave: function() { if (this._mouseDown) { set(this, 'isActive', false); this._mouseEntered = false; } }, mouseEnter: function() { if (this._mouseDown) { set(this, 'isActive', true); this._mouseEntered = true; } }, mouseUp: function(event) { if (get(this, 'isActive')) { // Actually invoke the button's target and action. // This method comes from the Ember.TargetActionSupport mixin. this.triggerAction(); set(this, 'isActive', false); } this._mouseDown = false; this._mouseEntered = false; return get(this, 'propagateEvents'); }, keyDown: function(event) { // Handle space or enter if (event.keyCode === 13 || event.keyCode === 32) { this.mouseDown(); } }, keyUp: function(event) { // Handle space or enter if (event.keyCode === 13 || event.keyCode === 32) { this.mouseUp(); } }, // TODO: Handle proper touch behavior. Including should make inactive when // finger moves more than 20x outside of the edge of the button (vs mouse // which goes inactive as soon as mouse goes out of edges.) touchStart: function(touch) { return this.mouseDown(touch); }, touchEnd: function(touch) { return this.mouseUp(touch); }, init: function() { Ember.deprecate("Ember.Button is deprecated and will be removed from future releases. Consider using the `{{action}}` helper."); this._super(); } }); })(); (function() { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== var get = Ember.get, set = Ember.set; /** @class @extends Ember.TextSupport */ Ember.TextArea = Ember.View.extend(Ember.TextSupport, /** @scope Ember.TextArea.prototype */ { classNames: ['ember-text-area'], tagName: "textarea", attributeBindings: ['rows', 'cols'], rows: null, cols: null, _updateElementValue: Ember.observer(function() { this.$().val(get(this, 'value')); }, 'value'), init: function() { this._super(); this.on("didInsertElement", this, this._updateElementValue); } }); })(); (function() { Ember.TabContainerView = Ember.View.extend(); })(); (function() { var get = Ember.get, getPath = Ember.getPath; Ember.TabPaneView = Ember.View.extend({ tabsContainer: Ember.computed(function() { return this.nearestInstanceOf(Ember.TabContainerView); }).property().volatile(), isVisible: Ember.computed(function() { return get(this, 'viewName') === getPath(this, 'tabsContainer.currentView'); }).property('tabsContainer.currentView').volatile() }); })(); (function() { var get = Ember.get, setPath = Ember.setPath; Ember.TabView = Ember.View.extend({ tabsContainer: Ember.computed(function() { return this.nearestInstanceOf(Ember.TabContainerView); }).property().volatile(), mouseUp: function() { setPath(this, 'tabsContainer.currentView', get(this, 'value')); } }); })(); (function() { })(); (function() { /*jshint eqeqeq:false */ var set = Ember.set, get = Ember.get, getPath = Ember.getPath; var indexOf = Ember.ArrayUtils.indexOf, indexesOf = Ember.ArrayUtils.indexesOf; /** @class The Ember.Select view class renders a [select](https://developer.mozilla.org/en/HTML/Element/select) HTML element, allowing the user to choose from a list of options. The selected option(s) are updated live in the `selection` property. @extends Ember.View */ Ember.Select = Ember.View.extend( /** @scope Ember.Select.prototype */ { tagName: 'select', defaultTemplate: Ember.Handlebars.compile('{{#if view.prompt}}{{/if}}{{#each view.content}}{{view Ember.SelectOption contentBinding="this"}}{{/each}}'), attributeBindings: ['multiple'], /** The `multiple` attribute of the select element. Indicates whether multiple options can be selected. @type Boolean @default false */ multiple: false, /** The list of options. If `optionLabelPath` and `optionValuePath` are not overridden, this should be a list of strings, which will serve simultaneously as labels and values. Otherwise, this should be a list of objects. For instance: content: Ember.A([ { id: 1, firstName: 'Yehuda' }, { id: 2, firstName: 'Tom' } ])), optionLabelPath: 'content.firstName', optionValuePath: 'content.id' @type Array @default null */ content: null, /** When `multiple` is false, the element of `content` that is currently selected, if any. When `multiple` is true, an array of such elements. @type Object or Array @default null */ selection: null, /** If given, a top-most dummy option will be rendered to serve as a user prompt. @type String @default null */ prompt: null, /** The path of the option labels. See `content`. @type String @default 'content' */ optionLabelPath: 'content', /** The path of the option values. See `content`. @type String @default 'content' */ optionValuePath: 'content', change: function() { if (get(this, 'multiple')) { this._changeMultiple(); } else { this._changeSingle(); } }, selectionDidChange: Ember.observer(function() { var selection = get(this, 'selection'), isArray = Ember.isArray(selection); if (get(this, 'multiple')) { if (!isArray) { set(this, 'selection', Ember.A([selection])); return; } this._selectionDidChangeMultiple(); } else { this._selectionDidChangeSingle(); } }, 'selection'), _triggerChange: function() { var selection = get(this, 'selection'); if (selection) { this.selectionDidChange(); } this.change(); }, _changeSingle: function() { var selectedIndex = this.$()[0].selectedIndex, content = get(this, 'content'), prompt = get(this, 'prompt'); if (!content) { return; } if (prompt && selectedIndex === 0) { set(this, 'selection', null); return; } if (prompt) { selectedIndex -= 1; } set(this, 'selection', content.objectAt(selectedIndex)); }, _changeMultiple: function() { var options = this.$('option:selected'), prompt = get(this, 'prompt'), offset = prompt ? 1 : 0, content = get(this, 'content'); if (!content){ return; } if (options) { var selectedIndexes = options.map(function(){ return this.index - offset; }).toArray(); set(this, 'selection', content.objectsAt(selectedIndexes)); } }, _selectionDidChangeSingle: function() { var el = this.$()[0], content = get(this, 'content'), selection = get(this, 'selection'), selectionIndex = content ? indexOf(content, selection) : -1, prompt = get(this, 'prompt'); if (prompt && selectionIndex > -1) { selectionIndex += 1; } if (el) { el.selectedIndex = selectionIndex; } }, _selectionDidChangeMultiple: function() { var content = get(this, 'content'), selection = get(this, 'selection'), selectedIndexes = content ? indexesOf(content, selection) : [-1], prompt = get(this, 'prompt'), offset = prompt ? 1 : 0, options = this.$('option'), adjusted; if (options) { options.each(function() { adjusted = this.index > -1 ? this.index + offset : -1; this.selected = indexOf(selectedIndexes, adjusted) > -1; }); } }, init: function() { this._super(); this.on("didInsertElement", this, this._triggerChange); } }); Ember.SelectOption = Ember.View.extend({ tagName: 'option', defaultTemplate: Ember.Handlebars.compile("{{view.label}}"), attributeBindings: ['value', 'selected'], init: function() { this.labelPathDidChange(); this.valuePathDidChange(); this._super(); }, selected: Ember.computed(function() { var content = get(this, 'content'), selection = getPath(this, 'parentView.selection'); if (getPath(this, 'parentView.multiple')) { return selection && indexOf(selection, content) > -1; } else { // Primitives get passed through bindings as objects... since // `new Number(4) !== 4`, we use `==` below return content == selection; } }).property('content', 'parentView.selection').volatile(), labelPathDidChange: Ember.observer(function() { var labelPath = getPath(this, 'parentView.optionLabelPath'); if (!labelPath) { return; } Ember.defineProperty(this, 'label', Ember.computed(function() { return getPath(this, labelPath); }).property(labelPath).cacheable()); }, 'parentView.optionLabelPath'), valuePathDidChange: Ember.observer(function() { var valuePath = getPath(this, 'parentView.optionValuePath'); if (!valuePath) { return; } Ember.defineProperty(this, 'value', Ember.computed(function() { return getPath(this, valuePath); }).property(valuePath).cacheable()); }, 'parentView.optionValuePath') }); })(); (function() { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== })(); (function() { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== /*globals Handlebars */ // Find templates stored in the head tag as script tags and make them available // to Ember.CoreView in the global Ember.TEMPLATES object. This will be run as as // jQuery DOM-ready callback. // // Script tags with "text/x-handlebars" will be compiled // with Ember's Handlebars and are suitable for use as a view's template. // Those with type="text/x-raw-handlebars" will be compiled with regular // Handlebars and are suitable for use in views' computed properties. Ember.Handlebars.bootstrap = function(ctx) { var selectors = 'script[type="text/x-handlebars"], script[type="text/x-raw-handlebars"]'; if (Ember.ENV.LEGACY_HANDLEBARS_TAGS) { selectors += ', script[type="text/html"]'; } Ember.warn("Ember no longer parses text/html script tags by default. Set ENV.LEGACY_HANDLEBARS_TAGS = true to restore this functionality.", Ember.ENV.LEGACY_HANDLEBARS_TAGS || Ember.$('script[type="text/html"]').length === 0); Ember.$(selectors, ctx) .each(function() { // Get a reference to the script tag var script = Ember.$(this), type = script.attr('type'); var compile = (script.attr('type') === 'text/x-raw-handlebars') ? Ember.$.proxy(Handlebars.compile, Handlebars) : Ember.$.proxy(Ember.Handlebars.compile, Ember.Handlebars), // Get the name of the script, used by Ember.View's templateName property. // First look for data-template-name attribute, then fall back to its // id if no name is found. templateName = script.attr('data-template-name') || script.attr('id'), template = compile(script.html()), view, viewPath, elementId, tagName, options; if (templateName) { // For templates which have a name, we save them and then remove them from the DOM Ember.TEMPLATES[templateName] = template; // Remove script tag from DOM script.remove(); } else { if (script.parents('head').length !== 0) { // don't allow inline templates in the head throw new Ember.Error("Template found in without a name specified. " + "Please provide a data-template-name attribute.\n" + script.html()); } // For templates which will be evaluated inline in the HTML document, instantiates a new // view, and replaces the script tag holding the template with the new // view's DOM representation. // // Users can optionally specify a custom view subclass to use by setting the // data-view attribute of the script tag. viewPath = script.attr('data-view'); view = viewPath ? Ember.getPath(viewPath) : Ember.View; // Get the id of the script, used by Ember.View's elementId property, // Look for data-element-id attribute. elementId = script.attr('data-element-id'); // Users can optionally specify a custom tag name to use by setting the // data-tag-name attribute on the script tag. tagName = script.attr('data-tag-name'); options = { template: template }; if (elementId) { options.elementId = elementId; } if (tagName) { options.tagName = tagName; } view = view.create(options); view._insertElementLater(function() { script.replaceWith(this.$()); // Avoid memory leak in IE script = null; }); } }); }; Ember.$(document).ready( function(){ Ember.Handlebars.bootstrap( Ember.$(document) ); } ); })(); (function() { // ========================================================================== // Project: Ember Handlebar Views // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== })(); (function() { // ========================================================================== // Project: Ember // Copyright: ©2011 Strobe Inc. and contributors. // License: Licensed under MIT license (see license.js) // ========================================================================== })();