jquery/jquery.js

   1 /*
   2  * jQuery - New Wave Javascript
   3  *
   4  * Copyright (c) 2006 John Resig (jquery.com)
   5  * Licensed under the MIT License:
   6  *   http://www.opensource.org/licenses/mit-license.php
   7  *
   8  * $Date$
   9  * $Rev$
  10  */
  11
  12 // Global undefined variable
  13 window.undefined = window.undefined;
  14
  15 /**
  16  * Create a new jQuery Object
  17  * @constructor
  18  */
  19 function jQuery(a,c) {
  20
  21         // Shortcut for document ready (because $(document).each() is silly)
  22         if ( a && a.constructor == Function )
  23                 return $(document).ready(a);
  24
  25         // Make sure t hat a selection was provided
  26         a = a || jQuery.context || document;
  27
  28         /*
  29          * Handle support for overriding other $() functions. Way too many libraries
  30          * provide this function to simply ignore it and overwrite it.
  31          */
  32
  33         // Check to see if this is a possible collision case
  34         if ( jQuery._$ && !c && a.constructor == String &&
  35
  36                 // Make sure that the expression is a colliding one
  37                 !/[^a-zA-Z0-9_-]/.test(a) &&
  38
  39                 // and that there are no elements that match it
  40                 // (this is the one truly ambiguous case)
  41                 !document.getElementsByTagName(a).length )
  42
  43                         // Use the default method, in case it works some voodoo
  44                         return jQuery._$( a );
  45
  46         // Watch for when a jQuery object is passed as the selector
  47         if ( a.jquery )
  48                 return a;
  49
  50         // Watch for when a jQuery object is passed at the context
  51         if ( c && c.jquery )
  52                 return $(c.get()).find(a);
  53
  54         // If the context is global, return a new object
  55         if ( window == this )
  56                 return new jQuery(a,c);
  57
  58         // Watch for when an array is passed in
  59         this.get( a.constructor == Array ?
  60                 // Assume that it's an array of DOM Elements
  61                 a :
  62
  63                 // Find the matching elements and save them for later
  64                 jQuery.find( a, c ) );
  65
  66         var fn = arguments[ arguments.length - 1 ];
  67         if ( fn && fn.constructor == Function )
  68                 this.each(fn);
  69 }
  70
  71 // Map over the $ in case of overwrite
  72 if ( $ )
  73         jQuery._$ = $;
  74
  75 // Map the jQuery namespace to the '$' one
  76 var $ = jQuery;
  77
  78 jQuery.fn = jQuery.prototype = {
  79         /**
  80          * The current SVN version of jQuery.
  81          *
  82          * @private
  83          * @property
  84          * @name jquery
  85          * @type String
  86          */
  87         jquery: "$Rev$",
  88
  89         /**
  90          * The number of elements currently matched.
  91          *
  92          * @example $("img").length;
  93          * @before <img src="test1.jpg"/> <img src="test2.jpg"/>
  94          * @result 2
  95          *
  96          * @property
  97          * @name length
  98          * @type Number
  99          */
 100
 101         /**
 102          * The number of elements currently matched.
 103          *
 104          * @example $("img").size();
 105          * @before <img src="test1.jpg"/> <img src="test2.jpg"/>
 106          * @result 2
 107          *
 108          * @name size
 109          * @type Number
 110          */
 111         size: function() {
 112                 return this.length;
 113         },
 114
 115         /**
 116          * Access all matched elements. This serves as a backwards-compatible
 117          * way of accessing all matched elements (other than the jQuery object
 118          * itself, which is, in fact, an array of elements).
 119          *
 120          * @example $("img").get();
 121          * @before <img src="test1.jpg"/> <img src="test2.jpg"/>
 122          * @result [ <img src="test1.jpg"/> <img src="test2.jpg"/> ]
 123          *
 124          * @name get
 125          * @type Array<Element>
 126          */
 127
 128         /**
 129          * Access a single matched element. <tt>num</tt> is used to access the
 130          * <tt>num</tt>th element matched.
 131          *
 132          * @example $("img").get(1);
 133          * @before <img src="test1.jpg"/> <img src="test2.jpg"/>
 134          * @result [ <img src="test1.jpg"/> ]
 135          *
 136          * @name get
 137          * @type Element
 138          * @param Number num Access the element in the <tt>num</tt>th position.
 139          */
 140
 141         /**
 142          * Set the jQuery object to an array of elements.
 143          *
 144          * @example $("img").get([ document.body ]);
 145          * @result $("img").get() == [ document.body ]
 146          *
 147          * @private
 148          * @name get
 149          * @type jQuery
 150          * @param Elements elems An array of elements
 151          */
 152         get: function( num ) {
 153                 // Watch for when an array (of elements) is passed in
 154                 if ( num && num.constructor == Array ) {
 155
 156                         // Use a tricky hack to make the jQuery object
 157                         // look and feel like an array
 158                         this.length = 0;
 159                         [].push.apply( this, num );
 160
 161                         return this;
 162                 } else
 163                         return num == undefined ?
 164
 165                                 // Return a 'clean' array
 166                                 jQuery.map( this, function(a){ return a } ) :
 167
 168                                 // Return just the object
 169                                 this[num];
 170         },
 171
 172         /**
 173          * Execute a function within the context of every matched element.
 174          * This means that every time the passed-in function is executed
 175          * (which is once for every element matched) the 'this' keyword
 176          * points to the specific element.
 177          *
 178          * Additionally, the function, when executed, is passed a single
 179          * argument representing the position of the element in the matched
 180          * set.
 181          *
 182          * @example $("img").each(function(){ this.src = "test.jpg"; });
 183          * @before <img/> <img/>
 184          * @result <img src="test.jpg"/> <img src="test.jpg"/>
 185          *
 186          * @name each
 187          * @type jQuery
 188          * @param Function fn A function to execute
 189          */
 190         each: function( fn ) {
 191                 // Iterate through all of the matched elements
 192                 for ( var i = 0; i < this.length; i++ )
 193
 194                         // Execute the function within the context of each element
 195                         fn.apply( this[i], [i] );
 196
 197                 return this;
 198         },
 199
 200         /**
 201          * Access a property on the first matched element.
 202          * This method makes it easy to retreive a property value
 203          * from the first matched element.
 204          *
 205          * @example $("img").attr("src");
 206          * @before <img src="test.jpg"/>
 207          * @result test.jpg
 208          *
 209          * @name attr
 210          * @type Object
 211          * @param String name The name of the property to access.
 212          */
 213
 214         /**
 215          * Set a hash of key/value object properties to all matched elements.
 216          * This serves as the best way to set a large number of properties
 217          * on all matched elements.
 218          *
 219          * @example $("img").attr({ src: "test.jpg", alt: "Test Image" });
 220          * @before <img/>
 221          * @result <img src="test.jpg" alt="Test Image"/>
 222          *
 223          * @name attr
 224          * @type jQuery
 225          * @param Hash prop A set of key/value pairs to set as object properties.
 226          */
 227
 228         /**
 229          * Set a single property to a value, on all matched elements.
 230          *
 231          * @example $("img").attr("src","test.jpg");
 232          * @before <img/>
 233          * @result <img src="test.jpg"/>
 234          *
 235          * @name attr
 236          * @type jQuery
 237          * @param String key The name of the property to set.
 238          * @param Object value The value to set the property to.
 239          */
 240         attr: function( key, value, type ) {
 241                 // Check to see if we're setting style values
 242                 return key.constructor != String || value ?
 243                         this.each(function(){
 244                                 // See if we're setting a hash of styles
 245                                 if ( value == undefined )
 246                                         // Set all the styles
 247                                         for ( var prop in key )
 248                                                 jQuery.attr(
 249                                                         type ? this.style : this,
 250                                                         prop, key[prop]
 251                                                 );
 252
 253                                 // See if we're setting a single key/value style
 254                                 else
 255                                         jQuery.attr(
 256                                                 type ? this.style : this,
 257                                                 key, value
 258                                         );
 259                         }) :
 260
 261                         // Look for the case where we're accessing a style value
 262                         jQuery[ type || "attr" ]( this[0], key );
 263         },
 264
 265         /**
 266          * Access a style property on the first matched element.
 267          * This method makes it easy to retreive a style property value
 268          * from the first matched element.
 269          *
 270          * @example $("p").css("red");
 271          * @before <p style="color:red;">Test Paragraph.</p>
 272          * @result red
 273          *
 274          * @name css
 275          * @type Object
 276          * @param String name The name of the property to access.
 277          */
 278
 279         /**
 280          * Set a hash of key/value style properties to all matched elements.
 281          * This serves as the best way to set a large number of style properties
 282          * on all matched elements.
 283          *
 284          * @example $("p").css({ color: "red", background: "blue" });
 285          * @before <p>Test Paragraph.</p>
 286          * @result <p style="color:red; background:blue;">Test Paragraph.</p>
 287          *
 288          * @name css
 289          * @type jQuery
 290          * @param Hash prop A set of key/value pairs to set as style properties.
 291          */
 292
 293         /**
 294          * Set a single style property to a value, on all matched elements.
 295          *
 296          * @example $("p").css("color","red");
 297          * @before <p>Test Paragraph.</p>
 298          * @result <p style="color:red;">Test Paragraph.</p>
 299          *
 300          * @name css
 301          * @type jQuery
 302          * @param String key The name of the property to set.
 303          * @param Object value The value to set the property to.
 304          */
 305         css: function( key, value ) {
 306                 return this.attr( key, value, "css" );
 307         },
 308
 309         /**
 310          * Retreive the text contents of all matched elements. The result is
 311          * a string that contains the combined text contents of all matched
 312          * elements. This method works on both HTML and XML documents.
 313          *
 314          * @example $("p").text();
 315          * @before <p>Test Paragraph.</p>
 316          * @result Test Paragraph.
 317          *
 318          * @name text
 319          * @type String
 320          */
 321         text: function(e) {
 322                 e = e || this;
 323                 var t = "";
 324                 for ( var j = 0; j < e.length; j++ ) {
 325                         var r = e[j].childNodes;
 326                         for ( var i = 0; i < r.length; i++ )
 327                                 t += r[i].nodeType != 1 ?
 328                                         r[i].nodeValue : jQuery.fn.text([ r[i] ]);
 329                 }
 330                 return t;
 331         },
 332
 333         /**
 334          * Wrap all matched elements with a structure of other elements.
 335          * This wrapping process is most useful for injecting additional
 336          * stucture into a document, without ruining the original semantic
 337          * qualities of a document.
 338          *
 339          * The way that is works is that it goes through the first element argument
 340          * provided and finds the deepest element within the structure - it is that
 341          * element that will en-wrap everything else.
 342          *
 343          * @example $("p").wrap("<div class='wrap'></div>");
 344          * @before <p>Test Paragraph.</p>
 345          * @result <div class='wrap'><p>Test Paragraph.</p></div>
 346          *
 347          * @name wrap
 348          * @type jQuery
 349          * @any String html A string of HTML, that will be created on the fly and wrapped around the target.
 350          * @any Element elem A DOM element that will be wrapped.
 351          * @any Array<Element> elems An array of elements, the first of which will be wrapped.
 352          * @any Object obj Any object, converted to a string, then a text node.
 353          */
 354         wrap: function() {
 355                 // The elements to wrap the target around
 356                 var a = jQuery.clean(arguments);
 357
 358                 // Wrap each of the matched elements individually
 359                 return this.each(function(){
 360                         // Clone the structure that we're using to wrap
 361                         var b = a[0].cloneNode(true);
 362
 363                         // Insert it before the element to be wrapped
 364                         this.parentNode.insertBefore( b, this );
 365
 366                         // Find he deepest point in the wrap structure
 367                         while ( b.firstChild )
 368                                 b = b.firstChild;
 369
 370                         // Move the matched element to within the wrap structure
 371                         b.appendChild( this );
 372                 });
 373         },
 374
 375         /**
 376          * Append any number of elements to the inside of all matched elements.
 377          * This operation is similar to doing an <tt>appendChild</tt> to all the
 378          * specified elements, adding them into the document.
 379          *
 380          * @example $("p").append("<b>Hello</b>");
 381          * @before <p>I would like to say: </p>
 382          * @result <p>I would like to say: <b>Hello</b></p>
 383          *
 384          * @name append
 385          * @type jQuery
 386          * @any String html A string of HTML, that will be created on the fly and appended to the target.
 387          * @any Element elem A DOM element that will be appended.
 388          * @any Array<Element> elems An array of elements, all of which will be appended.
 389          * @any Object obj Any object, converted to a string, then a text node.
 390          */
 391         append: function() {
 392                 return this.domManip(arguments, true, 1, function(a){
 393                         this.appendChild( a );
 394                 });
 395         },
 396
 397         /**
 398          * Prepend any number of elements to the inside of all matched elements.
 399          * This operation is the best way to insert a set of elements inside, at the
 400          * beginning, of all the matched element.
 401          *
 402          * @example $("p").prepend("<b>Hello</b>");
 403          * @before <p>, how are you?</p>
 404          * @result <p><b>Hello</b>, how are you?</p>
 405          *
 406          * @name prepend
 407          * @type jQuery
 408          * @any String html A string of HTML, that will be created on the fly and prepended to the target.
 409          * @any Element elem A DOM element that will be prepended.
 410          * @any Array<Element> elems An array of elements, all of which will be prepended.
 411          * @any Object obj Any object, converted to a string, then a text node.
 412          */
 413         prepend: function() {
 414                 return this.domManip(arguments, true, -1, function(a){
 415                         this.insertBefore( a, this.firstChild );
 416                 });
 417         },
 418
 419         /**
 420          * Insert any number of elements before each of the matched elements.
 421          *
 422          * @example $("p").before("<b>Hello</b>");
 423          * @before <p>how are you?</p>
 424          * @result <b>Hello</b><p>how are you?</p>
 425          *
 426          * @name before
 427          * @type jQuery
 428          * @any String html A string of HTML, that will be created on the fly and inserted.
 429          * @any Element elem A DOM element that will beinserted.
 430          * @any Array<Element> elems An array of elements, all of which will be inserted.
 431          * @any Object obj Any object, converted to a string, then a text node.
 432          */
 433         before: function() {
 434                 return this.domManip(arguments, false, 1, function(a){
 435                         this.parentNode.insertBefore( a, this );
 436                 });
 437         },
 438
 439         /**
 440          * Insert any number of elements after each of the matched elements.
 441          *
 442          * @example $("p").after("<p>I'm doing fine.</p>");
 443          * @before <p>How are you?</p>
 444          * @result <p>How are you?</p><p>I'm doing fine.</p>
 445          *
 446          * @name after
 447          * @type jQuery
 448          * @any String html A string of HTML, that will be created on the fly and inserted.
 449          * @any Element elem A DOM element that will beinserted.
 450          * @any Array<Element> elems An array of elements, all of which will be inserted.
 451          * @any Object obj Any object, converted to a string, then a text node.
 452          */
 453         after: function() {
 454                 return this.domManip(arguments, false, -1, function(a){
 455                         this.parentNode.insertBefore( a, this.nextSibling );
 456                 });
 457         },
 458
 459         /**
 460          * End the most recent 'destructive' operation, reverting the list of matched elements
 461          * back to its previous state. After an end operation, the list of matched elements will
 462          * revert to the last state of matched elements.
 463          *
 464          * @example $("p").find("span").end();
 465          * @before <p><span>Hello</span>, how are you?</p>
 466          * @result $("p").find("span").end() == [ <p>...</p> ]
 467          *
 468          * @name end
 469          * @type jQuery
 470          */
 471         end: function() {
 472                 return this.get( this.stack.pop() );
 473         },
 474
 475         /**
 476          * Searches for all elements that match the specified expression.
 477          * This method is the optimal way of finding additional descendant
 478          * elements with which to process.
 479          *
 480          * All searching is done using a jQuery expression. The expression can be
 481          * written using CSS 1-3 Selector syntax, or basic XPath.
 482          *
 483          * @example $("p").find("span");
 484          * @before <p><span>Hello</span>, how are you?</p>
 485          * @result $("p").find("span") == [ <span>Hello</span> ]
 486          *
 487          * @name find
 488          * @type jQuery
 489          * @param String expr An expression to search with.
 490          */
 491         find: function(t) {
 492                 return this.pushStack( jQuery.map( this, function(a){
 493                         return jQuery.find(t,a);
 494                 }), arguments );
 495         },
 496
 497         /**
 498          * Removes all elements from the set of matched elements that do not
 499          * match the specified expression. This method is used to narrow down
 500          * the results of a search.
 501          *
 502          * All searching is done using a jQuery expression. The expression
 503          * can be written using CSS 1-3 Selector syntax, or basic XPath.
 504          *
 505          * @example $("p").filter(".selected")
 506          * @before <p class="selected">Hello</p><p>How are you?</p>
 507          * @result $("p").filter(".selected") == [ <p class="selected">Hello</p> ]
 508          *
 509          * @name filter
 510          * @type jQuery
 511          * @param String expr An expression to search with.
 512          */
 513
 514          /**
 515           * Removes all elements from the set of matched elements that do not
 516           * match at least one of the expressions passed to the function. This
 517           * method is used when you want to filter the set of matched elements
 518           * through more than one expression.
 519           *
 520           * Elements will be retained in the jQuery object if they match at
 521           * least one of the expressions passed.
 522           *
 523           * @example $("p").filter([".selected", ":first"])
 524           * @before <p>Hello</p><p>Hello Again</p><p class="selected">And Again</p>
 525           * @result $("p").filter([".selected", ":first"]) == [ <p>Hello</p>, <p class="selected">And Again</p> ]
 526           *
 527           * @name filter
 528           * @type jQuery
 529           * @param Array<String> exprs A set of expressions to evaluate against
 530           */
 531         filter: function(t) {
 532                 return t.constructor == Array ?
 533                         // Multi Filtering
 534                         this.pushStack( jQuery.map(this,function(a){
 535                                 for ( var i = 0; i < t.length; i++ )
 536                                         if ( jQuery.filter(t[i],[a]).r.length )
 537                                                 return a;
 538                         }), arguments ) :
 539
 540                         this.pushStack( jQuery.filter(t,this).r, arguments );
 541         },
 542
 543         /**
 544          * Removes the specified Element from the set of matched elements. This
 545          * method is used to remove a single Element from a jQuery object.
 546          *
 547          * @example $("p").not( document.getElementById("selected") )
 548          * @before <p>Hello</p><p id="selected">Hello Again</p>
 549          * @result [ <p>Hello</p> ]
 550          *
 551          * @name not
 552          * @type jQuery
 553          * @param Element el An element to remove from the set
 554          */
 555
 556         /**
 557          * Removes elements matching the specified expression from the set
 558          * of matched elements. This method is used to remove one or more
 559          * elements from a jQuery object.
 560          *
 561          * @example $("p").not("#selected")
 562          * @before <p>Hello</p><p id="selected">Hello Again</p>
 563          * @result [ <p>Hello</p> ]
 564          *
 565          * @name not
 566          * @type jQuery
 567          * @param String expr An expression with which to remove matching elements
 568          */
 569         not: function(t) {
 570                 return this.pushStack( t.constructor == String ?
 571                         jQuery.filter(t,this,false).r :
 572                         jQuery.grep(this,function(a){ return a != t; }), arguments );
 573         },
 574
 575         /**
 576          * Adds the elements matched by the expression to the jQuery object. This
 577          * can be used to concatenate the result sets of two expressions.
 578          *
 579          * @example $("p").add("span")
 580          * @before <p>Hello</p><p><span>Hello Again</span></p>
 581          * @result [ <p>Hello</p>, <span>Hello Again</span> ]
 582          *
 583          * @name add
 584          * @type jQuery
 585          * @param String expr An expression whose matched elements are added
 586          */
 587
 588         /**
 589          * Adds each of the Elements in the array to the set of matched elements.
 590          * This is used to add a set of Elements to a jQuery object.
 591          *
 592          * @example $("p").add([document.getElementById("a"), document.getElementById("b")])
 593          * @before <p>Hello</p><p><span id="a">Hello Again</span><span id="b">And Again</span></p>
 594          * @result [ <p>Hello</p>, <span id="a">Hello Again</span>, <span id="b">And Again</span> ]
 595          *
 596          * @name add
 597          * @type jQuery
 598          * @param Array<Element> els An array of Elements to add
 599          */
 600
 601          /**
 602           * Adds a single Element to the set of matched elements. This is used to
 603           * add a single Element to a jQuery object.
 604           *
 605           * @example $("p").add( document.getElementById("a") )
 606           * @before <p>Hello</p><p><span id="a">Hello Again</span></p>
 607           * @result [ <p>Hello</p>, <span id="a">Hello Again</span> ]
 608           *
 609           * @name add
 610           * @type jQuery
 611           * @param Element el An Element to add
 612           */
 613         add: function(t) {
 614                 return this.pushStack( jQuery.merge( this, t.constructor == String ?
 615                         jQuery.find(t) : t.constructor == Array ? t : [t] ), arguments );
 616         },
 617
 618         /**
 619          * A wrapper function for each() to be used by append and prepend.
 620          * Handles cases where you're trying to modify the inner contents of
 621          * a table, when you actually need to work with the tbody.
 622          *
 623          * @member jQuery
 624          * @param {String} expr The expression with which to filter
 625          * @type Boolean
 626          */
 627         is: function(expr) {
 628                 return jQuery.filter(expr,this).r.length > 0;
 629         },
 630
 631         /**
 632          *
 633          *
 634          * @private
 635          * @name domManip
 636          * @param Array args
 637          * @param Boolean table
 638          * @param Number int
 639          * @param Function fn The function doing the DOM manipulation.
 640          * @type jQuery
 641          */
 642         domManip: function(args, table, dir, fn){
 643                 var clone = this.size() > 1;
 644                 var a = jQuery.clean(args);
 645
 646                 return this.each(function(){
 647                         var obj = this;
 648
 649                         if ( table && this.nodeName == "TABLE" ) {
 650                                 var tbody = this.getElementsByTagName("tbody");
 651
 652                                 if ( !tbody.length ) {
 653                                         obj = document.createElement("tbody");
 654                                         this.appendChild( obj );
 655                                 } else
 656                                         obj = tbody[0];
 657                         }
 658
 659                         for ( var i = ( dir < 0 ? a.length - 1 : 0 );
 660                                 i != ( dir < 0 ? dir : a.length ); i += dir )
 661                                         fn.apply( obj, [ a[i] ] );
 662                 });
 663         },
 664
 665         /**
 666          *
 667          *
 668          * @private
 669          * @name pushStack
 670          * @param Array a
 671          * @param Array args
 672          * @type jQuery
 673          */
 674         pushStack: function(a,args) {
 675                 var fn = args && args[args.length-1];
 676
 677                 if ( !fn || fn.constructor != Function ) {
 678                         if ( !this.stack ) this.stack = [];
 679                         this.stack.push( this.get() );
 680                         this.get( a );
 681                 } else {
 682                         var old = this.get();
 683                         this.get( a );
 684                         if ( fn.constructor == Function )
 685                                 return this.each( fn );
 686                         this.get( old );
 687                 }
 688
 689                 return this;
 690         },
 691
 692         extend: function(obj,prop) {
 693                 if ( !prop ) { prop = obj; obj = this; }
 694                 for ( var i in prop ) obj[i] = prop[i];
 695                 return obj;
 696         }
 697 };
 698
 699 jQuery.extend = jQuery.fn.extend;
 700
 701 new function() {
 702         var b = navigator.userAgent.toLowerCase();
 703
 704         // Figure out what browser is being used
 705         jQuery.browser = {
 706                 safari: /webkit/.test(b),
 707                 opera: /opera/.test(b),
 708                 msie: /msie/.test(b) && !/opera/.test(b),
 709                 mozilla: /mozilla/.test(b) && !/compatible/.test(b)
 710         };
 711
 712         // Check to see if the W3C box model is being used
 713         jQuery.boxModel = !jQuery.browser.msie || document.compatMode == "CSS1Compat";
 714
 715         var axis = {
 716                 /**
 717                  * Get a set of elements containing the unique parents of the matched
 718                  * set of elements.
 719                  *
 720                  * @example $("p").parent()
 721                  * @before <div><p>Hello</p><p>Hello</p></div>
 722                  * @result [ <div><p>Hello</p><p>Hello</p></div> ]
 723                  *
 724                  * @name parent
 725                  * @type jQuery
 726                  */
 727
 728                 /**
 729                  * Get a set of elements containing the unique parents of the matched
 730                  * set of elements, and filtered by an expression.
 731                  *
 732                  * @example $("p").parent(".selected")
 733                  * @before <div><p>Hello</p></div><div class="selected"><p>Hello Again</p></div>
 734                  * @result [ <div class="selected"><p>Hello Again</p></div> ]
 735                  *
 736                  * @name parent
 737                  * @type jQuery
 738                  * @param String expr An expression to filter the parents with
 739                  */
 740                 parent: "a.parentNode",
 741
 742                 /**
 743                  * Get a set of elements containing the unique ancestors of the matched
 744                  * set of elements.
 745                  *
 746                  * @example $("span").ancestors()
 747                  * @before <html><body><div><p><span>Hello</span></p><span>Hello Again</span></div></body></html>
 748                  * @result [ <body>...</body>, <div>...</div>, <p><span>Hello</span></p> ]
 749                  *
 750                  * @name ancestors
 751                  * @type jQuery
 752                  */
 753
 754                 /**
 755                  * Get a set of elements containing the unique ancestors of the matched
 756                  * set of elements, and filtered by an expression.
 757                  *
 758                  * @example $("span").ancestors("p")
 759                  * @before <html><body><div><p><span>Hello</span></p><span>Hello Again</span></div></body></html>
 760                  * @result [ <p><span>Hello</span></p> ]
 761                  *
 762                  * @name ancestors
 763                  * @type jQuery
 764                  * @param String expr An expression to filter the ancestors with
 765                  */
 766                 ancestors: jQuery.parents,
 767
 768                 /**
 769                  * A synonym for ancestors
 770                  */
 771                 parents: jQuery.parents,
 772
 773                 /**
 774                  * Get a set of elements containing the unique next siblings of each of the
 775                  * matched set of elements.
 776                  *
 777                  * It only returns the very next sibling, not all next siblings.
 778                  *
 779                  * @example $("p").next()
 780                  * @before <p>Hello</p><p>Hello Again</p><div><span>And Again</span></div>
 781                  * @result [ <p>Hello Again</p>, <div><span>And Again</span></div> ]
 782                  *
 783                  * @name next
 784                  * @type jQuery
 785                  */
 786
 787                 /**
 788                  * Get a set of elements containing the unique next siblings of each of the
 789                  * matched set of elements, and filtered by an expression.
 790                  *
 791                  * It only returns the very next sibling, not all next siblings.
 792                  *
 793                  * @example $("p").next(".selected")
 794                  * @before <p>Hello</p><p class="selected">Hello Again</p><div><span>And Again</span></div>
 795                  * @result [ <p class="selected">Hello Again</p> ]
 796                  *
 797                  * @name next
 798                  * @type jQuery
 799                  * @param String expr An expression to filter the next Elements with
 800                  */
 801                 next: "a.nextSibling",
 802
 803                 /**
 804                  * Get a set of elements containing the unique previous siblings of each of the
 805                  * matched set of elements.
 806                  *
 807                  * It only returns the immediately previous sibling, not all previous siblings.
 808                  *
 809                  * @example $("p").previous()
 810                  * @before <p>Hello</p><div><span>Hello Again</span></div><p>And Again</p>
 811                  * @result [ <div><span>Hello Again</span></div> ]
 812                  *
 813                  * @name prev
 814                  * @type jQuery
 815                  */
 816
 817                 /**
 818                  * Get a set of elements containing the unique previous siblings of each of the
 819                  * matched set of elements, and filtered by an expression.
 820                  *
 821                  * It only returns the immediately previous sibling, not all previous siblings.
 822                  *
 823                  * @example $("p").previous("selected")
 824                  * @before <div><span>Hello</span></div><p class="selected">Hello Again</p><p>And Again</p>
 825                  * @result [ <div><span>Hello</span></div> ]
 826                  *
 827                  * @name prev
 828                  * @type jQuery
 829                  * @param String expr An expression to filter the previous Elements with
 830                  */
 831                 prev: "a.previousSibling",
 832
 833                 /**
 834                  * Get a set of elements containing all of the unique siblings of each of the
 835                  * matched set of elements.
 836                  *
 837                  * @example $("div").siblings()
 838                  * @before <p>Hello</p><div><span>Hello Again</span></div><p>And Again</p>
 839                  * @result [ <p>Hello</p>, <p>And Again</p> ]
 840                  *
 841                  * @name siblings
 842                  * @type jQuery
 843                  */
 844
 845                 /**
 846                  * Get a set of elements containing all of the unique siblings of each of the
 847                  * matched set of elements, and filtered by an expression.
 848                  *
 849                  * @example $("div").siblings("selected")
 850                  * @before <div><span>Hello</span></div><p class="selected">Hello Again</p><p>And Again</p>
 851                  * @result [ <p class="selected">Hello Again</p> ]
 852                  *
 853                  * @name siblings
 854                  * @type jQuery
 855                  * @param String expr An expression to filter the sibling Elements with
 856                  */
 857                 siblings: jQuery.sibling
 858         };
 859
 860         for ( var i in axis ) new function(){
 861                 var t = axis[i];
 862                 jQuery.fn[ i ] = function(a) {
 863                         var ret = jQuery.map(this,t);
 864                         if ( a ) ret = jQuery.filter(a,ret).r;
 865                         return this.pushStack( ret, arguments );
 866                 };
 867         }
 868
 869         /*var to = ["append","prepend","before","after"];
 870
 871         for ( var i = 0; i < to.length; i++ ) new function(){
 872                 var n = to[i];
 873                 jQuery.fn[ n + "To" ] = function(){
 874                         var a = arguments;
 875                         return this.each(function(){
 876                                 for ( var i = 0; i < a.length; i++ )
 877                                         $(a[i])[n]( this );
 878                         });
 879                 };
 880         }*/
 881
 882         var each = {
 883                 show: function(){
 884                         this.style.display = this.oldblock ? this.oldblock : "";
 885                         if ( jQuery.css(this,"display") == "none" )
 886                                 this.style.display = "block";
 887                 },
 888
 889                 hide: function(){
 890                         this.oldblock = jQuery.css(this,"display");
 891                         if ( this.oldblock == "none" )
 892                                 this.oldblock = "block";
 893                         this.style.display = "none";
 894                 },
 895
 896                 toggle: function(){
 897                         var d = jQuery.css(this,"display");
 898                         $(this)[ !d || d == "none" ? "show" : "hide" ]();
 899                 },
 900
 901                 addClass: function(c){
 902                         jQuery.className.add(this,c);
 903                 },
 904
 905                 removeClass: function(c){
 906                         jQuery.className.remove(this,c);
 907                 },
 908
 909                 toggleClass: function( c ){
 910                         jQuery.className[ jQuery.className.has(this,a) ? "remove" : "add" ](this,c);
 911                 },
 912
 913                 remove: function(a){
 914                         if ( !a || jQuery.filter( [this], a ).r )
 915                                 this.parentNode.removeChild( this );
 916                 },
 917
 918                 empty: function(){
 919                         while ( this.firstChild )
 920                                 this.removeChild( this.firstChild );
 921                 },
 922
 923                 bind: function( type, fn ) {
 924                         jQuery.event.add( this, type, fn );
 925                 },
 926
 927                 unbind: function( type, fn ) {
 928                         jQuery.event.remove( this, type, fn );
 929                 },
 930
 931                 trigger: function( type ) {
 932                         jQuery.event.trigger( this, type );
 933                 }
 934         };
 935
 936         for ( var i in each ) new function() {
 937                 var n = each[i];
 938                 jQuery.fn[ i ] = function() {
 939                         var args = arguments;
 940                         return this.each(function(){
 941                                 n.apply( this, args );
 942                         });
 943                 };
 944         }
 945
 946         var attr = {
 947                 val: "value",
 948                 html: "innerHTML",
 949                 value: null,
 950                 id: null,
 951                 title: null,
 952                 name: null,
 953                 href: null,
 954                 src: null,
 955                 rel: null
 956         };
 957
 958         for ( var i in attr ) new function() {
 959                 var n = attr[i];
 960                 jQuery.fn[ i ] = function(h) {
 961                         return h == undefined ?
 962                                 this.length ? this[0][n] : null :
 963                                 this.attr( n, h );
 964                 };
 965         }
 966
 967         var css = "width,height,top,left,position,float,overflow,color,background".split(",");
 968
 969         for ( var i in css ) new function() {
 970                 var n = css[i];
 971                 jQuery.fn[ i ] = function(h) {
 972                         return h == undefined ?
 973                                 this.length ? jQuery.css( this[0], n ) : null :
 974                                 this.css( n, h );
 975                 };
 976         }
 977
 978 }
 979
 980 jQuery.extend({
 981         className: {
 982                 add: function(o,c){
 983                         if (jQuery.className.has(o,c)) return;
 984                         o.className += ( o.className ? " " : "" ) + c;
 985                 },
 986                 remove: function(o,c){
 987                         o.className = !c ? "" :
 988                                 o.className.replace(
 989                                         new RegExp("(^|\\s*\\b[^-])"+c+"($|\\b(?=[^-]))", "g"), "");
 990                 },
 991                 has: function(e,a) {
 992                         if ( e.className )
 993                                 e = e.className;
 994                         return new RegExp("(^|\\s)" + a + "(\\s|$)").test(e);
 995                 }
 996         },
 997
 998         /**
 999          * Swap in/out style options.
1000          * @private
1001          */
1002         swap: function(e,o,f) {
1003                 for ( var i in o ) {
1004                         e.style["old"+i] = e.style[i];
1005                         e.style[i] = o[i];
1006                 }
1007                 f.apply( e, [] );
1008                 for ( var i in o )
1009                         e.style[i] = e.style["old"+i];
1010         },
1011
1012         css: function(e,p) {
1013                 if ( p == "height" || p == "width" ) {
1014                         var old = {}, oHeight, oWidth, d = ["Top","Bottom","Right","Left"];
1015
1016                         for ( var i in d ) {
1017                                 old["padding" + d[i]] = 0;
1018                                 old["border" + d[i] + "Width"] = 0;
1019                         }
1020
1021                         jQuery.swap( e, old, function() {
1022                                 if (jQuery.css(e,"display") != "none") {
1023                                         oHeight = e.offsetHeight;
1024                                         oWidth = e.offsetWidth;
1025                                 } else
1026                                         jQuery.swap( e, { visibility: "hidden", position: "absolute", display: "" },
1027                                                 function(){
1028                                                         oHeight = e.clientHeight;
1029                                                         oWidth = e.clientWidth;
1030                                                 });
1031                         });
1032
1033                         return p == "height" ? oHeight : oWidth;
1034                 }
1035
1036                 var r;
1037
1038                 if (e.style[p])
1039                         r = e.style[p];
1040                 else if (e.currentStyle)
1041                         r = e.currentStyle[p];
1042                 else if (document.defaultView && document.defaultView.getComputedStyle) {
1043                         p = p.replace(/([A-Z])/g,"-$1").toLowerCase();
1044                         var s = document.defaultView.getComputedStyle(e,"");
1045                         r = s ? s.getPropertyValue(p) : null;
1046                 }
1047
1048                 return r;
1049         },
1050
1051         clean: function(a) {
1052                 var r = [];
1053                 for ( var i = 0; i < a.length; i++ ) {
1054                         if ( a[i].constructor == String ) {
1055
1056                                 if ( !a[i].indexOf("<tr") ) {
1057                                         var tr = true;
1058                                         a[i] = "<table>" + a[i] + "</table>";
1059                                 } else if ( !a[i].indexOf("<td") || !a[i].indexOf("<th") ) {
1060                                         var td = true;
1061                                         a[i] = "<table><tbody><tr>" + a[i] + "</tr></tbody></table>";
1062                                 }
1063
1064                                 var div = document.createElement("div");
1065                                 div.innerHTML = a[i];
1066
1067                                 if ( tr || td ) {
1068                                         div = div.firstChild.firstChild;
1069                                         if ( td ) div = div.firstChild;
1070                                 }
1071
1072                                 for ( var j = 0; j < div.childNodes.length; j++ )
1073                                         r.push( div.childNodes[j] );
1074                         } else if ( a[i].jquery || a[i].length && !a[i].nodeType )
1075                                 for ( var k = 0; k < a[i].length; k++ )
1076                                         r.push( a[i][k] );
1077                         else if ( a[i] !== null )
1078                                 r.push( a[i].nodeType ? a[i] : document.createTextNode(a[i].toString()) );
1079                 }
1080                 return r;
1081         },
1082
1083         expr: {
1084                 "": "m[2]== '*'||a.nodeName.toUpperCase()==m[2].toUpperCase()",
1085                 "#": "a.getAttribute('id')&&a.getAttribute('id')==m[2]",
1086                 ":": {
1087                         // Position Checks
1088                         lt: "i<m[3]-0",
1089                         gt: "i>m[3]-0",
1090                         nth: "m[3]-0==i",
1091                         eq: "m[3]-0==i",
1092                         first: "i==0",
1093                         last: "i==r.length-1",
1094                         even: "i%2==0",
1095                         odd: "i%2",
1096
1097                         // Child Checks
1098                         "first-child": "jQuery.sibling(a,0).cur",
1099                         "last-child": "jQuery.sibling(a,0).last",
1100                         "only-child": "jQuery.sibling(a).length==1",
1101
1102                         // Parent Checks
1103                         parent: "a.childNodes.length",
1104                         empty: "!a.childNodes.length",
1105
1106                         // Text Check
1107                         contains: "(a.innerText||a.innerHTML).indexOf(m[3])>=0",
1108
1109                         // Visibility
1110                         visible: "jQuery.css(a,'display')!='none'&&jQuery.css(a,'visibility')!='hidden'",
1111                         hidden: "jQuery.css(a,'display')=='none'||jQuery.css(a,'visibility')=='hidden'",
1112
1113                         // Form elements
1114                         enabled: "!a.disabled",
1115                         disabled: "a.disabled",
1116                         checked: "a.checked"
1117                 },
1118                 ".": "jQuery.className.has(a,m[2])",
1119                 "@": {
1120                         "=": "z==m[4]",
1121                         "!=": "z!=m[4]",
1122                         "^=": "!z.indexOf(m[4])",
1123                         "$=": "z.substr(z.length - m[4].length,m[4].length)==m[4]",
1124                         "*=": "z.indexOf(m[4])>=0",
1125                         "": "z"
1126                 },
1127                 "[": "jQuery.find(m[2],a).length"
1128         },
1129
1130         token: [
1131                 "\\.\\.|/\\.\\.", "a.parentNode",
1132                 ">|/", "jQuery.sibling(a.firstChild)",
1133                 "\\+", "jQuery.sibling(a).next",
1134                 "~", function(a){
1135                         var r = [];
1136                         var s = jQuery.sibling(a);
1137                         if ( s.n > 0 )
1138                                 for ( var i = s.n; i < s.length; i++ )
1139                                         r.push( s[i] );
1140                         return r;
1141                 }
1142         ],
1143
1144         find: function( t, context ) {
1145                 // Make sure that the context is a DOM Element
1146                 if ( context && context.getElementsByTagName == undefined )
1147                         context = null;
1148
1149                 // Set the correct context (if none is provided)
1150                 context = context || jQuery.context || document;
1151
1152                 if ( t.constructor != String ) return [t];
1153
1154                 if ( !t.indexOf("//") ) {
1155                         context = context.documentElement;
1156                         t = t.substr(2,t.length);
1157                 } else if ( !t.indexOf("/") ) {
1158                         context = context.documentElement;
1159                         t = t.substr(1,t.length);
1160                         // FIX Assume the root element is right :(
1161                         if ( t.indexOf("/") >= 1 )
1162                                 t = t.substr(t.indexOf("/"),t.length);
1163                 }
1164
1165                 var ret = [context];
1166                 var done = [];
1167                 var last = null;
1168
1169                 while ( t.length > 0 && last != t ) {
1170                         var r = [];
1171                         last = t;
1172
1173                         t = jQuery.trim(t).replace( /^\/\//i, "" );
1174
1175                         var foundToken = false;
1176
1177                         for ( var i = 0; i < jQuery.token.length; i += 2 ) {
1178                                 var re = new RegExp("^(" + jQuery.token[i] + ")");
1179                                 var m = re.exec(t);
1180
1181                                 if ( m ) {
1182                                         r = ret = jQuery.map( ret, jQuery.token[i+1] );
1183                                         t = jQuery.trim( t.replace( re, "" ) );
1184                                         foundToken = true;
1185                                 }
1186                         }
1187
1188                         if ( !foundToken ) {
1189                                 if ( !t.indexOf(",") || !t.indexOf("|") ) {
1190                                         if ( ret[0] == context ) ret.shift();
1191                                         done = jQuery.merge( done, ret );
1192                                         r = ret = [context];
1193                                         t = " " + t.substr(1,t.length);
1194                                 } else {
1195                                         var re2 = /^([#.]?)([a-z0-9\\*_-]*)/i;
1196                                         var m = re2.exec(t);
1197
1198                                         if ( m[1] == "#" ) {
1199                                                 // Ummm, should make this work in all XML docs
1200                                                 var oid = document.getElementById(m[2]);
1201                                                 r = ret = oid ? [oid] : [];
1202                                                 t = t.replace( re2, "" );
1203                                         } else {
1204                                                 if ( !m[2] || m[1] == "." ) m[2] = "*";
1205
1206                                                 for ( var i = 0; i < ret.length; i++ )
1207                                                         r = jQuery.merge( r,
1208                                                                 m[2] == "*" ?
1209                                                                         jQuery.getAll(ret[i]) :
1210                                                                         ret[i].getElementsByTagName(m[2])
1211                                                         );
1212                                         }
1213                                 }
1214                         }
1215
1216                         if ( t ) {
1217                                 var val = jQuery.filter(t,r);
1218                                 ret = r = val.r;
1219                                 t = jQuery.trim(val.t);
1220                         }
1221                 }
1222
1223                 if ( ret && ret[0] == context ) ret.shift();
1224                 done = jQuery.merge( done, ret );
1225
1226                 return done;
1227         },
1228
1229         getAll: function(o,r) {
1230                 r = r || [];
1231                 var s = o.childNodes;
1232                 for ( var i = 0; i < s.length; i++ )
1233                         if ( s[i].nodeType == 1 ) {
1234                                 r.push( s[i] );
1235                                 jQuery.getAll( s[i], r );
1236                         }
1237                 return r;
1238         },
1239
1240         attr: function(o,a,v){
1241                 if ( a && a.constructor == String ) {
1242                         var fix = {
1243                                 "for": "htmlFor",
1244                                 "class": "className",
1245                                 "float": "cssFloat"
1246                         };
1247
1248                         a = (fix[a] && fix[a].replace && fix[a] || a)
1249                                 .replace(/-([a-z])/ig,function(z,b){
1250                                         return b.toUpperCase();
1251                                 });
1252
1253                         if ( v != undefined ) {
1254                                 o[a] = v;
1255                                 if ( o.setAttribute && a != "disabled" )
1256                                         o.setAttribute(a,v);
1257                         }
1258
1259                         return o[a] || o.getAttribute && o.getAttribute(a) || "";
1260                 } else
1261                         return "";
1262         },
1263
1264         filter: function(t,r,not) {
1265                 // Figure out if we're doing regular, or inverse, filtering
1266                 var g = not !== false ? jQuery.grep :
1267                         function(a,f) {return jQuery.grep(a,f,true);};
1268
1269                 // Look for a string-like sequence
1270                 var str = "([a-zA-Z*_-][a-zA-Z0-9_-]*)";
1271
1272                 // Look for something (optionally) enclosed with quotes
1273                 var qstr = " *'?\"?([^'\"]*)'?\"? *";
1274
1275                 while ( t && /^[a-zA-Z\[*:.#]/.test(t) ) {
1276                         // Handles:
1277                         // [@foo], [@foo=bar], etc.
1278                         var re = new RegExp("^\\[ *@" + str + " *([!*$^=]*) *" + qstr + "\\]");
1279                         var m = re.exec(t);
1280
1281                         // Re-organize the match
1282                         if ( m ) m = ["", "@", m[2], m[1], m[3]];
1283
1284                         // Handles:
1285                         // [div], [.foo]
1286                         if ( !m ) {
1287                                 re = new RegExp("^(\\[)" + qstr + "\\]");
1288                                 m = re.exec(t);
1289                         }
1290
1291                         // Handles:
1292                         // :contains(test), :not(.foo)
1293                         if ( !m ) {
1294                                 re = new RegExp("^(:)" + str + "\\(" + qstr + "\\)");
1295                                 m = re.exec(t);
1296                         }
1297
1298                         // Handles:
1299                         // :foo, .foo, #foo, foo
1300                         if ( !m ) {
1301                                 re = new RegExp("^([:.#]*)" + str);
1302                                 m = re.exec(t);
1303                         }
1304
1305                         // Remove what we just matched
1306                         t = t.replace( re, "" );
1307
1308                         // :not() is a special case that can be optomized by
1309                         // keeping it out of the expression list
1310                         if ( m[1] == ":" && m[2] == "not" )
1311                                 r = jQuery.filter(m[3],r,false).r;
1312
1313                         // Otherwise, find the expression to execute
1314                         else {
1315                                 var f = jQuery.expr[m[1]];
1316                                 if ( f.constructor != String )
1317                                         f = jQuery.expr[m[1]][m[2]];
1318
1319                                 // Build a custom macro to enclose it
1320                                 eval("f = function(a,i){" +
1321                                         ( m[1] == "@" ? "z=jQuery.attr(a,m[3]);" : "" ) +
1322                                         "return " + f + "}");
1323
1324                                 // Execute it against the current filter
1325                                 r = g( r, f );
1326                         }
1327                 }
1328
1329                 // Return an array of filtered elements (r)
1330                 // and the modified expression string (t)
1331                 return { r: r, t: t };
1332         },
1333
1334         /**
1335          * Remove the whitespace from the beginning and end of a string.
1336          *
1337          * @private
1338          * @name $.trim
1339          * @type String
1340          * @param String str The string to trim.
1341          */
1342         trim: function(t){
1343                 return t.replace(/^\s+|\s+$/g, "");
1344         },
1345
1346         /**
1347          * All ancestors of a given element.
1348          *
1349          * @private
1350          * @name $.parents
1351          * @type Array<Element>
1352          * @param Element elem The element to find the ancestors of.
1353          */
1354         parents: function(a){
1355                 var b = [];
1356                 var c = a.parentNode;
1357                 while ( c && c != document ) {
1358                         b.push( c );
1359                         c = c.parentNode;
1360                 }
1361                 return b;
1362         },
1363
1364         /**
1365          * All elements on a specified axis.
1366          *
1367          * @private
1368          * @name $.sibling
1369          * @type Array
1370          * @param Element elem The element to find all the siblings of (including itself).
1371          */
1372         sibling: function(a,n) {
1373                 var type = [];
1374                 var tmp = a.parentNode.childNodes;
1375                 for ( var i = 0; i < tmp.length; i++ ) {
1376                         if ( tmp[i].nodeType == 1 )
1377                                 type.push( tmp[i] );
1378                         if ( tmp[i] == a )
1379                                 type.n = type.length - 1;
1380                 }
1381                 type.last = type.n == type.length - 1;
1382                 type.cur =
1383                         n == "even" && type.n % 2 == 0 ||
1384                         n == "odd" && type.n % 2 ||
1385                         type[n] == a;
1386                 type.next = type[type.n + 1];
1387                 return type;
1388         },
1389
1390         /**
1391          * Merge two arrays together, removing all duplicates.
1392          *
1393          * @private
1394          * @name $.merge
1395          * @type Array
1396          * @param Array a The first array to merge.
1397          * @param Array b The second array to merge.
1398          */
1399         merge: function(a,b) {
1400                 var d = [];
1401
1402                 // Move b over to the new array (this helps to avoid
1403                 // StaticNodeList instances)
1404                 for ( var k = 0; k < b.length; k++ )
1405                         d[k] = b[k];
1406
1407                 // Now check for duplicates between a and b and only
1408                 // add the unique items
1409                 for ( var i = 0; i < a.length; i++ ) {
1410                         var c = true;
1411
1412                         // The collision-checking process
1413                         for ( var j = 0; j < b.length; j++ )
1414                                 if ( a[i] == b[j] )
1415                                         c = false;
1416
1417                         // If the item is unique, add it
1418                         if ( c )
1419                                 d.push( a[i] );
1420                 }
1421
1422                 return d;
1423         },
1424
1425         /**
1426          * Remove items that aren't matched in an array. The function passed
1427          * in to this method will be passed two arguments: 'a' (which is the
1428          * array item) and 'i' (which is the index of the item in the array).
1429          *
1430          * @private
1431          * @name $.grep
1432          * @type Array
1433          * @param Array array The Array to find items in.
1434          * @param Function fn The function to process each item against.
1435          * @param Boolean inv Invert the selection - select the opposite of the function.
1436          */
1437         grep: function(a,f,s) {
1438                 // If a string is passed in for the function, make a function
1439                 // for it (a handy shortcut)
1440                 if ( f.constructor == String )
1441                         f = new Function("a","i","return " + f);
1442
1443                 var r = [];
1444
1445                 // Go through the array, only saving the items
1446                 // that pass the validator function
1447                 for ( var i = 0; i < a.length; i++ )
1448                         if ( !s && f(a[i],i) || s && !f(a[i],i) )
1449                                 r.push( a[i] );
1450
1451                 return r;
1452         },
1453
1454         /**
1455          * Translate all items in array to another array of items. The translation function
1456          * that is provided to this method is passed one argument: 'a' (the item to be
1457          * translated). If an array is returned, that array is mapped out and merged into
1458          * the full array. Additionally, returning 'null' or 'undefined' will delete the item
1459          * from the array. Both of these changes imply that the size of the array may not
1460          * be the same size upon completion, as it was when it started.
1461          *
1462          * @private
1463          * @name $.map
1464          * @type Array
1465          * @param Array array The Array to translate.
1466          * @param Function fn The function to process each item against.
1467          */
1468         map: function(a,f) {
1469                 // If a string is passed in for the function, make a function
1470                 // for it (a handy shortcut)
1471                 if ( f.constructor == String )
1472                         f = new Function("a","return " + f);
1473
1474                 var r = [];
1475
1476                 // Go through the array, translating each of the items to their
1477                 // new value (or values).
1478                 for ( var i = 0; i < a.length; i++ ) {
1479                         var t = f(a[i],i);
1480                         if ( t !== null && t != undefined ) {
1481                                 if ( t.constructor != Array ) t = [t];
1482                                 r = jQuery.merge( t, r );
1483                         }
1484                 }
1485                 return r;
1486         },
1487
1488         /*
1489          * A number of helper functions used for managing events.
1490          * Many of the ideas behind this code orignated from Dean Edwards' addEvent library.
1491          */
1492         event: {
1493
1494                 // Bind an event to an element
1495                 // Original by Dean Edwards
1496                 add: function(element, type, handler) {
1497                         // For whatever reason, IE has trouble passing the window object
1498                         // around, causing it to be cloned in the process
1499                         if ( jQuery.browser.msie && element.setInterval != undefined )
1500                                 element = window;
1501
1502                         // Make sure that the function being executed has a unique ID
1503                         if ( !handler.guid )
1504                                 handler.guid = this.guid++;
1505
1506                         // Init the element's event structure
1507                         if (!element.events)
1508                                 element.events = {};
1509
1510                         // Get the current list of functions bound to this event
1511                         var handlers = element.events[type];
1512
1513                         // If it hasn't been initialized yet
1514                         if (!handlers) {
1515                                 // Init the event handler queue
1516                                 handlers = element.events[type] = {};
1517
1518                                 // Remember an existing handler, if it's already there
1519                                 if (element["on" + type])
1520                                         handlers[0] = element["on" + type];
1521                         }
1522
1523                         // Add the function to the element's handler list
1524                         handlers[handler.guid] = handler;
1525
1526                         // And bind the global event handler to the element
1527                         element["on" + type] = this.handle;
1528
1529                         // Remember the function in a global list (for triggering)
1530                         if (!this.global[type])
1531                                 this.global[type] = [];
1532                         this.global[type].push( element );
1533                 },
1534
1535                 guid: 1,
1536                 global: {},
1537
1538                 // Detach an event or set of events from an element
1539                 remove: function(element, type, handler) {
1540                         if (element.events)
1541                                 if (type && element.events[type])
1542                                         if ( handler )
1543                                                 delete element.events[type][handler.guid];
1544                                         else
1545                                                 for ( var i in element.events[type] )
1546                                                         delete element.events[type][i];
1547                                 else
1548                                         for ( var j in element.events )
1549                                                 this.remove( element, j );
1550                 },
1551
1552                 trigger: function(type,data,element) {
1553                         // Touch up the incoming data
1554                         data = data || [];
1555
1556                         // Handle a global trigger
1557                         if ( !element ) {
1558                                 var g = this.global[type];
1559                                 if ( g )
1560                                         for ( var i = 0; i < g.length; i++ )
1561                                                 this.trigger( type, data, g[i] );
1562
1563                         // Handle triggering a single element
1564                         } else if ( element["on" + type] ) {
1565                                 // Pass along a fake event
1566                                 data.unshift( this.fix({ type: type, target: element }) );
1567
1568                                 // Trigger the event
1569                                 element["on" + type].apply( element, data );
1570                         }
1571                 },
1572
1573                 handle: function(event) {
1574                         event = event || jQuery.event.fix( window.event );
1575
1576                         // If no correct event was found, fail
1577                         if ( !event ) return;
1578
1579                         var returnValue = true;
1580
1581                         for ( var j in this.events[event.type] ) {
1582                                 if (this.events[event.type][j](event) === false) {
1583                                         event.preventDefault();
1584                                         event.stopPropagation();
1585                                         returnValue = false;
1586                                 }
1587                         }
1588
1589                         return returnValue;
1590                 },
1591
1592                 fix: function(event) {
1593                         if ( event ) {
1594                                 event.preventDefault = function() {
1595                                         this.returnValue = false;
1596                                 };
1597
1598                                 event.stopPropagation = function() {
1599                                         this.cancelBubble = true;
1600                                 };
1601                         }
1602
1603                         return event;
1604                 }
1605
1606         }
1607 });