First batch of doc/commenting additions.
[jquery.git] / jquery / jquery.js
index 325793d..6da9d60 100644 (file)
@@ -1,5 +1,5 @@
 /*
- * jQuery
+ * jQuery - New Wave Javascript
  *
  * Copyright (c) 2006 John Resig (jquery.com)
  * Licensed under the MIT License:
 // Global undefined variable
 window.undefined = window.undefined;
 
+/**
+ * Create a new jQuery Object
+ * @constructor
+ */
 function jQuery(a,c) {
-       this.cur = $.Select(
-               a || $.context || document,
-               c && c.$jquery && c.get(0) || c
-       );
-}
 
-if ( window.$ == undefined )
-       var $ = function(a,c) {
+       // Shortcut for document ready (because $(document).each() is silly)
+       if ( a && a.constructor == Function )
+               return $(document).ready(a);
+
+       // Make sure t hat a selection was provided
+       a = a || jQuery.context || document;
+
+       /*
+        * Handle support for overriding other $() functions. Way too many libraries
+        * provide this function to simply ignore it and overwrite it.
+        */
+
+       // Check to see if this is a possible collision case
+       if ( jQuery._$ && !c && a.constructor == String && 
+      
+               // Make sure that the expression is a colliding one
+               !/[^a-zA-Z0-9_-]/.test(a) &&
+        
+               // and that there are no elements that match it
+               // (this is the one truly ambiguous case)
+               !document.getElementsByTagName(a).length )
+
+                       // Use the default method, in case it works some voodoo
+                       return jQuery._$( a );
+
+       // Watch for when a jQuery object is passed as the selector
+       if ( a.jquery )
+               return a;
+
+       // Watch for when a jQuery object is passed at the context
+       if ( c && c.jquery )
+               return $(c.get()).find(a);
+       
+       // If the context is global, return a new object
+       if ( window == this )
                return new jQuery(a,c);
-       };
 
