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 && jQuery.fn.ready )
  23                 return jQuery(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 jQuery(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, args ) {
 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], args || [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                         return this.each( n, arguments );
 940                 };
 941         };
 942
 943         var attr = {
 944                 val: "value",
 945                 html: "innerHTML",
 946                 value: null,
 947                 id: null,
 948                 title: null,
 949                 name: null,
 950                 href: null,
 951                 src: null,
 952                 rel: null
 953         };
 954
 955         for ( var i in attr ) new function() {
 956                 var n = attr[i];
 957                 jQuery.fn[ i ] = function(h) {
 958                         return h == undefined ?
 959                                 this.length ? this[0][n] : null :
 960                                 this.attr( n, h );
 961                 };
 962         }
 963
 964         var css = "width,height,top,left,position,float,overflow,color,background".split(",");
 965
 966         for ( var i in css ) new function() {
 967                 var n = css[i];
 968                 jQuery.fn[ i ] = function(h) {
 969                         return h == undefined ?
 970                                 this.length ? jQuery.css( this[0], n ) : null :
 971                                 this.css( n, h );
 972                 };
 973         }
 974
 975 }
 976
 977 jQuery.extend({
 978         className: {
 979                 add: function(o,c){
 980                         if (jQuery.className.has(o,c)) return;
 981                         o.className += ( o.className ? " " : "" ) + c;
 982                 },
 983                 remove: function(o,c){
 984                         o.className = !c ? "" :
 985                                 o.className.replace(
 986                                         new RegExp("(^|\\s*\\b[^-])"+c+"($|\\b(?=[^-]))", "g"), "");
 987                 },
 988                 has: function(e,a) {
 989                         if ( e.className )
 990                                 e = e.className;
 991                         return new RegExp("(^|\\s)" + a + "(\\s|$)").test(e);
 992                 }
 993         },
 994
 995         /**
 996          * Swap in/out style options.
 997          * @private
 998          */
 999         swap: function(e,o,f) {
1000                 for ( var i in o ) {
1001                         e.style["old"+i] = e.style[i];
1002                         e.style[i] = o[i];
1003                 }
1004                 f.apply( e, [] );
1005                 for ( var i in o )
1006                         e.style[i] = e.style["old"+i];
1007         },
1008
1009         css: function(e,p) {
1010                 if ( p == "height" || p == "width" ) {
1011                         var old = {}, oHeight, oWidth, d = ["Top","Bottom","Right","Left"];
1012
1013                         for ( var i in d ) {
1014                                 old["padding" + d[i]] = 0;
1015                                 old["border" + d[i] + "Width"] = 0;
1016                         }
1017
1018                         jQuery.swap( e, old, function() {
1019                                 if (jQuery.css(e,"display") != "none") {
1020                                         oHeight = e.offsetHeight;
1021                                         oWidth = e.offsetWidth;
1022                                 } else
1023                                         jQuery.swap( e, { visibility: "hidden", position: "absolute", display: "" },
1024                                                 function(){
1025                                                         oHeight = e.clientHeight;
1026                                                         oWidth = e.clientWidth;
1027                                                 });
1028                         });
1029
1030                         return p == "height" ? oHeight : oWidth;
1031                 }
1032
1033                 var r;
1034
1035                 if (e.style[p])
1036                         r = e.style[p];
1037                 else if (e.currentStyle)
1038                         r = e.currentStyle[p];
1039                 else if (document.defaultView && document.defaultView.getComputedStyle) {
1040                         p = p.replace(/([A-Z])/g,"-$1").toLowerCase();
1041                         var s = document.defaultView.getComputedStyle(e,"");
1042                         r = s ? s.getPropertyValue(p) : null;
1043                 }
1044
1045                 return r;
1046         },
1047
1048         clean: function(a) {
1049                 var r = [];
1050                 for ( var i = 0; i < a.length; i++ ) {
1051                         if ( a[i].constructor == String ) {
1052
1053                                 if ( !a[i].indexOf("<tr") ) {
1054                                         var tr = true;
1055                                         a[i] = "<table>" + a[i] + "</table>";
1056                                 } else if ( !a[i].indexOf("<td") || !a[i].indexOf("<th") ) {
1057                                         var td = true;
1058                                         a[i] = "<table><tbody><tr>" + a[i] + "</tr></tbody></table>";
1059                                 }
1060
1061                                 var div = document.createElement("div");
1062                                 div.innerHTML = a[i];
1063
1064                                 if ( tr || td ) {
1065                                         div = div.firstChild.firstChild;
1066                                         if ( td ) div = div.firstChild;
1067                                 }
1068
1069                                 for ( var j = 0; j < div.childNodes.length; j++ )
1070                                         r.push( div.childNodes[j] );
1071                         } else if ( a[i].jquery || a[i].length && !a[i].nodeType )
1072                                 for ( var k = 0; k < a[i].length; k++ )
1073                                         r.push( a[i][k] );
1074                         else if ( a[i] !== null )
1075                                 r.push( a[i].nodeType ? a[i] : document.createTextNode(a[i].toString()) );
1076                 }
1077                 return r;
1078         },
1079
1080         expr: {
1081                 "": "m[2]== '*'||a.nodeName.toUpperCase()==m[2].toUpperCase()",
1082                 "#": "a.getAttribute('id')&&a.getAttribute('id')==m[2]",
1083                 ":": {
1084                         // Position Checks
1085                         lt: "i<m[3]-0",
1086                         gt: "i>m[3]-0",
1087                         nth: "m[3]-0==i",
1088                         eq: "m[3]-0==i",
1089                         first: "i==0",
1090                         last: "i==r.length-1",
1091                         even: "i%2==0",
1092                         odd: "i%2",
1093
1094                         // Child Checks
1095                         "first-child": "jQuery.sibling(a,0).cur",
1096                         "last-child": "jQuery.sibling(a,0).last",
1097                         "only-child": "jQuery.sibling(a).length==1",
1098
1099                         // Parent Checks
1100                         parent: "a.childNodes.length",
1101                         empty: "!a.childNodes.length",
1102
1103                         // Text Check
1104                         contains: "(a.innerText||a.innerHTML).indexOf(m[3])>=0",
1105
1106                         // Visibility
1107                         visible: "jQuery.css(a,'display')!='none'&&jQuery.css(a,'visibility')!='hidden'",
1108                         hidden: "jQuery.css(a,'display')=='none'||jQuery.css(a,'visibility')=='hidden'",
1109
1110                         // Form elements
1111                         enabled: "!a.disabled",
1112                         disabled: "a.disabled",
1113                         checked: "a.checked"
1114                 },
1115                 ".": "jQuery.className.has(a,m[2])",
1116                 "@": {
1117                         "=": "z==m[4]",
1118                         "!=": "z!=m[4]",
1119                         "^=": "!z.indexOf(m[4])",
1120                         "$=": "z.substr(z.length - m[4].length,m[4].length)==m[4]",
1121                         "*=": "z.indexOf(m[4])>=0",
1122                         "": "z"
1123                 },
1124                 "[": "jQuery.find(m[2],a).length"
1125         },
1126
1127         token: [
1128                 "\\.\\.|/\\.\\.", "a.parentNode",
1129                 ">|/", "jQuery.sibling(a.firstChild)",
1130                 "\\+", "jQuery.sibling(a).next",
1131                 "~", function(a){
1132                         var r = [];
1133                         var s = jQuery.sibling(a);
1134                         if ( s.n > 0 )
1135                                 for ( var i = s.n; i < s.length; i++ )
1136                                         r.push( s[i] );
1137                         return r;
1138                 }
1139         ],
1140
1141         find: function( t, context ) {
1142                 // Make sure that the context is a DOM Element
1143                 if ( context && context.getElementsByTagName == undefined )
1144                         context = null;
1145
1146                 // Set the correct context (if none is provided)
1147                 context = context || jQuery.context || document;
1148
1149                 if ( t.constructor != String ) return [t];
1150
1151                 if ( !t.indexOf("//") ) {
1152                         context = context.documentElement;
1153                         t = t.substr(2,t.length);
1154                 } else if ( !t.indexOf("/") ) {
1155                         context = context.documentElement;
1156                         t = t.substr(1,t.length);
1157                         // FIX Assume the root element is right :(
1158                         if ( t.indexOf("/") >= 1 )
1159                                 t = t.substr(t.indexOf("/"),t.length);
1160                 }
1161
1162                 var ret = [context];
1163                 var done = [];
1164                 var last = null;
1165
1166                 while ( t.length > 0 && last != t ) {
1167                         var r = [];
1168                         last = t;
1169
1170                         t = jQuery.trim(t).replace( /^\/\//i, "" );
1171
1172                         var foundToken = false;
1173
1174                         for ( var i = 0; i < jQuery.token.length; i += 2 ) {
1175                                 var re = new RegExp("^(" + jQuery.token[i] + ")");
1176                                 var m = re.exec(t);
1177
1178                                 if ( m ) {
1179                                         r = ret = jQuery.map( ret, jQuery.token[i+1] );
1180                                         t = jQuery.trim( t.replace( re, "" ) );
1181                                         foundToken = true;
1182                                 }
1183                         }
1184
1185                         if ( !foundToken ) {
1186                                 if ( !t.indexOf(",") || !t.indexOf("|") ) {
1187                                         if ( ret[0] == context ) ret.shift();
1188                                         done = jQuery.merge( done, ret );
1189                                         r = ret = [context];
1190                                         t = " " + t.substr(1,t.length);
1191                                 } else {
1192                                         var re2 = /^([#.]?)([a-z0-9\\*_-]*)/i;
1193                                         var m = re2.exec(t);
1194
1195                                         if ( m[1] == "#" ) {
1196                                                 // Ummm, should make this work in all XML docs
1197                                                 var oid = document.getElementById(m[2]);
1198                                                 r = ret = oid ? [oid] : [];
1199                                                 t = t.replace( re2, "" );
1200                                         } else {
1201                                                 if ( !m[2] || m[1] == "." ) m[2] = "*";
1202
1203                                                 for ( var i = 0; i < ret.length; i++ )
1204                                                         r = jQuery.merge( r,
1205                                                                 m[2] == "*" ?
1206                                                                         jQuery.getAll(ret[i]) :
1207                                                                         ret[i].getElementsByTagName(m[2])
1208                                                         );
1209                                         }
1210                                 }
1211                         }
1212
1213                         if ( t ) {
1214                                 var val = jQuery.filter(t,r);
1215                                 ret = r = val.r;
1216                                 t = jQuery.trim(val.t);
1217                         }
1218                 }
1219
1220                 if ( ret && ret[0] == context ) ret.shift();
1221                 done = jQuery.merge( done, ret );
1222
1223                 return done;
1224         },
1225
1226         getAll: function(o,r) {
1227                 r = r || [];
1228                 var s = o.childNodes;
1229                 for ( var i = 0; i < s.length; i++ )
1230                         if ( s[i].nodeType == 1 ) {
1231                                 r.push( s[i] );
1232                                 jQuery.getAll( s[i], r );
1233                         }
1234                 return r;
1235         },
1236
1237         attr: function(o,a,v){
1238                 if ( a && a.constructor == String ) {
1239                         var fix = {
1240                                 "for": "htmlFor",
1241                                 "class": "className",
1242                                 "float": "cssFloat"
1243                         };
1244
1245                         a = (fix[a] && fix[a].replace && fix[a] || a)
1246                                 .replace(/-([a-z])/ig,function(z,b){
1247                                         return b.toUpperCase();
1248                                 });
1249
1250                         if ( v != undefined ) {
1251                                 o[a] = v;
1252                                 if ( o.setAttribute && a != "disabled" )
1253                                         o.setAttribute(a,v);
1254                         }
1255
1256                         return o[a] || o.getAttribute && o.getAttribute(a) || "";
1257                 } else
1258                         return "";
1259         },
1260
1261         filter: function(t,r,not) {
1262                 // Figure out if we're doing regular, or inverse, filtering
1263                 var g = not !== false ? jQuery.grep :
1264                         function(a,f) {return jQuery.grep(a,f,true);};
1265
1266                 // Look for a string-like sequence
1267                 var str = "([a-zA-Z*_-][a-zA-Z0-9_-]*)";
1268
1269                 // Look for something (optionally) enclosed with quotes
1270                 var qstr = " *'?\"?([^'\"]*)'?\"? *";
1271
1272                 while ( t && /^[a-zA-Z\[*:.#]/.test(t) ) {
1273                         // Handles:
1274                         // [@foo], [@foo=bar], etc.
1275                         var re = new RegExp("^\\[ *@" + str + " *([!*$^=]*) *" + qstr + "\\]");
1276                         var m = re.exec(t);
1277
1278                         // Re-organize the match
1279                         if ( m ) m = ["", "@", m[2], m[1], m[3]];
1280
1281                         // Handles:
1282                         // [div], [.foo]
1283                         if ( !m ) {
1284                                 re = new RegExp("^(\\[)" + qstr + "\\]");
1285                                 m = re.exec(t);
1286                         }
1287
1288                         // Handles:
1289                         // :contains(test), :not(.foo)
1290                         if ( !m ) {
1291                                 re = new RegExp("^(:)" + str + "\\(" + qstr + "\\)");
1292                                 m = re.exec(t);
1293                         }
1294
1295                         // Handles:
1296                         // :foo, .foo, #foo, foo
1297                         if ( !m ) {
1298                                 re = new RegExp("^([:.#]*)" + str);
1299                                 m = re.exec(t);
1300                         }
1301
1302                         // Remove what we just matched
1303                         t = t.replace( re, "" );
1304
1305                         // :not() is a special case that can be optomized by
1306                         // keeping it out of the expression list
1307                         if ( m[1] == ":" && m[2] == "not" )
1308                                 r = jQuery.filter(m[3],r,false).r;
1309
1310                         // Otherwise, find the expression to execute
1311                         else {
1312                                 var f = jQuery.expr[m[1]];
1313                                 if ( f.constructor != String )
1314                                         f = jQuery.expr[m[1]][m[2]];
1315
1316                                 // Build a custom macro to enclose it
1317                                 eval("f = function(a,i){" +
1318                                         ( m[1] == "@" ? "z=jQuery.attr(a,m[3]);" : "" ) +
1319                                         "return " + f + "}");
1320
1321                                 // Execute it against the current filter
1322                                 r = g( r, f );
1323                         }
1324                 }
1325
1326                 // Return an array of filtered elements (r)
1327                 // and the modified expression string (t)
1328                 return { r: r, t: t };
1329         },
1330
1331         /**
1332          * Remove the whitespace from the beginning and end of a string.
1333          *
1334          * @private
1335          * @name $.trim
1336          * @type String
1337          * @param String str The string to trim.
1338          */
1339         trim: function(t){
1340                 return t.replace(/^\s+|\s+$/g, "");
1341         },
1342
1343         /**
1344          * All ancestors of a given element.
1345          *
1346          * @private
1347          * @name $.parents
1348          * @type Array<Element>
1349          * @param Element elem The element to find the ancestors of.
1350          */
1351         parents: function(a){
1352                 var b = [];
1353                 var c = a.parentNode;
1354                 while ( c && c != document ) {
1355                         b.push( c );
1356                         c = c.parentNode;
1357                 }
1358                 return b;
1359         },
1360
1361         /**
1362          * All elements on a specified axis.
1363          *
1364          * @private
1365          * @name $.sibling
1366          * @type Array
1367          * @param Element elem The element to find all the siblings of (including itself).
1368          */
1369         sibling: function(a,n) {
1370                 var type = [];
1371                 var tmp = a.parentNode.childNodes;
1372                 for ( var i = 0; i < tmp.length; i++ ) {
1373                         if ( tmp[i].nodeType == 1 )
1374                                 type.push( tmp[i] );
1375                         if ( tmp[i] == a )
1376                                 type.n = type.length - 1;
1377                 }
1378                 type.last = type.n == type.length - 1;
1379                 type.cur =
1380                         n == "even" && type.n % 2 == 0 ||
1381                         n == "odd" && type.n % 2 ||
1382                         type[n] == a;
1383                 type.next = type[type.n + 1];
1384                 return type;
1385         },
1386
1387         /**
1388          * Merge two arrays together, removing all duplicates.
1389          *
1390          * @private
1391          * @name $.merge
1392          * @type Array
1393          * @param Array a The first array to merge.
1394          * @param Array b The second array to merge.
1395          */
1396         merge: function(a,b) {
1397                 var d = [];
1398
1399                 // Move b over to the new array (this helps to avoid
1400                 // StaticNodeList instances)
1401                 for ( var k = 0; k < b.length; k++ )
1402                         d[k] = b[k];
1403
1404                 // Now check for duplicates between a and b and only
1405                 // add the unique items
1406                 for ( var i = 0; i < a.length; i++ ) {
1407                         var c = true;
1408
1409                         // The collision-checking process
1410                         for ( var j = 0; j < b.length; j++ )
1411                                 if ( a[i] == b[j] )
1412                                         c = false;
1413
1414                         // If the item is unique, add it
1415                         if ( c )
1416                                 d.push( a[i] );
1417                 }
1418
1419                 return d;
1420         },
1421
1422         /**
1423          * Remove items that aren't matched in an array. The function passed
1424          * in to this method will be passed two arguments: 'a' (which is the
1425          * array item) and 'i' (which is the index of the item in the array).
1426          *
1427          * @private
1428          * @name $.grep
1429          * @type Array
1430          * @param Array array The Array to find items in.
1431          * @param Function fn The function to process each item against.
1432          * @param Boolean inv Invert the selection - select the opposite of the function.
1433          */
1434         grep: function(a,f,s) {
1435                 // If a string is passed in for the function, make a function
1436                 // for it (a handy shortcut)
1437                 if ( f.constructor == String )
1438                         f = new Function("a","i","return " + f);
1439
1440                 var r = [];
1441
1442                 // Go through the array, only saving the items
1443                 // that pass the validator function
1444                 for ( var i = 0; i < a.length; i++ )
1445                         if ( !s && f(a[i],i) || s && !f(a[i],i) )
1446                                 r.push( a[i] );
1447
1448                 return r;
1449         },
1450
1451         /**
1452          * Translate all items in array to another array of items. The translation function
1453          * that is provided to this method is passed one argument: 'a' (the item to be
1454          * translated). If an array is returned, that array is mapped out and merged into
1455          * the full array. Additionally, returning 'null' or 'undefined' will delete the item
1456          * from the array. Both of these changes imply that the size of the array may not
1457          * be the same size upon completion, as it was when it started.
1458          *
1459          * @private
1460          * @name $.map
1461          * @type Array
1462          * @param Array array The Array to translate.
1463          * @param Function fn The function to process each item against.
1464          */
1465         map: function(a,f) {
1466                 // If a string is passed in for the function, make a function
1467                 // for it (a handy shortcut)
1468                 if ( f.constructor == String )
1469                         f = new Function("a","return " + f);
1470
1471                 var r = [];
1472
1473                 // Go through the array, translating each of the items to their
1474                 // new value (or values).
1475                 for ( var i = 0; i < a.length; i++ ) {
1476                         var t = f(a[i],i);
1477                         if ( t !== null && t != undefined ) {
1478                                 if ( t.constructor != Array ) t = [t];
1479                                 r = jQuery.merge( t, r );
1480                         }
1481                 }
1482                 return r;
1483         },
1484
1485         /*
1486          * A number of helper functions used for managing events.
1487          * Many of the ideas behind this code orignated from Dean Edwards' addEvent library.
1488          */
1489         event: {
1490
1491                 // Bind an event to an element
1492                 // Original by Dean Edwards
1493                 add: function(element, type, handler) {
1494                         // For whatever reason, IE has trouble passing the window object
1495                         // around, causing it to be cloned in the process
1496                         if ( jQuery.browser.msie && element.setInterval != undefined )
1497                                 element = window;
1498
1499                         // Make sure that the function being executed has a unique ID
1500                         if ( !handler.guid )
1501                                 handler.guid = this.guid++;
1502
1503                         // Init the element's event structure
1504                         if (!element.events)
1505                                 element.events = {};
1506
1507                         // Get the current list of functions bound to this event
1508                         var handlers = element.events[type];
1509
1510                         // If it hasn't been initialized yet
1511                         if (!handlers) {
1512                                 // Init the event handler queue
1513                                 handlers = element.events[type] = {};
1514
1515                                 // Remember an existing handler, if it's already there
1516                                 if (element["on" + type])
1517                                         handlers[0] = element["on" + type];
1518                         }
1519
1520                         // Add the function to the element's handler list
1521                         handlers[handler.guid] = handler;
1522
1523                         // And bind the global event handler to the element
1524                         element["on" + type] = this.handle;
1525
1526                         // Remember the function in a global list (for triggering)
1527                         if (!this.global[type])
1528                                 this.global[type] = [];
1529                         this.global[type].push( element );
1530                 },
1531
1532                 guid: 1,
1533                 global: {},
1534
1535                 // Detach an event or set of events from an element
1536                 remove: function(element, type, handler) {
1537                         if (element.events)
1538                                 if (type && element.events[type])
1539                                         if ( handler )
1540                                                 delete element.events[type][handler.guid];
1541                                         else
1542                                                 for ( var i in element.events[type] )
1543                                                         delete element.events[type][i];
1544                                 else
1545                                         for ( var j in element.events )
1546                                                 this.remove( element, j );
1547                 },
1548
1549                 trigger: function(type,data,element) {
1550                         // Touch up the incoming data
1551                         data = data || [];
1552
1553                         // Handle a global trigger
1554                         if ( !element ) {
1555                                 var g = this.global[type];
1556                                 if ( g )
1557                                         for ( var i = 0; i < g.length; i++ )
1558                                                 this.trigger( type, data, g[i] );
1559
1560                         // Handle triggering a single element
1561                         } else if ( element["on" + type] ) {
1562                                 // Pass along a fake event
1563                                 data.unshift( this.fix({ type: type, target: element }) );
1564
1565                                 // Trigger the event
1566                                 element["on" + type].apply( element, data );
1567                         }
1568                 },
1569
1570                 handle: function(event) {
1571                         event = event || jQuery.event.fix( window.event );
1572
1573                         // If no correct event was found, fail
1574                         if ( !event ) return;
1575
1576                         var returnValue = true;
1577
1578                         var c = this.events[event.type];
1579
1580                         for ( var j in c ) {
1581                                 if ( c[j].apply( this, [event] ) === false ) {
1582                                         event.preventDefault();
1583                                         event.stopPropagation();
1584                                         returnValue = false;
1585                                 }
1586                         }
1587
1588                         return returnValue;
1589                 },
1590
1591                 fix: function(event) {
1592                         if ( event ) {
1593                                 event.preventDefault = function() {
1594                                         this.returnValue = false;
1595                                 };
1596
1597                                 event.stopPropagation = function() {
1598                                         this.cancelBubble = true;
1599                                 };
1600                         }
1601
1602                         return event;
1603                 }
1604
1605         }
1606 });