Function: replace(domElementOrMarkupStringOrCSSSelector, domInsertionElement, functionCallback(domElement))

Description: Inserts a DOM element, markup string, or CSS selector referenced element at the same location as the target element in the DOM.

Returns: domElement, or $A object if chained.

Example:

// Replace a DOM element targetted with a CSS selector
var myElement = $A.replace(domElement, "#myTargetNodeId");

// Replace a DOM element with a markup string
var myElement = $A.replace('<div>Here we are now, entertain us.</div>', domElement);

// Replace a DOM element with an element referenced by a CSS selector
var myElement = $A.replace("#myTargetNodeToMove", domElement);

// Replace a DOM element and exicute a callback when done
var myElement = $A.replace(domElementToMove, domElementToTarget, function(domElementToMove) {
  // Do something with domElementToMove after the replace is complete.
});

// Or the same using chaining

// Replace a DOM element targetted with a CSS selector
var myChain = $A(domElement).replace("#myTargetNodeId");

// Replace a DOM element with a markup string
var myChain = $A('<div>Here we are now, entertain us.</div>').replace(domElement);

// Replace a DOM element with an element referenced by a CSS selector
var myChain = $A("#myTargetNodeToMove").replace(domElement);

// Replace a DOM element and exicute a callback when done
var myChain = $A(domElementToMove).replace(domElementToTarget, function(domElementToMove) {
  // Do something with domElementToMove after the replace is complete.
});

// To return the modified element within a chain, use the "return()" method.

var myElement = myChain.return();