X-Git-Url: http://git.asbjorn.biz/?a=blobdiff_plain;f=jquery%2Fjquery.js;h=e46fc73865c83b517f3ffcb95d8f77f6aa2038b8;hb=HEAD;hp=178ed0a3a1d2dde4be098351b9bbc7bda188a35d;hpb=6e868bb091f14a534c898c7a47e6fecd3e403b60;p=jquery.git diff --git a/jquery/jquery.js b/jquery/jquery.js deleted file mode 100644 index 178ed0a..0000000 --- a/jquery/jquery.js +++ /dev/null @@ -1,1766 +0,0 @@ -/* - * jQuery - New Wave Javascript - * - * Copyright (c) 2006 John Resig (jquery.com) - * Licensed under the MIT License: - * http://www.opensource.org/licenses/mit-license.php - * - * $Date$ - * $Rev$ - */ - -// Global undefined variable -window.undefined = window.undefined; - -/** - * Create a new jQuery Object - * @constructor - */ -function jQuery(a,c) { - - // Shortcut for document ready (because $(document).each() is silly) - if ( a && a.constructor == Function && jQuery.fn.ready ) - return jQuery(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 jQuery(c.get()).find(a); - - // If the context is global, return a new object - if ( window == this ) - return new jQuery(a,c); - - // Handle HTML strings - var m = /^[^<]*(<.+>)[^>]*$/.exec(a); - if ( m ) a = jQuery.clean( [ m[1] ] ); - - // Watch for when an array is passed in - this.get( a.constructor == Array || a.length && a[0] != undefined && a[0].nodeType ? - // Assume that it is an array of DOM Elements - jQuery.merge( a, [] ) : - - // Find the matching elements and save them for later - jQuery.find( 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. - * - * @example $("img").length; - * @before - * @result 2 - * - * @property - * @name length - * @type Number - */ - - /** - * The number of elements currently matched. - * - * @example $("img").size(); - * @before - * @result 2 - * - * @name size - * @type Number - */ - size: function() { - return this.length; - }, - - /** - * 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). - * - * @example $("img").get(); - * @before - * @result [ ] - * - * @name get - * @type Array - */ - - /** - * Access a single matched element. num is used to access the - * numth element matched. - * - * @example $("img").get(1); - * @before - * @result [ ] - * - * @name get - * @type Element - * @param Number num Access the element in the numth position. - */ - - /** - * Set the jQuery object to an array of elements. - * - * @example $("img").get([ document.body ]); - * @result $("img").get() == [ document.body ] - * - * @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 - jQuery.map( this, function(a){ return a } ) : - - // Return just the object - this[num]; - }, - - /** - * 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. - * - * @example $("img").each(function(){ this.src = "test.jpg"; }); - * @before - * @result - * - * @name each - * @type jQuery - * @param Function fn A function to execute - */ - each: function( fn, args ) { - // 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], args || [i] ); - - return this; - }, - - /** - * Access a property on the first matched element. - * This method makes it easy to retreive a property value - * from the first matched element. - * - * @example $("img").attr("src"); - * @before - * @result test.jpg - * - * @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. - * - * @example $("img").attr({ src: "test.jpg", alt: "Test Image" }); - * @before - * @result Test Image - * - * @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. - * - * @example $("img").attr("src","test.jpg"); - * @before - * @result - * - * @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, type ) { - // Check to see if we're setting style values - return key.constructor != String || value ? - this.each(function(){ - // 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 - 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 ); - }, - - /** - * 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. - * - * @example $("p").css("red"); - * @before

Test Paragraph.

- * @result red - * - * @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. - * - * @example $("p").css({ color: "red", background: "blue" }); - * @before

Test Paragraph.

- * @result

Test Paragraph.

- * - * @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. - * - * @example $("p").css("color","red"); - * @before

Test Paragraph.

- * @result

Test Paragraph.

