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