src/manipulation.js

   1 var rinlinejQuery = / jQuery\d+="(?:\d+|null)"/g,
   2         rleadingWhitespace = /^\s+/,
   3         rxhtmlTag = /(<([\w:]+)[^>]*?)\/>/g,
   4         rselfClosing = /^(?:abbr|br|col|img|input|link|meta|param|hr|area|embed)$/i,
   5         rtagName = /<([\w:]+)/,
   6         rtbody = /<tbody/i,
   7         rhtml = /<|&\w+;/,
   8         fcloseTag = function(all, front, tag){
   9                 return rselfClosing.test(tag) ?
  10                         all :
  11                         front + "></" + tag + ">";
  12         },
  13         wrapMap = {
  14                 option: [ 1, "<select multiple='multiple'>", "</select>" ],
  15                 legend: [ 1, "<fieldset>", "</fieldset>" ],
  16                 thead: [ 1, "<table>", "</table>" ],
  17                 tr: [ 2, "<table><tbody>", "</tbody></table>" ],
  18                 td: [ 3, "<table><tbody><tr>", "</tr></tbody></table>" ],
  19                 col: [ 2, "<table><tbody></tbody><colgroup>", "</colgroup></table>" ],
  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 ( typeof text !== "object" && text !== undefined ) {
  35                         return this.empty().append( (this[0] && this[0].ownerDocument || document).createTextNode( text ) );
  36                 }
  37
  38                 var ret = "";
  39
  40                 jQuery.each( this, function() {
  41                         // Get the text from text nodes and CDATA nodes
  42                         if ( this.nodeType === 3 || this.nodeType === 4 ) {
  43                                 ret += this.nodeValue;
  44
  45                         // Traverse everything else, except comment nodes
  46                         } else if ( this.nodeType !== 8 ) {
  47                                 ret += jQuery.fn.text.call( this.childNodes );
  48                         }
  49                 });
  50
  51                 return ret;
  52         },
  53
  54         wrapAll: function( html ) {
  55                 if ( jQuery.isFunction( html ) ) {
  56                         return this.each(function() {
  57                                 jQuery(this).wrapAll( html.apply(this, arguments) );
  58                         });
  59                 }
  60
  61                 if ( this[0] ) {
  62                         // The elements to wrap the target around
  63                         var wrap = jQuery( html, this[0].ownerDocument ).eq(0).clone();
  64
  65                         if ( this[0].parentNode ) {
  66                                 wrap.insertBefore( this[0] );
  67                         }
  68
  69                         wrap.map(function(){
  70                                 var elem = this;
  71
  72                                 while ( elem.firstChild && elem.firstChild.nodeType === 1 ) {
  73                                         elem = elem.firstChild;
  74                                 }
  75
  76                                 return elem;
  77                         }).append(this);
  78                 }
  79
  80                 return this;
  81         },
  82
  83         wrapInner: function( html ) {
  84                 return this.each(function(){
  85                         jQuery( this ).contents().wrapAll( html );
  86                 });
  87         },
  88
  89         wrap: function( html ) {
  90                 return this.each(function(){
  91                         jQuery( this ).wrapAll( html );
  92                 });
  93         },
  94
  95         unwrap: function() {
  96                 return this.parent().each(function(){
  97                         if ( !jQuery.nodeName( this, "body" ) ) {
  98                                 jQuery( this ).replaceWith( this.childNodes );
  99                         }
 100                 }).end();
 101         },
 102
 103         append: function() {
 104                 return this.domManip(arguments, true, function(elem){
 105                         if ( this.nodeType === 1 ) {
 106                                 this.appendChild( elem );
 107                         }
 108                 });
 109         },
 110
 111         prepend: function() {
 112                 return this.domManip(arguments, true, function(elem){
 113                         if ( this.nodeType === 1 ) {
 114                                 this.insertBefore( elem, this.firstChild );
 115                         }
 116                 });
 117         },
 118
 119         before: function() {
 120                 if ( this[0] && this[0].parentNode ) {
 121                         return this.domManip(arguments, false, function(elem){
 122                                 this.parentNode.insertBefore( elem, this );
 123                         });
 124                 } else if ( arguments.length ) {
 125                         var set = jQuery(arguments[0]);
 126                         set.push.apply( set, this.toArray() );
 127                         return this.pushStack( set, "before", arguments );
 128                 }
 129         },
 130
 131         after: function() {
 132                 if ( this[0] && this[0].parentNode ) {
 133                         return this.domManip(arguments, false, function(elem){
 134                                 this.parentNode.insertBefore( elem, this.nextSibling );
 135                         });
 136                 } else if ( arguments.length ) {
 137                         var set = this.pushStack( this, "after", arguments );
 138                         set.push.apply( set, jQuery(arguments[0]).toArray() );
 139                         return set;
 140                 }
 141         },
 142
 143         clone: function( events ) {
 144                 // Do the clone
 145                 var ret = this.map(function(){
 146                         if ( !jQuery.support.noCloneEvent && !jQuery.isXMLDoc(this) ) {
 147                                 // IE copies events bound via attachEvent when
 148                                 // using cloneNode. Calling detachEvent on the
 149                                 // clone will also remove the events from the orignal
 150                                 // In order to get around this, we use innerHTML.
 151                                 // Unfortunately, this means some modifications to
 152                                 // attributes in IE that are actually only stored
 153                                 // as properties will not be copied (such as the
 154                                 // the name attribute on an input).
 155                                 var html = this.outerHTML, ownerDocument = this.ownerDocument;
 156                                 if ( !html ) {
 157                                         var div = ownerDocument.createElement("div");
 158                                         div.appendChild( this.cloneNode(true) );
 159                                         html = div.innerHTML;
 160                                 }
 161
 162                                 return jQuery.clean([html.replace(rinlinejQuery, "")
 163                                         .replace(rleadingWhitespace, "")], ownerDocument)[0];
 164                         } else {
 165                                 return this.cloneNode(true);
 166                         }
 167                 });
 168
 169                 // Copy the events from the original to the clone
 170                 if ( events === true ) {
 171                         cloneCopyEvent( this, ret );
 172                         cloneCopyEvent( this.find("*"), ret.find("*") );
 173                 }
 174
 175                 // Return the cloned set
 176                 return ret;
 177         },
 178
 179         html: function( value ) {
 180                 if ( value === undefined ) {
 181                         return this[0] ?
 182                                 this[0].innerHTML.replace(rinlinejQuery, "") :
 183                                 null;
 184
 185                 // See if we can take a shortcut and just use innerHTML
 186                 } else if ( typeof value === "string" && !/<script/i.test( value ) &&
 187                         (jQuery.support.leadingWhitespace || !rleadingWhitespace.test( value )) &&
 188                         !wrapMap[ (rtagName.exec( value ) || ["", ""])[1].toLowerCase() ] ) {
 189
 190                         try {
 191                                 for ( var i = 0, l = this.length; i < l; i++ ) {
 192                                         // Remove element nodes and prevent memory leaks
 193                                         if ( this[i].nodeType === 1 ) {
 194                                                 cleanData( this[i].getElementsByTagName("*") );
 195                                                 this[i].innerHTML = value;
 196                                         }
 197                                 }
 198
 199                         // If using innerHTML throws an exception, use the fallback method
 200                         } catch(e) {
 201                                 this.empty().append( value );
 202                         }
 203
 204                 } else {
 205                         this.empty().append( value );
 206                 }
 207
 208                 return this;
 209         },
 210
 211         replaceWith: function( value ) {
 212                 if ( this[0] && this[0].parentNode ) {
 213                         return this.each(function(){
 214                                 var next = this.nextSibling, parent = this.parentNode;
 215
 216                                 jQuery(this).remove();
 217
 218                                 if ( next ) {
 219                                         jQuery(next).before( value );
 220                                 } else {
 221                                         jQuery(parent).append( value );
 222                                 }
 223                         });
 224                 } else {
 225                         return this.pushStack( jQuery(jQuery.isFunction(value) ? value() : value), "replaceWith", value );
 226                 }
 227         },
 228
 229         detach: function( selector ) {
 230                 return this.remove( selector, true );
 231         },
 232
 233         domManip: function( args, table, callback ) {
 234                 var results, first, value = args[0], scripts = [];
 235
 236                 if ( jQuery.isFunction(value) ) {
 237                         return this.each(function() {
 238                                 args[0] = value.call(this);
 239                                 return jQuery(this).domManip( args, table, callback );
 240                         });
 241                 }
 242
 243                 if ( this[0] ) {
 244                         // If we're in a fragment, just use that instead of building a new one
 245                         if ( args[0] && args[0].parentNode && args[0].parentNode.nodeType === 11 ) {
 246                                 results = { fragment: args[0].parentNode };
 247                         } else {
 248                                 results = buildFragment( args, this, scripts );
 249                         }
 250
 251                         first = results.fragment.firstChild;
 252
 253                         if ( first ) {
 254                                 table = table && jQuery.nodeName( first, "tr" );
 255
 256                                 for ( var i = 0, l = this.length; i < l; i++ ) {
 257                                         callback.call(
 258                                                 table ?
 259                                                         root(this[i], first) :
 260                                                         this[i],
 261                                                 results.cacheable || this.length > 1 || i > 0 ?
 262                                                         results.fragment.cloneNode(true) :
 263                                                         results.fragment
 264                                         );
 265                                 }
 266                         }
 267
 268                         if ( scripts ) {
 269                                 jQuery.each( scripts, evalScript );
 270                         }
 271                 }
 272
 273                 return this;
 274
 275                 function root( elem, cur ) {
 276                         return jQuery.nodeName(elem, "table") ?
 277                                 (elem.getElementsByTagName("tbody")[0] ||
 278                                 elem.appendChild(elem.ownerDocument.createElement("tbody"))) :
 279                                 elem;
 280                 }
 281         }
 282 });
 283
 284 function cloneCopyEvent(orig, ret) {
 285         var i = 0;
 286
 287         ret.each(function(){
 288                 if ( this.nodeName !== orig[i].nodeName ) {
 289                         return;
 290                 }
 291
 292                 var events = jQuery.data( orig[i], "events" );
 293
 294                 for ( var type in events ) {
 295                         for ( var handler in events[ type ] ) {
 296                                 jQuery.event.add( this, type, events[ type ][ handler ], events[ type ][ handler ].data );
 297                         }
 298                 }
 299         });
 300 }
 301
 302 function buildFragment(args, nodes, scripts){
 303         var fragment, cacheable, cached, cacheresults, doc;
 304
 305         if ( args.length === 1 && typeof args[0] === "string" && args[0].length < 512 && args[0].indexOf("<option") < 0 ) {
 306                 cacheable = true;
 307                 cacheresults = jQuery.fragments[ args[0] ];
 308                 if ( cacheresults ) {
 309                         if ( cacheresults !== 1 ) {
 310                                 fragment = cacheresults;
 311                         }
 312                         cached = true;
 313                 }
 314         }
 315
 316         if ( !fragment ) {
 317                 doc = (nodes && nodes[0] ? nodes[0].ownerDocument || nodes[0] : document);
 318                 fragment = doc.createDocumentFragment();
 319                 jQuery.clean( args, doc, fragment, scripts );
 320         }
 321
 322         if ( cacheable ) {
 323                 jQuery.fragments[ args[0] ] = cacheresults ? fragment : 1;
 324         }
 325
 326         return { fragment: fragment, cacheable: cacheable };
 327 }
 328
 329 jQuery.fragments = {};
 330
 331 jQuery.each({
 332         appendTo: "append",
 333         prependTo: "prepend",
 334         insertBefore: "before",
 335         insertAfter: "after",
 336         replaceAll: "replaceWith"
 337 }, function(name, original){
 338         jQuery.fn[ name ] = function( selector ) {
 339                 var ret = [], insert = jQuery( selector );
 340
 341                 for ( var i = 0, l = insert.length; i < l; i++ ) {
 342                         var elems = (i > 0 ? this.clone(true) : this).get();
 343                         jQuery.fn[ original ].apply( jQuery(insert[i]), elems );
 344                         ret = ret.concat( elems );
 345                 }
 346                 return this.pushStack( ret, name, insert.selector );
 347         };
 348 });
 349
 350 jQuery.each({
 351         // keepData is for internal use only--do not document
 352         remove: function( selector, keepData ) {
 353                 if ( !selector || jQuery.filter( selector, [ this ] ).length ) {
 354                         if ( !keepData && this.nodeType === 1 ) {
 355                                 cleanData( this.getElementsByTagName("*") );
 356                                 cleanData( [ this ] );
 357                         }
 358
 359                         if ( this.parentNode ) {
 360                                  this.parentNode.removeChild( this );
 361                         }
 362                 }
 363         },
 364
 365         empty: function() {
 366                 // Remove element nodes and prevent memory leaks
 367                 if ( this.nodeType === 1 ) {
 368                         cleanData( this.getElementsByTagName("*") );
 369                 }
 370
 371                 // Remove any remaining nodes
 372                 while ( this.firstChild ) {
 373                         this.removeChild( this.firstChild );
 374                 }
 375         }
 376 }, function(name, fn){
 377         jQuery.fn[ name ] = function(){
 378                 return this.each( fn, arguments );
 379         };
 380 });
 381
 382 jQuery.extend({
 383         clean: function( elems, context, fragment, scripts ) {
 384                 context = context || document;
 385
 386                 // !context.createElement fails in IE with an error but returns typeof 'object'
 387                 if ( typeof context.createElement === "undefined" ) {
 388                         context = context.ownerDocument || context[0] && context[0].ownerDocument || document;
 389                 }
 390
 391                 var ret = [], div = context.createElement("div");
 392
 393                 jQuery.each(elems, function(i, elem){
 394                         if ( typeof elem === "number" ) {
 395                                 elem += '';
 396                         }
 397
 398                         if ( !elem ) { return; }
 399
 400                         // Convert html string into DOM nodes
 401                         if ( typeof elem === "string" && !rhtml.test( elem ) ) {
 402                                 elem = context.createTextNode( elem );
 403
 404                         } else if ( typeof elem === "string" ) {
 405                                 // Fix "XHTML"-style tags in all browsers
 406                                 elem = elem.replace(rxhtmlTag, fcloseTag);
 407
 408                                 // Trim whitespace, otherwise indexOf won't work as expected
 409                                 var tag = (rtagName.exec( elem ) || ["", ""])[1].toLowerCase(),
 410                                         wrap = wrapMap[ tag ] || wrapMap._default,
 411                                         depth = wrap[0];
 412
 413                                 // Go to html and back, then peel off extra wrappers
 414                                 div.innerHTML = wrap[1] + elem + wrap[2];
 415
 416                                 // Move to the right depth
 417                                 while ( depth-- ) {
 418                                         div = div.lastChild;
 419                                 }
 420
 421                                 // Remove IE's autoinserted <tbody> from table fragments
 422                                 if ( !jQuery.support.tbody ) {
 423
 424                                         // String was a <table>, *may* have spurious <tbody>
 425                                         var hasBody = rtbody.test(elem),
 426                                                 tbody = tag === "table" && !hasBody ?
 427                                                         div.firstChild && div.firstChild.childNodes :
 428
 429                                                         // String was a bare <thead> or <tfoot>
 430                                                         wrap[1] == "<table>" && !hasBody ?
 431                                                                 div.childNodes :
 432                                                                 [];
 433
 434                                         for ( var j = tbody.length - 1; j >= 0 ; --j ) {
 435                                                 if ( jQuery.nodeName( tbody[ j ], "tbody" ) && !tbody[ j ].childNodes.length ) {
 436                                                         tbody[ j ].parentNode.removeChild( tbody[ j ] );
 437                                                 }
 438                                         }
 439
 440                                 }
 441
 442                                 // IE completely kills leading whitespace when innerHTML is used
 443                                 if ( !jQuery.support.leadingWhitespace && rleadingWhitespace.test( elem ) ) {
 444                                         div.insertBefore( context.createTextNode( rleadingWhitespace.exec(elem)[0] ), div.firstChild );
 445                                 }
 446
 447                                 elem = jQuery.makeArray( div.childNodes );
 448                         }
 449
 450                         if ( elem.nodeType ) {
 451                                 ret.push( elem );
 452                         } else {
 453                                 ret = jQuery.merge( ret, elem );
 454                         }
 455
 456                 });
 457
 458                 if ( fragment ) {
 459                         for ( var i = 0; ret[i]; i++ ) {
 460                                 if ( scripts && jQuery.nodeName( ret[i], "script" ) && (!ret[i].type || ret[i].type.toLowerCase() === "text/javascript") ) {
 461                                         scripts.push( ret[i].parentNode ? ret[i].parentNode.removeChild( ret[i] ) : ret[i] );
 462                                 } else {
 463                                         if ( ret[i].nodeType === 1 ) {
 464                                                 ret.splice.apply( ret, [i + 1, 0].concat(jQuery.makeArray(ret[i].getElementsByTagName("script"))) );
 465                                         }
 466                                         fragment.appendChild( ret[i] );
 467                                 }
 468                         }
 469                 }
 470
 471                 return ret;
 472         }
 473 });
 474
 475 function cleanData( elems ) {
 476         for ( var i = 0, elem, id; (elem = elems[i]) != null; i++ ) {
 477                 if ( (id = elem[expando]) ) {
 478                         delete jQuery.cache[ id ];
 479                 }
 480         }
 481 }