- * - * @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, "curCSS" ); - }, - - /** - * 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. - * - * @example $("p").text(); - * @before

Test Paragraph.

- * @result Test Paragraph. - * - * @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; - }, - - /** - * Wrap all matched elements with a structure of other elements. - * This wrapping process is most useful for injecting additional - * stucture into a document, without ruining the original semantic - * qualities of a document. - * - * The way that is works is that it goes through the first element argument - * provided and finds the deepest element within the structure - it is that - * element that will en-wrap everything else. - * - * @example $("p").wrap("
"); - * @before

Test Paragraph.

- * @result

Test Paragraph.

- * - * @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 elems An array of elements, the first of which will be wrapped. - * @any Object obj Any object, converted to a string, then a text node. - */ - wrap: function() { - // The elements to wrap the target around - var a = jQuery.clean(arguments); - - // Wrap each of the matched elements individually - return this.each(function(){ - // Clone the structure that we're using to wrap - var b = a[0].cloneNode(true); - - // Insert it before the element to be wrapped - this.parentNode.insertBefore( b, this ); - - // Find he deepest point in the wrap structure - while ( b.firstChild ) - b = b.firstChild; - - // Move the matched element to within the wrap structure - b.appendChild( this ); - }); - }, - - /** - * Append any number of elements to the inside of all matched elements. - * This operation is similar to doing an appendChild to all the - * specified elements, adding them into the document. - * - * @example $("p").append("Hello"); - * @before

I would like to say:

- * @result

I would like to say: Hello

- * - * @name append - * @type jQuery - * @any String html A string of HTML, that will be created on the fly and appended to the target. - * @any Element elem A DOM element that will be appended. - * @any Array elems An array of elements, all of which will be appended. - * @any Object obj Any object, converted to a string, then a text node. - */ - append: function() { - return this.domManip(arguments, true, 1, function(a){ - this.appendChild( a ); - }); - }, - - /** - * Prepend any number of elements to the inside of all matched elements. - * This operation is the best way to insert a set of elements inside, at the - * beginning, of all the matched element. - * - * @example $("p").prepend("Hello"); - * @before

, how are you?

- * @result

Hello, how are you?

- * - * @name prepend - * @type jQuery - * @any String html A string of HTML, that will be created on the fly and prepended to the target. - * @any Element elem A DOM element that will be prepended. - * @any Array elems An array of elements, all of which will be prepended. - * @any Object obj Any object, converted to a string, then a text node. - */ - prepend: function() { - return this.domManip(arguments, true, -1, function(a){ - this.insertBefore( a, this.firstChild ); - }); - }, - - /** - * Insert any number of elements before each of the matched elements. - * - * @example $("p").before("Hello"); - * @before

how are you?

- * @result Hello

how are you?

- * - * @name before - * @type jQuery - * @any String html A string of HTML, that will be created on the fly and inserted. - * @any Element elem A DOM element that will beinserted. - * @any Array elems An array of elements, all of which will be inserted. - * @any Object obj Any object, converted to a string, then a text node. - */ - before: function() { - return this.domManip(arguments, false, 1, function(a){ - this.parentNode.insertBefore( a, this ); - }); - }, - - /** - * Insert any number of elements after each of the matched elements. - * - * @example $("p").after("

I'm doing fine.

"); - * @before

How are you?

- * @result

How are you?

I'm doing fine.

- * - * @name after - * @type jQuery - * @any String html A string of HTML, that will be created on the fly and inserted. - * @any Element elem A DOM element that will beinserted. - * @any Array elems An array of elements, all of which will be inserted. - * @any Object obj Any object, converted to a string, then a text node. - */ - after: function() { - return this.domManip(arguments, false, -1, function(a){ - this.parentNode.insertBefore( a, this.nextSibling ); - }); - }, - - /** - * End the most recent 'destructive' operation, reverting the list of matched elements - * back to its previous state. After an end operation, the list of matched elements will - * revert to the last state of matched elements. - * - * @example $("p").find("span").end(); - * @before

Hello, how are you?

- * @result $("p").find("span").end() == [

...

] - * - * @name end - * @type jQuery - */ - end: function() { - return this.get( this.stack.pop() ); - }, - - /** - * Searches for all elements that match the specified expression. - * This method is the optimal way of finding additional descendant - * elements with which to process. - * - * All searching is done using a jQuery expression. The expression can be - * written using CSS 1-3 Selector syntax, or basic XPath. - * - * @example $("p").find("span"); - * @before

Hello, how are you?

- * @result $("p").find("span") == [ Hello ] - * - * @name find - * @type jQuery - * @param String expr An expression to search with. - */ - find: function(t) { - return this.pushStack( jQuery.map( this, function(a){ - return jQuery.find(t,a); - }), arguments ); - }, - - /** - * Removes all elements from the set of matched elements that do not - * match the specified expression. This method is used to narrow down - * the results of a search. - * - * All searching is done using a jQuery expression. The expression - * can be written using CSS 1-3 Selector syntax, or basic XPath. - * - * @example $("p").filter(".selected") - * @before

Hello

How are you?

- * @result $("p").filter(".selected") == [

Hello

] - * - * @name filter - * @type jQuery - * @param String expr An expression to search with. - */ - - /** - * Removes all elements from the set of matched elements that do not - * match at least one of the expressions passed to the function. This - * method is used when you want to filter the set of matched elements - * through more than one expression. - * - * Elements will be retained in the jQuery object if they match at - * least one of the expressions passed. - * - * @example $("p").filter([".selected", ":first"]) - * @before

Hello

Hello Again

And Again

- * @result $("p").filter([".selected", ":first"]) == [

Hello

,

And Again

] - * - * @name filter - * @type jQuery - * @param Array exprs A set of expressions to evaluate against - */ - filter: function(t) { - return this.pushStack( - t.constructor == Array && - jQuery.map(this,function(a){ - for ( var i = 0; i < t.length; i++ ) - if ( jQuery.filter(t[i],[a]).r.length ) - return a; - }) || - - t.constructor == Boolean && - ( t ? this.get() : [] ) || - - t.constructor == Function && - jQuery.grep( this, t ) || - - jQuery.filter(t,this).r, arguments ); - }, - - /** - * Removes the specified Element from the set of matched elements. This - * method is used to remove a single Element from a jQuery object. - * - * @example $("p").not( document.getElementById("selected") ) - * @before

Hello

Hello Again

- * @result [

Hello

] - * - * @name not - * @type jQuery - * @param Element el An element to remove from the set - */ - - /** - * Removes elements matching the specified expression from the set - * of matched elements. This method is used to remove one or more - * elements from a jQuery object. - * - * @example $("p").not("#selected") - * @before

Hello

Hello Again

- * @result [

Hello

] - * - * @name not - * @type jQuery - * @param String expr An expression with which to remove matching elements - */ - not: function(t) { - return this.pushStack( t.constructor == String ? - jQuery.filter(t,this,false).r : - jQuery.grep(this,function(a){ return a != t; }), arguments ); - }, - - /** - * Adds the elements matched by the expression to the jQuery object. This - * can be used to concatenate the result sets of two expressions. - * - * @example $("p").add("span") - * @before

Hello

Hello Again

- * @result [

Hello

, Hello Again ] - * - * @name add - * @type jQuery - * @param String expr An expression whose matched elements are added - */ - - /** - * Adds each of the Elements in the array to the set of matched elements. - * This is used to add a set of Elements to a jQuery object. - * - * @example $("p").add([document.getElementById("a"), document.getElementById("b")]) - * @before

Hello

Hello AgainAnd Again

- * @result [

Hello

, Hello Again, And Again ] - * - * @name add - * @type jQuery - * @param Array els An array of Elements to add - */ - - /** - * Adds a single Element to the set of matched elements. This is used to - * add a single Element to a jQuery object. - * - * @example $("p").add( document.getElementById("a") ) - * @before

Hello

Hello Again

- * @result [

Hello

, Hello Again ] - * - * @name add - * @type jQuery - * @param Element el An Element to add - */ - add: function(t) { - return this.pushStack( jQuery.merge( this, t.constructor == String ? - jQuery.find(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 - */ - is: function(expr) { - return expr ? jQuery.filter(expr,this).r.length > 0 : this.length > 0; - }, - - /** - * - * - * @private - * @name domManip - * @param Array args - * @param Boolean table - * @param Number int - * @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(){ - 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]; - } - //alert( obj ); - for ( var i = ( dir < 0 ? a.length - 1 : 0 ); - i != ( dir < 0 ? dir : a.length ); i += dir ) { - fn.apply( obj, [ clone ? a[i].cloneNode(true) : a[i] ] ); - //alert( fn ); - } - }); - }, - - /** - * - * - * @private - * @name pushStack - * @param Array a - * @param Array args - * @type jQuery - */ - 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; - }, - - extend: function(obj,prop) { - if ( !prop ) { prop = obj; obj = this; } - for ( var i in prop ) obj[i] = prop[i]; - return obj; - } -}; - -jQuery.extend = jQuery.fn.extend; - -new function() { - var b = navigator.userAgent.toLowerCase(); - - // Figure out what browser is being used - jQuery.browser = { - safari: /webkit/.test(b), - opera: /opera/.test(b), - msie: /msie/.test(b) && !/opera/.test(b), - mozilla: /mozilla/.test(b) && !/compatible/.test(b) - }; - - // Check to see if the W3C box model is being used - jQuery.boxModel = !jQuery.browser.msie || document.compatMode == "CSS1Compat"; - - var axis = { - /** - * Get a set of elements containing the unique parents of the matched - * set of elements. - * - * @example $("p").parent() - * @before

Hello

Hello

- * @result [

Hello

Hello

] - * - * @name parent - * @type jQuery - */ - - /** - * Get a set of elements containing the unique parents of the matched - * set of elements, and filtered by an expression. - * - * @example $("p").parent(".selected") - * @before

Hello

Hello Again

- * @result [

Hello Again

] - * - * @name parent - * @type jQuery - * @param String expr An expression to filter the parents with - */ - parent: "a.parentNode", - - /** - * Get a set of elements containing the unique ancestors of the matched - * set of elements. - * - * @example $("span").ancestors() - * @before

Hello

Hello Again
- * @result [ ...,
...
,

Hello

] - * - * @name ancestors - * @type jQuery - */ - - /** - * Get a set of elements containing the unique ancestors of the matched - * set of elements, and filtered by an expression. - * - * @example $("span").ancestors("p") - * @before

Hello

Hello Again
- * @result [

Hello

] - * - * @name ancestors - * @type jQuery - * @param String expr An expression to filter the ancestors with - */ - ancestors: jQuery.parents, - - /** - * A synonym for ancestors - */ - parents: jQuery.parents, - - /** - * Get a set of elements containing the unique next siblings of each of the - * matched set of elements. - * - * It only returns the very next sibling, not all next siblings. - * - * @example $("p").next() - * @before

Hello

Hello Again

And Again
- * @result [

Hello Again

,
And Again
] - * - * @name next - * @type jQuery - */ - - /** - * Get a set of elements containing the unique next siblings of each of the - * matched set of elements, and filtered by an expression. - * - * It only returns the very next sibling, not all next siblings. - * - * @example $("p").next(".selected") - * @before

Hello

Hello Again

And Again
- * @result [

Hello Again

] - * - * @name next - * @type jQuery - * @param String expr An expression to filter the next Elements with - */ - next: "jQuery.sibling(a).next", - - /** - * Get a set of elements containing the unique previous siblings of each of the - * matched set of elements. - * - * It only returns the immediately previous sibling, not all previous siblings. - * - * @example $("p").previous() - * @before

Hello

Hello Again

And Again

- * @result [
Hello Again
] - * - * @name prev - * @type jQuery - */ - - /** - * Get a set of elements containing the unique previous siblings of each of the - * matched set of elements, and filtered by an expression. - * - * It only returns the immediately previous sibling, not all previous siblings. - * - * @example $("p").previous("selected") - * @before
Hello

Hello Again

And Again

- * @result [
Hello
] - * - * @name prev - * @type jQuery - * @param String expr An expression to filter the previous Elements with - */ - prev: "jQuery.sibling(a).prev", - - /** - * Get a set of elements containing all of the unique siblings of each of the - * matched set of elements. - * - * @example $("div").siblings() - * @before

Hello

Hello Again

And Again

- * @result [

Hello

,

And Again

] - * - * @name siblings - * @type jQuery - */ - - /** - * Get a set of elements containing all of the unique siblings of each of the - * matched set of elements, and filtered by an expression. - * - * @example $("div").siblings("selected") - * @before
Hello

Hello Again

And Again

- * @result [

Hello Again

] - * - * @name siblings - * @type jQuery - * @param String expr An expression to filter the sibling Elements with - */ - siblings: jQuery.sibling - }; - - for ( var i in axis ) new function(){ - var t = axis[i]; - jQuery.fn[ i ] = function(a) { - var ret = jQuery.map(this,t); - if ( a && a.constructor == String ) - ret = jQuery.filter(a,ret).r; - return this.pushStack( ret, arguments ); - }; - }; - - // appendTo, prependTo, beforeTo, afterTo - - var to = ["append","prepend","before","after"]; - - for ( var i = 0; i < to.length; i++ ) new 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 = { - /** - * Displays each of the set of matched elements if they are hidden. - * - * @example $("p").show() - * @before

Hello

- * @result [

Hello

] - * - * @name show - * @type jQuery - */ - show: function(){ - this.style.display = this.oldblock ? this.oldblock : ""; - if ( jQuery.css(this,"display") == "none" ) - this.style.display = "block"; - }, - - /** - * Hides each of the set of matched elements if they are shown. - * - * @example $("p").hide() - * @before

Hello

- * @result [

Hello

] - * - * @name hide - * @type jQuery - */ - hide: function(){ - this.oldblock = jQuery.css(this,"display"); - if ( this.oldblock == "none" ) - this.oldblock = "block"; - this.style.display = "none"; - }, - - /** - * Toggles each of the set of matched elements. If they are shown, - * toggle makes them hidden. If they are hidden, toggle - * makes them shown. - * - * @example $("p").toggle() - * @before

Hello

Hello Again

- * @result [

Hello

,

Hello Again

] - * - * @name toggle - * @type jQuery - */ - toggle: function(){ - var d = jQuery.css(this,"display"); - $(this)[ !d || d == "none" ? "show" : "hide" ](); - }, - - /** - * Adds the specified class to each of the set of matched elements. - * - * @example ("p").addClass("selected") - * @before

Hello

- * @result [

Hello

] - * - * @name addClass - * @type jQuery - * @param String class A CSS class to add to the elements - */ - addClass: function(c){ - jQuery.className.add(this,c); - }, - - /** - * The opposite of addClass. Removes the specified class from the - * set of matched elements. - * - * @example ("p").removeClass("selected") - * @before

Hello

- * @result [

Hello

] - * - * @name removeClass - * @type jQuery - * @param String class A CSS class to remove from the elements - */ - removeClass: function(c){ - jQuery.className.remove(this,c); - }, - - /** - * Adds the specified class if it is present. Remove it if it is - * not present. - * - * @example ("p").toggleClass("selected") - * @before

Hello

Hello Again

- * @result [

Hello

,

Hello Again

] - * - * @name toggleClass - * @type jQuery - * @param String class A CSS class with which to toggle the elements - */ - toggleClass: function( c ){ - jQuery.className[ jQuery.className.has(this,c) ? "remove" : "add" ](this,c); - }, - - /** - * TODO: Document - */ - remove: function(a){ - if ( !a || jQuery.filter( [this], a ).r ) - this.parentNode.removeChild( this ); - }, - - /** - * Removes all child nodes from the set of matched elements. - * - * @example ("p").empty() - * @before

Hello, Person and person

- * @result [

] - * - * @name empty - * @type jQuery - */ - empty: function(){ - while ( this.firstChild ) - this.removeChild( this.firstChild ); - }, - - /** - * Binds a particular event (like click) to a each of a set of match elements. - * - * @example $("p").bind( "click", function() { alert("Hello"); } ) - * @before

Hello

- * @result [

Hello

] - * - * Cancel a default action and prevent it from bubbling by returning false - * from your function. - * - * @example $("form").bind( "submit", function() { return false; } ) - * - * Cancel a default action by using the preventDefault method. - * - * @example $("form").bind( "submit", function() { e.preventDefault(); } ) - * - * Stop an event from bubbling by using the stopPropogation method. - * - * @example $("form").bind( "submit", function() { e.stopPropogation(); } ) - * - * @name bind - * @type jQuery - * @param String type An event type - * @param Function fn A function to bind to the event on each of the set of matched elements - */ - bind: function( type, fn ) { - if ( fn.constructor == String ) - fn = new Function("e", ( !fn.indexOf(".") ? "$(this)" : "return " ) + fn); - jQuery.event.add( this, type, fn ); - }, - - /** - * The opposite of bind. Removes a bound event from each of a set of matched - * elements. You must pass the identical function that was used in the original - * bind method. - * - * @example $("p").unbind( "click", function() { alert("Hello"); } ) - * @before

Hello

- * @result [

Hello

] - * - * @name unbind - * @type jQuery - * @param String type An event type - * @param Function fn A function to unbind from the event on each of the set of matched elements - */ - unbind: function( type, fn ) { - jQuery.event.remove( this, type, fn ); - }, - - /** - * Trigger a particular event. - * - * @example $("p").trigger("click") - * @before

Hello

- * @result [

Hello

] - * - * @name trigger - * @type jQuery - * @param String type An event type - */ - trigger: function( type, data ) { - jQuery.event.trigger( type, data, this ); - } - }; - - for ( var i in each ) new function() { - var n = each[i]; - jQuery.fn[ i ] = function() { - return this.each( n, arguments ); - }; - }; - - var attr = { - val: "value", - html: "innerHTML", - value: null, - id: null, - title: null, - name: null, - href: null, - src: null, - rel: null - }; - - for ( var i in attr ) new function() { - var n = attr[i] || i; - jQuery.fn[ i ] = function(h) { - return h == undefined ? - this.length ? this[0][n] : null : - this.attr( n, h ); - }; - }; - - var css = "width,height,top,left,position,float,overflow,color,background".split(","); - - for ( var i in css ) new function() { - var n = css[i]; - jQuery.fn[ i ] = function(h) { - return h == undefined ? - ( this.length ? jQuery.css( this[0], n ) : null ) : - this.css( n, h ); - }; - }; - -} - -jQuery.extend({ - className: { - add: function(o,c){ - if (jQuery.className.has(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"), ""); - }, - has: function(e,a) { - if ( e.className ) - e = e.className; - return new RegExp("(^|\\s)" + a + "(\\s|$)").test(e); - } - }, - - /** - * Swap in/out style options. - * @private - */ - 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]; - }, - - css: function(e,p) { - if ( p == "height" || p == "width" ) { - var old = {}, oHeight, oWidth, d = ["Top","Bottom","Right","Left"]; - - for ( var i in d ) { - old["padding" + d[i]] = 0; - old["border" + d[i] + "Width"] = 0; - } - - jQuery.swap( e, old, function() { - if (jQuery.css(e,"display") != "none") { - oHeight = e.offsetHeight; - oWidth = e.offsetWidth; - } else - jQuery.swap( e, { visibility: "hidden", position: "absolute", display: "" }, - function(){ - oHeight = e.clientHeight; - oWidth = e.clientWidth; - }); - }); - - return p == "height" ? oHeight : oWidth; - } else if ( p == "opacity" && jQuery.browser.msie ) - return parseFloat( jQuery.curCSS(e,"filter").replace(/[^0-9.]/,"") ) || 1; - - return jQuery.curCSS( e, p ); - }, - - curCSS: function(e,p,force) { - var r; - - if (!force && e.style[p]) - r = e.style[p]; - else if (e.currentStyle) { - p = p.replace(/\-(\w)/g,function(m,c){return c.toUpperCase()}); - r = e.currentStyle[p]; - } else if (document.defaultView && document.defaultView.getComputedStyle) { - p = p.replace(/([A-Z])/g,"-$1").toLowerCase(); - var s = document.defaultView.getComputedStyle(e,""); - r = s ? s.getPropertyValue(p) : null; - } - - return r; - }, - - clean: function(a) { - var r = []; - for ( var i = 0; i < a.length; i++ ) { - if ( a[i].constructor == String ) { - - if ( !a[i].indexOf(""; - } else if ( !a[i].indexOf(""; - } - - var div = document.createElement("div"); - div.innerHTML = a[i]; - - if ( tr || td ) { - div = div.firstChild.firstChild; - if ( td ) div = div.firstChild; - } - - for ( var j = 0; j < div.childNodes.length; j++ ) - r.push( div.childNodes[j] ); - } else if ( a[i].jquery || a[i].length && !a[i].nodeType ) - for ( var k = 0; k < a[i].length; k++ ) - r.push( a[i][k] ); - else if ( a[i] !== null ) - r.push( a[i].nodeType ? a[i] : document.createTextNode(a[i].toString()) ); - } - return r; - }, - - expr: { - "": "m[2]== '*'||a.nodeName.toUpperCase()==m[2].toUpperCase()", - "#": "a.getAttribute('id')&&a.getAttribute('id')==m[2]", - ":": { - // Position Checks - lt: "im[3]-0", - nth: "m[3]-0==i", - eq: "m[3]-0==i", - first: "i==0", - last: "i==r.length-1", - even: "i%2==0", - odd: "i%2", - - // Child Checks - "first-child": "jQuery.sibling(a,0).cur", - "last-child": "jQuery.sibling(a,0).last", - "only-child": "jQuery.sibling(a).length==1", - - // Parent Checks - parent: "a.childNodes.length", - empty: "!a.childNodes.length", - - // Text Check - contains: "(a.innerText||a.innerHTML).indexOf(m[3])>=0", - - // Visibility - visible: "a.type!='hidden'&&jQuery.css(a,'display')!='none'&&jQuery.css(a,'visibility')!='hidden'", - hidden: "a.type=='hidden'||jQuery.css(a,'display')=='none'||jQuery.css(a,'visibility')=='hidden'", - - // Form elements - enabled: "!a.disabled", - disabled: "a.disabled", - checked: "a.checked" - }, - ".": "jQuery.className.has(a,m[2])", - "@": { - "=": "z==m[4]", - "!=": "z!=m[4]", - "^=": "!z.indexOf(m[4])", - "$=": "z.substr(z.length - m[4].length,m[4].length)==m[4]", - "*=": "z.indexOf(m[4])>=0", - "": "z" - }, - "[": "jQuery.find(m[2],a).length" - }, - - token: [ - "\\.\\.|/\\.\\.", "a.parentNode", - ">|/", "jQuery.sibling(a.firstChild)", - "\\+", "jQuery.sibling(a).next", - "~", function(a){ - var r = []; - var s = jQuery.sibling(a); - if ( s.n > 0 ) - for ( var i = s.n; i < s.length; i++ ) - r.push( s[i] ); - return r; - } - ], - - find: function( t, context ) { - // Make sure that the context is a DOM Element - if ( context && context.nodeType == 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("//") ) { - context = context.documentElement; - t = t.substr(2,t.length); - } else if ( !t.indexOf("/") ) { - context = context.documentElement; - t = t.substr(1,t.length); - // FIX Assume the root element is right :( - if ( t.indexOf("/") >= 1 ) - t = t.substr(t.indexOf("/"),t.length); - } - - var ret = [context]; - var done = []; - var last = null; - - while ( t.length > 0 && last != t ) { - var r = []; - last = t; - - t = jQuery.trim(t).replace( /^\/\//i, "" ); - - var foundToken = false; - - 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 = jQuery.map( ret, jQuery.token[i+1] ); - t = jQuery.trim( t.replace( re, "" ) ); - foundToken = true; - } - } - - if ( !foundToken ) { - if ( !t.indexOf(",") || !t.indexOf("|") ) { - if ( ret[0] == context ) ret.shift(); - done = jQuery.merge( done, ret ); - r = ret = [context]; - t = " " + t.substr(1,t.length); - } else { - var re2 = /^([#.]?)([a-z0-9\\*_-]*)/i; - var m = re2.exec(t); - - if ( m[1] == "#" ) { - // Ummm, should make this work in all XML docs - var oid = document.getElementById(m[2]); - r = ret = oid ? [oid] : []; - t = t.replace( re2, "" ); - } else { - if ( !m[2] || m[1] == "." ) m[2] = "*"; - - for ( var i = 0; i < ret.length; i++ ) - r = jQuery.merge( r, - m[2] == "*" ? - jQuery.getAll(ret[i]) : - ret[i].getElementsByTagName(m[2]) - ); - } - } - } - - if ( t ) { - var val = jQuery.filter(t,r); - ret = r = val.r; - t = jQuery.trim(val.t); - } - } - - if ( ret && ret[0] == context ) ret.shift(); - done = jQuery.merge( done, ret ); - - return done; - }, - - getAll: function(o,r) { - r = r || []; - var s = o.childNodes; - for ( var i = 0; i < s.length; i++ ) - if ( s[i].nodeType == 1 ) { - r.push( s[i] ); - jQuery.getAll( s[i], r ); - } - return r; - }, - - attr: function(o,a,v){ - if ( a && a.constructor == String ) { - var fix = { - "for": "htmlFor", - "class": "className", - "float": "cssFloat" - }; - - a = (fix[a] && fix[a].replace && fix[a] || a) - .replace(/-([a-z])/ig,function(z,b){ - return b.toUpperCase(); - }); - - if ( v != undefined ) { - o[a] = v; - if ( o.setAttribute && a != "disabled" ) - o.setAttribute(a,v); - } - - return o[a] || o.getAttribute && o.getAttribute(a) || ""; - } else - return ""; - }, - - // The regular expressions that power the parsing engine - parse: [ - // Match: [@value='test'], [@foo] - [ "\\[ *(@)S *([!*$^=]*) *Q\\]", 1 ], - - // Match: [div], [div p] - [ "(\\[)Q\\]", 0 ], - - // Match: :contains('foo') - [ "(:)S\\(Q\\)", 0 ], - - // Match: :even, :last-chlid - [ "([:.#]*)S", 0 ] - ], - - filter: function(t,r,not) { - // Figure out if we're doing regular, or inverse, filtering - var g = not !== false ? jQuery.grep : - function(a,f) {return jQuery.grep(a,f,true);}; - - while ( t && /^[a-z[({<*:.#]/i.test(t) ) { - - var p = jQuery.parse; - - for ( var i = 0; i < p.length; i++ ) { - var re = new RegExp( "^" + p[i][0] - - // Look for a string-like sequence - .replace( 'S', "([a-z*_-][a-z0-9_-]*)" ) - - // Look for something (optionally) enclosed with quotes - .replace( 'Q', " *'?\"?([^'\"]*)'?\"? *" ), "i" ); - - var m = re.exec( t ); - - if ( m ) { - // Re-organize the match - if ( p[i][1] ) - m = ["", m[1], m[3], m[2], m[4]]; - - // Remove what we just matched - t = t.replace( re, "" ); - - break; - } - } - - // :not() is a special case that can be optomized by - // keeping it out of the expression list - if ( m[1] == ":" && m[2] == "not" ) - r = jQuery.filter(m[3],r,false).r; - - // Otherwise, find the expression to execute - else { - var f = jQuery.expr[m[1]]; - if ( f.constructor != String ) - f = jQuery.expr[m[1]][m[2]]; - - // Build a custom macro to enclose it - eval("f = function(a,i){" + - ( m[1] == "@" ? "z=jQuery.attr(a,m[3]);" : "" ) + - "return " + f + "}"); - - // Execute it against the current filter - r = g( r, f ); - } - } - - // Return an array of filtered elements (r) - // and the modified expression string (t) - return { r: r, t: t }; - }, - - /** - * Remove the whitespace from the beginning and end of a string. - * - * @private - * @name $.trim - * @type String - * @param String str The string to trim. - */ - trim: function(t){ - return t.replace(/^\s+|\s+$/g, ""); - }, - - /** - * All ancestors of a given element. - * - * @private - * @name $.parents - * @type Array - * @param Element elem The element to find the ancestors of. - */ - parents: function(a){ - var b = []; - var c = a.parentNode; - while ( c && c != document ) { - b.push( c ); - c = c.parentNode; - } - return b; - }, - - /** - * All elements on a specified axis. - * - * @private - * @name $.sibling - * @type Array - * @param Element elem The element to find all the siblings of (including itself). - */ - sibling: function(a,n) { - var type = []; - var tmp = a.parentNode.childNodes; - for ( var i = 0; i < tmp.length; i++ ) { - if ( tmp[i].nodeType == 1 ) - type.push( tmp[i] ); - if ( tmp[i] == a ) - type.n = type.length - 1; - } - type.last = type.n == type.length - 1; - type.cur = - n == "even" && type.n % 2 == 0 || - n == "odd" && type.n % 2 || - type[n] == a; - type.prev = type[type.n - 1]; - type.next = type[type.n + 1]; - return type; - }, - - /** - * Merge two arrays together, removing all duplicates. - * - * @private - * @name $.merge - * @type Array - * @param Array a The first array to merge. - * @param Array b The second array to merge. - */ - merge: function(a,b) { - var d = []; - - // Move b over to the new array (this helps to avoid - // StaticNodeList instances) - for ( var k = 0; k < b.length; k++ ) - d[k] = b[k]; - - // Now check for duplicates between a and b and only - // add the unique items - for ( var i = 0; i < a.length; i++ ) { - var c = true; - - // The collision-checking process - for ( var j = 0; j < b.length; j++ ) - if ( a[i] == b[j] ) - c = false; - - // If the item is unique, add it - if ( c ) - d.push( a[i] ); - } - - return d; - }, - - /** - * Remove items that aren't matched in an array. The function passed - * in to this method will be passed two arguments: 'a' (which is the - * array item) and 'i' (which is the index of the item in the array). - * - * @private - * @name $.grep - * @type Array - * @param Array array The Array to find items in. - * @param Function fn The function to process each item against. - * @param Boolean inv Invert the selection - select the opposite of the function. - */ - grep: function(a,f,s) { - // If a string is passed in for the function, make a function - // for it (a handy shortcut) - if ( f.constructor == String ) - f = new Function("a","i","return " + f); - - var r = []; - - // Go through the array, only saving the items - // that pass the validator function - for ( var i = 0; i < a.length; i++ ) - if ( !s && f(a[i],i) || s && !f(a[i],i) ) - r.push( a[i] ); - - return r; - }, - - /** - * Translate all items in array to another array of items. The translation function - * that is provided to this method is passed one argument: 'a' (the item to be - * translated). If an array is returned, that array is mapped out and merged into - * the full array. Additionally, returning 'null' or 'undefined' will delete the item - * from the array. Both of these changes imply that the size of the array may not - * be the same size upon completion, as it was when it started. - * - * @private - * @name $.map - * @type Array - * @param Array array The Array to translate. - * @param Function fn The function to process each item against. - */ - map: function(a,f) { - // If a string is passed in for the function, make a function - // for it (a handy shortcut) - if ( f.constructor == String ) - f = new Function("a","return " + f); - - var r = []; - - // Go through the array, translating each of the items to their - // new value (or values). - for ( var i = 0; i < a.length; i++ ) { - var t = f(a[i],i); - if ( t !== null && t != undefined ) { - if ( t.constructor != Array ) t = [t]; - r = jQuery.merge( t, r ); - } - } - return r; - }, - - /* - * A number of helper functions used for managing events. - * Many of the ideas behind this code orignated from Dean Edwards' addEvent library. - */ - event: { - - // 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; - - // Make sure that the function being executed has a unique ID - if ( !handler.guid ) - handler.guid = this.guid++; - - // Init the element's event structure - if (!element.events) - element.events = {}; - - // Get the current list of functions bound to this event - var handlers = element.events[type]; - - // If it hasn't been initialized yet - if (!handlers) { - // Init the event handler queue - handlers = element.events[type] = {}; - - // Remember an existing handler, if it's already there - if (element["on" + type]) - handlers[0] = element["on" + type]; - } - - // Add the function to the element's handler list - handlers[handler.guid] = handler; - - // And bind the global event handler to the element - element["on" + type] = this.handle; - - // Remember the function in a global list (for triggering) - 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 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) { - if ( typeof jQuery == "undefined" ) return; - - event = event || jQuery.event.fix( window.event ); - - // If no correct event was found, fail - if ( !event ) return; - - var returnValue = true; - - var c = this.events[event.type]; - - for ( var j in c ) { - if ( c[j].apply( this, [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; - } - - } -});