wrap
wrap: function( html ) {
// <summary>
// Wrap all matched elements with a structure of other elements.
// This wrapping process is most useful for injecting additional
// stucture into a document, without ruining the original semantic
// qualities of a document.
// This works by going through the first element
// provided and finding the deepest ancestor element within its
// structure - it is that element that will en-wrap everything else.
// This does not work with elements that contain text. Any necessary text
// must be added after the wrapping is done.
// Part of DOM/Manipulation
// </summary>
// <returns type="jQuery" />
// <param name="html" type="Element">
// A DOM element that will be wrapped around the target.
// </param>
return this.each(function(){
jQuery( this ).wrapAll( html );
});
},