Marionette

Marionette was built on top of the Backbone.js library, a JavaScript library adding MVC principles to JavaScript.

Using these MVC principles, Marionette adds support for features usually provided by more advanced programming languages like Ruby, PHP or Python.

The framework is not a framework per se, but a collection of useful Backbone.js packages.

What is new in this release:

• You can now set a filter method on a CollectionView or CompositeView to filter what views are show. This is useful for when you are displaying a list that a user can filter.
• Add the reorderOnSort option to CollectionView and CompositeView to use jQuery to move child nodes around without having to re-render the entire tree. This is a massive perf boost and is an easy win if you are sorting your collections.
• The CollectionView now has a viewComparator, to enable custom sorting on a per view basis regardless of what how your backing collection is sorted.
• Refactor sort param lookup to use Marionette.getOption.
• Add a new helper method for easier showing of child nodes showChildView
• this.showChildView('sidebar', new SidebarView());
• Add a new helper method of easier retrieving of child nodes getChildView
• this.getChildView(‘sidebar')
• Add a destroyImmediate option to the LayoutView, to destroy the layout view element and then remove the child nodes. This is a perf optimization that you can now opt into.
• @ui interpolation is now supported within region definitions on a LayoutView
• regionEvent support was added
• The destroy method now returns this instance that was destroyed to enable easier chaining of view actions.
• If you define the options hash on your Marionette.View or if you pass options as a function to your Marionette.View, pass the result of options down to the backbone view constructor.
• All views now have a isRendered property, that is updated after render and destroy.

What is new in version 2.4.3:

• You can now set a filter method on a CollectionView or CompositeView to filter what views are show. This is useful for when you are displaying a list that a user can filter.
• Add the reorderOnSort option to CollectionView and CompositeView to use jQuery to move child nodes around without having to re-render the entire tree. This is a massive perf boost and is an easy win if you are sorting your collections.
• The CollectionView now has a viewComparator, to enable custom sorting on a per view basis regardless of what how your backing collection is sorted.
• Refactor sort param lookup to use Marionette.getOption.
• Add a new helper method for easier showing of child nodes showChildView
• this.showChildView('sidebar', new SidebarView());
• Add a new helper method of easier retrieving of child nodes getChildView
• this.getChildView(‘sidebar')
• Add a destroyImmediate option to the LayoutView, to destroy the layout view element and then remove the child nodes. This is a perf optimization that you can now opt into.
• @ui interpolation is now supported within region definitions on a LayoutView
• regionEvent support was added
• The destroy method now returns this instance that was destroyed to enable easier chaining of view actions.
• If you define the options hash on your Marionette.View or if you pass options as a function to your Marionette.View, pass the result of options down to the backbone view constructor.
• All views now have a isRendered property, that is updated after render and destroy.

What is new in version 2.4.2:

• You can now set a filter method on a CollectionView or CompositeView to filter what views are show. This is useful for when you are displaying a list that a user can filter.
• Add the reorderOnSort option to CollectionView and CompositeView to use jQuery to move child nodes around without having to re-render the entire tree. This is a massive perf boost and is an easy win if you are sorting your collections.
• The CollectionView now has a viewComparator, to enable custom sorting on a per view basis regardless of what how your backing collection is sorted.
• Refactor sort param lookup to use Marionette.getOption.
• Add a new helper method for easier showing of child nodes showChildView
• this.showChildView('sidebar', new SidebarView());
• Add a new helper method of easier retrieving of child nodes getChildView
• this.getChildView(‘sidebar')
• Add a destroyImmediate option to the LayoutView, to destroy the layout view element and then remove the child nodes. This is a perf optimization that you can now opt into.
• @ui interpolation is now supported within region definitions on a LayoutView
• regionEvent support was added
• The destroy method now returns this instance that was destroyed to enable easier chaining of view actions.
• If you define the options hash on your Marionette.View or if you pass options as a function to your Marionette.View, pass the result of options down to the backbone view constructor.
• All views now have a isRendered property, that is updated after render and destroy.

What is new in version 2.4.1:

• You can now set a filter method on a CollectionView or CompositeView to filter what views are show. This is useful for when you are displaying a list that a user can filter.
• Add the reorderOnSort option to CollectionView and CompositeView to use jQuery to move child nodes around without having to re-render the entire tree. This is a massive perf boost and is an easy win if you are sorting your collections.
• The CollectionView now has a viewComparator, to enable custom sorting on a per view basis regardless of what how your backing collection is sorted.
• Refactor sort param lookup to use Marionette.getOption.
• Add a new helper method for easier showing of child nodes showChildView
• this.showChildView('sidebar', new SidebarView());
• Add a new helper method of easier retrieving of child nodes getChildView
• this.getChildView(‘sidebar')
• Add a destroyImmediate option to the LayoutView, to destroy the layout view element and then remove the child nodes. This is a perf optimization that you can now opt into.
• @ui interpolation is now supported within region definitions on a LayoutView
• regionEvent support was added
• The destroy method now returns this instance that was destroyed to enable easier chaining of view actions.
• If you define the options hash on your Marionette.View or if you pass options as a function to your Marionette.View, pass the result of options down to the backbone view constructor.
• All views now have a isRendered property, that is updated after render and destroy.

What is new in version 2.3.2:

• Bug Fixes:
• IE8 regression in Marionette._getValue to always call apply with either an array of params or an empty array.

What is new in version 2.2.2:

• Fixes:
• Remove duplicate call to region.empty on view destroy.
• Fix call time of swapOut.
• Fix broken link in Marionette Error messages.

What is new in version 2.2.0:

• CollectionViews now receive events from emptyViews in the childEvents hash
• Regions now receive swapOut and beforeSwapOut events.
• Region constructor now can take a el as an option when calling addRegion
• Region reset leaves el intact
• Application has this.options
• Application has initialize method
• Behaviors no longer wrap view methods
• Normalize region selectors hash to allow a user to use the @ui. syntax

What is new in version 2.1.0:

• Add a el reference to the views el from within a behavior instance.
• ItemViews can now have no template by setting template: false.
• Application objects can now configure their default message channel.
• Application objects now have the getOption method.
• Regions now have a hasView method to determine if there is a view within a given region.
• Views no longer use toJSON directly on models. instead they call into the new overridable methods serializeModel and serializeCollection where are called via serializeData.

What is new in version 2.0.0:

• This is a breaking release and contains many API updates and changes.

What is new in version 1.8.2:

• Fixes:
• Behaviors now calls stopListening on close.
• Behaviors now undelegate modelEvents and collectionEvents when the parent view calls undelegateEvents.

What is new in version 1.7.4:

• General:
• Update bower dependencies to take advantage of the fact that marionette repos follow semver.
• Fixes:
• Behaviors events no longer collide with each other.
• Revert stopListening call on stop for modules. While this was a "fix", the docs were quite vague leading to breaking changes for many people.

What is new in version 1.7.1:

• Fixes:
• Enables the use of string based behavior event methods.

What is new in version 1.6.4:

• Patches a bug that would cause modules to be initialized twice when a custom module class is passed.

What is new in version 1.6.3:

• Enable more direct module instantiation on Marionette.App.
• Fix @ui interpolation for handling complex selectors.
• Improved readme docs for CollectionView, AppRouter and ItemView.
• Handle THE npm self sign cert problem
• Replaced unneeded argument slicing.
• Normalize error throwing to use internal throwError helper method.

What is new in version 1.5.1:

• Fixed bug where show and onDomRefresh was not called on itemViews in certain conditions.

What is new in version 1.5.0:

• Fixed bug where resetting a `collection` within a `collectionView` would cause `onShow` and `onDomRefresh` to be called incorrectly.
• `addItemView` now returns the `view` that was added.
• Can now specify an `itemEvents` hash or method which allows you to capture all bubbling itemEvents without having to manually set bindings.

What is new in version 1.4.0:

• Adds the ability to use the new @ui. syntax within the events and triggers hash to prevent selector duplication.

What is new in version 1.2.3:

• Fixed bug where child views were being added before the initial render, thus raising errors.

What is new in version 1.2.2:

• Move the instantiation of view options above the constructor This allows for view options to be accessed from within the initialize method for a given view This is needed since backbone views no longer set the view options in the constructor.

What is new in version 1.2.1:

• Fixed a bug so now view options are {} by default and not undefined.
• Fixed a bug where the triggers preventDefault and stopPropagation were executing in the wrong context - triggers now prevent default and stop propagation by default once more.

What is new in version 1.2.0:

• Update Backbone to 1.1.0
• Added the ability to customize the behavior of triggers preventDefault and stopPropagation

What is new in version 1.0.3:

• Added index parameter to method signature, to show that is is available.
• Deleted uneeeded constructor function and removed call to getItemView as it was causing problems and was not needed in the constructor.
• Fixed a bug to decrement the .length when a region is removed.

What is new in version 1.0.2:

• Fixed bug to unbind them after the "close" event / onClose method, so the ui elements are available during these.
• Fixed bug that was reversing the order of routes, causing the wrong route to be fired in many cases.

Requirements:

• JavaScript enabled on client side
• Backbone.js 0.9.9 or higher
• Underscore.js 1.4.4 or higher