All Versions
Latest Version
Avg Release Cycle
116 days
Latest Release
1283 days ago

Changelog History
Page 2

  • v3.4.3 Changes

    September 06, 2017

    πŸ›  Fixes

    • 🚚 NextCollectionView collection single model remove no longer incorrectly removes all children
    • EmptyView will correctly display if a NextCollectionView is rendered in initialize
  • v3.4.2 Changes

    πŸ›  Fixes

    • Regions will now ensure there is only one node in its $el
    • Regions will not query outside of the parent view if the selector is not found in its context
    • The setDomApi and setRenderer class methods now correctly return the prototype when called
  • v3.4.1 Changes

    πŸ›  Fixes

    • Options passed to a behavior are now correctly passed to the behavior
    • πŸ— The ES6 module is no longer exposed in package.json as this was breaking for some builds
    • The detachContents will now correctly detach when using monitorViewEvents: false on a NextCollectionView
  • v3.4.0 Changes

    πŸ”‹ Features

    • πŸ— A new build of Marionette supporting ES6 modules was added
    • βž• Added DOM API to encapsulate DOM interactions in the views and region
    • monitorViewEvents was added as an option to all Views to disable DOM lifecycle events
    • βž• Added swapChildViews to NextCollectionView
    • βž• Added viewComparator: false option to NextCollectionView for disabling the default sort

    Experimental API Breaking Changes

    • 🚚 DOM Mixin was removed (replaced with DOM API)
    • NextCollectionView attachHtml no longer receives the view as the first argument

    πŸ›  Fixes

    • A region's currentView will now be set during that view's initial dom:refresh event
    • A view will now be considered rendered if its el has contents and not only if it has an el


    • While Backbone.Radio is still a dependency, it will no longer cause Marionette to error if nonexistent
    • 🐎 Various performance improvements
  • v3.3.1 Changes

    πŸ›  Fixes

    • πŸ—„ Behavior defaults deprecation notice was always triggering
    • Regions threw an error if a childview destroy resulted in a parent view destroy
  • v3.3.0 Changes

    πŸ”‹ Features

    • βž• Added removeView and isSwapping to Region to better support animation
    • NextCollectionView added as a potential replacement for CollectionView in v4
    • βž• Added view initialize event to behaviors
    • getRegion will now render the region's view if it is currently not rendered
    • 🚚 If a behavior or a region is destroyed it will now be removed from the view
    • βž• Added onDomRemove event for better clean up of things added in onDomRefresh
    • 0️⃣ childViewEventPrefix feature flag to allow for false by default
    • πŸ‘Œ Support custom renderers per view prototype

    πŸ›  Fixes

    • Trigger detach events when restoring el

    πŸ—„ Deprecations

    • πŸ—„ template: false deprecated in favor of template: _.noop
    • πŸ—„ Behavior defaults deprecated in favor of setting options on the Behavior definition
    • Marionette.Renderer in favor of new custom view renderer.


    • ⚑️ Update babel and build tools
    • πŸ›  Fix tests runner for IE11
  • v3.2.0 Changes

    πŸ”‹ Features

    • πŸ”Œ Separate Mn DOM interaction into a mixin for DOM plugin ease
    • πŸ‘ View.childViewEvents should support trigger
    • πŸ‘ Allow showing a template or static string in a region
    • πŸ”‹ Feature/trigger method event args

    πŸ›  Fixes

    • Custom CollectionView.viewComparator no longer sorts collection.models
    • CollectionView re-indexes correctly when removing views.
    • CollectionView.filter can filter by View child index
    • Region will no longer detach pre-existing HTML when View's el is already in the region
    • πŸ›  Fix Region clean up when View is destroyed
    • Destroy CollectionView.children by View and not Model


    • βœ‚ Remove MarionetteError "ViewDestroyError" from View's
  • v3.1.0 Changes


    • 🐎 Performance optimizations for triggerMethod, mergeOptions and other internal event handlers
    • ⚑️ Significant render and removal optimizations for CollectionView utilizing Backbone's update event

    πŸ”‹ Features

    • πŸ—„ Region.detachView and View.detachChildView were added for removing a view from a region without destroying it. This is preferred to the now deprecated preventDestroy region show/empty option
    • childViewEventPrefix: false will disable auto-proxying of child events to the parent view
    • Application will now accept a region definition object literal as an instantiation option
    • 🚚 Regions are now destroyed when removed from a View

    πŸ›  Fixes

    • πŸ›  Fixed an issue with Lodash 4 compatibility related to behavior events

    πŸ—„ Deprecations

    • πŸ—„ Region empty's preventDestroy option was deprecated in favor of detachView
    • πŸ—„ A region definition object literal's selector key was deprecated due to redundacy in favor of the existing key el


    • πŸ“š Many documentation fixes for v3
    • βœ‚ Removed shouldReplace logic from attachHtml so overriding no longer breaks replaceElement functionality
    • πŸ”¦ Exposed View.normalizeUIString for external libraries
    • πŸ‘Œ Improvements were made for Views initialized with existing DOM elements
  • v3.0.0 Changes

    πŸ”– Version 3.0.0 of Marionette has arrived and contains many improvements over version 2.x but also some API Changes. Below is a list of the changes made to each component.

    πŸš€ To help the community transition over we have released a v2 patch tool to assist ⬆️ the upgrade. Marionette Patch Tool


    • πŸ”€ LayoutView + ItemView merge and rename to View.
    • Marionette.View -> ViewMixin
    • βž• Added LayoutView shortcut methods such as showChildView.
    • isDestroyed and isRendered made private with a public accessor method.
    • 0️⃣ Now set _isDestroyed to false by default
    • Call Backbone.View with result of options (163188eeb8)
    • CompositeView's renderChildren is now public.
    • πŸ“‡ Renamed childEvents to childViewEvents.
    • βœ‚ Removed passing view options as a function
    • πŸ“‡ Renamed templateHelpers to templateContext
    • Made sure before:render is triggered before emptying regions.
    • Regions are not attached directly to the layout. Use getRegion to access the region or showChildView to show a View within it.
    • πŸ‘ Allowed CompositeView to attach to existing HTML with template:false
    • βž• Added hasRegion for layouts
    • Enabled passing preventDestroy to region.empty.
    • πŸ”€ View now removes its element before destroying child regions. There was an option to turn it on, but now it’s available by default. This helps remove all of the synchronous paints going up the tree.


    • The childView attribute now accepts a function
    • 🚚 getChildView was removed
    • emptyView now accepts a function as an arg.
    • Proxied events do not append β€œthis” as an argument
    • βœ‚ Removed the apply:filter event from CollectionView.
    • 🚚 removeChildView now returns the removed view.


    • πŸ›  Fixed inconsistency in addRegion, it now behaves like addRegions and adds the region to internal this.regions.
    • View can replace regions's el.
    • Replaced region manager with region-mixin.
    • βœ‚ Removed static buildRegion
    • βœ‚ Removed swap events.


    • Introduced region to Application (rootRegion)
    • βœ‚ Removed regions
    • βœ‚ Removed Initializers and Finalizers Callbacks
    • βœ‚ Removed Application vent, commands, requests


    • βž• Added support for Object.isDestroyed


    • βž• Added Rest & Spread ES6 syntax
    • using ES6 Modules
    • Replaced var and let with const.

    General Enhancements

    • βž• Added DEV_MODE
    • πŸ”„ Changed multiple arg usage to drop for lodash 3 support.
    • Behavior, View Mixins.
    • βž• Added cid field to object, application, behavior, and region
    • βž• Added TemplateCache options.
    • πŸ‘ Allow a user to define trigger handlers in options.
    • πŸ‘ Increased Lodash compatibility, (now supports upto lodash 4)
    • βž• Added first class support for Backbone.Radio in Mn.Object
    • ⚑️ Updated BB and _ deps to modern versions
    • ⚑️ Updated Radio from 0.9 to 2.0
    • delegateEntityEvents. Delegate Events used to set delegate entity events, it was extracted because now backbone calls delegateEvent everytime the element is set.
    • βž• Added Backbone.Babysitter to Mn and removed the Babysitter dependency.

    πŸ—„ Deprecations

    • πŸ—„ Deprecated CompositeView
    • πŸ—„ Deprecated Behavior Lookups.

    βœ‚ Removed

    • βœ‚ Removed Marionette.Module - there’s a shim that you can pull in to get Module and Deferred
    • βœ‚ Removed Marionette.Deferred
    • βœ‚ Removed component.json
    • βœ‚ Removed Controller
    • βœ‚ Removed Callbacks
    • βœ‚ Removed Wreqr (replaced with Radio)
    • βœ‚ Removed actAsCollection
    • βœ‚ Removed _getValue.

    API Renames

    • πŸ“‡ Renamed render:collection => render:children
    • πŸ“‡ Renamed bindEntityEvents => bindEvents.
  • v3.0.0-pre5 Changes

    πŸ“š Documentation

    • πŸ‘Œ Improved installation docs.
    • ⚑️ Updated CollectionView docs to reflect API changes.
    • πŸ‘Œ Improved Behavior docs.
    • πŸ‘Œ Improved functions docs.
    • πŸ‘Œ Improved update guide.
    • βž• Added "basics" docs.

    API Changes

    • emptyView now accepts a function as an arg.
    • βœ‚ Removed the apply:filter event from CollectionView.
    • 🚚 removeChildView now returns the removed view.
    • bindEntityEvents renamed bindEvents.
    • πŸ—„ Deprecated Behavior Lookups.
    • βž• Added Backbone.Babysitter to Mn and removed the Babysitter dependency.

    πŸ› Bug fixes

    • CollectionView now only triggers destroy:children if it has been rendered.
    • Parent views will now successfully listen for destroy in childViewEvents.


    • Replaced var and let with const.
    • βž• Added consistent function declarations and added rules to eslint.
    • πŸ‘‰ Tweaked peerDependencies to only allow patch versions.
    • Directory structure changes and file naming consistency.
    • πŸ‘Œ Improved test coverage.
    • βœ‚ Removed bundled build.