-jQuery.prototype = $.fn = {
-       $jquery: "$Rev$",
+       // Watch for when an array is passed in
+       this.get( a.constructor == Array ?
+               // Assume that it's an array of DOM Elements
+               a :
+
+               // Find the matching elements and save them for later
+               jQuery.Select( a, c ) );
+
+       var fn = arguments[ arguments.length - 1 ];
+       if ( fn && fn.constructor == Function )
+               this.each(fn);
+}
+
+// Map over the $ in case of overwrite
+if ( $ )
+       jQuery._$ = $;
+
+// Map the jQuery namespace to the '$' one
+var $ = jQuery;
+
+jQuery.fn = jQuery.prototype = {
+       /**
+        * The current SVN version of jQuery.
+        *
+        * @private
+        * @property
+        * @name jquery
+        * @type String
+        */
+       jquery: "$Rev$",
+       
+       /**
+        * The number of elements currently matched.
+        *
+        * @property
+        * @name length
+        * @type Number
+        */
        
-       // The only two getters
+       /**
+        * The number of elements currently matched.
+        *
+        * @name size
+        * @type Number
+        */
        size: function() {
-               return this.get().length;
+               return this.length;
        },
-       get: function(i) {
-               return i == undefined ? this.cur : this.cur[i];
+       
+       /**
+        * Access all matched elements. This serves as a backwards-compatible
+        * way of accessing all matched elements (other than the jQuery object
+        * itself, which is, in fact, an array of elements).
+        *
+        * @name get
+        * @type Array<Element>
+        */
+        
+       /**
+        * Access a single matched element. <tt>num</tt> is used to access the 
+        * <tt>num</tt>th element matched.
+        *
+        * @name get
+        * @type Element
+        * @param Number num Access the element in the <tt>num</tt>th position.
+        */
+        
+       /**
+        * Set the jQuery object to an array of elements.
+        *
+        * @private
+        * @name get
+        * @type jQuery
+        * @param Elements elems An array of elements
+        */
+       get: function( num ) {
+               // Watch for when an array (of elements) is passed in
+               if ( num && num.constructor == Array ) {
+               
+                       // Use a tricky hack to make the jQuery object
+                       // look and feel like an array
+                       this.length = 0;
+                       [].push.apply( this, num );
+                       
+                       return this;
+               } else
+                       return num == undefined ?
+
+                               // Return a 'clean' array
+                               $.map( this, function(a){ return a } ) :
+
+                               // Return just the object
+                               this[num];
        },
        
-       each: function(f) {
-               for ( var i = 0; i < this.size(); i++ )
-                       f.apply( this.get(i), [i] );
+       /**
+        * Execute a function within the context of every matched element.
+        * This means that every time the passed-in function is executed
+        * (which is once for every element matched) the 'this' keyword
+        * points to the specific element.
+        *
+        * Additionally, the function, when executed, is passed a single
+        * argument representing the position of the element in the matched
+        * set.
+        *
+        * @name each
+        * @type jQuery
+        * @param Function fn A function to execute
+        */
+       each: function( fn ) {
+               // Iterate through all of the matched elements
+               for ( var i = 0; i < this.length; i++ )
+               
+                       // Execute the function within the context of each element
+                       fn.apply( this[i], [i] );
+               
                return this;
        },
-       set: function(a,b) {
-               return this.each(function(){
-                       if ( b == undefined )
-                               for ( var j in a )
-                                       $.attr(this,j,a[j]);
-                       else
-                               $.attr(this,a,b);
-               });
-       },
-       html: function(h) {
-               return h == undefined && this.size() ?
-                       this.get(0).innerHTML : this.set( "innerHTML", h );
-       },
-       val: function(h) {
-               return h == undefined && this.size() ?
-                       this.get(0).value : this.set( "value", h );
-       },
-       text: function(e) {
-               e = e || this.get();
-               var t = "";
-               for ( var j = 0; j < e.length; j++ )
-                       for ( var i = 0; i < e[j].childNodes.length; i++ )
-                               t += e[j].childNodes[i].nodeType != 1 ?
-                                       e[j].childNodes[i].nodeValue :
-                                       $.fn.text(e[j].childNodes[i].childNodes);
-               return t;
-       },
        
-       css: function(a,b) {
-               return  a.constructor != String || b ?
+       /**
+        * Access a property on the first matched element.
+        * This method makes it easy to retreive a property value
+        * from the first matched element.
+        *
+        * @name attr
+        * @type Object
+        * @param String name The name of the property to access.
+        */
+        
+       /**
+        * Set a hash of key/value object properties to all matched elements.
+        * This serves as the best way to set a large number of properties
+        * on all matched elements.
+        *
+        * @name attr
+        * @type jQuery
+        * @param Hash prop A set of key/value pairs to set as object properties.
+        */
+        
+       /**
+        * Set a single property to a value, on all matched elements.
+        *
+        * @name attr
+        * @type jQuery
+        * @param String key The name of the property to set.
+        * @param Object value The value to set the property to.
+        */
+       attr: function( key, value ) {
+               // Check to see if we're setting style values
+               return key.constructor != String || value ?
                        this.each(function(){
-                               if ( !b )
-                                       for ( var j in a )
-                                               $.attr(this.style,j,a[j]);
+                               // See if we're setting a hash of styles
+                               if ( value == undefined )
+                                       // Set all the styles
+                                       for ( var prop in key )
+                                               jQuery.attr(
+                                                       type ? this.style : this,
+                                                       prop, key[prop]
+                                               );
+                               
+                               // See if we're setting a single key/value style
                                else
-                                       $.attr(this.style,a,b);
-                       }) : $.css( this.get(0), a );
-       },
-       toggle: function() {
-               return this.each(function(){
-                       var d = $.css(this,"display");
-                       if ( d == "none" || d === "" )
-                               $(this).show();
-                       else
-                               $(this).hide();
-               });
-       },
-       show: function() {
-               return this.each(function(){
-                       this.style.display = this.oldblock ? this.oldblock : "";
-                       if ( $.css(this,"display") == "none" )
-                               this.style.display = "block";
-               });
-       },
-       hide: function() {
-               return this.each(function(){
-                       this.oldblock = $.css(this,"display");
-                       if ( this.oldblock == "none" )
-                               this.oldblock = "block";
-                       this.style.display = "none";
-               });
-       },
-       addClass: function(c) {
-               return this.each(function(){
-                       $.class.add(this,c);
-               });
-       },
-       removeClass: function(c) {
-               return this.each(function(){
-                       $.class.remove(this,c);
-               });
+                                       jQuery.attr(
+                                               type ? this.style : this,
+                                               key, value
+                                       );
+                       }) :
+                       
+                       // Look for the case where we're accessing a style value
+                       jQuery[ type || "attr" ]( this[0], key );
        },
-       // TODO: Optomize
-       toggleClass: function(c) {
-               return this.each(function(){
-                       if ($.hasWord(this,c))
-                               $.class.remove(this,c);
-                       else
-                               $.class.add(this,c);
-               });
+       
+       /**
+        * Access a style property on the first matched element.
+        * This method makes it easy to retreive a style property value
+        * from the first matched element.
+        *
+        * @name css
+        * @type Object
+        * @param String name The name of the property to access.
+        */
+        
+       /**
+        * Set a hash of key/value style properties to all matched elements.
+        * This serves as the best way to set a large number of style properties
+        * on all matched elements.
+        *
+        * @name css
+        * @type jQuery
+        * @param Hash prop A set of key/value pairs to set as style properties.
+        */
+        
+       /**
+        * Set a single style property to a value, on all matched elements.
+        *
+        * @name css
+        * @type jQuery
+        * @param String key The name of the property to set.
+        * @param Object value The value to set the property to.
+        */
+       css: function( key, value ) {
+               return this.attr( key, value, "css" );
        },
-       remove: function() {
-               this.each(function(){this.parentNode.removeChild( this );});
-               this.cur = [];
-               return this;
+       
+       /**
+        * Retreive the text contents of all matched elements. The result is
+        * a string that contains the combined text contents of all matched
+        * elements. This method works on both HTML and XML documents.
+        *
+        * @name text
+        * @type String
+        */
+       text: function(e) {
+               e = e || this;
+               var t = "";
+               for ( var j = 0; j < e.length; j++ ) {
+                       var r = e[j].childNodes;
+                       for ( var i = 0; i < r.length; i++ )
+                               t += r[i].nodeType != 1 ?
+                                       r[i].nodeValue : jQuery.fn.text([ r[i] ]);
+               }
+               return t;
        },
        
+       /**
+        * Set a single style property to a value, on all matched elements.
+        *
+        * @name wrap
+        * @type jQuery
+        * @any String html A string of HTML, that will be created on the fly and wrapped around the target.
+        * @any Element elem A DOM element that will be wrapped.
+        * @any Array<Element> elems An array of elements, the first of which will be wrapped.
+        * @any Object 
+        */
        wrap: function() {
-               var a = $.clean(arguments);
+               var a = jQuery.clean(arguments);
                return this.each(function(){
                        var b = a[0].cloneNode(true);
                        this.parentNode.insertBefore( b, this );
@@ -139,152 +301,123 @@ jQuery.prototype = $.fn = {
        },
        
        append: function() {
-               var clone = this.size() > 1;
-               var a = $.clean(arguments);
-               return this.domManip(function(){
-                       for ( var i = 0; i < a.length; i++ )
-                               this.appendChild( clone ? a[i].cloneNode(true) : a[i] );
-               });
-       },
-       
-       appendTo: function() {
-               var a = arguments;
-               return this.each(function(){
-                       for ( var i = 0; i < a.length; i++ )
-                               $(a[i]).append( this );
+               return this.domManip(arguments, true, 1, function(a){
+                       this.appendChild( 1 );
                });
        },
        
        prepend: function() {
-               var clone = this.size() > 1;
-               var a = $.clean(arguments);
-               return this.domManip(function(){
-                       for ( var i = a.length - 1; i >= 0; i-- )
-                               this.insertBefore( clone ? a[i].cloneNode(true) : a[i], this.firstChild );
+               return this.domManip(arguments, true, -1, function(a){
+                       this.insertBefore( a, this.firstChild );
                });
        },
        
        before: function() {
-               var clone = this.size() > 1;
-               var a = $.clean(arguments);
-               return this.each(function(){
-                       for ( var i = 0; i < a.length; i++ )
-                               this.parentNode.insertBefore( clone ? a[i].cloneNode(true) : a[i], this );
+               return this.domManip(arguments, false, 1, function(a){
+                       this.parentNode.insertBefore( a, this );
                });
        },
        
        after: function() {
-               var clone = this.size() > 1;
-               var a = $.clean(arguments);
-               return this.each(function(){
-                       for ( var i = a.length - 1; i >= 0; i-- )
-                               this.parentNode.insertBefore( clone ? a[i].cloneNode(true) : a[i], this.nextSibling );
+               return this.domManip(arguments, false, -1, function(a){
+                       this.parentNode.insertBefore( a, this.nextSibling );
                });
        },
        
-       empty: function() {
+       /**
+        * A wrapper function for each() to be used by append and prepend.
+        * Handles cases where you're trying to modify the inner contents of
+        * a table, when you actually need to work with the tbody.
+        *
+        * @private
+        * @member jQuery
+        * @param {Function} fn The function doing the DOM manipulation.
+        * @type jQuery
+        */
+       domManip: function(args, table, dir, fn){
+               var clone = this.size() > 1;
+               var a = jQuery.clean(args);
+               
                return this.each(function(){
-                       while ( this.firstChild )
-                               this.removeChild( this.firstChild );
-               });
-       },
-       
-       bind: function(t,f) {
-               return this.each(function(){$.event.add(this,t,f);});
-       },
-       unbind: function(t,f) {
-               return this.each(function(){$.event.remove(this,t,f);});
-       },
-       trigger: function(t) {
-               return this.each(function(){$.event.trigger(this,t);});
-       },
+                       var obj = this;
+                       
+                       if ( table && this.nodeName == "TABLE" ) {
+                               var tbody = this.getElementsByTagName("tbody");
+
+                               if ( !tbody.length ) {
+                                       obj = document.createElement("tbody");
+                                       this.appendChild( obj );
+                               } else
+                                       obj = tbody[0];
+                       }
        
-       find: function(t) {
-               var old = [], ret = [];
-               this.each(function(){
-                       old[old.length] = this;
-                       ret = $.merge( ret, $.Select(t,this) );
+                       for ( var i = ( dir < 0 ? a.length - 1 : 0 );
+                               i != ( dir < 0 ? dir : a.length ); i += dir )
+                                       fn.apply( obj, [ a[i] ] );
                });
-               this.old = old;
-               this.cur = ret;
-               return this;
-       },
-       end: function() {
-               this.cur = this.old;
-               return this;
        },
        
-       parent: function(a) {
-               this.cur = $.map(this.cur,"d.parentNode");
-               if ( a ) this.cur = $.filter(a,this.cur).r;
+       pushStack: function(a,args) {
+               var fn = args && args[args.length-1];
+
+               if ( !fn || fn.constructor != Function ) {
+                       if ( !this.stack ) this.stack = [];
+                       this.stack.push( this.get() );
+                       this.get( a );
+               } else {
+                       var old = this.get();
+                       this.get( a );
+                       if ( fn.constructor == Function )
+                               return this.each( fn );
+                       this.get( old );
+               }
+
                return this;
        },
-       
-       parents: function(a) {
-               this.cur = $.map(this.cur,$.parents);
-               if ( a ) this.cur = $.filter(a,this.cur).r;
+
+       end: function() {
+               this.get( this.stack.pop() );
                return this;
        },
        
-       siblings: function(a) {
-               // Incorrect, need to exclude current element
-               this.cur = $.map(this.cur,$.sibling);
-               if ( a ) this.cur = $.filter(a,this.cur).r;
-               return this;
+       find: function(t) {
+               return this.pushStack( jQuery.map( this, function(a){
+                       return jQuery.Select(t,a);
+               }), arguments );
        },
        
        filter: function(t) {
-               this.cur = $.filter(t,this.cur).r;
-               return this;
+               return t.constructor == Array ?
+                       // Multi Filtering
+                       this.pushStack( jQuery.map(this,function(a){
+                               for ( var i = 0; i < t.length; i++ )
+                                       if ( jQuery.filter(t[i],[a]).r.length )
+                                               return a;
+                       }), arguments ) :
+                       
+                       this.pushStack( jQuery.filter(t,this).r, arguments );
        },
        not: function(t) {
-               this.cur = t.constructor == String ?
-                       $.filter(t,this.cur,false).r :
-                       $.grep(this.cur,function(a){ return a != t; });
-               return this;
+               return this.pushStack( t.constructor == String ?
+                       jQuery.filter(t,this,false).r :
+                       jQuery.grep(this,function(a){ return a != t; }), arguments );
        },
        add: function(t) {
-               this.cur = $.merge( this.cur, t.constructor == String ?
-                       $.Select(t) : t.constructor == Array ? t : [t] );
-               return this;
-       },
-       is: function(t) {
-               return $.filter(t,this.cur).r.length > 0;
+               return this.pushStack( jQuery.merge( this, t.constructor == String ?
+                       jQuery.Select(t) : t.constructor == Array ? t : [t] ), arguments );
        },
        
        /**
         * A wrapper function for each() to be used by append and prepend.
         * Handles cases where you're trying to modify the inner contents of
         * a table, when you actually need to work with the tbody.
+        *
+        * @member jQuery
+        * @param {String} expr The expression with which to filter
+        * @type Boolean
         */
-       domManip: function(fn){
-               return this.each(function(){
-                       var obj = this;
-                       
-                       if ( this.nodeName == "TABLE" ) {
-                               var tbody = this.getElementsByTagName("tbody");
-
-                               if ( !tbody.length ) {
-                                       obj = document.createElement("tbody");
-                                       this.appendChild( obj );
-                               } else
-                                       obj = tbody[0];
-                       }
-       
-                       fn.apply( obj );
-               });
-       }
-};
-
-$.class = {
-       add: function(o,c){
-               if ($.hasWord(o,c)) return;
-               o.className += ( o.className.length > 0 ? " " : "" ) + c;
-       },
-       remove: function(o,c){
-               o.className = !c ? "" :
-                       o.className.replace(
-                               new RegExp("(^|\\s*\\b[^-])"+c+"($|\\b(?=[^-]))", "g"), "");
+       is: function(expr) {
+               return jQuery.filter(expr,this).r.length > 0;
        }
 };
 
@@ -292,7 +425,7 @@ $.class = {
        var b = navigator.userAgent.toLowerCase();
 
        // Figure out what browser is being used
-       $.browser =
+       jQuery.browser =
                ( /webkit/.test(b) && "safari" ) ||
                ( /opera/.test(b) && "opera" ) ||
                ( /msie/.test(b) && "msie" ) ||
@@ -300,45 +433,162 @@ $.class = {
                "other";
 
        // Check to see if the W3C box model is being used
-       $.boxModel = ( $.browser != "msie" || document.compatMode == "CSS1Compat" );
-})();
+       jQuery.boxModel = ( jQuery.browser != "msie" || document.compatMode == "CSS1Compat" );
+
+       var axis = {
+               parent: "a.parentNode",
+               parents: jQuery.parents,
+               ancestors: jQuery.parents,
+               next: "a.nextSibling",
+               prev: "a.previousSibling",
+               siblings: jQuery.sibling
+       };
+       
+       for ( var i in axis ) {(function(){
+               var t = axis[i];
+               jQuery.fn[ i ] = function(a) {
+                       var ret = jQuery.map(this,t);
+                       if ( a ) ret = jQuery.filter(a,ret).r;
+                       return this.pushStack( ret, arguments );
+               };
+       })();}
+       
+       var to = "html,append,prepend,before,after".split(',');
+       
+       for ( var i = 0; i < to.length; i++ ) {(function(){
+               var n = to[i];
+               jQuery.fn[ n + "To" ] = function(){
+                       var a = arguments;
+                       return this.each(function(){
+                               for ( var i = 0; i < a.length; i++ )
+                                       $(a[i])[n]( this );
+                       });
+               };
+       })();}
+       
+       var each = {
+               show: function(){
+                       this.style.display = this.oldblock ? this.oldblock : "";
+                       if ( jQuery.css(this,"display") == "none" )
+                               this.style.display = "block";
+               },
+               
+               hide: function(){
+                       this.oldblock = jQuery.css(this,"display");
+                       if ( this.oldblock == "none" )
+                               this.oldblock = "block";
+                       this.style.display = "none";
+               },
+               
+               toggle: function(){
+                       var d = jQuery.css(this,"display");
+                       $(this)[ !d || d == "none" ? 'show' : 'hide' ]();
+               },
+               
+               addClass: function(c){
+                       jQuery.className.add(this,c);
+               },
+               
+               removeClass: function(c){
+                       jQuery.className.remove(this,c);
+               },
+       
+               toggleClass: function( c ){
+                       jQuery.className[ jQuery.hasWord(this,a) ? 'remove' : 'add' ](this,c);
+               },
+               
+               remove: function(){
+                       this.parentNode.removeChild( this );
+               },
+       
+               empty: function(){
+                       while ( this.firstChild )
+                               this.removeChild( this.firstChild );
+               },
+               
+               bind: function( type, fn ) {
+                       jQuery.event.add( this, type, fn );
+               },
+               
+               unbind: function( type, fn ) {
+                       jQuery.event.remove( this, type, fn );
+               },
+               
+               trigger: function( type ) {
+                       jQuery.event.trigger( this, type );
+               },
+       };
+       
+       for ( var i in each ) {(function(){
+               var n = each[i];
+               jQuery.fn[ i ] = function(a,b) {
+                       var a = arguments;
+                       return this.each(function(){
+                               n.apply( this, a );
+                       });
+               };
+       })();}
+       
+       var attr = {
+               val: 'value',
+               html: 'innerHTML'
+       };
+       
+       for ( var i in attr ) {(function(){
+               var n = attr[i];
+               jQuery.fn[ i ] = function(h) {
+                       return h == undefined && this.length ?
+                               this[0][n] : this.set( n, h );
+               };
+       })();}
 
-$.css = function(e,p) {
-       // Adapted from Prototype 1.4.0
-       if ( p == "height" || p == "width" ) {
+})();
 
-               // Handle extra width/height provided by the W3C box model
-               var ph = (!$.boxModel ? 0 :
-                       $.css(e,"paddingTop") + $.css(e,"paddingBottom") +
-                       $.css(e,"borderTopWidth") + $.css(e,"borderBottomWidth")) || 0;
+jQuery.className = {
+       add: function(o,c){
+               if (jQuery.hasWord(o,c)) return;
+               o.className += ( o.className ? " " : "" ) + c;
+       },
+       remove: function(o,c){
+               o.className = !c ? "" :
+                       o.className.replace(
+                               new RegExp("(^|\\s*\\b[^-])"+c+"($|\\b(?=[^-]))", "g"), "");
+       }
+};
 
-               var pw = (!$.boxModel ? 0 :
-                       $.css(e,"paddingLeft") + $.css(e,"paddingRight") +
-                       $.css(e,"borderLeftWidth") + $.css(e,"borderRightWidth")) || 0;
+$.swap = function(e,o,f) {
+       for ( var i in o ) {
+               e.style["old"+i] = e.style[i];
+               e.style[i] = o[i];
+       }
+       f.apply( e, [] );
+       for ( var i in o )
+               e.style[i] = e.style["old"+i];
+};
 
-               var oHeight, oWidth;
+jQuery.css = function(e,p) {
+       // Adapted from Prototype 1.4.0
+       if ( p == "height" || p == "width" ) {
+               var old = {}, oHeight, oWidth, d = ["Top","Bottom","Right","Left"];
 
-               if ($.css(e,"display") != 'none') {
-                       oHeight = e.offsetHeight || parseInt(e.style.height) || 0;
-                       oWidth = e.offsetWidth || parseInt(e.style.width) || 0;
-               } else {
-                       var els = e.style;
-                       var ov = els.visibility;
-                       var op = els.position;
-                       var od = els.display;
-                       els.visibility = "hidden";
-                       els.position = "absolute";
-                       els.display = "";
-                       oHeight = e.clientHeight || parseInt(e.style.height);
-                       oWidth = e.clientWidth || parseInt(e.style.width);
-                       els.display = od;
-                       els.position = op;
-                       els.visibility = ov;
+               for ( var i in d ) {
+                       old["padding" + d[i]] = 0;
+                       old["border" + d[i] + "Width"] = 0;
                }
 
-               return p == "height" ?
-                       (oHeight - ph < 0 ? 0 : oHeight - ph) :
-                       (oWidth - pw < 0 ? 0 : oWidth - pw);
+               $.swap( e, old, function() {
+                       if (jQuery.css(e,"display") != 'none') {
+                               oHeight = e.offsetHeight;
+                               oWidth = e.offsetWidth;
+                       } else
+                               $.swap( e, { visibility: 'hidden', position: 'absolute', display: '' },
+                                       function(){
+                                               oHeight = e.clientHeight;
+                                               oWidth = e.clientWidth;
+                                       });
+               });
+
+               return p == "height" ? oHeight : oWidth;
        }
        
        var r;
@@ -353,10 +603,10 @@ $.css = function(e,p) {
                r = s ? s.getPropertyValue(p) : null;
        }
        
-       return /top|right|left|bottom/i.test(p) ? parseFloat( r ) : r;
+       return r;
 };
 
-$.clean = function(a) {
+jQuery.clean = function(a) {
        var r = [];
        for ( var i = 0; i < a.length; i++ ) {
                if ( a[i].constructor == String ) {
@@ -389,7 +639,7 @@ $.clean = function(a) {
        return r;
 };
 
-$.g = {
+jQuery.g = {
        "": "m[2]== '*'||a.nodeName.toUpperCase()==m[2].toUpperCase()",
        "#": "a.getAttribute('id')&&a.getAttribute('id')==m[2]",
        ":": {
@@ -401,47 +651,47 @@ $.g = {
                last: "i==r.length-1",
                even: "i%2==0",
                odd: "i%2==1",
-               "first-child": "$.sibling(a,0).cur",
-               "nth-child": "(m[3]=='even'?$.sibling(a,m[3]).n%2==0:(m[3]=='odd'?$.sibling(a,m[3]).n%2==1:$.sibling(a,m[3]).cur))",
-               "last-child": "$.sibling(a,0,true).cur",
-               "nth-last-child": "$.sibling(a,m[3],true).cur",
-               "first-of-type": "$.ofType(a,0)",
-               "nth-of-type": "$.ofType(a,m[3])",
-               "last-of-type": "$.ofType(a,0,true)",
-               "nth-last-of-type": "$.ofType(a,m[3],true)",
-               "only-of-type": "$.ofType(a)==1",
-               "only-child": "$.sibling(a).length==1",
+               "first-child": "jQuery.sibling(a,0).cur",
+               "nth-child": "(m[3]=='even'?jQuery.sibling(a,m[3]).n%2==0:(m[3]=='odd'?jQuery.sibling(a,m[3]).n%2==1:jQuery.sibling(a,m[3]).cur))",
+               "last-child": "jQuery.sibling(a,0,true).cur",
+               "nth-last-child": "jQuery.sibling(a,m[3],true).cur",
+               "first-of-type": "jQuery.ofType(a,0)",
+               "nth-of-type": "jQuery.ofType(a,m[3])",
+               "last-of-type": "jQuery.ofType(a,0,true)",
+               "nth-last-of-type": "jQuery.ofType(a,m[3],true)",
+               "only-of-type": "jQuery.ofType(a)==1",
+               "only-child": "jQuery.sibling(a).length==1",
                parent: "a.childNodes.length",
                empty: "!a.childNodes.length",
                root: "a==(a.ownerDocument||document).documentElement",
                contains: "(a.innerText||a.innerHTML).indexOf(m[3])!=-1",
-               visible: "(!a.type||a.type!='hidden')&&($.css(a,'display')!= 'none'&&$.css(a,'visibility')!= 'hidden')",
-               hidden: "(a.type&&a.type == 'hidden')||$.css(a,'display')=='none'||$.css(a,'visibility')== 'hidden'",
-               enabled: "a.disabled==false",
+               visible: "(!a.type||a.type!='hidden')&&(jQuery.css(a,'display')!='none'&&jQuery.css(a,'visibility')!= 'hidden')",
+               hidden: "(a.type&&a.type=='hidden')||jQuery.css(a,'display')=='none'||jQuery.css(a,'visibility')== 'hidden'",
+               enabled: "!a.disabled",
                disabled: "a.disabled",
                checked: "a.checked"
        },
-       ".": "$.hasWord(a,m[2])",
+       ".": "jQuery.hasWord(a,m[2])",
        "@": {
-               "=": "$.attr(a,m[3])==m[4]",
-               "!=": "$.attr(a,m[3])!=m[4]",
-               "~=": "$.hasWord($.attr(a,m[3]),m[4])",
-               "|=": "!$.attr(a,m[3]).indexOf(m[4])",
-               "^=": "!$.attr(a,m[3]).indexOf(m[4])",
-               "$=": "$.attr(a,m[3]).substr( $.attr(a,m[3]).length - m[4].length,m[4].length )==m[4]",
-               "*=": "$.attr(a,m[3]).indexOf(m[4])>=0",
-               "": "m[3]=='*'?a.attributes.length>0:$.attr(a,m[3])"
+               "=": "jQuery.attr(a,m[3])==m[4]",
+               "!=": "jQuery.attr(a,m[3])!=m[4]",
+               "~=": "jQuery.hasWord(jQuery.attr(a,m[3]),m[4])",
+               "|=": "!jQuery.attr(a,m[3]).indexOf(m[4])",
+               "^=": "!jQuery.attr(a,m[3]).indexOf(m[4])",
+               "$=": "jQuery.attr(a,m[3]).substr( jQuery.attr(a,m[3]).length - m[4].length,m[4].length )==m[4]",
+               "*=": "jQuery.attr(a,m[3]).indexOf(m[4])>=0",
+               "": "m[3]=='*'?a.attributes.length>0:jQuery.attr(a,m[3])"
        },
-       "[": "$.Select(m[2],a).length"
+       "[": "jQuery.Select(m[2],a).length"
 };
 
-$.token = [
+jQuery.token = [
        "\\.\\.|/\\.\\.", "a.parentNode",
-       ">|/", "$.sibling(a.firstChild)",
-       "\\+", "$.sibling(a).next",
+       ">|/", "jQuery.sibling(a.firstChild)",
+       "\\+", "jQuery.sibling(a).next",
        "~", function(a){
                var r = [];
-               var s = $.sibling(a);
+               var s = jQuery.sibling(a);
                if ( s.n > 0 )
                        for ( var i = s.n; i < s.length; i++ )
                                r[r.length] = s[i];
@@ -449,8 +699,14 @@ $.token = [
        }
 ];
 
-$.Select = function( t, context ) {
-       context = context || $.context || document;
+jQuery.Select = function( t, context ) {
+       // Make sure that the context is a DOM Element
+       if ( context && context.getElementsByTagName == undefined )
+               context = null;
+
+       // Set the correct context (if none is provided)
+       context = context || jQuery.context || document;
+
        if ( t.constructor != String ) return [t];
 
        if ( !t.indexOf("//") ) {
@@ -469,20 +725,20 @@ $.Select = function( t, context ) {
        var last = null;
 
        while ( t.length > 0 && last != t ) {
-    var r = [];
+               var r = [];
                last = t;
 
-    t = $.cleanSpaces(t).replace( /^\/\//i, "" );
+               t = jQuery.cleanSpaces(t).replace( /^\/\//i, "" );
                
                var foundToken = false;
                
-               for ( var i = 0; i < $.token.length; i += 2 ) {
-                       var re = new RegExp("^(" + $.token[i] + ")");
+               for ( var i = 0; i < jQuery.token.length; i += 2 ) {
+                       var re = new RegExp("^(" + jQuery.token[i] + ")");
                        var m = re.exec(t);
                        
                        if ( m ) {
-                               r = ret = $.map( ret, $.token[i+1] );
-                               t = $.cleanSpaces( t.replace( re, "" ) );
+                               r = ret = jQuery.map( ret, jQuery.token[i+1] );
+                               t = jQuery.cleanSpaces( t.replace( re, "" ) );
                                foundToken = true;
                        }
                }
@@ -491,7 +747,7 @@ $.Select = function( t, context ) {
 
                        if ( !t.indexOf(",") || !t.indexOf("|") ) {
                                if ( ret[0] == context ) ret.shift();
-                               done = $.merge( done, ret );
+                               done = jQuery.merge( done, ret );
                                r = ret = [context];
                                t = " " + t.substr(1,t.length);
                        } else {
@@ -507,31 +763,41 @@ $.Select = function( t, context ) {
                                        if ( !m[2] || m[1] == "." ) m[2] = "*";
        
                                        for ( var i = 0; i < ret.length; i++ )
-                                               r = $.merge( r, $.tag(ret[i],m[2]) );
+                                               r = jQuery.merge( r,
+                                                       m[2] == "*" ?
+                                                               jQuery.getAll(ret[i]) :
+                                                               ret[i].getElementsByTagName(m[2])
+                                               );
                                }
                        }
                        
                }
 
                if ( t ) {
-                       var val = $.filter(t,r);
+                       var val = jQuery.filter(t,r);
                        ret = r = val.r;
-                       t = $.cleanSpaces(val.t);
+                       t = jQuery.cleanSpaces(val.t);
                }
        }
 
        if ( ret && ret[0] == context ) ret.shift();
-       done = $.merge( done, ret );
+       done = jQuery.merge( done, ret );
 
        return done;
 };
 
-$.tag = function(a,b){
-       return a && a.getElementsByTagName != undefined ?
-               a.getElementsByTagName( b ) : [];
+jQuery.getAll = function(o,r) {
+       r = r || [];
+       var s = o.childNodes;
+       for ( var i = 0; i < s.length; i++ )
+               if ( s[i].nodeType == 1 ) {
+                       r[r.length] = s[i];
+                       jQuery.getAll( s[i], r );
+               }
+       return r;
 };
 
-$.attr = function(o,a,v){
+jQuery.attr = function(o,a,v){
        if ( a && a.constructor == String ) {
                var fix = {
                        "for": "htmlFor",
@@ -551,13 +817,13 @@ $.attr = function(o,a,v){
                return "";
 };
 
-$.filter = function(t,r,not) {
-       var g = $.grep;
+jQuery.filter = function(t,r,not) {
+       var g = jQuery.grep;
        if ( not === false )
-               g = function(a,f) {return $.grep(a,f,true);};
+               g = function(a,f) {return jQuery.grep(a,f,true);};
 
        while ( t && t.match(/^[:\\.#\\[a-zA-Z\\*]/) ) {
-               var re = /^\[ *@([a-z0-9*()_-]+) *([~!|*$^=]*) *'?"?([^'"]*)'?"? *\]/i;
+               var re = /^\[ *@([a-z*_-][a-z0-9()_-]*) *([~!|*$^=]*) *'?"?([^'"]*)'?"? *\]/i;
                var m = re.exec(t);
 
                if ( m )
@@ -579,14 +845,14 @@ $.filter = function(t,r,not) {
                t = t.replace( re, "" );
 
                if ( m[1] == ":" && m[2] == "not" )
-                       r = $.filter(m[3],r,false).r;
+                       r = jQuery.filter(m[3],r,false).r;
                else {
                        var f = null;
 
-                       if ( $.g[m[1]].constructor == String )
-                               f = $.g[m[1]];
-                       else if ( $.g[m[1]][m[2]] )
-                               f = $.g[m[1]][m[2]];
+                       if ( jQuery.g[m[1]].constructor == String )
+                               f = jQuery.g[m[1]];
+                       else if ( jQuery.g[m[1]][m[2]] )
+                               f = jQuery.g[m[1]][m[2]];
 
                        if ( f ) {
                                eval("f = function(a,i){return " + f + "}");
@@ -598,7 +864,7 @@ $.filter = function(t,r,not) {
        return { r: r, t: t };
 };
 
-$.parents = function(a){
+jQuery.parents = function(a){
        var b = [];
        var c = a.parentNode;
        while ( c && c != document ) {
@@ -608,17 +874,17 @@ $.parents = function(a){
        return b;
 };
 
-$.cleanSpaces = function(t){
+jQuery.cleanSpaces = function(t){
        return t.replace(/^\s+|\s+$/g, "");
 };
 
-$.ofType = function(a,n,e) {
-       var t = $.grep($.sibling(a),function(b){ return b.nodeName == a.nodeName; });
+jQuery.ofType = function(a,n,e) {
+       var t = jQuery.grep(jQuery.sibling(a),function(b){ return b.nodeName == a.nodeName; });
        if ( e ) n = t.length - n - 1;
        return n != undefined ? t[n] == a : t.length;
 };
 
-$.sibling = function(a,n,e) {
+jQuery.sibling = function(a,n,e) {
        var type = [];
        var tmp = a.parentNode.childNodes;
        for ( var i = 0; i < tmp.length; i++ ) {
@@ -628,30 +894,18 @@ $.sibling = function(a,n,e) {
                        type.n = type.length - 1;
        }
        if ( e ) n = type.length - n - 1;
-       type.cur = ( type[n] == a );
-       type.prev = ( type.n > 0 ? type[type.n - 1] : null );
-       type.next = ( type.n < type.length - 1 ? type[type.n + 1] : null );
+       type.cur = type[n] == a;
+       type.next = type[type.n + 1];
        return type;
 };
 
-$.hasWord = function(e,a) {
-       if ( e == undefined ) return;
-       if ( e.className ) e = e.className;
+jQuery.hasWord = function(e,a) {
+       if ( e.className )
+               e = e.className;
        return new RegExp("(^|\\s)" + a + "(\\s|$)").test(e);
 };
 
-$.getAll = function(o,r) {
-       r = r || [];
-       var s = o.childNodes;
-       for ( var i = 0; i < s.length; i++ )
-               if ( s[i].nodeType == 1 ) {
-                       r[r.length] = s[i];
-                       $.getAll( s[i], r );
-               }
-       return r;
-};
-
-$.merge = function(a,b) {
+jQuery.merge = function(a,b) {
        var d = [];
        for ( var k = 0; k < b.length; k++ ) d[k] = b[k];
 
@@ -666,108 +920,134 @@ $.merge = function(a,b) {
        return d;
 };
 
-$.grep = function(a,f,s) {
+jQuery.grep = function(a,f,s) {
        if ( f.constructor == String )
                f = new Function("a","i","return " + f);
        var r = [];
-       if ( a != undefined )
+       if ( a )
                for ( var i = 0; i < a.length; i++ )
                        if ( (!s && f(a[i],i)) || (s && !f(a[i],i)) )
                                r[r.length] = a[i];
        return r;
 };
 
-$.map = function(a,f) {
+jQuery.map = function(a,f) {
        if ( f.constructor == String )
                f = new Function("a","return " + f);
        
        var r = [];
        for ( var i = 0; i < a.length; i++ ) {
                var t = f(a[i],i);
-               if ( t !== null ) {
+               if ( t !== null && t != undefined ) {
                        if ( t.constructor != Array ) t = [t];
-                       r = $.merge( t, r );
+                       r = jQuery.merge( t, r );
                }
        }
        return r;
 };
 
-$.event = {};
-
-// Bind an event to an element
-// Original by Dean Edwards
-$.event.add = function(element, type, handler) {
-       // For whatever reason, IE has trouble passing the window object
-       // around, causing it to be cloned in the process
-       if ( $.browser == "msie" && element.setInterval != undefined )
-               element = window;
-
-       if (!handler.$$guid) handler.$$guid = $.event.add.guid++;
-       if (!element.events) element.events = {};
-       var handlers = element.events[type];
-       if (!handlers) {
-               handlers = element.events[type] = {};
-               if (element["on" + type])
-                       handlers[0] = element["on" + type];
-       }
-       handlers[handler.$$guid] = handler;
-       element["on" + type] = $.event.handle;
-};
+jQuery.event = {
 
-$.event.add.guid = 1;
+       // Bind an event to an element
+       // Original by Dean Edwards
+       add: function(element, type, handler) {
+               // For whatever reason, IE has trouble passing the window object
+               // around, causing it to be cloned in the process
+               if ( jQuery.browser == "msie" && element.setInterval != undefined )
+                       element = window;
+       
+               if (!handler.guid) handler.guid = jQuery.event.guid++;
+               if (!element.events) element.events = {};
+               var handlers = element.events[type];
+               if (!handlers) {
+                       handlers = element.events[type] = {};
+                       if (element["on" + type])
+                               handlers[0] = element["on" + type];
+               }
+               handlers[handler.guid] = handler;
+               element["on" + type] = this.handle;
 
-// Detach an event or set of events from an element
-$.event.remove = function(element, type, handler) {
-       if (element.events)
-               if (type && element.events[type])
-                       if ( handler )
-                               delete element.events[type][handler.$$guid];
+               if (!this.global[type])
+                       this.global[type] = [];
+               this.global[type].push( element );
+       },
+       
+       guid: 1,
+       global: {},
+       
+       // Detach an event or set of events from an element
+       remove: function(element, type, handler) {
+               if (element.events)
+                       if (type && element.events[type])
+                               if ( handler )
+                                       delete element.events[type][handler.guid];
+                               else
+                                       for ( var i in element.events[type] )
+                                               delete element.events[type][i];
                        else
-                               for ( var i in element.events[type] )
-                                       delete element.events[type][i];
-               else
-                       for ( var j in element.events )
-                               $.event.remove( element, j );
-};
-
-$.event.trigger = function(element,type,data) {
-       data = data || [ $.event.fix({ type: type }) ];
-       if ( element && element["on" + type] )
-               element["on" + type].apply( element, data );
-};
-
-$.event.handle = function(event) {
-       if ( !event && !window.event ) return;
-
-       var returnValue = true, handlers = [];
-       event = event || $.event.fix(window.event);
-
-       for ( var j in this.events[event.type] )
-               handlers[handlers.length] = this.events[event.type][j];
-
-       for ( var i = 0; i < handlers.length; i++ ) {
-               if ( handlers[i].constructor == Function ) {
-                       this.$$handleEvent = handlers[i];
-                       if (this.$$handleEvent(event) === false) {
-                               event.preventDefault();
-                               event.stopPropagation();
-                               returnValue = false;
+                               for ( var j in element.events )
+                                       this.remove( element, j );
+       },
+       
+       trigger: function(type,data,element) {
+               // Touch up the incoming data
+               data = data || [];
+
+               // Handle a global trigger
+               if ( !element ) {
+                       var g = this.global[type];
+                       if ( g )
+                               for ( var i = 0; i < g.length; i++ )
+                                       this.trigger( type, data, g[i] );
+
+               // Handle triggering a single element
+               } else if ( element["on" + type] ) {
+                       // Pass along a fake event
+                       data.unshift( this.fix({ type: type, target: element }) );
+
+                       // Trigger the event
+                       element["on" + type].apply( element, data );
+               }
+       },
+       
+       handle: function(event) {
+               // Handle adding events to items in IFrames, in IE
+               event = event ||
+                       jQuery.event.fix( ((this.ownerDocument || this.document || 
+                               this).parentWindow || window).event );
+
+               // If no correct event was found, fail
+               if ( !event ) return;
+       
+               var returnValue = true, handlers = [];
+       
+               for ( var j in this.events[event.type] )
+                       handlers[handlers.length] = this.events[event.type][j];
+       
+               for ( var i = 0; i < handlers.length; i++ )
+                       if ( handlers[i].constructor == Function ) {
+                               this.handleEvent = handlers[i];
+                               if (this.handleEvent(event) === false) {
+                                       event.preventDefault();
+                                       event.stopPropagation();
+                                       returnValue = false;
+                               }
                        }
+               return returnValue;
+       },
+       
+       fix: function(event) {
+               if ( event ) {
+                       event.preventDefault = function() {
+                               this.returnValue = false;
+                       };
+               
+                       event.stopPropagation = function() {
+                               this.cancelBubble = true;
+                       };
                }
+               
+               return event;
        }
-       return returnValue;
-};
-
-$.event.fix = function(event) {
-       event.preventDefault = $.event.fix.preventDefault;
-       event.stopPropagation = $.event.fix.stopPropagation;
-       return event;
-};
-
-$.event.fix.preventDefault = function() {
-       this.returnValue = false;
-};
 
-$.event.fix.stopPropagation = function() {
-       this.cancelBubble = true;
-};
+};
\ No newline at end of file