/*
Script: Core.js
Mootools - My Object Oriented javascript.
License:
MIT-style license.
MooTools Copyright:
copyright (c) 2007 Valerio Proietti, <http://mad4milk.net>
MooTools Credits:
- Class is slightly based on Base.js <http://dean.edwards.name/weblog/2006/03/base/> (c) 2006 Dean Edwards, License <http://creativecommons.org/licenses/LGPL/2.1/>
- Some functions are inspired by those found in prototype.js <http://prototype.conio.net/> (c) 2005 Sam Stephenson sam [at] conio [dot] net, MIT-style license
- Documentation by Aaron Newton (aaron.newton [at] cnet [dot] com) and Valerio Proietti.
*/
var MooTools = {
version: '1.11'
};
/* Section: Core Functions */
/*
Function: $defined
Returns true if the passed in value/object is defined, that means is not null or undefined.
Arguments:
obj - object to inspect
*/
function $defined(obj){
return (obj != undefined);
};
/*
Function: $type
Returns the type of object that matches the element passed in.
Arguments:
obj - the object to inspect.
Example:
>var myString = 'hello';
>$type(myString); //returns "string"
Returns:
'element' - if obj is a DOM element node
'textnode' - if obj is a DOM text node
'whitespace' - if obj is a DOM whitespace node
'arguments' - if obj is an arguments object
'object' - if obj is an object
'string' - if obj is a string
'number' - if obj is a number
'boolean' - if obj is a boolean
'function' - if obj is a function
'regexp' - if obj is a regular expression
'class' - if obj is a Class. (created with new Class, or the extend of another class).
'collection' - if obj is a native htmlelements collection, such as childNodes, getElementsByTagName .. etc.
false - (boolean) if the object is not defined or none of the above.
*/
function $type(obj){
if (!$defined(obj)) return false;
if (obj.htmlElement) return 'element';
var type = typeof obj;
if (type == 'object' && obj.nodeName){
switch(obj.nodeType){
case 1: return 'element';
case 3: return (/\S/).test(obj.nodeValue) ? 'textnode' : 'whitespace';
}
}
if (type == 'object' || type == 'function'){
switch(obj.constructor){
case Array: return 'array';
case RegExp: return 'regexp';
case Class: return 'class';
}
if (typeof obj.length == 'number'){
if (obj.item) return 'collection';
if (obj.callee) return 'arguments';
}
}
return type;
};
/*
Function: $merge
merges a number of objects recursively without referencing them or their sub-objects.
Arguments:
any number of objects.
Example:
>var mergedObj = $merge(obj1, obj2, obj3);
>//obj1, obj2, and obj3 are unaltered
*/
function $merge(){
var mix = {};
for (var i = 0; i < arguments.length; i++){
for (var property in arguments[i]){
var ap = arguments[i][property];
var mp = mix[property];
if (mp && $type(ap) == 'object' && $type(mp) == 'object') mix[property] = $merge(mp, ap);
else mix[property] = ap;
}
}
return mix;
};
/*
Function: $extend
Copies all the properties from the second passed object to the first passed Object.
If you do myWhatever.extend = $extend the first parameter will become myWhatever, and your extend function will only need one parameter.
Example:
(start code)
var firstOb = {
'name': 'John',
'lastName': 'Doe'
};
var secondOb = {
'age': '20',
'sex': 'male',
'lastName': 'Dorian'
};
$extend(firstOb, secondOb);
//firstOb will become:
{
'name': 'John',
'lastName': 'Dorian',
'age': '20',
'sex': 'male'
};
(end)
Returns:
The first object, extended.
*/
var $extend = function(){
var args = arguments;
if (!args[1]) args = [this, args[0]];
for (var property in args[1]) args[0][property] = args[1][property];
return args[0];
};
/*
Function: $native
Will add a .extend method to the objects passed as a parameter, but the property passed in will be copied to the object's prototype only if non previously existent.
Its handy if you dont want the .extend method of an object to overwrite existing methods.
Used automatically in MooTools to implement Array/String/Function/Number methods to browser that dont support them whitout manual checking.
Arguments:
a number of classes/native javascript objects
*/
var $native = function(){
for (var i = 0, l = arguments.length; i < l; i++){
arguments[i].extend = function(props){
for (var prop in props){
if (!this.prototype[prop]) this.prototype[prop] = props[prop];
if (!this[prop]) this[prop] = $native.generic(prop);
}
};
}
};
$native.generic = function(prop){
return function(bind){
return this.prototype[prop].apply(bind, Array.prototype.slice.call(arguments, 1));
};
};
$native(Function, Array, String, Number);
/*
Function: $chk
Returns true if the passed in value/object exists or is 0, otherwise returns false.
Useful to accept zeroes.
Arguments:
obj - object to inspect
*/
function $chk(obj){
return !!(obj || obj === 0);
};
/*
Function: $pick
Returns the first object if defined, otherwise returns the second.
Arguments:
obj - object to test
picked - the default to return
Example:
(start code)
function say(msg){
alert($pick(msg, 'no meessage supplied'));
}
(end)
*/
function $pick(obj, picked){
return $defined(obj) ? obj : picked;
};
/*
Function: $random
Returns a random integer number between the two passed in values.
Arguments:
min - integer, the minimum value (inclusive).
max - integer, the maximum value (inclusive).
Returns:
a random integer between min and max.
*/
function $random(min, max){
return Math.floor(Math.random() * (max - min + 1) + min);
};
/*
Function: $time
Returns the current timestamp
Returns:
a timestamp integer.
*/
function $time(){
return new Date().getTime();
};
/*
Function: $clear
clears a timeout or an Interval.
Returns:
null
Arguments:
timer - the setInterval or setTimeout to clear.
Example:
>var myTimer = myFunction.delay(5000); //wait 5 seconds and execute my function.
>myTimer = $clear(myTimer); //nevermind
See also:
<Function.delay>, <Function.periodical>
*/
function $clear(timer){
clearTimeout(timer);
clearInterval(timer);
return null;
};
/*
Class: Abstract
Abstract class, to be used as singleton. Will add .extend to any object
Arguments:
an object
Returns:
the object with an .extend property, equivalent to <$extend>.
*/
var Abstract = function(obj){
obj = obj || {};
obj.extend = $extend;
return obj;
};
//window, document
var Window = new Abstract(window);
var Document = new Abstract(document);
document.head = document.getElementsByTagName('head')[0];
/*
Class: window
Some properties are attached to the window object by the browser detection.
Note:
browser detection is entirely object-based. We dont sniff.
Properties:
window.ie - will be set to true if the current browser is internet explorer (any).
window.ie6 - will be set to true if the current browser is internet explorer 6.
window.ie7 - will be set to true if the current browser is internet explorer 7.
window.gecko - will be set to true if the current browser is Mozilla/Gecko.
window.webkit - will be set to true if the current browser is Safari/Konqueror.
window.webkit419 - will be set to true if the current browser is Safari2 / webkit till version 419.
window.webkit420 - will be set to true if the current browser is Safari3 (Webkit SVN Build) / webkit over version 419.
window.opera - is set to true by opera itself.
*/
window.xpath = !!(document.evaluate);
if (window.ActiveXObject) window.ie = window[window.XMLHttpRequest ? 'ie7' : 'ie6'] = true;
else if (document.childNodes && !document.all && !navigator.taintEnabled) window.webkit = window[window.xpath ? 'webkit420' : 'webkit419'] = true;
else if (document.getBoxObjectFor != null) window.gecko = true;
/*compatibility*/
window.khtml = window.webkit;
Object.extend = $extend;
/*end compatibility*/
//htmlelement
if (typeof HTMLElement == 'undefined'){
var HTMLElement = function(){};
if (window.webkit) document.createElement("iframe"); //fixes safari
HTMLElement.prototype = (window.webkit) ? window["[[DOMElement.prototype]]"] : {};
}
HTMLElement.prototype.htmlElement = function(){};
//enables background image cache for internet explorer 6
if (window.ie6) try {document.execCommand("BackgroundImageCache", false, true);} catch(e){};
/*
Script: Class.js
Contains the Class Function, aims to ease the creation of reusable Classes.
License:
MIT-style license.
*/
/*
Class: Class
The base class object of the <http://mootools.net> framework.
Creates a new class, its initialize method will fire upon class instantiation.
Initialize wont fire on instantiation when you pass *null*.
Arguments:
properties - the collection of properties that apply to the class.
Example:
(start code)
var Cat = new Class({
initialize: function(name){
this.name = name;
}
});
var myCat = new Cat('Micia');
alert(myCat.name); //alerts 'Micia'
(end)
*/
var Class = function(properties){
var klass = function(){
return (arguments[0] !== null && this.initialize && $type(this.initialize) == 'function') ? this.initialize.apply(this, arguments) : this;
};
$extend(klass, this);
klass.prototype = properties;
klass.constructor = Class;
return klass;
};
/*
Property: empty
Returns an empty function
*/
Class.empty = function(){};
Class.prototype = {
/*
Property: extend
Returns the copy of the Class extended with the passed in properties.
Arguments:
properties - the properties to add to the base class in this new Class.
Example:
(start code)
var Animal = new Class({
initialize: function(age){
this.age = age;
}
});
var Cat = Animal.extend({
initialize: function(name, age){
this.parent(age); //will call the previous initialize;
this.name = name;
}
});
var myCat = new Cat('Micia', 20);
alert(myCat.name); //alerts 'Micia'
alert(myCat.age); //alerts 20
(end)
*/
extend: function(properties){
var proto = new this(null);
for (var property in properties){
var pp = proto[property];
proto[property] = Class.Merge(pp, properties[property]);
}
return new Class(proto);
},
/*
Property: implement
Implements the passed in properties to the base Class prototypes, altering the base class, unlike <Class.extend>.
Arguments:
properties - the properties to add to the base class.
Example:
(start code)
var Animal = new Class({
initialize: function(age){
this.age = age;
}
});
Animal.implement({
setName: function(name){
this.name = name
}
});
var myAnimal = new Animal(20);
myAnimal.setName('Micia');
alert(myAnimal.name); //alerts 'Micia'
(end)
*/
implement: function(){
for (var i = 0, l = arguments.length; i < l; i++) $extend(this.prototype, arguments[i]);
}
};
//internal
Class.Merge = function(previous, current){
if (previous && previous != current){
var type = $type(current);
if (type != $type(previous)) return current;
switch(type){
case 'function':
var merged = function(){
this.parent = arguments.callee.parent;
return current.apply(this, arguments);
};
merged.parent = previous;
return merged;
case 'object': return $merge(previous, current);
}
}
return current;
};
/*
Script: Array.js
Contains Array prototypes, <$A>, <$each>
License:
MIT-style license.
*/
/*
Class: Array
A collection of The Array Object prototype methods.
*/
//custom methods
Array.extend({
/*
Property: forEach
Iterates through an array; This method is only available for browsers without native *forEach* support.
For more info see <http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:forEach>
*forEach* executes the provided function (callback) once for each element present in the array. callback is invoked only for indexes of the array which have assigned values; it is not invoked for indexes which have been deleted or which have never been assigned values.
Arguments:
fn - function to execute with each item in the array; passed the item and the index of that item in the array
bind - the object to bind "this" to (see <Function.bind>)
Example:
>['apple','banana','lemon'].each(function(item, index){
> alert(index + " = " + item); //alerts "0 = apple" etc.
>}, bindObj); //optional second arg for binding, not used here
*/
forEach: function(fn, bind){
for (var i = 0, j = this.length; i < j; i++) fn.call(bind, this[i], i, this);
},
/*
Property: filter
This method is provided only for browsers without native *filter* support.
For more info see <http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Objects:Array:filter>
*filter* calls a provided callback function once for each element in an array, and constructs a new array of all the values for which callback returns a true value. callback is invoked only for indexes of the array which have assigned values; it is not invoked for indexes which have been deleted or which have never been assigned values. Array elements which do not pass the callback test are simply skipped, and are not included in the new array.
Arguments:
fn - function to execute with each item in the array; passed the item and the index of that item in the array
bind - the object to bind "this" to (see <Function.bind>)
Example:
>var biggerThanTwenty = [10,3,25,100].filter(function(item, index){
> return item > 20;
>});
>//biggerThanTwenty = [25,100]
*/
filter: function(fn, bind){
var results = [];
for (var i = 0, j = this.length; i < j; i++){
if (fn.call(bind, this[i], i, this)) results.push(this[i]);
}
return results;
},
/*
Property: map
This method is provided only for browsers without native *map* support.
For more info see <http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:map>
*map* calls a provided callback function once for each element in an array, in order, and constructs a new array from the results. callback is invoked only for indexes of the array which have assigned values; it is not invoked for indexes which have been deleted or which have never been assigned values.
Arguments:
fn - function to execute with each item in the array; passed the item and the index of that item in the array
bind - the object to bind "this" to (see <Function.bind>)
Example:
>var timesTwo = [1,2,3].map(function(item, index){
> return item*2;
>});
>//timesTwo = [2,4,6];
*/
map: function(fn, bind){
var results = [];
for (var i = 0, j = this.length; i < j; i++) results[i] = fn.call(bind, this[i], i, this);
return results;
},
/*
Property: every
This method is provided only for browsers without native *every* support.
For more info see <http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:every>
*every* executes the provided callback function once for each element present in the array until it finds one where callback returns a false value. If such an element is found, the every method immediately returns false. Otherwise, if callback returned a true value for all elements, every will return true. callback is invoked only for indexes of the array which have assigned values; it is not invoked for indexes which have been deleted or which have never been assigned values.
Arguments:
fn - function to execute with each item in the array; passed the item and the index of that item in the array
bind - the object to bind "this" to (see <Function.bind>)
Example:
>var areAllBigEnough = [10,4,25,100].every(function(item, index){
> return item > 20;
>});
>//areAllBigEnough = false
*/
every: function(fn, bind){
for (var i = 0, j = this.length; i < j; i++){
if (!fn.call(bind, this[i], i, this)) return false;
}
return true;
},
/*
Property: some
This method is provided only for browsers without native *some* support.
For more info see <http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:some>
*some* executes the callback function once for each element present in the array until it finds one where callback returns a true value. If such an element is found, some immediately returns true. Otherwise, some returns false. callback is invoked only for indexes of the array which have assigned values; it is not invoked for indexes which have been deleted or which have never been assigned values.
Arguments:
fn - function to execute with each item in the array; passed the item and the index of that item in the array
bind - the object to bind "this" to (see <Function.bind>)
Example:
>var isAnyBigEnough = [10,4,25,100].some(function(item, index){
> return item > 20;
>});
>//isAnyBigEnough = true
*/
some: function(fn, bind){
for (var i = 0, j = this.length; i < j; i++){
if (fn.call(bind, this[i], i, this)) return true;
}
return false;
},
/*
Property: indexOf
This method is provided only for browsers without native *indexOf* support.
For more info see <http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:indexOf>
*indexOf* compares a search element to elements of the Array using strict equality (the same method used by the ===, or triple-equals, operator).
Arguments:
item - any type of object; element to locate in the array
from - integer; optional; the index of the array at which to begin the search (defaults to 0)
Example:
>['apple','lemon','banana'].indexOf('lemon'); //returns 1
>['apple','lemon'].indexOf('banana'); //returns -1
*/
indexOf: function(item, from){
var len = this.length;
for (var i = (from < 0) ? Math.max(0, len + from) : from || 0; i < len; i++){
if (this[i] === item) return i;
}
return -1;
},
/*
Property: each
Same as <Array.forEach>.
Arguments:
fn - function to execute with each item in the array; passed the item and the index of that item in the array
bind - optional, the object that the "this" of the function will refer to.
Example:
>var Animals = ['Cat', 'Dog', 'Coala'];
>Animals.each(function(animal){
> document.write(animal)
>});
*/
/*
Property: copy
returns a copy of the array.
Returns:
a new array which is a copy of the current one.
Arguments:
start - integer; optional; the index where to start the copy, default is 0. If negative, it is taken as the offset from the end of the array.
length - integer; optional; the number of elements to copy. By default, copies all elements from start to the end of the array.
Example:
>var letters = ["a","b","c"];
>var copy = letters.copy(); // ["a","b","c"] (new instance)
*/
copy: function(start, length){
start = start || 0;
if (start < 0) start = this.length + start;
length = length || (this.length - start);
var newArray = [];
for (var i = 0; i < length; i++) newArray[i] = this[start++];
return newArray;
},
/*
Property: remove
Removes all occurrences of an item from the array.
Arguments:
item - the item to remove
Returns:
the Array with all occurrences of the item removed.
Example:
>["1","2","3","2"].remove("2") // ["1","3"];
*/
remove: function(item){
var i = 0;
var len = this.length;
while (i < len){
if (this[i] === item){
this.splice(i, 1);
len--;
} else {
i++;
}
}
return this;
},
/*
Property: contains
Tests an array for the presence of an item.
Arguments:
item - the item to search for in the array.
from - integer; optional; the index at which to begin the search, default is 0. If negative, it is taken as the offset from the end of the array.
Returns:
true - the item was found
false - it wasn't
Example:
>["a","b","c"].contains("a"); // true
>["a","b","c"].contains("d"); // false
*/
contains: function(item, from){
return this.indexOf(item, from) != -1;
},
/*
Property: associate
Creates an object with key-value pairs based on the array of keywords passed in
and the current content of the array.
Arguments:
keys - the array of keywords.
Example:
(start code)
var Animals = ['Cat', 'Dog', 'Coala', 'Lizard'];
var Speech = ['Miao', 'Bau', 'Fruuu', 'Mute'];
var Speeches = Animals.associate(Speech);
//Speeches['Miao'] is now Cat.
//Speeches['Bau'] is now Dog.
//...
(end)
*/
associate: function(keys){
var obj = {}, length = Math.min(this.length, keys.length);
for (var i = 0; i < length; i++) obj[keys[i]] = this[i];
return obj;
},
/*
Property: extend
Extends an array with another one.
Arguments:
array - the array to extend ours with
Example:
>var Animals = ['Cat', 'Dog', 'Coala'];
>Animals.extend(['Lizard']);
>//Animals is now: ['Cat', 'Dog', 'Coala', 'Lizard'];
*/
extend: function(array){
for (var i = 0, j = array.length; i < j; i++) this.push(array[i]);
return this;
},
/*
Property: merge
merges an array in another array, without duplicates. (case- and type-sensitive)
Arguments:
array - the array to merge from.
Example:
>['Cat','Dog'].merge(['Dog','Coala']); //returns ['Cat','Dog','Coala']
*/
merge: function(array){
for (var i = 0, l = array.length; i < l; i++) this.include(array[i]);
return this;
},
/*
Property: include
includes the passed in element in the array, only if its not already present. (case- and type-sensitive)
Arguments:
item - item to add to the array (if not present)
Example:
>['Cat','Dog'].include('Dog'); //returns ['Cat','Dog']
>['Cat','Dog'].include('Coala'); //returns ['Cat','Dog','Coala']
*/
include: function(item){
if (!this.contains(item)) this.push(item);
return this;
},
/*
Property: getRandom
returns a random item in the Array
*/
getRandom: function(){
return this[$random(0, this.length - 1)] || null;
},
/*
Property: getLast
returns the last item in the Array
*/
getLast: function(){
return this[this.length - 1] || null;
}
});
//copies
Array.prototype.each = Array.prototype.forEach;
Array.each = Array.forEach;
/* Section: Utility Functions */
/*
Function: $A()
Same as <Array.copy>, but as function.
Useful to apply Array prototypes to iterable objects, as a collection of DOM elements or the arguments object.
Example:
(start code)
function myFunction(){
$A(arguments).each(argument, function(){
alert(argument);
});
};
//the above will alert all the arguments passed to the function myFunction.
(end)
*/
function $A(array){
return Array.copy(array);
};
/*
Function: $each
Use to iterate through iterables that are not regular arrays, such as builtin getElementsByTagName calls, arguments of a function, or an object.
Arguments:
iterable - an iterable element or an objct.
function - function to apply to the iterable.
bind - optional, the 'this' of the function will refer to this object.
Function argument:
The function argument will be passed the following arguments.
item - the current item in the iterator being procesed
index - integer; the index of the item, or key in case of an object.
Examples:
(start code)
$each(['Sun','Mon','Tue'], function(day, index){
alert('name:' + day + ', index: ' + index);
});
//alerts "name: Sun, index: 0", "name: Mon, index: 1", etc.
//over an object
$each({first: "Sunday", second: "Monday", third: "Tuesday"}, function(value, key){
alert("the " + key + " day of the week is " + value);
});
//alerts "the first day of the week is Sunday",
//"the second day of the week is Monday", etc.
(end)
*/
function $each(iterable, fn, bind){
if (iterable && typeof iterable.length == 'number' && $type(iterable) != 'object'){
Array.forEach(iterable, fn, bind);
} else {
for (var name in iterable) fn.call(bind || iterable, iterable[name], name);
}
};
/*compatibility*/
Array.prototype.test = Array.prototype.contains;
/*end compatibility*/
/*
Script: String.js
Contains String prototypes.
License:
MIT-style license.
*/
/*
Class: String
A collection of The String Object prototype methods.
*/
String.extend({
/*
Property: test
Tests a string with a regular expression.
Arguments:
regex - a string or regular expression object, the regular expression you want to match the string with
params - optional, if first parameter is a string, any parameters you want to pass to the regex ('g' has no effect)
Returns:
true if a match for the regular expression is found in the string, false if not.
See <http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Objects:RegExp:test>
Example:
>"I like cookies".test("cookie"); // returns true
>"I like cookies".test("COOKIE", "i") // ignore case, returns true
>"I like cookies".test("cake"); // returns false
*/
test: function(regex, params){
return (($type(regex) == 'string') ? new RegExp(regex, params) : regex).test(this);
},
/*
Property: toInt
parses a string to an integer.
Returns:
either an int or "NaN" if the string is not a number.
Example:
>var value = "10px".toInt(); // value is 10
*/
toInt: function(){
return parseInt(this, 10);
},
/*
Property: toFloat
parses a string to an float.
Returns:
either a float or "NaN" if the string is not a number.
Example:
>var value = "10.848".toFloat(); // value is 10.848
*/
toFloat: function(){
return parseFloat(this);
},
/*
Property: camelCase
Converts a hiphenated string to a camelcase string.
Example:
>"I-like-cookies".camelCase(); //"ILikeCookies"
Returns:
the camel cased string
*/
camelCase: function(){
return this.replace(/-\D/g, function(match){
return match.charAt(1).toUpperCase();
});
},
/*
Property: hyphenate
Converts a camelCased string to a hyphen-ated string.
Example:
>"ILikeCookies".hyphenate(); //"I-like-cookies"
*/
hyphenate: function(){
return this.replace(/\w[A-Z]/g, function(match){
return (match.charAt(0) + '-' + match.charAt(1).toLowerCase());
});
},
/*
Property: capitalize
Converts the first letter in each word of a string to Uppercase.
Example:
>"i like cookies".capitalize(); //"I Like Cookies"
Returns:
the capitalized string
*/
capitalize: function(){
return this.replace(/\b[a-z]/g, function(match){
return match.toUpperCase();
});
},
/*
Property: trim
Trims the leading and trailing spaces off a string.
Example:
>" i like cookies ".trim() //"i like cookies"
Returns:
the trimmed string
*/
trim: function(){
return this.replace(/^\s+|\s+$/g, '');
},
/*
Property: clean
trims (<String.trim>) a string AND removes all the double spaces in a string.
Returns:
the cleaned string
Example:
>" i like cookies \n\n".clean() //"i like cookies"
*/
clean: function(){
return this.replace(/\s{2,}/g, ' ').trim();
},
/*
Property: rgbToHex
Converts an RGB value to hexidecimal. The string must be in the format of "rgb(255,255,255)" or "rgba(255,255,255,1)";
Arguments:
array - boolean value, defaults to false. Use true if you want the array ['FF','33','00'] as output instead of "#FF3300"
Returns:
hex string or array. returns "transparent" if the output is set as string and the fourth value of rgba in input string is 0.
Example:
>"rgb(17,34,51)".rgbToHex(); //"#112233"
>"rgba(17,34,51,0)".rgbToHex(); //"transparent"
>"rgb(17,34,51)".rgbToHex(true); //['11','22','33']
*/
rgbToHex: function(array){
var rgb = this.match(/\d{1,3}/g);
return (rgb) ? rgb.rgbToHex(array) : false;
},
/*
Property: hexToRgb
Converts a hexidecimal color value to RGB. Input string must be the hex color value (with or without the hash). Also accepts triplets ('333');
Arguments:
array - boolean value, defaults to false. Use true if you want the array [255,255,255] as output instead of "rgb(255,255,255)";
Returns:
rgb string or array.
Example:
>"#112233".hexToRgb(); //"rgb(17,34,51)"
>"#112233".hexToRgb(true); //[17,34,51]
*/
hexToRgb: function(array){
var hex = this.match(/^#?(\w{1,2})(\w{1,2})(\w{1,2})$/);
return (hex) ? hex.slice(1).hexToRgb(array) : false;
},
/*
Property: contains
checks if the passed in string is contained in the String. also accepts an optional second parameter, to check if the string is contained in a list of separated values.
Example:
>'a b c'.contains('c', ' '); //true
>'a bc'.contains('bc'); //true
>'a bc'.contains('b', ' '); //false
*/
contains: function(string, s){
return (s) ? (s + this + s).indexOf(s + string + s) > -1 : this.indexOf(string) > -1;
},
/*
Property: escapeRegExp
Returns string with escaped regular expression characters
Example:
>var search = 'animals.sheeps[1]'.escapeRegExp(); // search is now 'animals\.sheeps\[1\]'
Returns:
Escaped string
*/
escapeRegExp: function(){
return this.replace(/([.*+?^${}()|[\]\/\\])/g, '\\$1');
}
});
Array.extend({
/*
Property: rgbToHex
see <String.rgbToHex>, but as an array method.
*/
rgbToHex: function(array){
if (this.length < 3) return false;
if (this.length == 4 && this[3] == 0 && !array) return 'transparent';
var hex = [];
for (var i = 0; i < 3; i++){
var bit = (this[i] - 0).toString(16);
hex.push((bit.length == 1) ? '0' + bit : bit);
}
return array ? hex : '#' + hex.join('');
},
/*
Property: hexToRgb
same as <String.hexToRgb>, but as an array method.
*/
hexToRgb: function(array){
if (this.length != 3) return false;
var rgb = [];
for (var i = 0; i < 3; i++){
rgb.push(parseInt((this[i].length == 1) ? this[i] + this[i] : this[i], 16));
}
return array ? rgb : 'rgb(' + rgb.join(',') + ')';
}
});
/*
Script: Function.js
Contains Function prototypes and utility functions .
License:
MIT-style license.
Credits:
- Some functions are inspired by those found in prototype.js <http://prototype.conio.net/> (c) 2005 Sam Stephenson sam [at] conio [dot] net, MIT-style license
*/
/*
Class: Function
A collection of The Function Object prototype methods.
*/
Function.extend({
/*
Property: create
Main function to create closures.
Returns:
a function.
Arguments:
options - An Options object.
Options:
bind - The object that the "this" of the function will refer to. Default is the current function.
event - If set to true, the function will act as an event listener and receive an event as first argument.
If set to a class name, the function will receive a new instance of this class (with the event passed as argument's constructor) as first argument.
Default is false.
arguments - A single argument or array of arguments that will be passed to the function when called.
If both the event and arguments options are set, the event is passed as first argument and the arguments array will follow.
Default is no custom arguments, the function will receive the standard arguments when called.
delay - Numeric value: if set, the returned function will delay the actual execution by this amount of milliseconds and return a timer handle when called.
Default is no delay.
periodical - Numeric value: if set, the returned function will periodically perform the actual execution with this specified interval and return a timer handle when called.
Default is no periodical execution.
attempt - If set to true, the returned function will try to execute and return either the results or false on error. Default is false.
*/
create: function(options){
var fn = this;
options = $merge({
'bind': fn,
'event': false,
'arguments': null,
'delay': false,
'periodical': false,
'attempt': false
}, options);
if ($chk(options.arguments) && $type(options.arguments) != 'array') options.arguments = [options.arguments];
return function(event){
var args;
if (options.event){
event = event || window.event;
args = [(options.event === true) ? event : new options.event(event)];
if (options.arguments) args.extend(options.arguments);
}
else args = options.arguments || arguments;
var returns = function(){
return fn.apply($pick(options.bind, fn), args);
};
if (options.delay) return setTimeout(returns, options.delay);
if (options.periodical) return setInterval(returns, options.periodical);
if (options.attempt) try {return returns();} catch(err){return false;};
return returns();
};
},
/*
Property: pass
Shortcut to create closures with arguments and bind.
Returns:
a function.
Arguments:
args - the arguments passed. must be an array if arguments > 1
bind - optional, the object that the "this" of the function will refer to.
Example:
>myFunction.pass([arg1, arg2], myElement);
*/
pass: function(args, bind){
return this.create({'arguments': args, 'bind': bind});
},
/*
Property: attempt
Tries to execute the function, returns either the result of the function or false on error.
Arguments:
args - the arguments passed. must be an array if arguments > 1
bind - optional, the object that the "this" of the function will refer to.
Example:
>myFunction.attempt([arg1, arg2], myElement);
*/
attempt: function(args, bind){
return this.create({'arguments': args, 'bind': bind, 'attempt': true})();
},
/*
Property: bind
method to easily create closures with "this" altered.
Arguments:
bind - optional, the object that the "this" of the function will refer to.
args - optional, the arguments passed. must be an array if arguments > 1
Returns:
a function.
Example:
>function myFunction(){
> this.setStyle('color', 'red');
> // note that 'this' here refers to myFunction, not an element
> // we'll need to bind this function to the element we want to alter
>};
>var myBoundFunction = myFunction.bind(myElement);
>myBoundFunction(); // this will make the element myElement red.
*/
bind: function(bind, args){
return this.create({'bind': bind, 'arguments': args});
},
/*
Property: bindAsEventListener
cross browser method to pass event firer
Arguments:
bind - optional, the object that the "this" of the function will refer to.
args - optional, the arguments passed. must be an array if arguments > 1
Returns:
a function with the parameter bind as its "this" and as a pre-passed argument event or window.event, depending on the browser.
Example:
>function myFunction(event){
> alert(event.clientx) //returns the coordinates of the mouse..
>};
>myElement.onclick = myFunction.bindAsEventListener(myElement);
*/
bindAsEventListener: function(bind, args){
return this.create({'bind': bind, 'event': true, 'arguments': args});
},
/*
Property: delay
Delays the execution of a function by a specified duration.
Arguments:
delay - the duration to wait in milliseconds.
bind - optional, the object that the "this" of the function will refer to.
args - optional, the arguments passed. must be an array if arguments > 1
Example:
>myFunction.delay(50, myElement) //wait 50 milliseconds, then call myFunction and bind myElement to it
>(function(){alert('one second later...')}).delay(1000); //wait a second and alert
*/
delay: function(delay, bind, args){
return this.create({'delay': delay, 'bind': bind, 'arguments': args})();
},
/*
Property: periodical
Executes a function in the specified intervals of time
Arguments:
interval - the duration of the intervals between executions.
bind - optional, the object that the "this" of the function will refer to.
args - optional, the arguments passed. must be an array if arguments > 1
*/
periodical: function(interval, bind, args){
return this.create({'periodical': interval, 'bind': bind, 'arguments': args})();
}
});
/*
Script: Number.js
Contains the Number prototypes.
License:
MIT-style license.
*/
/*
Class: Number
A collection of The Number Object prototype methods.
*/
Number.extend({
/*
Property: toInt
Returns this number; useful because toInt must work on both Strings and Numbers.
*/
toInt: function(){
return parseInt(this);
},
/*
Property: toFloat
Returns this number as a float; useful because toFloat must work on both Strings and Numbers.
*/
toFloat: function(){
return parseFloat(this);
},
/*
Property: limit
Limits the number.
Arguments:
min - number, minimum value
max - number, maximum value
Returns:
the number in the given limits.
Example:
>(12).limit(2, 6.5) // returns 6.5
>(-4).limit(2, 6.5) // returns 2
>(4.3).limit(2, 6.5) // returns 4.3
*/
limit: function(min, max){
return Math.min(max, Math.max(min, this));
},
/*
Property: round
Returns the number rounded to specified precision.
Arguments:
precision - integer, number of digits after the decimal point. Can also be negative or zero (default).
Example:
>12.45.round() // returns 12
>12.45.round(1) // returns 12.5
>12.45.round(-1) // returns 10
Returns:
The rounded number.
*/
round: function(precision){
precision = Math.pow(10, precision || 0);
return Math.round(this * precision) / precision;
},
/*
Property: times
Executes a passed in function the specified number of times
Arguments:
function - the function to be executed on each iteration of the loop
Example:
>(4).times(alert);
*/
times: function(fn){
for (var i = 0; i < this; i++) fn(i);
}
});
/*
Script: Element.js
Contains useful Element prototypes, to be used with the dollar function <$>.
License:
MIT-style license.
Credits:
- Some functions are inspired by those found in prototype.js <http://prototype.conio.net/> (c) 2005 Sam Stephenson sam [at] conio [dot] net, MIT-style license
*/
/*
Class: Element
Custom class to allow all of its methods to be used with any DOM element via the dollar function <$>.
*/
var Element = new Class({
/*
Property: initialize
Creates a new element of the type passed in.
Arguments:
el - string; the tag name for the element you wish to create. you can also pass in an element reference, in which case it will be extended.
props - object; the properties you want to add to your element.
Accepts the same keys as <Element.setProperties>, but also allows events and styles
Props:
the key styles will be used as setStyles, the key events will be used as addEvents. any other key is used as setProperty.
Example:
(start code)
new Element('a', {
'styles': {
'display': 'block',
'border': '1px solid black'
},
'events': {
'click': function(){
//aaa
},
'mousedown': function(){
//aaa
}
},
'class': 'myClassSuperClass',
'href': 'http://mad4milk.net'
});
(end)
*/
initialize: function(el, props){
if ($type(el) == 'string'){
if (window.ie && props && (props.name || props.type)){
var name = (props.name) ? ' name="' + props.name + '"' : '';
var type = (props.type) ? ' type="' + props.type + '"' : '';
delete props.name;
delete props.type;
el = '<' + el + name + type + '>';
}
el = document.createElement(el);
}
el = $(el);
return (!props || !el) ? el : el.set(props);
}
});
/*
Class: Elements
- Every dom function such as <$$>, or in general every function that returns a collection of nodes in mootools, returns them as an Elements class.
- The purpose of the Elements class is to allow <Element> methods to work also on <Elements> array.
- Elements is also an Array, so it accepts all the <Array> methods.
- Every node of the Elements instance is already extended with <$>.
Example:
>$$('myselector').each(function(el){
> //...
>});
some iterations here, $$('myselector') is also an array.
>$$('myselector').setStyle('color', 'red');
every element returned by $$('myselector') also accepts <Element> methods, in this example every element will be made red.
*/
var Elements = new Class({
initialize: function(elements){
return (elements) ? $extend(elements, this) : this;
}
});
Elements.extend = function(props){
for (var prop in props){
this.prototype[prop] = props[prop];
this[prop] = $native.generic(prop);
}
};
/*
Section: Utility Functions
Function: $
returns the element passed in with all the Element prototypes applied.
Arguments:
el - a reference to an actual element or a string representing the id of an element
Example:
>$('myElement') // gets a DOM element by id with all the Element prototypes applied.
>var div = document.getElementById('myElement');
>$(div) //returns an Element also with all the mootools extentions applied.
You'll use this when you aren't sure if a variable is an actual element or an id, as
well as just shorthand for document.getElementById().
Returns:
a DOM element or false (if no id was found).
Note:
you need to call $ on an element only once to get all the prototypes.
But its no harm to call it multiple times, as it will detect if it has been already extended.
*/
function $(el){
if (!el) return null;
if (el.htmlElement) return Garbage.collect(el);
if ([window, document].contains(el)) return el;
var type = $type(el);
if (type == 'string'){
el = document.getElementById(el);
type = (el) ? 'element' : false;
}
if (type != 'element') return null;
if (el.htmlElement) return Garbage.collect(el);
if (['object', 'embed'].contains(el.tagName.toLowerCase())) return el;
$extend(el, Element.prototype);
el.htmlElement = function(){};
return Garbage.collect(el);
};
/*
Function: $$
Selects, and extends DOM elements. Elements arrays returned with $$ will also accept all the <Element> methods.
The return type of element methods run through $$ is always an array. If the return array is only made by elements,
$$ will be applied automatically.
Arguments:
HTML Collections, arrays of elements, arrays of strings as element ids, elements, strings as selectors.
Any number of the above as arguments are accepted.
Note:
if you load <Element.Selectors.js>, $$ will also accept CSS Selectors, otherwise the only selectors supported are tag names.
Example:
>$$('a') //an array of all anchor tags on the page
>$$('a', 'b') //an array of all anchor and bold tags on the page
>$$('#myElement') //array containing only the element with id = myElement. (only with <Element.Selectors.js>)
>$$('#myElement a.myClass') //an array of all anchor tags with the class "myClass"
>//within the DOM element with id "myElement" (only with <Element.Selectors.js>)
>$$(myelement, myelement2, 'a', ['myid', myid2, 'myid3'], document.getElementsByTagName('div')) //an array containing:
>// the element referenced as myelement if existing,
>// the element referenced as myelement2 if existing,
>// all the elements with a as tag in the page,
>// the element with id = myid if existing
>// the element with id = myid2 if existing
>// the element with id = myid3 if existing
>// all the elements with div as tag in the page
Returns:
array - array of all the dom elements matched, extended with <$>. Returns as <Elements>.
*/
document.getElementsBySelector = document.getElementsByTagName;
function $$(){
var elements = [];
for (var i = 0, j = arguments.length; i < j; i++){
var selector = arguments[i];
switch($type(selector)){
case 'element': elements.push(selector);
case 'boolean': break;
case false: break;
case 'string': selector = document.getElementsBySelector(selector, true);
default: elements.extend(selector);
}
}
return $$.unique(elements);
};
$$.unique = function(array){
var elements = [];
for (var i = 0, l = array.length; i < l; i++){
if (array[i].$included) continue;
var element = $(array[i]);
if (element && !element.$included){
element.$included = true;
elements.push(element);
}
}
for (var n = 0, d = elements.length; n < d; n++) elements[n].$included = null;
return new Elements(elements);
};
Elements.Multi = function(property){
return function(){
var args = arguments;
var items = [];
var elements = true;
for (var i = 0, j = this.length, returns; i < j; i++){
returns = this[i][property].apply(this[i], args);
if ($type(returns) != 'element') elements = false;
items.push(returns);
};
return (elements) ? $$.unique(items) : items;
};
};
Element.extend = function(properties){
for (var property in properties){
HTMLElement.prototype[property] = properties[property];
Element.prototype[property] = properties[property];
Element[property] = $native.generic(property);
var elementsProperty = (Array.prototype[property]) ? property + 'Elements' : property;
Elements.prototype[elementsProperty] = Elements.Multi(property);
}
};
/*
Class: Element
Custom class to allow all of its methods to be used with any DOM element via the dollar function <$>.
*/
Element.extend({
/*
Property: set
you can set events, styles and properties with this shortcut. same as calling new Element.
*/
set: function(props){
for (var prop in props){
var val = props[prop];
switch(prop){
case 'styles': this.setStyles(val); break;
case 'events': if (this.addEvents) this.addEvents(val); break;
case 'properties': this.setProperties(val); break;
default: this.setProperty(prop, val);
}
}
return this;
},
inject: function(el, where){
el = $(el);
switch(where){
case 'before': el.parentNode.insertBefore(this, el); break;
case 'after':
var next = el.getNext();
if (!next) el.parentNode.appendChild(this);
else el.parentNode.insertBefore(this, next);
break;
case 'top':
var first = el.firstChild;
if (first){
el.insertBefore(this, first);
break;
}
default: el.appendChild(this);
}
return this;
},
/*
Property: injectBefore
Inserts the Element before the passed element.
Arguments:
el - an element reference or the id of the element to be injected in.
Example:
>html:
><div id="myElement"></div>
><div id="mySecondElement"></div>
>js:
>$('mySecondElement').injectBefore('myElement');
>resulting html:
><div id="mySecondElement"></div>
><div id="myElement"></div>
*/
injectBefore: function(el){
return this.inject(el, 'before');
},
/*
Property: injectAfter
Same as <Element.injectBefore>, but inserts the element after.
*/
injectAfter: function(el){
return this.inject(el, 'after');
},
/*
Property: injectInside
Same as <Element.injectBefore>, but inserts the element inside.
*/
injectInside: function(el){
return this.inject(el, 'bottom');
},
/*
Property: injectTop
Same as <Element.injectInside>, but inserts the element inside, at the top.
*/
injectTop: function(el){
return this.inject(el, 'top');
},
/*
Property: adopt
Inserts the passed elements inside the Element.
Arguments:
accepts elements references, element ids as string, selectors ($$('stuff')) / array of elements, array of ids as strings and collections.
*/
adopt: function(){
var elements = [];
$each(arguments, function(argument){
elements = elements.concat(argument);
});
$$(elements).inject(this);
return this;
},
/*
Property: remove
Removes the Element from the DOM.
Example:
>$('myElement').remove() //bye bye
*/
remove: function(){
return this.parentNode.removeChild(this);
},
/*
Property: clone
Clones the Element and returns the cloned one.
Arguments:
contents - boolean, when true the Element is cloned with childNodes, default true
Returns:
the cloned element
Example:
>var clone = $('myElement').clone().injectAfter('myElement');
>//clones the Element and append the clone after the Element.
*/
clone: function(contents){
var el = $(this.cloneNode(contents !== false));
if (!el.$events) return el;
el.$events = {};
for (var type in this.$events) el.$events[type] = {
'keys': $A(this.$events[type].keys),
'values': $A(this.$events[type].values)
};
return el.removeEvents();
},
/*
Property: replaceWith
Replaces the Element with an element passed.
Arguments:
el - a string representing the element to be injected in (myElementId, or div), or an element reference.
If you pass div or another tag, the element will be created.
Returns:
the passed in element
Example:
>$('myOldElement').replaceWith($('myNewElement')); //$('myOldElement') is gone, and $('myNewElement') is in its place.
*/
replaceWith: function(el){
el = $(el);
this.parentNode.replaceChild(el, this);
return el;
},
/*
Property: appendText
Appends text node to a DOM element.
Arguments:
text - the text to append.
Example:
><div id="myElement">hey</div>
>$('myElement').appendText(' howdy'); //myElement innerHTML is now "hey howdy"
*/
appendText: function(text){
this.appendChild(document.createTextNode(text));
return this;
},
/*
Property: hasClass
Tests the Element to see if it has the passed in className.
Returns:
true - the Element has the class
false - it doesn't
Arguments:
className - string; the class name to test.
Example:
><div id="myElement" class="testClass"></div>
>$('myElement').hasClass('testClass'); //returns true
*/
hasClass: function(className){
return this.className.contains(className, ' ');
},
/*
Property: addClass
Adds the passed in class to the Element, if the element doesnt already have it.
Arguments:
className - string; the class name to add
Example:
><div id="myElement" class="testClass"></div>
>$('myElement').addClass('newClass'); //<div id="myElement" class="testClass newClass"></div>
*/
addClass: function(className){
if (!this.hasClass(className)) this.className = (this.className + ' ' + className).clean();
return this;
},
/*
Property: removeClass
Works like <Element.addClass>, but removes the class from the element.
*/
removeClass: function(className){
this.className = this.className.replace(new RegExp('(^|\\s)' + className + '(?:\\s|$)'), '$1').clean();
return this;
},
/*
Property: toggleClass
Adds or removes the passed in class name to the element, depending on if it's present or not.
Arguments:
className - the class to add or remove
Example:
><div id="myElement" class="myClass"></div>
>$('myElement').toggleClass('myClass');
><div id="myElement" class=""></div>
>$('myElement').toggleClass('myClass');
><div id="myElement" class="myClass"></div>
*/
toggleClass: function(className){
return this.hasClass(className) ? this.removeClass(className) : this.addClass(className);
},
/*
Property: setStyle
Sets a css property to the Element.
Arguments:
property - the property to set
value - the value to which to set it; for numeric values that require "px" you can pass an integer
Example:
>$('myElement').setStyle('width', '300px'); //the width is now 300px
>$('myElement').setStyle('width', 300); //the width is now 300px
*/
setStyle: function(property, value){
switch(property){
case 'opacity': return this.setOpacity(parseFloat(value));
case 'float': property = (window.ie) ? 'styleFloat' : 'cssFloat';
}
property = property.camelCase();
switch($type(value)){
case 'number': if (!['zIndex', 'zoom'].contains(property)) value += 'px'; break;
case 'array': value = 'rgb(' + value.join(',') + ')';
}
this.style[property] = value;
return this;
},
/*
Property: setStyles
Applies a collection of styles to the Element.
Arguments:
source - an object or string containing all the styles to apply. When its a string it overrides old style.
Examples:
>$('myElement').setStyles({
> border: '1px solid #000',
> width: 300,
> height: 400
>});
OR
>$('myElement').setStyles('border: 1px solid #000; width: 300px; height: 400px;');
*/
setStyles: function(source){
switch($type(source)){
case 'object': Element.setMany(this, 'setStyle', source); break;
case 'string': this.style.cssText = source;
}
return this;
},
/*
Property: setOpacity
Sets the opacity of the Element, and sets also visibility == "hidden" if opacity == 0, and visibility = "visible" if opacity > 0.
Arguments:
opacity - float; Accepts values from 0 to 1.
Example:
>$('myElement').setOpacity(0.5) //make it 50% transparent
*/
setOpacity: function(opacity){
if (opacity == 0){
if (this.style.visibility != "hidden") this.style.visibility = "hidden";
} else {
if (this.style.visibility != "visible") this.style.visibility = "visible";
}
if (!this.currentStyle || !this.currentStyle.hasLayout) this.style.zoom = 1;
if (window.ie) this.style.filter = (opacity == 1) ? '' : "alpha(opacity=" + opacity * 100 + ")";
this.style.opacity = this.$tmp.opacity = opacity;
return this;
},
/*
Property: getStyle
Returns the style of the Element given the property passed in.
Arguments:
property - the css style property you want to retrieve
Example:
>$('myElement').getStyle('width'); //returns "400px"
>//but you can also use
>$('myElement').getStyle('width').toInt(); //returns 400
Returns:
the style as a string
*/
getStyle: function(property){
property = property.camelCase();
var result = this.style[property];
if (!$chk(result)){
if (property == 'opacity') return this.$tmp.opacity;
result = [];
for (var style in Element.Styles){
if (property == style){
Element.Styles[style].each(function(s){
var style = this.getStyle(s);
result.push(parseInt(style) ? style : '0px');
}, this);
if (property == 'border'){
var every = result.every(function(bit){
return (bit == result[0]);
});
return (every) ? result[0] : false;
}
return result.join(' ');
}
}
if (property.contains('border')){
if (Element.Styles.border.contains(property)){
return ['Width', 'Style', 'Color'].map(function(p){
return this.getStyle(property + p);
}, this).join(' ');
} else if (Element.borderShort.contains(property)){
return ['Top', 'Right', 'Bottom', 'Left'].map(function(p){
return this.getStyle('border' + p + property.replace('border', ''));
}, this).join(' ');
}
}
if (document.defaultView) result = document.defaultView.getComputedStyle(this, null).getPropertyValue(property.hyphenate());
else if (this.currentStyle) result = this.currentStyle[property];
}
if (window.ie) result = Element.fixStyle(property, result, this);
if (result && property.test(/color/i) && result.contains('rgb')){
return result.split('rgb').splice(1,4).map(function(color){
return color.rgbToHex();
}).join(' ');
}
return result;
},
/*
Property: getStyles
Returns an object of styles of the Element for each argument passed in.
Arguments:
properties - strings; any number of style properties
Example:
>$('myElement').getStyles('width','height','padding');
>//returns an object like:
>{width: "10px", height: "10px", padding: "10px 0px 10px 0px"}
*/
getStyles: function(){
return Element.getMany(this, 'getStyle', arguments);
},
walk: function(brother, start){
brother += 'Sibling';
var el = (start) ? this[start] : this[brother];
while (el && $type(el) != 'element') el = el[brother];
return $(el);
},
/*
Property: getPrevious
Returns the previousSibling of the Element, excluding text nodes.
Example:
>$('myElement').getPrevious(); //get the previous DOM element from myElement
Returns:
the sibling element or undefined if none found.
*/
getPrevious: function(){
return this.walk('previous');
},
/*
Property: getNext
Works as Element.getPrevious, but tries to find the nextSibling.
*/
getNext: function(){
return this.walk('next');
},
/*
Property: getFirst
Works as <Element.getPrevious>, but tries to find the firstChild.
*/
getFirst: function(){
return this.walk('next', 'firstChild');
},
/*
Property: getLast
Works as <Element.getPrevious>, but tries to find the lastChild.
*/
getLast: function(){
return this.walk('previous', 'lastChild');
},
/*
Property: getParent
returns the $(element.parentNode)
*/
getParent: function(){
return $(this.parentNode);
},
/*
Property: getChildren
returns all the $(element.childNodes), excluding text nodes. Returns as <Elements>.
*/
getChildren: function(){
return $$(this.childNodes);
},
/*
Property: hasChild
returns true if the passed in element is a child of the $(element).
*/
hasChild: function(el){
return !!$A(this.getElementsByTagName('*')).contains(el);
},
/*
Property: getProperty
Gets the an attribute of the Element.
Arguments:
property - string; the attribute to retrieve
Example:
>$('myImage').getProperty('src') // returns whatever.gif
Returns:
the value, or an empty string
*/
getProperty: function(property){
var index = Element.Properties[property];
if (index) return this[index];
var flag = Element.PropertiesIFlag[property] || 0;
if (!window.ie || flag) return this.getAttribute(property, flag);
var node = this.attributes[property];
return (node) ? node.nodeValue : null;
},
/*
Property: removeProperty
Removes an attribute from the Element
Arguments:
property - string; the attribute to remove
*/
removeProperty: function(property){
var index = Element.Properties[property];
if (index) this[index] = '';
else this.removeAttribute(property);
return this;
},
/*
Property: getProperties
same as <Element.getStyles>, but for properties
*/
getProperties: function(){
return Element.getMany(this, 'getProperty', arguments);
},
/*
Property: setProperty
Sets an attribute for the Element.
Arguments:
property - string; the property to assign the value passed in
value - the value to assign to the property passed in
Example:
>$('myImage').setProperty('src', 'whatever.gif'); //myImage now points to whatever.gif for its source
*/
setProperty: function(property, value){
var index = Element.Properties[property];
if (index) this[index] = value;
else this.setAttribute(property, value);
return this;
},
/*
Property: setProperties
Sets numerous attributes for the Element.
Arguments:
source - an object with key/value pairs.
Example:
(start code)
$('myElement').setProperties({
src: 'whatever.gif',
alt: 'whatever dude'
});
<img src="whatever.gif" alt="whatever dude">
(end)
*/
setProperties: function(source){
return Element.setMany(this, 'setProperty', source);
},
/*
Property: setHTML
Sets the innerHTML of the Element.
Arguments:
html - string; the new innerHTML for the element.
Example:
>$('myElement').setHTML(newHTML) //the innerHTML of myElement is now = newHTML
*/
setHTML: function(){
this.innerHTML = $A(arguments).join('');
return this;
},
/*
Property: setText
Sets the inner text of the Element.
Arguments:
text - string; the new text content for the element.
Example:
>$('myElement').setText('some text') //the text of myElement is now = 'some text'
*/
setText: function(text){
var tag = this.getTag();
if (['style', 'script'].contains(tag)){
if (window.ie){
if (tag == 'style') this.styleSheet.cssText = text;
else if (tag == 'script') this.setProperty('text', text);
return this;
} else {
this.removeChild(this.firstChild);
return this.appendText(text);
}
}
this[$defined(this.innerText) ? 'innerText' : 'textContent'] = text;
return this;
},
/*
Property: getText
Gets the inner text of the Element.
*/
getText: function(){
var tag = this.getTag();
if (['style', 'script'].contains(tag)){
if (window.ie){
if (tag == 'style') return this.styleSheet.cssText;
else if (tag == 'script') return this.getProperty('text');
} else {
return this.innerHTML;
}
}
return ($pick(this.innerText, this.textContent));
},
/*
Property: getTag
Returns the tagName of the element in lower case.
Example:
>$('myImage').getTag() // returns 'img'
Returns:
The tag name in lower case
*/
getTag: function(){
return this.tagName.toLowerCase();
},
/*
Property: empty
Empties an element of all its children.
Example:
>$('myDiv').empty() // empties the Div and returns it
Returns:
The element.
*/
empty: function(){
Garbage.trash(this.getElementsByTagName('*'));
return this.setHTML('');
}
});
Element.fixStyle = function(property, result, element){
if ($chk(parseInt(result))) return result;
if (['height', 'width'].contains(property)){
var values = (property == 'width') ? ['left', 'right'] : ['top', 'bottom'];
var size = 0;
values.each(function(value){
size += element.getStyle('border-' + value + '-width').toInt() + element.getStyle('padding-' + value).toInt();
});
return element['offset' + property.capitalize()] - size + 'px';
} else if (property.test(/border(.+)Width|margin|padding/)){
return '0px';
}
return result;
};
Element.Styles = {'border': [], 'padding': [], 'margin': []};
['Top', 'Right', 'Bottom', 'Left'].each(function(direction){
for (var style in Element.Styles) Element.Styles[style].push(style + direction);
});
Element.borderShort = ['borderWidth', 'borderStyle', 'borderColor'];
Element.getMany = function(el, method, keys){
var result = {};
$each(keys, function(key){
result[key] = el[method](key);
});
return result;
};
Element.setMany = function(el, method, pairs){
for (var key in pairs) el[method](key, pairs[key]);
return el;
};
Element.Properties = new Abstract({
'class': 'className', 'for': 'htmlFor', 'colspan': 'colSpan', 'rowspan': 'rowSpan',
'accesskey': 'accessKey', 'tabindex': 'tabIndex', 'maxlength': 'maxLength',
'readonly': 'readOnly', 'frameborder': 'frameBorder', 'value': 'value',
'disabled': 'disabled', 'checked': 'checked', 'multiple': 'multiple', 'selected': 'selected'
});
Element.PropertiesIFlag = {
'href': 2, 'src': 2
};
Element.Methods = {
Listeners: {
addListener: function(type, fn){
if (this.addEventListener) this.addEventListener(type, fn, false);
else this.attachEvent('on' + type, fn);
return this;
},
removeListener: function(type, fn){
if (this.removeEventListener) this.removeEventListener(type, fn, false);
else this.detachEvent('on' + type, fn);
return this;
}
}
};
window.extend(Element.Methods.Listeners);
document.extend(Element.Methods.Listeners);
Element.extend(Element.Methods.Listeners);
var Garbage = {
elements: [],
collect: function(el){
if (!el.$tmp){
Garbage.elements.push(el);
el.$tmp = {'opacity': 1};
}
return el;
},
trash: function(elements){
for (var i = 0, j = elements.length, el; i < j; i++){
if (!(el = elements[i]) || !el.$tmp) continue;
if (el.$events) el.fireEvent('trash').removeEvents();
for (var p in el.$tmp) el.$tmp[p] = null;
for (var d in Element.prototype) el[d] = null;
Garbage.elements[Garbage.elements.indexOf(el)] = null;
el.htmlElement = el.$tmp = el = null;
}
Garbage.elements.remove(null);
},
empty: function(){
Garbage.collect(window);
Garbage.collect(document);
Garbage.trash(Garbage.elements);
}
};
window.addListener('beforeunload', function(){
window.addListener('unload', Garbage.empty);
if (window.ie) window.addListener('unload', CollectGarbage);
});
/*
Script: Element.Form.js
Contains Element prototypes to deal with Forms and their elements.
License:
MIT-style license.
*/
/*
Class: Element
Custom class to allow all of its methods to be used with any DOM element via the dollar function <$>.
*/
Element.extend({
/*
Property: getValue
Returns the value of the Element, if its tag is textarea, select or input. getValue called on a multiple select will return an array.
*/
getValue: function(){
switch(this.getTag()){
case 'select':
var values = [];
$each(this.options, function(option){
if (option.selected) values.push($pick(option.value, option.text));
});
return (this.multiple) ? values : values[0];
case 'input': if (!(this.checked && ['checkbox', 'radio'].contains(this.type)) && !['hidden', 'text', 'password'].contains(this.type)) break;
case 'textarea': return this.value;
}
return false;
},
getFormElements: function(){
return $$(this.getElementsByTagName('input'), this.getElementsByTagName('select'), this.getElementsByTagName('textarea'));
},
/*
Property: toQueryString
Reads the children inputs of the Element and generates a query string, based on their values. Used internally in <Ajax>
Example:
(start code)
<form id="myForm" action="submit.php">
<input name="email" value="bob@bob.com">
<input name="zipCode" value="90210">
</form>
<script>
$('myForm').toQueryString()
</script>
(end)
Returns:
email=bob@bob.com&zipCode=90210
*/
toQueryString: function(){
var queryString = [];
this.getFormElements().each(function(el){
var name = el.name;
var value = el.getValue();
if (value === false || !name || el.disabled) return;
var qs = function(val){
queryString.push(name + '=' + encodeURIComponent(val));
};
if ($type(value) == 'array') value.each(qs);
else qs(value);
});
return queryString.join('&');
}
});
