2dccc759255574810ac6881e4d4c4b25ba6ea079
[jquery.git] / src / manipulation.js
1 var rinlinejQuery = / jQuery\d+="(?:\d+|null)"/g,
2         rleadingWhitespace = /^\s+/,
3         rxhtmlTag = /(<([\w:]+)[^>]*?)\/>/g,
4         rselfClosing = /^(?:area|br|col|embed|hr|img|input|link|meta|param)$/i,
5         rtagName = /<([\w:]+)/,
6         rtbody = /<tbody/i,
7         rhtml = /<|&\w+;/,
8         rnocache = /<script|<object|<embed/i,
9         rchecked = /checked\s*(?:[^=]|=\s*.checked.)/i,  // checked="checked" or checked (html5)
10         fcloseTag = function( all, front, tag ) {
11                 return rselfClosing.test( tag ) ?
12                         all :
13                         front + "></" + tag + ">";
14         },
15         wrapMap = {
16                 option: [ 1, "<select multiple='multiple'>", "</select>" ],
17                 legend: [ 1, "<fieldset>", "</fieldset>" ],
18                 thead: [ 1, "<table>", "</table>" ],
19                 tr: [ 2, "<table><tbody>", "</tbody></table>" ],
20                 td: [ 3, "<table><tbody><tr>", "</tr></tbody></table>" ],
21                 col: [ 2, "<table><tbody></tbody><colgroup>", "</colgroup></table>" ],
22                 area: [ 1, "<map>", "</map>" ],
23                 _default: [ 0, "", "" ]
24         };
25
26 wrapMap.optgroup = wrapMap.option;
27 wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead;
28 wrapMap.th = wrapMap.td;
29
30 // IE can't serialize <link> and <script> tags normally
31 if ( !jQuery.support.htmlSerialize ) {
32         wrapMap._default = [ 1, "div<div>", "</div>" ];
33 }
34
35 jQuery.fn.extend({
36         text: function( text ) {
37                 if ( jQuery.isFunction(text) ) {
38                         return this.each(function(i) {
39                                 var self = jQuery(this);
40                                 self.text( text.call(this, i, self.text()) );
41                         });
42                 }
43
44                 if ( typeof text !== "object" && text !== undefined ) {
45                         return this.empty().append( (this[0] && this[0].ownerDocument || document).createTextNode( text ) );
46                 }
47
48                 return jQuery.getText( this );
49         },
50
51         wrapAll: function( html ) {
52                 if ( jQuery.isFunction( html ) ) {
53                         return this.each(function(i) {
54                                 jQuery(this).wrapAll( html.call(this, i) );
55                         });
56                 }
57
58                 if ( this[0] ) {
59                         // The elements to wrap the target around
60                         var wrap = jQuery( html, this[0].ownerDocument ).eq(0).clone(true);
61
62                         if ( this[0].parentNode ) {
63                                 wrap.insertBefore( this[0] );
64                         }
65
66                         wrap.map(function() {
67                                 var elem = this;
68
69                                 while ( elem.firstChild && elem.firstChild.nodeType === 1 ) {
70                                         elem = elem.firstChild;
71                                 }
72
73                                 return elem;
74                         }).append(this);
75                 }
76
77                 return this;
78         },
79
80         wrapInner: function( html ) {
81                 if ( jQuery.isFunction( html ) ) {
82                         return this.each(function(i) {
83                                 jQuery(this).wrapInner( html.call(this, i) );
84                         });
85                 }
86
87                 return this.each(function() {
88                         var self = jQuery( this ), contents = self.contents();
89
90                         if ( contents.length ) {
91                                 contents.wrapAll( html );
92
93                         } else {
94                                 self.append( html );
95                         }
96                 });
97         },
98
99         wrap: function( html ) {
100                 return this.each(function() {
101                         jQuery( this ).wrapAll( html );
102                 });
103         },
104
105         unwrap: function() {
106                 return this.parent().each(function() {
107                         if ( !jQuery.nodeName( this, "body" ) ) {
108                                 jQuery( this ).replaceWith( this.childNodes );
109                         }
110                 }).end();
111         },
112
113         append: function() {
114                 return this.domManip(arguments, true, function( elem ) {
115                         if ( this.nodeType === 1 ) {
116                                 this.appendChild( elem );
117                         }
118                 });
119         },
120
121         prepend: function() {
122                 return this.domManip(arguments, true, function( elem ) {
123                         if ( this.nodeType === 1 ) {
124                                 this.insertBefore( elem, this.firstChild );
125                         }
126                 });
127         },
128
129         before: function() {
130                 if ( this[0] && this[0].parentNode ) {
131                         return this.domManip(arguments, false, function( elem ) {
132                                 this.parentNode.insertBefore( elem, this );
133                         });
134                 } else if ( arguments.length ) {
135                         var set = jQuery(arguments[0]);
136                         set.push.apply( set, this.toArray() );
137                         return this.pushStack( set, "before", arguments );
138                 }
139         },
140
141         after: function() {
142                 if ( this[0] && this[0].parentNode ) {
143                         return this.domManip(arguments, false, function( elem ) {
144                                 this.parentNode.insertBefore( elem, this.nextSibling );
145                         });
146                 } else if ( arguments.length ) {
147                         var set = this.pushStack( this, "after", arguments );
148                         set.push.apply( set, jQuery(arguments[0]).toArray() );
149                         return set;
150                 }
151         },
152         
153         // keepData is for internal use only--do not document
154         remove: function( selector, keepData ) {
155                 for ( var i = 0, elem; (elem = this[i]) != null; i++ ) {
156                         if ( !selector || jQuery.filter( selector, [ elem ] ).length ) {
157                                 if ( !keepData && elem.nodeType === 1 ) {
158                                         jQuery.cleanData( elem.getElementsByTagName("*") );
159                                         jQuery.cleanData( [ elem ] );
160                                 }
161
162                                 if ( elem.parentNode ) {
163                                          elem.parentNode.removeChild( elem );
164                                 }
165                         }
166                 }
167                 
168                 return this;
169         },
170
171         empty: function() {
172                 for ( var i = 0, elem; (elem = this[i]) != null; i++ ) {
173                         // Remove element nodes and prevent memory leaks
174                         if ( elem.nodeType === 1 ) {
175                                 jQuery.cleanData( elem.getElementsByTagName("*") );
176                         }
177
178                         // Remove any remaining nodes
179                         while ( elem.firstChild ) {
180                                 elem.removeChild( elem.firstChild );
181                         }
182                 }
183                 
184                 return this;
185         },
186
187         clone: function( events ) {
188                 // Do the clone
189                 var ret = this.map(function() {
190                         if ( !jQuery.support.noCloneEvent && !jQuery.isXMLDoc(this) ) {
191                                 // IE copies events bound via attachEvent when
192                                 // using cloneNode. Calling detachEvent on the
193                                 // clone will also remove the events from the orignal
194                                 // In order to get around this, we use innerHTML.
195                                 // Unfortunately, this means some modifications to
196                                 // attributes in IE that are actually only stored
197                                 // as properties will not be copied (such as the
198                                 // the name attribute on an input).
199                                 var html = this.outerHTML, ownerDocument = this.ownerDocument;
200                                 if ( !html || jQuery.nodeName( this, "form" ) ) {
201                                         var div = ownerDocument.createElement("div");
202                                         div.appendChild( this.cloneNode(true) );
203                                         html = div.innerHTML;
204                                 }
205
206                                 return jQuery.clean([html.replace(rinlinejQuery, "")
207                                         // Handle the case in IE 8 where action=/test/> self-closes a tag
208                                         .replace(/=([^="'>\s]+\/)>/g, '="$1">')
209                                         .replace(rleadingWhitespace, "")], ownerDocument)[0];
210                         } else {
211                                 return this.cloneNode(true);
212                         }
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, fcloseTag);
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), old = self.html();
255                                 self.empty().append(function(){
256                                         return value.call( this, i, old );
257                                 });
258                         });
259
260                 } else {
261                         this.empty().append( value );
262                 }
263
264                 return this;
265         },
266
267         replaceWith: function( value ) {
268                 if ( this[0] && this[0].parentNode ) {
269                         // Make sure that the elements are removed from the DOM before they are inserted
270                         // this can help fix replacing a parent with child elements
271                         if ( !jQuery.isFunction( value ) ) {
272                                 value = jQuery( value ).detach();
273
274                         } else {
275                                 return this.each(function(i) {
276                                         var self = jQuery(this), old = self.html();
277                                         self.replaceWith( value.call( this, i, old ) );
278                                 });
279                         }
280
281                         return this.each(function() {
282                                 var next = this.nextSibling, parent = this.parentNode;
283
284                                 jQuery(this).remove();
285
286                                 if ( next ) {
287                                         jQuery(next).before( value );
288                                 } else {
289                                         jQuery(parent).append( value );
290                                 }
291                         });
292                 } else {
293                         return this.pushStack( jQuery(jQuery.isFunction(value) ? value() : value), "replaceWith", value );
294                 }
295         },
296
297         detach: function( selector ) {
298                 return this.remove( selector, true );
299         },
300
301         domManip: function( args, table, callback ) {
302                 var results, first, value = args[0], scripts = [], fragment;
303
304                 // We can't cloneNode fragments that contain checked, in WebKit
305                 if ( !jQuery.support.checkClone && arguments.length === 3 && typeof value === "string" && rchecked.test( value ) ) {
306                         return this.each(function() {
307                                 jQuery(this).domManip( args, table, callback, true );
308                         });
309                 }
310
311                 if ( jQuery.isFunction(value) ) {
312                         return this.each(function(i) {
313                                 var self = jQuery(this);
314                                 args[0] = value.call(this, i, table ? self.html() : undefined);
315                                 self.domManip( args, table, callback );
316                         });
317                 }
318
319                 if ( this[0] ) {
320                         // If we're in a fragment, just use that instead of building a new one
321                         if ( args[0] && args[0].parentNode && args[0].parentNode.nodeType === 11 ) {
322                                 results = { fragment: args[0].parentNode };
323                         } else {
324                                 results = buildFragment( args, this, scripts );
325                         }
326                         
327                         fragment = results.fragment;
328                         
329                         if ( fragment.childNodes.length === 1 ) {
330                                 first = fragment = fragment.firstChild;
331                         } else {
332                                 first = fragment.firstChild;
333                         }
334
335                         if ( first ) {
336                                 table = table && jQuery.nodeName( first, "tr" );
337
338                                 for ( var i = 0, l = this.length; i < l; i++ ) {
339                                         callback.call(
340                                                 table ?
341                                                         root(this[i], first) :
342                                                         this[i],
343                                                 i > 0 || results.cacheable || this.length > 1  ?
344                                                         fragment.cloneNode(true) :
345                                                         fragment
346                                         );
347                                 }
348                         }
349
350                         if ( scripts.length ) {
351                                 jQuery.each( scripts, evalScript );
352                         }
353                 }
354
355                 return this;
356
357                 function root( elem, cur ) {
358                         return jQuery.nodeName(elem, "table") ?
359                                 (elem.getElementsByTagName("tbody")[0] ||
360                                 elem.appendChild(elem.ownerDocument.createElement("tbody"))) :
361                                 elem;
362                 }
363         }
364 });
365
366 function cloneCopyEvent(orig, ret) {
367         var i = 0;
368
369         ret.each(function() {
370                 if ( this.nodeName !== (orig[i] && orig[i].nodeName) ) {
371                         return;
372                 }
373
374                 var oldData = jQuery.data( orig[i++] ), curData = jQuery.data( this, oldData ), events = oldData && oldData.events;
375
376                 if ( events ) {
377                         delete curData.handle;
378                         curData.events = {};
379
380                         for ( var type in events ) {
381                                 for ( var handler in events[ type ] ) {
382                                         jQuery.event.add( this, type, events[ type ][ handler ], events[ type ][ handler ].data );
383                                 }
384                         }
385                 }
386         });
387 }
388
389 function buildFragment( args, nodes, scripts ) {
390         var fragment, cacheable, cacheresults,
391                 doc = (nodes && nodes[0] ? nodes[0].ownerDocument || nodes[0] : document);
392
393         // Only cache "small" (1/2 KB) strings that are associated with the main document
394         // Cloning options loses the selected state, so don't cache them
395         // IE 6 doesn't like it when you put <object> or <embed> elements in a fragment
396         // Also, WebKit does not clone 'checked' attributes on cloneNode, so don't cache
397         if ( args.length === 1 && typeof args[0] === "string" && args[0].length < 512 && doc === document &&
398                 !rnocache.test( args[0] ) && (jQuery.support.checkClone || !rchecked.test( args[0] )) ) {
399
400                 cacheable = true;
401                 cacheresults = jQuery.fragments[ args[0] ];
402                 if ( cacheresults ) {
403                         if ( cacheresults !== 1 ) {
404                                 fragment = cacheresults;
405                         }
406                 }
407         }
408
409         if ( !fragment ) {
410                 fragment = doc.createDocumentFragment();
411                 jQuery.clean( args, doc, fragment, scripts );
412         }
413
414         if ( cacheable ) {
415                 jQuery.fragments[ args[0] ] = cacheresults ? fragment : 1;
416         }
417
418         return { fragment: fragment, cacheable: cacheable };
419 }
420
421 jQuery.fragments = {};
422
423 jQuery.each({
424         appendTo: "append",
425         prependTo: "prepend",
426         insertBefore: "before",
427         insertAfter: "after",
428         replaceAll: "replaceWith"
429 }, function( name, original ) {
430         jQuery.fn[ name ] = function( selector ) {
431                 var ret = [], insert = jQuery( selector );
432                 
433                 if ( this.length === 1 && this[0].parentNode && this[0].parentNode.nodeType === 11 && insert.length === 1 ) {
434                         insert[ original ]( this[0] );
435                         return this;
436                         
437                 } else {
438                         for ( var i = 0, l = insert.length; i < l; i++ ) {
439                                 var elems = (i > 0 ? this.clone(true) : this).get();
440                                 jQuery.fn[ original ].apply( jQuery(insert[i]), elems );
441                                 ret = ret.concat( elems );
442                         }
443                 
444                         return this.pushStack( ret, name, insert.selector );
445                 }
446         };
447 });
448
449 jQuery.extend({
450         clean: function( elems, context, fragment, scripts ) {
451                 context = context || document;
452
453                 // !context.createElement fails in IE with an error but returns typeof 'object'
454                 if ( typeof context.createElement === "undefined" ) {
455                         context = context.ownerDocument || context[0] && context[0].ownerDocument || document;
456                 }
457
458                 var ret = [];
459
460                 for ( var i = 0, elem; (elem = elems[i]) != null; i++ ) {
461                         if ( typeof elem === "number" ) {
462                                 elem += "";
463                         }
464
465                         if ( !elem ) {
466                                 continue;
467                         }
468
469                         // Convert html string into DOM nodes
470                         if ( typeof elem === "string" && !rhtml.test( elem ) ) {
471                                 elem = context.createTextNode( elem );
472
473                         } else if ( typeof elem === "string" ) {
474                                 // Fix "XHTML"-style tags in all browsers
475                                 elem = elem.replace(rxhtmlTag, fcloseTag);
476
477                                 // Trim whitespace, otherwise indexOf won't work as expected
478                                 var tag = (rtagName.exec( elem ) || ["", ""])[1].toLowerCase(),
479                                         wrap = wrapMap[ tag ] || wrapMap._default,
480                                         depth = wrap[0],
481                                         div = context.createElement("div");
482
483                                 // Go to html and back, then peel off extra wrappers
484                                 div.innerHTML = wrap[1] + elem + wrap[2];
485
486                                 // Move to the right depth
487                                 while ( depth-- ) {
488                                         div = div.lastChild;
489                                 }
490
491                                 // Remove IE's autoinserted <tbody> from table fragments
492                                 if ( !jQuery.support.tbody ) {
493
494                                         // String was a <table>, *may* have spurious <tbody>
495                                         var hasBody = rtbody.test(elem),
496                                                 tbody = tag === "table" && !hasBody ?
497                                                         div.firstChild && div.firstChild.childNodes :
498
499                                                         // String was a bare <thead> or <tfoot>
500                                                         wrap[1] === "<table>" && !hasBody ?
501                                                                 div.childNodes :
502                                                                 [];
503
504                                         for ( var j = tbody.length - 1; j >= 0 ; --j ) {
505                                                 if ( jQuery.nodeName( tbody[ j ], "tbody" ) && !tbody[ j ].childNodes.length ) {
506                                                         tbody[ j ].parentNode.removeChild( tbody[ j ] );
507                                                 }
508                                         }
509
510                                 }
511
512                                 // IE completely kills leading whitespace when innerHTML is used
513                                 if ( !jQuery.support.leadingWhitespace && rleadingWhitespace.test( elem ) ) {
514                                         div.insertBefore( context.createTextNode( rleadingWhitespace.exec(elem)[0] ), div.firstChild );
515                                 }
516
517                                 elem = div.childNodes;
518                         }
519
520                         if ( elem.nodeType ) {
521                                 ret.push( elem );
522                         } else {
523                                 ret = jQuery.merge( ret, elem );
524                         }
525                 }
526
527                 if ( fragment ) {
528                         for ( var i = 0; ret[i]; i++ ) {
529                                 if ( scripts && jQuery.nodeName( ret[i], "script" ) && (!ret[i].type || ret[i].type.toLowerCase() === "text/javascript") ) {
530                                         scripts.push( ret[i].parentNode ? ret[i].parentNode.removeChild( ret[i] ) : ret[i] );
531                                 
532                                 } else {
533                                         if ( ret[i].nodeType === 1 ) {
534                                                 ret.splice.apply( ret, [i + 1, 0].concat(jQuery.makeArray(ret[i].getElementsByTagName("script"))) );
535                                         }
536                                         fragment.appendChild( ret[i] );
537                                 }
538                         }
539                 }
540
541                 return ret;
542         },
543         
544         cleanData: function( elems ) {
545                 var data, id, cache = jQuery.cache;
546                 
547                 for ( var i = 0, elem; (elem = elems[i]) != null; i++ ) {
548                         id = elem[ jQuery.expando ];
549                         
550                         if ( id ) {
551                                 data = cache[ id ];
552                                 
553                                 if ( data.events ) {
554                                         for ( var event in data.events ) {
555                                                 removeEvent( elem, event, data.handle );
556                                         }
557                                 }
558                                 
559                                 removeExpando( elem );
560                                 
561                                 delete cache[ id ];
562                         }
563                 }
564         }
565 });