src/manipulation.js

   1 (function( jQuery ) {
   2
   3 var rinlinejQuery = / jQuery\d+="(?:\d+|null)"/g,
   4         rleadingWhitespace = /^\s+/,
   5         rxhtmlTag = /<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/ig,
   6         rtagName = /<([\w:]+)/,
   7         rtbody = /<tbody/i,
   8         rhtml = /<|&#?\w+;/,
   9         rnocache = /<(?:script|object|embed|option|style)/i,
  10         // checked="checked" or checked (html5)
  11         rchecked = /checked\s*(?:[^=]|=\s*.checked.)/i,
  12         wrapMap = {
  13                 option: [ 1, "<select multiple='multiple'>", "</select>" ],
  14                 legend: [ 1, "<fieldset>", "</fieldset>" ],
  15                 thead: [ 1, "<table>", "</table>" ],
  16                 tr: [ 2, "<table><tbody>", "</tbody></table>" ],
  17                 td: [ 3, "<table><tbody><tr>", "</tr></tbody></table>" ],
  18                 col: [ 2, "<table><tbody></tbody><colgroup>", "</colgroup></table>" ],
  19                 area: [ 1, "<map>", "</map>" ],
  20                 _default: [ 0, "", "" ]
  21         };
  22
  23 wrapMap.optgroup = wrapMap.option;
  24 wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead;
  25 wrapMap.th = wrapMap.td;
  26
  27 // IE can't serialize <link> and <script> tags normally
  28 if ( !jQuery.support.htmlSerialize ) {
  29         wrapMap._default = [ 1, "div<div>", "</div>" ];
  30 }
  31
  32 jQuery.fn.extend({
  33         text: function( text ) {
  34                 if ( jQuery.isFunction(text) ) {
  35                         return this.each(function(i) {
  36                                 var self = jQuery( this );
  37
  38                                 self.text( text.call(this, i, self.text()) );
  39                         });
  40                 }
  41
  42                 if ( typeof text !== "object" && text !== undefined ) {
  43                         return this.empty().append( (this[0] && this[0].ownerDocument || document).createTextNode( text ) );
  44                 }
  45
  46                 return jQuery.text( this );
  47         },
  48
  49         wrapAll: function( html ) {
  50                 if ( jQuery.isFunction( html ) ) {
  51                         return this.each(function(i) {
  52                                 jQuery(this).wrapAll( html.call(this, i) );
  53                         });
  54                 }
  55
  56                 if ( this[0] ) {
  57                         // The elements to wrap the target around
  58                         var wrap = jQuery( html, this[0].ownerDocument ).eq(0).clone(true);
  59
  60                         if ( this[0].parentNode ) {
  61                                 wrap.insertBefore( this[0] );
  62                         }
  63
  64                         wrap.map(function() {
  65                                 var elem = this;
  66
  67                                 while ( elem.firstChild && elem.firstChild.nodeType === 1 ) {
  68                                         elem = elem.firstChild;
  69                                 }
  70
  71                                 return elem;
  72                         }).append(this);
  73                 }
  74
  75                 return this;
  76         },
  77
  78         wrapInner: function( html ) {
  79                 if ( jQuery.isFunction( html ) ) {
  80                         return this.each(function(i) {
  81                                 jQuery(this).wrapInner( html.call(this, i) );
  82                         });
  83                 }
  84
  85                 return this.each(function() {
  86                         var self = jQuery( this ),
  87                                 contents = self.contents();
  88
  89                         if ( contents.length ) {
  90                                 contents.wrapAll( html );
  91
  92                         } else {
  93                                 self.append( html );
  94                         }
  95                 });
  96         },
  97
  98         wrap: function( html ) {
  99                 return this.each(function() {
 100                         jQuery( this ).wrapAll( html );
 101                 });
 102         },
 103
 104         unwrap: function() {
 105                 return this.parent().each(function() {
 106                         if ( !jQuery.nodeName( this, "body" ) ) {
 107                                 jQuery( this ).replaceWith( this.childNodes );
 108                         }
 109                 }).end();
 110         },
 111
 112         append: function() {
 113                 return this.domManip(arguments, true, function( elem ) {
 114                         if ( this.nodeType === 1 ) {
 115                                 this.appendChild( elem );
 116                         }
 117                 });
 118         },
 119
 120         prepend: function() {
 121                 return this.domManip(arguments, true, function( elem ) {
 122                         if ( this.nodeType === 1 ) {
 123                                 this.insertBefore( elem, this.firstChild );
 124                         }
 125                 });
 126         },
 127
 128         before: function() {
 129                 if ( this[0] && this[0].parentNode ) {
 130                         return this.domManip(arguments, false, function( elem ) {
 131                                 this.parentNode.insertBefore( elem, this );
 132                         });
 133                 } else if ( arguments.length ) {
 134                         var set = jQuery(arguments[0]);
 135                         set.push.apply( set, this.toArray() );
 136                         return this.pushStack( set, "before", arguments );
 137                 }
 138         },
 139
 140         after: function() {
 141                 if ( this[0] && this[0].parentNode ) {
 142                         return this.domManip(arguments, false, function( elem ) {
 143                                 this.parentNode.insertBefore( elem, this.nextSibling );
 144                         });
 145                 } else if ( arguments.length ) {
 146                         var set = this.pushStack( this, "after", arguments );
 147                         set.push.apply( set, jQuery(arguments[0]).toArray() );
 148                         return set;
 149                 }
 150         },
 151
 152         // keepData is for internal use only--do not document
 153         remove: function( selector, keepData ) {
 154                 for ( var i = 0, elem; (elem = this[i]) != null; i++ ) {
 155                         if ( !selector || jQuery.filter( selector, [ elem ] ).length ) {
 156                                 if ( !keepData && elem.nodeType === 1 ) {
 157                                         jQuery.cleanData( elem.getElementsByTagName("*") );
 158                                         jQuery.cleanData( [ elem ] );
 159                                 }
 160
 161                                 if ( elem.parentNode ) {
 162                                          elem.parentNode.removeChild( elem );
 163                                 }
 164                         }
 165                 }
 166
 167                 return this;
 168         },
 169
 170         empty: function() {
 171                 for ( var i = 0, elem; (elem = this[i]) != null; i++ ) {
 172                         // Remove element nodes and prevent memory leaks
 173                         if ( elem.nodeType === 1 ) {
 174                                 jQuery.cleanData( elem.getElementsByTagName("*") );
 175                         }
 176
 177                         // Remove any remaining nodes
 178                         while ( elem.firstChild ) {
 179                                 elem.removeChild( elem.firstChild );
 180                         }
 181                 }
 182
 183                 return this;
 184         },
 185
 186         clone: function( events ) {
 187                 // Do the clone
 188                 var ret = this.map(function() {
 189                         var clone = this.cloneNode(true);
 190                         if ( !jQuery.support.noCloneEvent && (this.nodeType === 1 || this.nodeType === 11) && !jQuery.isXMLDoc(this) ) {
 191                                 // IE copies events bound via attachEvent when using cloneNode.
 192                                 // Calling detachEvent on the clone will also remove the events
 193                                 // from the original. In order to get around this, we use some
 194                                 // proprietary methods to clear the events. Thanks to MooTools
 195                                 // guys for this hotness.
 196
 197                                 // Using Sizzle here is crazy slow, so we use getElementsByTagName
 198                                 // instead
 199                                 var srcElements = this.getElementsByTagName("*"),
 200                                         destElements = clone.getElementsByTagName("*");
 201
 202                                 // Weird iteration because IE will replace the length property
 203                                 // with an element if you are cloning the body and one of the
 204                                 // elements on the page has a name or id of "length"
 205                                 for ( var i = 0; srcElements[i]; ++i ) {
 206                                         cloneFixAttributes( srcElements[i], destElements[i] );
 207                                 }
 208
 209                                 cloneFixAttributes( this, clone );
 210                         }
 211
 212                         return clone;
 213                 });
 214
 215                 // Copy the events from the original to the clone
 216                 if ( events === true ) {
 217                         cloneCopyEvent( this, ret );
 218                         cloneCopyEvent( this.find("*"), ret.find("*") );
 219                 }
 220
 221                 // Return the cloned set
 222                 return ret;
 223         },
 224
 225         html: function( value ) {
 226                 if ( value === undefined ) {
 227                         return this[0] && this[0].nodeType === 1 ?
 228                                 this[0].innerHTML.replace(rinlinejQuery, "") :
 229                                 null;
 230
 231                 // See if we can take a shortcut and just use innerHTML
 232                 } else if ( typeof value === "string" && !rnocache.test( value ) &&
 233                         (jQuery.support.leadingWhitespace || !rleadingWhitespace.test( value )) &&
 234                         !wrapMap[ (rtagName.exec( value ) || ["", ""])[1].toLowerCase() ] ) {
 235
 236                         value = value.replace(rxhtmlTag, "<$1></$2>");
 237
 238                         try {
 239                                 for ( var i = 0, l = this.length; i < l; i++ ) {
 240                                         // Remove element nodes and prevent memory leaks
 241                                         if ( this[i].nodeType === 1 ) {
 242                                                 jQuery.cleanData( this[i].getElementsByTagName("*") );
 243                                                 this[i].innerHTML = value;
 244                                         }
 245                                 }
 246
 247                         // If using innerHTML throws an exception, use the fallback method
 248                         } catch(e) {
 249                                 this.empty().append( value );
 250                         }
 251
 252                 } else if ( jQuery.isFunction( value ) ) {
 253                         this.each(function(i){
 254                                 var self = jQuery( this );
 255
 256                                 self.html( value.call(this, i, self.html()) );
 257                         });
 258
 259                 } else {
 260                         this.empty().append( value );
 261                 }
 262
 263                 return this;
 264         },
 265
 266         replaceWith: function( value ) {
 267                 if ( this[0] && this[0].parentNode ) {
 268                         // Make sure that the elements are removed from the DOM before they are inserted
 269                         // this can help fix replacing a parent with child elements
 270                         if ( jQuery.isFunction( value ) ) {
 271                                 return this.each(function(i) {
 272                                         var self = jQuery(this), old = self.html();
 273                                         self.replaceWith( value.call( this, i, old ) );
 274                                 });
 275                         }
 276
 277                         if ( typeof value !== "string" ) {
 278                                 value = jQuery( value ).detach();
 279                         }
 280
 281                         return this.each(function() {
 282                                 var next = this.nextSibling,
 283                                         parent = this.parentNode;
 284
 285                                 jQuery( this ).remove();
 286
 287                                 if ( next ) {
 288                                         jQuery(next).before( value );
 289                                 } else {
 290                                         jQuery(parent).append( value );
 291                                 }
 292                         });
 293                 } else {
 294                         return this.pushStack( jQuery(jQuery.isFunction(value) ? value() : value), "replaceWith", value );
 295                 }
 296         },
 297
 298         detach: function( selector ) {
 299                 return this.remove( selector, true );
 300         },
 301
 302         domManip: function( args, table, callback ) {
 303                 var results, first, fragment, parent,
 304                         value = args[0],
 305                         scripts = [];
 306
 307                 // We can't cloneNode fragments that contain checked, in WebKit
 308                 if ( !jQuery.support.checkClone && arguments.length === 3 && typeof value === "string" && rchecked.test( value ) ) {
 309                         return this.each(function() {
 310                                 jQuery(this).domManip( args, table, callback, true );
 311                         });
 312                 }
 313
 314                 if ( jQuery.isFunction(value) ) {
 315                         return this.each(function(i) {
 316                                 var self = jQuery(this);
 317                                 args[0] = value.call(this, i, table ? self.html() : undefined);
 318                                 self.domManip( args, table, callback );
 319                         });
 320                 }
 321
 322                 if ( this[0] ) {
 323                         parent = value && value.parentNode;
 324
 325                         // If we're in a fragment, just use that instead of building a new one
 326                         if ( jQuery.support.parentNode && parent && parent.nodeType === 11 && parent.childNodes.length === this.length ) {
 327                                 results = { fragment: parent };
 328
 329                         } else {
 330                                 results = jQuery.buildFragment( args, this, scripts );
 331                         }
 332
 333                         fragment = results.fragment;
 334
 335                         if ( fragment.childNodes.length === 1 ) {
 336                                 first = fragment = fragment.firstChild;
 337                         } else {
 338                                 first = fragment.firstChild;
 339                         }
 340
 341                         if ( first ) {
 342                                 table = table && jQuery.nodeName( first, "tr" );
 343
 344                                 for ( var i = 0, l = this.length; i < l; i++ ) {
 345                                         callback.call(
 346                                                 table ?
 347                                                         root(this[i], first) :
 348                                                         this[i],
 349                                                 i > 0 || results.cacheable || this.length > 1  ?
 350                                                         jQuery(fragment).clone(true)[0] :
 351                                                         fragment
 352                                         );
 353                                 }
 354                         }
 355
 356                         if ( scripts.length ) {
 357                                 jQuery.each( scripts, evalScript );
 358                         }
 359                 }
 360
 361                 return this;
 362         }
 363 });
 364
 365 function root( elem, cur ) {
 366         return jQuery.nodeName(elem, "table") ?
 367                 (elem.getElementsByTagName("tbody")[0] ||
 368                 elem.appendChild(elem.ownerDocument.createElement("tbody"))) :
 369                 elem;
 370 }
 371
 372 function cloneCopyEvent(orig, ret) {
 373         ret.each(function (nodeIndex) {
 374                 if ( this.nodeType !== 1 || !jQuery.hasData(orig[nodeIndex]) ) {
 375                         return;
 376                 }
 377
 378                 // XXX remove for 1.5 RC or merge back in if there is actually a reason for this check that has been
 379                 // unexposed by unit tests
 380                 if ( this.nodeName !== (orig[nodeIndex] && orig[nodeIndex].nodeName) ) {
 381                         throw "Cloned data mismatch";
 382                 }
 383
 384                 var oldData = jQuery.data( orig[nodeIndex] ),
 385                         curData = jQuery.data( this, oldData ),
 386                         events = oldData && oldData.events;
 387
 388                 if ( events ) {
 389                         delete curData.handle;
 390                         curData.events = {};
 391
 392                         for ( var type in events ) {
 393                                 for ( var i = 0, l = events[ type ].length; i < l; i++ ) {
 394                                         jQuery.event.add( this, type, events[ type ][ i ], events[ type ][ i ].data );
 395                                 }
 396                         }
 397                 }
 398         });
 399 }
 400
 401 function cloneFixAttributes(src, dest) {
 402         // We do not need to do anything for non-Elements
 403         if ( dest.nodeType !== 1 ) {
 404                 return;
 405         }
 406
 407         var nodeName = dest.nodeName.toLowerCase();
 408
 409         // clearAttributes removes the attributes, which we don't want,
 410         // but also removes the attachEvent events, which we *do* want
 411         dest.clearAttributes();
 412
 413         // mergeAttributes, in contrast, only merges back on the
 414         // original attributes, not the events
 415         dest.mergeAttributes(src);
 416
 417         // IE6-8 fail to clone children inside object elements that use
 418         // the proprietary classid attribute value (rather than the type
 419         // attribute) to identify the type of content to display
 420         if ( nodeName === "object" ) {
 421                 dest.outerHTML = src.outerHTML;
 422
 423         // IE6-8 fails to persist the checked state of a cloned checkbox
 424         // or radio button
 425         } else if ( nodeName === "input" && src.checked ) {
 426                 dest.defaultChecked = dest.checked = src.checked;
 427
 428         // IE6-8 fails to return the selected option to the default selected
 429         // state when cloning options
 430         } else if ( nodeName === "option" ) {
 431                 dest.selected = src.defaultSelected;
 432         }
 433
 434         // Event data gets referenced instead of copied if the expando
 435         // gets copied too
 436         dest.removeAttribute( jQuery.expando );
 437 }
 438
 439 jQuery.buildFragment = function( args, nodes, scripts ) {
 440         var fragment, cacheable, cacheresults,
 441                 doc = (nodes && nodes[0] ? nodes[0].ownerDocument || nodes[0] : document);
 442
 443         // Only cache "small" (1/2 KB) HTML strings that are associated with the main document
 444         // Cloning options loses the selected state, so don't cache them
 445         // IE 6 doesn't like it when you put <object> or <embed> elements in a fragment
 446         // Also, WebKit does not clone 'checked' attributes on cloneNode, so don't cache
 447         if ( args.length === 1 && typeof args[0] === "string" && args[0].length < 512 && doc === document &&
 448                 args[0].charAt(0) === "<" && !rnocache.test( args[0] ) && (jQuery.support.checkClone || !rchecked.test( args[0] )) ) {
 449
 450                 cacheable = true;
 451                 cacheresults = jQuery.fragments[ args[0] ];
 452                 if ( cacheresults ) {
 453                         if ( cacheresults !== 1 ) {
 454                                 fragment = cacheresults;
 455                         }
 456                 }
 457         }
 458
 459         if ( !fragment ) {
 460                 fragment = doc.createDocumentFragment();
 461                 jQuery.clean( args, doc, fragment, scripts );
 462         }
 463
 464         if ( cacheable ) {
 465                 jQuery.fragments[ args[0] ] = cacheresults ? fragment : 1;
 466         }
 467
 468         return { fragment: fragment, cacheable: cacheable };
 469 };
 470
 471 jQuery.fragments = {};
 472
 473 jQuery.each({
 474         appendTo: "append",
 475         prependTo: "prepend",
 476         insertBefore: "before",
 477         insertAfter: "after",
 478         replaceAll: "replaceWith"
 479 }, function( name, original ) {
 480         jQuery.fn[ name ] = function( selector ) {
 481                 var ret = [],
 482                         insert = jQuery( selector ),
 483                         parent = this.length === 1 && this[0].parentNode;
 484
 485                 if ( parent && parent.nodeType === 11 && parent.childNodes.length === 1 && insert.length === 1 ) {
 486                         insert[ original ]( this[0] );
 487                         return this;
 488
 489                 } else {
 490                         for ( var i = 0, l = insert.length; i < l; i++ ) {
 491                                 var elems = (i > 0 ? this.clone(true) : this).get();
 492                                 jQuery( insert[i] )[ original ]( elems );
 493                                 ret = ret.concat( elems );
 494                         }
 495
 496                         return this.pushStack( ret, name, insert.selector );
 497                 }
 498         };
 499 });
 500
 501 jQuery.extend({
 502         clean: function( elems, context, fragment, scripts ) {
 503                 context = context || document;
 504
 505                 // !context.createElement fails in IE with an error but returns typeof 'object'
 506                 if ( typeof context.createElement === "undefined" ) {
 507                         context = context.ownerDocument || context[0] && context[0].ownerDocument || document;
 508                 }
 509
 510                 var ret = [];
 511
 512                 for ( var i = 0, elem; (elem = elems[i]) != null; i++ ) {
 513                         if ( typeof elem === "number" ) {
 514                                 elem += "";
 515                         }
 516
 517                         if ( !elem ) {
 518                                 continue;
 519                         }
 520
 521                         // Convert html string into DOM nodes
 522                         if ( typeof elem === "string" && !rhtml.test( elem ) ) {
 523                                 elem = context.createTextNode( elem );
 524
 525                         } else if ( typeof elem === "string" ) {
 526                                 // Fix "XHTML"-style tags in all browsers
 527                                 elem = elem.replace(rxhtmlTag, "<$1></$2>");
 528
 529                                 // Trim whitespace, otherwise indexOf won't work as expected
 530                                 var tag = (rtagName.exec( elem ) || ["", ""])[1].toLowerCase(),
 531                                         wrap = wrapMap[ tag ] || wrapMap._default,
 532                                         depth = wrap[0],
 533                                         div = context.createElement("div");
 534
 535                                 // Go to html and back, then peel off extra wrappers
 536                                 div.innerHTML = wrap[1] + elem + wrap[2];
 537
 538                                 // Move to the right depth
 539                                 while ( depth-- ) {
 540                                         div = div.lastChild;
 541                                 }
 542
 543                                 // Remove IE's autoinserted <tbody> from table fragments
 544                                 if ( !jQuery.support.tbody ) {
 545
 546                                         // String was a <table>, *may* have spurious <tbody>
 547                                         var hasBody = rtbody.test(elem),
 548                                                 tbody = tag === "table" && !hasBody ?
 549                                                         div.firstChild && div.firstChild.childNodes :
 550
 551                                                         // String was a bare <thead> or <tfoot>
 552                                                         wrap[1] === "<table>" && !hasBody ?
 553                                                                 div.childNodes :
 554                                                                 [];
 555
 556                                         for ( var j = tbody.length - 1; j >= 0 ; --j ) {
 557                                                 if ( jQuery.nodeName( tbody[ j ], "tbody" ) && !tbody[ j ].childNodes.length ) {
 558                                                         tbody[ j ].parentNode.removeChild( tbody[ j ] );
 559                                                 }
 560                                         }
 561
 562                                 }
 563
 564                                 // IE completely kills leading whitespace when innerHTML is used
 565                                 if ( !jQuery.support.leadingWhitespace && rleadingWhitespace.test( elem ) ) {
 566                                         div.insertBefore( context.createTextNode( rleadingWhitespace.exec(elem)[0] ), div.firstChild );
 567                                 }
 568
 569                                 elem = div.childNodes;
 570                         }
 571
 572                         if ( elem.nodeType ) {
 573                                 ret.push( elem );
 574                         } else {
 575                                 ret = jQuery.merge( ret, elem );
 576                         }
 577                 }
 578
 579                 if ( fragment ) {
 580                         for ( i = 0; ret[i]; i++ ) {
 581                                 if ( scripts && jQuery.nodeName( ret[i], "script" ) && (!ret[i].type || ret[i].type.toLowerCase() === "text/javascript") ) {
 582                                         scripts.push( ret[i].parentNode ? ret[i].parentNode.removeChild( ret[i] ) : ret[i] );
 583
 584                                 } else {
 585                                         if ( ret[i].nodeType === 1 ) {
 586                                                 ret.splice.apply( ret, [i + 1, 0].concat(jQuery.makeArray(ret[i].getElementsByTagName("script"))) );
 587                                         }
 588                                         fragment.appendChild( ret[i] );
 589                                 }
 590                         }
 591                 }
 592
 593                 return ret;
 594         },
 595
 596         cleanData: function( elems ) {
 597                 var data, id, cache = jQuery.cache,
 598                         special = jQuery.event.special,
 599                         deleteExpando = jQuery.support.deleteExpando;
 600
 601                 for ( var i = 0, elem; (elem = elems[i]) != null; i++ ) {
 602                         if ( elem.nodeName && jQuery.noData[elem.nodeName.toLowerCase()] ) {
 603                                 continue;
 604                         }
 605
 606                         id = elem[ jQuery.expando ];
 607
 608                         if ( id ) {
 609                                 data = cache[ id ];
 610
 611                                 if ( data && data.events ) {
 612                                         for ( var type in data.events ) {
 613                                                 if ( special[ type ] ) {
 614                                                         jQuery.event.remove( elem, type );
 615
 616                                                 } else {
 617                                                         jQuery.removeEvent( elem, type, data.handle );
 618                                                 }
 619                                         }
 620                                 }
 621
 622                                 if ( deleteExpando ) {
 623                                         delete elem[ jQuery.expando ];
 624
 625                                 } else if ( elem.removeAttribute ) {
 626                                         elem.removeAttribute( jQuery.expando );
 627                                 }
 628
 629                                 delete cache[ id ];
 630                         }
 631                 }
 632         }
 633 });
 634
 635 function evalScript( i, elem ) {
 636         if ( elem.src ) {
 637                 jQuery.ajax({
 638                         url: elem.src,
 639                         async: false,
 640                         dataType: "script"
 641                 });
 642         } else {
 643                 jQuery.globalEval( elem.text || elem.textContent || elem.innerHTML || "" );
 644         }
 645
 646         if ( elem.parentNode ) {
 647                 elem.parentNode.removeChild( elem );
 648         }
 649 }
 650
 651 })( jQuery );