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                 parents: jQuery.parents,
 768                 next: "a.nextSibling",
 769                 prev: "a.previousSibling",
 770                 siblings: jQuery.sibling
 771         };
 772
 773         for ( var i in axis ) new function(){
 774                 var t = axis[i];
 775                 jQuery.fn[ i ] = function(a) {
 776                         var ret = jQuery.map(this,t);
 777                         if ( a ) ret = jQuery.filter(a,ret).r;
 778                         return this.pushStack( ret, arguments );
 779                 };
 780         }
 781
 782         /*var to = ["append","prepend","before","after"];
 783
 784         for ( var i = 0; i < to.length; i++ ) new function(){
 785                 var n = to[i];
 786                 jQuery.fn[ n + "To" ] = function(){
 787                         var a = arguments;
 788                         return this.each(function(){
 789                                 for ( var i = 0; i < a.length; i++ )
 790                                         $(a[i])[n]( this );
 791                         });
 792                 };
 793         }*/
 794
 795         var each = {
 796                 show: function(){
 797                         this.style.display = this.oldblock ? this.oldblock : "";
 798                         if ( jQuery.css(this,"display") == "none" )
 799                                 this.style.display = "block";
 800                 },
 801
 802                 hide: function(){
 803                         this.oldblock = jQuery.css(this,"display");
 804                         if ( this.oldblock == "none" )
 805                                 this.oldblock = "block";
 806                         this.style.display = "none";
 807                 },
 808
 809                 toggle: function(){
 810                         var d = jQuery.css(this,"display");
 811                         $(this)[ !d || d == "none" ? "show" : "hide" ]();
 812                 },
 813
 814                 addClass: function(c){
 815                         jQuery.className.add(this,c);
 816                 },
 817
 818                 removeClass: function(c){
 819                         jQuery.className.remove(this,c);
 820                 },
 821
 822                 toggleClass: function( c ){
 823                         jQuery.className[ jQuery.className.has(this,a) ? "remove" : "add" ](this,c);
 824                 },
 825
 826                 remove: function(a){
 827                         if ( !a || jQuery.filter( [this], a ).r )
 828                                 this.parentNode.removeChild( this );
 829                 },
 830
 831                 empty: function(){
 832                         while ( this.firstChild )
 833                                 this.removeChild( this.firstChild );
 834                 },
 835
 836                 bind: function( type, fn ) {
 837                         jQuery.event.add( this, type, fn );
 838                 },
 839
 840                 unbind: function( type, fn ) {
 841                         jQuery.event.remove( this, type, fn );
 842                 },
 843
 844                 trigger: function( type ) {
 845                         jQuery.event.trigger( this, type );
 846                 }
 847         };
 848
 849         for ( var i in each ) new function() {
 850                 var n = each[i];
 851                 jQuery.fn[ i ] = function() {
 852                         var args = arguments;
 853                         return this.each(function(){
 854                                 n.apply( this, args );
 855                         });
 856                 };
 857         }
 858
 859         var attr = {
 860                 val: "value",
 861                 html: "innerHTML",
 862                 value: null,
 863                 id: null,
 864                 title: null,
 865                 name: null,
 866                 href: null,
 867                 src: null,
 868                 rel: null
 869         };
 870
 871         for ( var i in attr ) new function() {
 872                 var n = attr[i];
 873                 jQuery.fn[ i ] = function(h) {
 874                         return h == undefined ?
 875                                 this.length ? this[0][n] : null :
 876                                 this.attr( n, h );
 877                 };
 878         }
 879
 880         var css = "width,height,top,left,position,float,overflow,color,background".split(",");
 881
 882         for ( var i in css ) new function() {
 883                 var n = css[i];
 884                 jQuery.fn[ i ] = function(h) {
 885                         return h == undefined ?
 886                                 this.length ? jQuery.css( this[0], n ) : null :
 887                                 this.css( n, h );
 888                 };
 889         }
 890
 891 }
 892
 893 jQuery.extend({
 894         className: {
 895                 add: function(o,c){
 896                         if (jQuery.className.has(o,c)) return;
 897                         o.className += ( o.className ? " " : "" ) + c;
 898                 },
 899                 remove: function(o,c){
 900                         o.className = !c ? "" :
 901                                 o.className.replace(
 902                                         new RegExp("(^|\\s*\\b[^-])"+c+"($|\\b(?=[^-]))", "g"), "");
 903                 },
 904                 has: function(e,a) {
 905                         if ( e.className )
 906                                 e = e.className;
 907                         return new RegExp("(^|\\s)" + a + "(\\s|$)").test(e);
 908                 }
 909         },
 910
 911         /**
 912          * Swap in/out style options.
 913          * @private
 914          */
 915         swap: function(e,o,f) {
 916                 for ( var i in o ) {
 917                         e.style["old"+i] = e.style[i];
 918                         e.style[i] = o[i];
 919                 }
 920                 f.apply( e, [] );
 921                 for ( var i in o )
 922                         e.style[i] = e.style["old"+i];
 923         },
 924
 925         css: function(e,p) {
 926                 if ( p == "height" || p == "width" ) {
 927                         var old = {}, oHeight, oWidth, d = ["Top","Bottom","Right","Left"];
 928
 929                         for ( var i in d ) {
 930                                 old["padding" + d[i]] = 0;
 931                                 old["border" + d[i] + "Width"] = 0;
 932                         }
 933
 934                         jQuery.swap( e, old, function() {
 935                                 if (jQuery.css(e,"display") != "none") {
 936                                         oHeight = e.offsetHeight;
 937                                         oWidth = e.offsetWidth;
 938                                 } else
 939                                         jQuery.swap( e, { visibility: "hidden", position: "absolute", display: "" },
 940                                                 function(){
 941                                                         oHeight = e.clientHeight;
 942                                                         oWidth = e.clientWidth;
 943                                                 });
 944                         });
 945
 946                         return p == "height" ? oHeight : oWidth;
 947                 }
 948
 949                 var r;
 950
 951                 if (e.style[p])
 952                         r = e.style[p];
 953                 else if (e.currentStyle)
 954                         r = e.currentStyle[p];
 955                 else if (document.defaultView && document.defaultView.getComputedStyle) {
 956                         p = p.replace(/([A-Z])/g,"-$1").toLowerCase();
 957                         var s = document.defaultView.getComputedStyle(e,"");
 958                         r = s ? s.getPropertyValue(p) : null;
 959                 }
 960
 961                 return r;
 962         },
 963
 964         clean: function(a) {
 965                 var r = [];
 966                 for ( var i = 0; i < a.length; i++ ) {
 967                         if ( a[i].constructor == String ) {
 968
 969                                 if ( !a[i].indexOf("<tr") ) {
 970                                         var tr = true;
 971                                         a[i] = "<table>" + a[i] + "</table>";
 972                                 } else if ( !a[i].indexOf("<td") || !a[i].indexOf("<th") ) {
 973                                         var td = true;
 974                                         a[i] = "<table><tbody><tr>" + a[i] + "</tr></tbody></table>";
 975                                 }
 976
 977                                 var div = document.createElement("div");
 978                                 div.innerHTML = a[i];
 979
 980                                 if ( tr || td ) {
 981                                         div = div.firstChild.firstChild;
 982                                         if ( td ) div = div.firstChild;
 983                                 }
 984
 985                                 for ( var j = 0; j < div.childNodes.length; j++ )
 986                                         r.push( div.childNodes[j] );
 987                         } else if ( a[i].jquery || a[i].length && !a[i].nodeType )
 988                                 for ( var k = 0; k < a[i].length; k++ )
 989                                         r.push( a[i][k] );
 990                         else if ( a[i] !== null )
 991                                 r.push( a[i].nodeType ? a[i] : document.createTextNode(a[i].toString()) );
 992                 }
 993                 return r;
 994         },
 995
 996         expr: {
 997                 "": "m[2]== '*'||a.nodeName.toUpperCase()==m[2].toUpperCase()",
 998                 "#": "a.getAttribute('id')&&a.getAttribute('id')==m[2]",
 999                 ":": {
1000                         // Position Checks
1001                         lt: "i<m[3]-0",
1002                         gt: "i>m[3]-0",
1003                         nth: "m[3]-0==i",
1004                         eq: "m[3]-0==i",
1005                         first: "i==0",
1006                         last: "i==r.length-1",
1007                         even: "i%2==0",
1008                         odd: "i%2",
1009
1010                         // Child Checks
1011                         "first-child": "jQuery.sibling(a,0).cur",
1012                         "last-child": "jQuery.sibling(a,0).last",
1013                         "only-child": "jQuery.sibling(a).length==1",
1014
1015                         // Parent Checks
1016                         parent: "a.childNodes.length",
1017                         empty: "!a.childNodes.length",
1018
1019                         // Text Check
1020                         contains: "(a.innerText||a.innerHTML).indexOf(m[3])>=0",
1021
1022                         // Visibility
1023                         visible: "jQuery.css(a,'display')!='none'&&jQuery.css(a,'visibility')!='hidden'",
1024                         hidden: "jQuery.css(a,'display')=='none'||jQuery.css(a,'visibility')=='hidden'",
1025
1026                         // Form elements
1027                         enabled: "!a.disabled",
1028                         disabled: "a.disabled",
1029                         checked: "a.checked"
1030                 },
1031                 ".": "jQuery.className.has(a,m[2])",
1032                 "@": {
1033                         "=": "z==m[4]",
1034                         "!=": "z!=m[4]",
1035                         "^=": "!z.indexOf(m[4])",
1036                         "$=": "z.substr(z.length - m[4].length,m[4].length)==m[4]",
1037                         "*=": "z.indexOf(m[4])>=0",
1038                         "": "z"
1039                 },
1040                 "[": "jQuery.find(m[2],a).length"
1041         },
1042
1043         token: [
1044                 "\\.\\.|/\\.\\.", "a.parentNode",
1045                 ">|/", "jQuery.sibling(a.firstChild)",
1046                 "\\+", "jQuery.sibling(a).next",
1047                 "~", function(a){
1048                         var r = [];
1049                         var s = jQuery.sibling(a);
1050                         if ( s.n > 0 )
1051                                 for ( var i = s.n; i < s.length; i++ )
1052                                         r.push( s[i] );
1053                         return r;
1054                 }
1055         ],
1056
1057         find: function( t, context ) {
1058                 // Make sure that the context is a DOM Element
1059                 if ( context && context.getElementsByTagName == undefined )
1060                         context = null;
1061
1062                 // Set the correct context (if none is provided)
1063                 context = context || jQuery.context || document;
1064
1065                 if ( t.constructor != String ) return [t];
1066
1067                 if ( !t.indexOf("//") ) {
1068                         context = context.documentElement;
1069                         t = t.substr(2,t.length);
1070                 } else if ( !t.indexOf("/") ) {
1071                         context = context.documentElement;
1072                         t = t.substr(1,t.length);
1073                         // FIX Assume the root element is right :(
1074                         if ( t.indexOf("/") >= 1 )
1075                                 t = t.substr(t.indexOf("/"),t.length);
1076                 }
1077
1078                 var ret = [context];
1079                 var done = [];
1080                 var last = null;
1081
1082                 while ( t.length > 0 && last != t ) {
1083                         var r = [];
1084                         last = t;
1085
1086                         t = jQuery.trim(t).replace( /^\/\//i, "" );
1087
1088                         var foundToken = false;
1089
1090                         for ( var i = 0; i < jQuery.token.length; i += 2 ) {
1091                                 var re = new RegExp("^(" + jQuery.token[i] + ")");
1092                                 var m = re.exec(t);
1093
1094                                 if ( m ) {
1095                                         r = ret = jQuery.map( ret, jQuery.token[i+1] );
1096                                         t = jQuery.trim( t.replace( re, "" ) );
1097                                         foundToken = true;
1098                                 }
1099                         }
1100
1101                         if ( !foundToken ) {
1102                                 if ( !t.indexOf(",") || !t.indexOf("|") ) {
1103                                         if ( ret[0] == context ) ret.shift();
1104                                         done = jQuery.merge( done, ret );
1105                                         r = ret = [context];
1106                                         t = " " + t.substr(1,t.length);
1107                                 } else {
1108                                         var re2 = /^([#.]?)([a-z0-9\\*_-]*)/i;
1109                                         var m = re2.exec(t);
1110
1111                                         if ( m[1] == "#" ) {
1112                                                 // Ummm, should make this work in all XML docs
1113                                                 var oid = document.getElementById(m[2]);
1114                                                 r = ret = oid ? [oid] : [];
1115                                                 t = t.replace( re2, "" );
1116                                         } else {
1117                                                 if ( !m[2] || m[1] == "." ) m[2] = "*";
1118
1119                                                 for ( var i = 0; i < ret.length; i++ )
1120                                                         r = jQuery.merge( r,
1121                                                                 m[2] == "*" ?
1122                                                                         jQuery.getAll(ret[i]) :
1123                                                                         ret[i].getElementsByTagName(m[2])
1124                                                         );
1125                                         }
1126                                 }
1127                         }
1128
1129                         if ( t ) {
1130                                 var val = jQuery.filter(t,r);
1131                                 ret = r = val.r;
1132                                 t = jQuery.trim(val.t);
1133                         }
1134                 }
1135
1136                 if ( ret && ret[0] == context ) ret.shift();
1137                 done = jQuery.merge( done, ret );
1138
1139                 return done;
1140         },
1141
1142         getAll: function(o,r) {
1143                 r = r || [];
1144                 var s = o.childNodes;
1145                 for ( var i = 0; i < s.length; i++ )
1146                         if ( s[i].nodeType == 1 ) {
1147                                 r.push( s[i] );
1148                                 jQuery.getAll( s[i], r );
1149                         }
1150                 return r;
1151         },
1152
1153         attr: function(o,a,v){
1154                 if ( a && a.constructor == String ) {
1155                         var fix = {
1156                                 "for": "htmlFor",
1157                                 "class": "className",
1158                                 "float": "cssFloat"
1159                         };
1160
1161                         a = (fix[a] && fix[a].replace && fix[a] || a)
1162                                 .replace(/-([a-z])/ig,function(z,b){
1163                                         return b.toUpperCase();
1164                                 });
1165
1166                         if ( v != undefined ) {
1167                                 o[a] = v;
1168                                 if ( o.setAttribute && a != "disabled" )
1169                                         o.setAttribute(a,v);
1170                         }
1171
1172                         return o[a] || o.getAttribute && o.getAttribute(a) || "";
1173                 } else
1174                         return "";
1175         },
1176
1177         filter: function(t,r,not) {
1178                 // Figure out if we're doing regular, or inverse, filtering
1179                 var g = not !== false ? jQuery.grep :
1180                         function(a,f) {return jQuery.grep(a,f,true);};
1181
1182                 // Look for a string-like sequence
1183                 var str = "([a-zA-Z*_-][a-zA-Z0-9_-]*)";
1184
1185                 // Look for something (optionally) enclosed with quotes
1186                 var qstr = " *'?\"?([^'\"]*)'?\"? *";
1187
1188                 while ( t && /^[a-zA-Z\[*:.#]/.test(t) ) {
1189                         // Handles:
1190                         // [@foo], [@foo=bar], etc.
1191                         var re = new RegExp("^\\[ *@" + str + " *([!*$^=]*) *" + qstr + "\\]");
1192                         var m = re.exec(t);
1193
1194                         // Re-organize the match
1195                         if ( m ) m = ["", "@", m[2], m[1], m[3]];
1196
1197                         // Handles:
1198                         // [div], [.foo]
1199                         if ( !m ) {
1200                                 re = new RegExp("^(\\[)" + qstr + "\\]");
1201                                 m = re.exec(t);
1202                         }
1203
1204                         // Handles:
1205                         // :contains(test), :not(.foo)
1206                         if ( !m ) {
1207                                 re = new RegExp("^(:)" + str + "\\(" + qstr + "\\)");
1208                                 m = re.exec(t);
1209                         }
1210
1211                         // Handles:
1212                         // :foo, .foo, #foo, foo
1213                         if ( !m ) {
1214                                 re = new RegExp("^([:.#]*)" + str);
1215                                 m = re.exec(t);
1216                         }
1217
1218                         // Remove what we just matched
1219                         t = t.replace( re, "" );
1220
1221                         // :not() is a special case that can be optomized by
1222                         // keeping it out of the expression list
1223                         if ( m[1] == ":" && m[2] == "not" )
1224                                 r = jQuery.filter(m[3],r,false).r;
1225
1226                         // Otherwise, find the expression to execute
1227                         else {
1228                                 var f = jQuery.expr[m[1]];
1229                                 if ( f.constructor != String )
1230                                         f = jQuery.expr[m[1]][m[2]];
1231
1232                                 // Build a custom macro to enclose it
1233                                 eval("f = function(a,i){" +
1234                                         ( m[1] == "@" ? "z=jQuery.attr(a,m[3]);" : "" ) +
1235                                         "return " + f + "}");
1236
1237                                 // Execute it against the current filter
1238                                 r = g( r, f );
1239                         }
1240                 }
1241
1242                 // Return an array of filtered elements (r)
1243                 // and the modified expression string (t)
1244                 return { r: r, t: t };
1245         },
1246
1247         /**
1248          * Remove the whitespace from the beginning and end of a string.
1249          *
1250          * @private
1251          * @name $.trim
1252          * @type String
1253          * @param String str The string to trim.
1254          */
1255         trim: function(t){
1256                 return t.replace(/^\s+|\s+$/g, "");
1257         },
1258
1259         /**
1260          * All ancestors of a given element.
1261          *
1262          * @private
1263          * @name $.parents
1264          * @type Array<Element>
1265          * @param Element elem The element to find the ancestors of.
1266          */
1267         parents: function(a){
1268                 var b = [];
1269                 var c = a.parentNode;
1270                 while ( c && c != document ) {
1271                         b.push( c );
1272                         c = c.parentNode;
1273                 }
1274                 return b;
1275         },
1276
1277         /**
1278          * All elements on a specified axis.
1279          *
1280          * @private
1281          * @name $.sibling
1282          * @type Array
1283          * @param Element elem The element to find all the siblings of (including itself).
1284          */
1285         sibling: function(a,n) {
1286                 var type = [];
1287                 var tmp = a.parentNode.childNodes;
1288                 for ( var i = 0; i < tmp.length; i++ ) {
1289                         if ( tmp[i].nodeType == 1 )
1290                                 type.push( tmp[i] );
1291                         if ( tmp[i] == a )
1292                                 type.n = type.length - 1;
1293                 }
1294                 type.last = type.n == type.length - 1;
1295                 type.cur =
1296                         n == "even" && type.n % 2 == 0 ||
1297                         n == "odd" && type.n % 2 ||
1298                         type[n] == a;
1299                 type.next = type[type.n + 1];
1300                 return type;
1301         },
1302
1303         /**
1304          * Merge two arrays together, removing all duplicates.
1305          *
1306          * @private
1307          * @name $.merge
1308          * @type Array
1309          * @param Array a The first array to merge.
1310          * @param Array b The second array to merge.
1311          */
1312         merge: function(a,b) {
1313                 var d = [];
1314
1315                 // Move b over to the new array (this helps to avoid
1316                 // StaticNodeList instances)
1317                 for ( var k = 0; k < b.length; k++ )
1318                         d[k] = b[k];
1319
1320                 // Now check for duplicates between a and b and only
1321                 // add the unique items
1322                 for ( var i = 0; i < a.length; i++ ) {
1323                         var c = true;
1324
1325                         // The collision-checking process
1326                         for ( var j = 0; j < b.length; j++ )
1327                                 if ( a[i] == b[j] )
1328                                         c = false;
1329
1330                         // If the item is unique, add it
1331                         if ( c )
1332                                 d.push( a[i] );
1333                 }
1334
1335                 return d;
1336         },
1337
1338         /**
1339          * Remove items that aren't matched in an array. The function passed
1340          * in to this method will be passed two arguments: 'a' (which is the
1341          * array item) and 'i' (which is the index of the item in the array).
1342          *
1343          * @private
1344          * @name $.grep
1345          * @type Array
1346          * @param Array array The Array to find items in.
1347          * @param Function fn The function to process each item against.
1348          * @param Boolean inv Invert the selection - select the opposite of the function.
1349          */
1350         grep: function(a,f,s) {
1351                 // If a string is passed in for the function, make a function
1352                 // for it (a handy shortcut)
1353                 if ( f.constructor == String )
1354                         f = new Function("a","i","return " + f);
1355
1356                 var r = [];
1357
1358                 // Go through the array, only saving the items
1359                 // that pass the validator function
1360                 for ( var i = 0; i < a.length; i++ )
1361                         if ( !s && f(a[i],i) || s && !f(a[i],i) )
1362                                 r.push( a[i] );
1363
1364                 return r;
1365         },
1366
1367         /**
1368          * Translate all items in array to another array of items. The translation function
1369          * that is provided to this method is passed one argument: 'a' (the item to be
1370          * translated). If an array is returned, that array is mapped out and merged into
1371          * the full array. Additionally, returning 'null' or 'undefined' will delete the item
1372          * from the array. Both of these changes imply that the size of the array may not
1373          * be the same size upon completion, as it was when it started.
1374          *
1375          * @private
1376          * @name $.map
1377          * @type Array
1378          * @param Array array The Array to translate.
1379          * @param Function fn The function to process each item against.
1380          */
1381         map: function(a,f) {
1382                 // If a string is passed in for the function, make a function
1383                 // for it (a handy shortcut)
1384                 if ( f.constructor == String )
1385                         f = new Function("a","return " + f);
1386
1387                 var r = [];
1388
1389                 // Go through the array, translating each of the items to their
1390                 // new value (or values).
1391                 for ( var i = 0; i < a.length; i++ ) {
1392                         var t = f(a[i],i);
1393                         if ( t !== null && t != undefined ) {
1394                                 if ( t.constructor != Array ) t = [t];
1395                                 r = jQuery.merge( t, r );
1396                         }
1397                 }
1398                 return r;
1399         },
1400
1401         /*
1402          * A number of helper functions used for managing events.
1403          * Many of the ideas behind this code orignated from Dean Edwards' addEvent library.
1404          */
1405         event: {
1406
1407                 // Bind an event to an element
1408                 // Original by Dean Edwards
1409                 add: function(element, type, handler) {
1410                         // For whatever reason, IE has trouble passing the window object
1411                         // around, causing it to be cloned in the process
1412                         if ( jQuery.browser.msie && element.setInterval != undefined )
1413                                 element = window;
1414
1415                         // Make sure that the function being executed has a unique ID
1416                         if ( !handler.guid )
1417                                 handler.guid = this.guid++;
1418
1419                         // Init the element's event structure
1420                         if (!element.events)
1421                                 element.events = {};
1422
1423                         // Get the current list of functions bound to this event
1424                         var handlers = element.events[type];
1425
1426                         // If it hasn't been initialized yet
1427                         if (!handlers) {
1428                                 // Init the event handler queue
1429                                 handlers = element.events[type] = {};
1430
1431                                 // Remember an existing handler, if it's already there
1432                                 if (element["on" + type])
1433                                         handlers[0] = element["on" + type];
1434                         }
1435
1436                         // Add the function to the element's handler list
1437                         handlers[handler.guid] = handler;
1438
1439                         // And bind the global event handler to the element
1440                         element["on" + type] = this.handle;
1441
1442                         // Remember the function in a global list (for triggering)
1443                         if (!this.global[type])
1444                                 this.global[type] = [];
1445                         this.global[type].push( element );
1446                 },
1447
1448                 guid: 1,
1449                 global: {},
1450
1451                 // Detach an event or set of events from an element
1452                 remove: function(element, type, handler) {
1453                         if (element.events)
1454                                 if (type && element.events[type])
1455                                         if ( handler )
1456                                                 delete element.events[type][handler.guid];
1457                                         else
1458                                                 for ( var i in element.events[type] )
1459                                                         delete element.events[type][i];
1460                                 else
1461                                         for ( var j in element.events )
1462                                                 this.remove( element, j );
1463                 },
1464
1465                 trigger: function(type,data,element) {
1466                         // Touch up the incoming data
1467                         data = data || [];
1468
1469                         // Handle a global trigger
1470                         if ( !element ) {
1471                                 var g = this.global[type];
1472                                 if ( g )
1473                                         for ( var i = 0; i < g.length; i++ )
1474                                                 this.trigger( type, data, g[i] );
1475
1476                         // Handle triggering a single element
1477                         } else if ( element["on" + type] ) {
1478                                 // Pass along a fake event
1479                                 data.unshift( this.fix({ type: type, target: element }) );
1480
1481                                 // Trigger the event
1482                                 element["on" + type].apply( element, data );
1483                         }
1484                 },
1485
1486                 handle: function(event) {
1487                         event = event || jQuery.event.fix( window.event );
1488
1489                         // If no correct event was found, fail
1490                         if ( !event ) return;
1491
1492                         var returnValue = true;
1493
1494                         for ( var j in this.events[event.type] ) {
1495                                 if (this.events[event.type][j](event) === false) {
1496                                         event.preventDefault();
1497                                         event.stopPropagation();
1498                                         returnValue = false;
1499                                 }
1500                         }
1501
1502                         return returnValue;
1503                 },
1504
1505                 fix: function(event) {
1506                         if ( event ) {
1507                                 event.preventDefault = function() {
1508                                         this.returnValue = false;
1509                                 };
1510
1511                                 event.stopPropagation = function() {
1512                                         this.cancelBubble = true;
1513                                 };
1514                         }
1515
1516                         return event;
1517                 }
1518
1519         }
1520 });