6f0373daa224c0df88c7c7c1baac71fd892a459f
[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                                 return this.each(function(i) {
273                                         var self = jQuery(this), old = self.html();
274                                         self.replaceWith( value.call( this, i, old ) );
275                                 });
276                         }
277
278                         if ( typeof value !== "string" ) {
279                                 value = jQuery(value).detach();
280                         }
281
282                         return this.each(function() {
283                                 var next = this.nextSibling, 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, value = args[0], scripts = [], fragment;
304
305                 // We can't cloneNode fragments that contain checked, in WebKit
306                 if ( !jQuery.support.checkClone && arguments.length === 3 && typeof value === "string" && rchecked.test( value ) ) {
307                         return this.each(function() {
308                                 jQuery(this).domManip( args, table, callback, true );
309                         });
310                 }
311
312                 if ( jQuery.isFunction(value) ) {
313                         return this.each(function(i) {
314                                 var self = jQuery(this);
315                                 args[0] = value.call(this, i, table ? self.html() : undefined);
316                                 self.domManip( args, table, callback );
317                         });
318                 }
319
320                 if ( this[0] ) {
321                         // If we're in a fragment, just use that instead of building a new one
322                         if ( args[0] && args[0].parentNode && args[0].parentNode.nodeType === 11 ) {
323                                 results = { fragment: args[0].parentNode };
324                         } else {
325                                 results = buildFragment( args, this, scripts );
326                         }
327                         
328                         fragment = results.fragment;
329                         
330                         if ( fragment.childNodes.length === 1 ) {
331                                 first = fragment = fragment.firstChild;
332                         } else {
333                                 first = fragment.firstChild;
334                         }
335
336                         if ( first ) {
337                                 table = table && jQuery.nodeName( first, "tr" );
338
339                                 for ( var i = 0, l = this.length; i < l; i++ ) {
340                                         callback.call(
341                                                 table ?
342                                                         root(this[i], first) :
343                                                         this[i],
344                                                 i > 0 || results.cacheable || this.length > 1  ?
345                                                         fragment.cloneNode(true) :
346                                                         fragment
347                                         );
348                                 }
349                         }
350
351                         if ( scripts.length ) {
352                                 jQuery.each( scripts, evalScript );
353                         }
354                 }
355
356                 return this;
357
358                 function root( elem, cur ) {
359                         return jQuery.nodeName(elem, "table") ?
360                                 (elem.getElementsByTagName("tbody")[0] ||
361                                 elem.appendChild(elem.ownerDocument.createElement("tbody"))) :
362                                 elem;
363                 }
364         }
365 });
366
367 function cloneCopyEvent(orig, ret) {
368         var i = 0;
369
370         ret.each(function() {
371                 if ( this.nodeName !== (orig[i] && orig[i].nodeName) ) {
372                         return;
373                 }
374
375                 var oldData = jQuery.data( orig[i++] ), curData = jQuery.data( this, oldData ), events = oldData && oldData.events;
376
377                 if ( events ) {
378                         delete curData.handle;
379                         curData.events = {};
380
381                         for ( var type in events ) {
382                                 for ( var handler in events[ type ] ) {
383                                         jQuery.event.add( this, type, events[ type ][ handler ], events[ type ][ handler ].data );
384                                 }
385                         }
386                 }
387         });
388 }
389
390 function buildFragment( args, nodes, scripts ) {
391         var fragment, cacheable, cacheresults,
392                 doc = (nodes && nodes[0] ? nodes[0].ownerDocument || nodes[0] : document);
393
394         // Only cache "small" (1/2 KB) strings that are associated with the main document
395         // Cloning options loses the selected state, so don't cache them
396         // IE 6 doesn't like it when you put <object> or <embed> elements in a fragment
397         // Also, WebKit does not clone 'checked' attributes on cloneNode, so don't cache
398         if ( args.length === 1 && typeof args[0] === "string" && args[0].length < 512 && doc === document &&
399                 !rnocache.test( args[0] ) && (jQuery.support.checkClone || !rchecked.test( args[0] )) ) {
400
401                 cacheable = true;
402                 cacheresults = jQuery.fragments[ args[0] ];
403                 if ( cacheresults ) {
404                         if ( cacheresults !== 1 ) {
405                                 fragment = cacheresults;
406                         }
407                 }
408         }
409
410         if ( !fragment ) {
411                 fragment = doc.createDocumentFragment();
412                 jQuery.clean( args, doc, fragment, scripts );
413         }
414
415         if ( cacheable ) {
416                 jQuery.fragments[ args[0] ] = cacheresults ? fragment : 1;
417         }
418
419         return { fragment: fragment, cacheable: cacheable };
420 }
421
422 jQuery.fragments = {};
423
424 jQuery.each({
425         appendTo: "append",
426         prependTo: "prepend",
427         insertBefore: "before",
428         insertAfter: "after",
429         replaceAll: "replaceWith"
430 }, function( name, original ) {
431         jQuery.fn[ name ] = function( selector ) {
432                 var ret = [], insert = jQuery( selector );
433                 
434                 if ( this.length === 1 && this[0].parentNode && this[0].parentNode.nodeType === 11 && insert.length === 1 ) {
435                         insert[ original ]( this[0] );
436                         return this;
437                         
438                 } else {
439                         for ( var i = 0, l = insert.length; i < l; i++ ) {
440                                 var elems = (i > 0 ? this.clone(true) : this).get();
441                                 jQuery.fn[ original ].apply( jQuery(insert[i]), elems );
442                                 ret = ret.concat( elems );
443                         }
444                 
445                         return this.pushStack( ret, name, insert.selector );
446                 }
447         };
448 });
449
450 jQuery.extend({
451         clean: function( elems, context, fragment, scripts ) {
452                 context = context || document;
453
454                 // !context.createElement fails in IE with an error but returns typeof 'object'
455                 if ( typeof context.createElement === "undefined" ) {
456                         context = context.ownerDocument || context[0] && context[0].ownerDocument || document;
457                 }
458
459                 var ret = [];
460
461                 for ( var i = 0, elem; (elem = elems[i]) != null; i++ ) {
462                         if ( typeof elem === "number" ) {
463                                 elem += "";
464                         }
465
466                         if ( !elem ) {
467                                 continue;
468                         }
469
470                         // Convert html string into DOM nodes
471                         if ( typeof elem === "string" && !rhtml.test( elem ) ) {
472                                 elem = context.createTextNode( elem );
473
474                         } else if ( typeof elem === "string" ) {
475                                 // Fix "XHTML"-style tags in all browsers
476                                 elem = elem.replace(rxhtmlTag, fcloseTag);
477
478                                 // Trim whitespace, otherwise indexOf won't work as expected
479                                 var tag = (rtagName.exec( elem ) || ["", ""])[1].toLowerCase(),
480                                         wrap = wrapMap[ tag ] || wrapMap._default,
481                                         depth = wrap[0],
482                                         div = context.createElement("div");
483
484                                 // Go to html and back, then peel off extra wrappers
485                                 div.innerHTML = wrap[1] + elem + wrap[2];
486
487                                 // Move to the right depth
488                                 while ( depth-- ) {
489                                         div = div.lastChild;
490                                 }
491
492                                 // Remove IE's autoinserted <tbody> from table fragments
493                                 if ( !jQuery.support.tbody ) {
494
495                                         // String was a <table>, *may* have spurious <tbody>
496                                         var hasBody = rtbody.test(elem),
497                                                 tbody = tag === "table" && !hasBody ?
498                                                         div.firstChild && div.firstChild.childNodes :
499
500                                                         // String was a bare <thead> or <tfoot>
501                                                         wrap[1] === "<table>" && !hasBody ?
502                                                                 div.childNodes :
503                                                                 [];
504
505                                         for ( var j = tbody.length - 1; j >= 0 ; --j ) {
506                                                 if ( jQuery.nodeName( tbody[ j ], "tbody" ) && !tbody[ j ].childNodes.length ) {
507                                                         tbody[ j ].parentNode.removeChild( tbody[ j ] );
508                                                 }
509                                         }
510
511                                 }
512
513                                 // IE completely kills leading whitespace when innerHTML is used
514                                 if ( !jQuery.support.leadingWhitespace && rleadingWhitespace.test( elem ) ) {
515                                         div.insertBefore( context.createTextNode( rleadingWhitespace.exec(elem)[0] ), div.firstChild );
516                                 }
517
518                                 elem = div.childNodes;
519                         }
520
521                         if ( elem.nodeType ) {
522                                 ret.push( elem );
523                         } else {
524                                 ret = jQuery.merge( ret, elem );
525                         }
526                 }
527
528                 if ( fragment ) {
529                         for ( var i = 0; ret[i]; i++ ) {
530                                 if ( scripts && jQuery.nodeName( ret[i], "script" ) && (!ret[i].type || ret[i].type.toLowerCase() === "text/javascript") ) {
531                                         scripts.push( ret[i].parentNode ? ret[i].parentNode.removeChild( ret[i] ) : ret[i] );
532                                 
533                                 } else {
534                                         if ( ret[i].nodeType === 1 ) {
535                                                 ret.splice.apply( ret, [i + 1, 0].concat(jQuery.makeArray(ret[i].getElementsByTagName("script"))) );
536                                         }
537                                         fragment.appendChild( ret[i] );
538                                 }
539                         }
540                 }
541
542                 return ret;
543         },
544         
545         cleanData: function( elems ) {
546                 var data, id, cache = jQuery.cache;
547                 
548                 for ( var i = 0, elem; (elem = elems[i]) != null; i++ ) {
549                         id = elem[ jQuery.expando ];
550                         
551                         if ( id ) {
552                                 data = cache[ id ];
553                                 
554                                 if ( data.events ) {
555                                         for ( var event in data.events ) {
556                                                 removeEvent( elem, event, data.handle );
557                                         }
558                                 }
559                                 
560                                 removeExpando( elem );
561                                 
562                                 delete cache[ id ];
563                         }
564                 }
565         }
566 });