Add `replaceElement` option to Marionette.Region

marionette.replaceElement.js

Marionette.Region.prototype.show = function(view, options) {
  var forceShow, isChangingView, isDifferentView, preventDestroy, replaceElement, showOptions, _shouldDestroyView, _shouldReplaceElement, _shouldShowView;
  
  this._ensureElement();
  
  showOptions = options || {};
  isDifferentView = view !== this.currentView;
  preventDestroy = !!showOptions.preventDestroy;
  forceShow = !!showOptions.forceShow;
  replaceElement = !!showOptions.replaceElement;
  isChangingView = !!this.currentView;
  _shouldDestroyView = isDifferentView && !preventDestroy;
  _shouldShowView = isDifferentView || forceShow;
  _shouldReplaceElement = replaceElement;
  
  if (isChangingView) {
    this.triggerMethod('before:swapOut', this.currentView);
  }
  
  if (_shouldDestroyView) {
    this.empty();
  }
  
  if (_shouldShowView) {
    view.once('destroy', this.empty, this);
    view.render();
    
    if (isChangingView) {
      this.triggerMethod('before:swap', view);
    }
    
    this.triggerMethod('before:show', view);
    Marionette.triggerMethodOn(view, 'before:show');
    this.attachHtml(view, _shouldReplaceElement);
    
    if (isChangingView) {
      this.triggerMethod('swapOut', this.currentView);
    }
    
    this.currentView = view;
    
    if (isChangingView) {
      triggerMethod('swap', view);
    }
    
    this.triggerMethod('show', view);
    Marionette.triggerMethodOn(view, 'show');
    
    return this;
  }
  
  return this;
};

Marionette.Region.prototype.replaceEl = function(view) {
  var parent;
  
  parent = this.el.parentNode;
  parent.replaceChild(view.el, this.el);
  this.replaced = true;
};

Marionette.Region.prototype.restoreEl = function() {
  var parent, view;
  
  view = this.currentView;
  parent = this.el.parentNode;
  parent.replaceChild(this.el, view.el);
  this.replaced = false;
};

Marionette.Region.prototype.attachHtml = function(view) {
  if (arguments[1]) {
    this.replaceEl(view);
  } else {
    this.el.innerHTML = '';
    this.el.appendChild(view.el);
  }
};

Marionette.Region.prototype.empty = function() {
  var view;
  
  view = this.currentView;
  
  if (!view) {
    return;
  }
  
  this.triggerMethod('before:empty', view);
  
  if (this.replaced) {
    this.restoreEl();
  }
  
  this._destroyView();
  this.triggerMethod('empty', view);
  delete this.currentView;
  
  return this;
};