kis-js/kis.js

769 lines
14 KiB
JavaScript
Raw Normal View History

2011-06-11 17:08:00 -04:00
/**
Kis JS Keep It Simple JS Library
Copyright Timothy J. Warren
License Public Domain
2011-07-06 12:16:18 -04:00
Version 0.1.1
*/
2011-06-11 17:08:00 -04:00
2011-06-29 11:36:33 -04:00
(function (){
2011-06-11 17:08:00 -04:00
"use strict";
// Property name for expandos on DOM objects
var kis_expando = "KIS_0_1_0";
//Browser requirements check
if (!document.querySelectorAll)
{
return;
}
var $_, $;
2011-06-13 11:34:15 -04:00
$_ = {};
$_ = window.$_ = window.$_ || $_;
if(typeof window.console === "undefined")
{
window.console = {
log:function(){}
}
}
2011-06-14 16:20:43 -04:00
/**
* $
*
* Simple DOM selector function
*/
$ = function (a)
2011-06-11 17:08:00 -04:00
{
2011-07-05 11:22:23 -04:00
var x;
if (typeof a !== "string"){ return a;}
2011-07-05 11:22:23 -04:00
//Pick the quickest method for each kind of selector
if(a.match(/^#([\w\-]+$)/))
{
return document.getElementById(a.split('#')[1]);
}
else if(a.match(/^([\w\-]+)$/))
{
x = document.getElementsByTagName(a);
}
else
{
x = document.querySelectorAll(a);
2011-07-05 19:19:32 -04:00
}
2011-07-05 11:22:23 -04:00
2011-06-11 17:08:00 -04:00
return (x.length === 1) ? x[0] : x;
};
window.$ = $;
2011-06-13 11:34:15 -04:00
/**
* Ajax
2011-06-13 11:34:15 -04:00
*
* Object for making ajax requests
*/
(function (){
2011-06-11 17:08:00 -04:00
var ajax = {
_do: function (url, data, callback, isPost)
2011-06-11 17:08:00 -04:00
{
if (typeof callback === "undefined")
{
callback = function (){};
}
2011-07-05 19:19:32 -04:00
var request = (typeof window.XMLHttpRequest !== "undefined")
2011-06-29 11:45:39 -04:00
? new XMLHttpRequest()
: false;
2011-06-11 17:08:00 -04:00
var type = (isPost) ? "POST" : "GET";
url += (type === "GET") ? "?" + this._serialize(data, true) : '';
2011-06-11 17:08:00 -04:00
request.open(type, url);
request.onreadystatechange = function ()
{
if (request.readyState === 4)
2011-06-11 17:08:00 -04:00
{
callback(request.responseText);
}
2011-06-13 11:34:15 -04:00
};
if (type === "POST")
2011-06-11 17:08:00 -04:00
{
2011-06-13 11:46:26 -04:00
request.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
2011-06-11 17:08:00 -04:00
request.send(this._serialize(data));
}
else
{
request.send(null);
}
},
_serialize: function (data, encode)
2011-06-11 17:08:00 -04:00
{
var pairs = [];
2011-06-11 17:08:00 -04:00
for (var name in data)
{
if (!data.hasOwnProperty(name))
{
continue;
}
if (typeof data[name] === "function")
{
continue;
}
2011-06-11 17:08:00 -04:00
var value = data[name].toString();
if (encode === true)
{
name = encodeURIComponent(name.replace(" ", "+"));
value = encodeURIComponent(value.replace(" ", "+"));
}
2011-06-11 17:08:00 -04:00
pairs.push(name + "=" + value);
}
2011-06-11 17:08:00 -04:00
return pairs.join("&");
}
};
$_.get = function (url, data, callback)
2011-06-11 17:08:00 -04:00
{
ajax._do(url, data, callback, false);
};
$_.post = function (url, data, callback)
2011-06-11 17:08:00 -04:00
{
ajax._do(url, data, callback, true);
};
}());
2011-06-11 17:08:00 -04:00
/**
* Qs
*
2011-06-11 17:08:00 -04:00
* Object for encoding and decoding querystrings and hashbang strings
*/
(function (){
$_.hb = (history.pushState) ? false : true;
var qs = {
parse: function (hb)
2011-06-11 17:08:00 -04:00
{
hb = hb || $_.hb;
var h, i, hString, pairs, pLen, data, y;
data = {};
if (hb === true)
{
h = location.hash.split('#!/');
hString = (h.length > 1) ? h[1] : '';
}
else if (hb === false || hb === undefined)
{
hString = window.location.search.substring(1);
}
else
{
return false;
}
pairs = hString.split('&');
pLen = pairs.length;
for (i = 0; i < pLen; i++)
{
y = pairs[i].split('=');
if (y.length < 2)
{
return data;
}
data[y[0]] = y[1];
}
return data;
},
set: function (key, value, hb)
2011-06-11 17:08:00 -04:00
{
hb = hb || $_.hb;
var pairs = this.parse(hb);
if (key !== undefined && value !== undefined)
{
pairs[key] = value;
}
var vars = [];
for (var x in pairs)
{
if (pairs.hasOwnProperty(x))
{
vars.push(x + '=' + pairs[x]);
}
}
var qs = vars.join('&');
if (hb === true)
2011-06-11 17:08:00 -04:00
{
qs = '!/' + qs;
location.hash = qs;
2011-06-11 17:08:00 -04:00
}
return qs;
},
get: function (key, hb)
2011-06-11 17:08:00 -04:00
{
hb = hb || $_.hb;
var pairs = this.parse(hb);
return (pairs[key]) ? pairs[key] : '';
2011-06-11 17:08:00 -04:00
}
};
$_.qs = qs;
}());
/**
* Store object
*
* Wrapper for localstorage data serialization
*/
(function (){
var store = {
get: function (key)
{
return JSON.parse(localStorage.getItem(key));
},
set: function (key, value)
2011-06-11 17:08:00 -04:00
{
if (typeof value !== "string")
2011-06-11 17:08:00 -04:00
{
value = JSON.stringify(value);
2011-06-11 17:08:00 -04:00
}
2011-06-14 16:20:43 -04:00
localStorage.setItem(key, value);
},
getAll: function ()
2011-06-11 17:08:00 -04:00
{
var i,
len,
data;
len = localStorage.length;
data = {};
for (i = 0; i < len; i++)
{
var name = localStorage.key(i);
var value = localStorage.getItem(name);
data[name] = value;
}
return data;
2011-06-11 17:08:00 -04:00
}
};
$_.store = store;
}());
2011-06-14 16:20:43 -04:00
/**
* Event object
*
* Event api wrapper
*/
(function (){
var attach, remove, add_remove, e;
// Define the proper attach and remove functions
// based on browser support
if(typeof document.addEventListener !== "undefined")
{
attach = function (sel, event, callback)
{
if (typeof sel.addEventListener === "function")
{
sel.addEventListener(event, callback, false);
}
};
remove = function (sel, event, callback)
{
if (typeof sel.removeEventListener === "function")
{
sel.removeEventListener(event, callback, false);
}
};
}
//typeof function doesn't work in IE where attachEvent is available: brute force it
else if(typeof document.attachEvent !== "undefined")
{
attach = function (sel, event, callback)
{
function listener () {
// Internet Explorer fails to correctly set the 'this' object
// for event listeners, so we need to set it ourselves.
callback.apply(sel, arguments);
}
var i, len;
2011-07-05 19:19:32 -04:00
if (typeof sel.attachEvent !== "undefined")
{
remove(sel, event, callback); // Make sure we don't have duplicate listeners
sel.attachEvent("on" + event, listener);
// Store our listener so we can remove it later
var expando = sel[kis_expando] = sel[kis_expando] || {};
expando.listeners = expando.listeners || {};
expando.listeners[event] = expando.listeners[event] || [];
expando.listeners[event].push({
callback: callback,
listener: listener
});
}
2011-07-05 19:19:32 -04:00
else
{
console.log("Failed to attach event:"+event+" on "+sel);
2011-07-05 19:19:32 -04:00
}
};
remove = function (sel, event, callback)
{
2011-07-05 19:19:32 -04:00
if(typeof sel.detachEvent !== "undefined")
{
var expando = sel[kis_expando];
if (expando && expando.listeners
&& expando.listeners[event])
{
var listeners = expando.listeners[event];
var len = listeners.length
for (var i=0; i<len; i++)
{
if (listeners[i].callback === callback)
{
sel.detachEvent("on" + event, listeners[i].listener);
listeners.splice(i, 1);
if(listeners.length === 0)
{
delete expando.listeners[event];
}
return;
}
}
}
}
};
}
add_remove = function (sel, event, callback, add)
{
var i, len, selx;
if (typeof sel === "undefined")
{
return false;
}
//Get the DOM object if you give me a selector string
sel = $(sel);
//Multiple events? Run recursively!
if (!event.match(/^([\w\-]+)$/))
{
event = event.split(" ");
len = event.length;
for (i = 0; i < len; i++)
{
add_remove(sel, event[i], callback, add);
}
return;
}
//Check for multiple DOM objects
if (sel.length > 1)
{
len = sel.length;
for (i = 0; i < len; i++)
{
selx = (sel.item(i)) ? sel.item(i) : sel[i];
//Call recursively
add_remove(selx, event, callback, add);
}
}
else
{
2011-06-29 11:45:39 -04:00
(add === true)
? attach(sel, event, callback)
: remove(sel, event, callback);
}
};
e = {
add: function (sel, event, callback)
{
add_remove(sel, event, callback, true);
},
remove: function (sel, event, callback)
{
add_remove(sel, event, callback, false);
}
};
$_.event = e;
}());
/**
* Dom manipulation object
*
*/
(function (){
var d;
//Private function for getting/setting attributes
function _attr(sel, name, value)
{
2011-07-05 19:19:32 -04:00
var oldVal, doAttr, i;
if(sel.length > 1)
{
var len = sel.length;
for(i=0;i<len;i++)
{
_attr(sel[i], name, value);
}
}
//Get the value of the attribute, if it exists
if (typeof sel.hasAttribute !== "undefined")
{
if (sel.hasAttribute(name))
{
oldVal = sel.getAttribute(name);
}
doAttr = true;
}
else if (typeof sel[name] !== "undefined")
{
oldVal = sel[name];
doAttr = false;
}
else if (name === "class" && typeof sel.className !== "undefined") //className attribute
{
name = "className";
oldVal = sel.className;
doAttr = false;
}
//Well, I guess that attribute doesn't exist
if (typeof oldVal === "undefined" && (typeof value === "undefined" || value === null))
{
2011-07-05 19:19:32 -04:00
console.log(value);
console.log(sel);
console.log("Element does not have the selected attribute");
return;
}
//No value to set? Return the current value
if (typeof value === "undefined")
{
return oldVal;
}
//Determine what to do with the attribute
if (typeof value !== "undefined" && value !== null)
{
2011-06-29 11:45:39 -04:00
(doAttr === true)
? sel.setAttribute(name, value)
: sel[name] = value;
}
else if (value === null)
{
2011-06-29 11:45:39 -04:00
(doAttr === true)
? sel.removeAttribute(name)
: sel[name] = null;
}
return (typeof value !== "undefined") ? value : oldVal;
}
// Private function for class manipulation
function _class(sel, c, add)
{
var ec, cs, len, i, classInd;
//We can do this the easy way
if (sel.classList)
{
if (add === true)
{
sel.classList.add(c);
return;
}
else if (add === false)
{
sel.classList.remove(c);
return;
}
}
else //Or the hard way
{
//No class attribute? Set an empty string
2011-07-05 19:19:32 -04:00
ec = sel.className;//_attr(sel, "class");
ec = (typeof ec === "string") ? ec : '';
//Convert class attribute string into array
if (typeof ec === "string")
{
cs = (ec !== '') ? ec.split(" ") : [];
len = cs.length;
classInd = false;
//Check for the class in the array
for (i = 0; i < len; i++)
{
if (cs[i] === c)
{
classInd = i;
break;
}
}
}
//Add or remove from class array
if (add === true)
{
//Only add the class if isn't already there
if (classInd === false)
{
cs.push(c);
}
}
else if (add === false)
{
//Make sure the class you want to remove exists
if (classInd !== false)
{
cs.splice(classInd, 1);
}
}
var cName = (cs.length > 1) ? cs.join(" ") : cs[0];
if (typeof sel.className !== "undefined")
{
sel.className = cName;
}
else if (typeof sel.setAttribute !== "undefined")
{
sel.setAttribute('class', cName);
}
else
{
console.log(sel);
}
return cName;
}
}
function _css(sel, prop, val)
{
var equi;
//Todo: camelCase things like border-left to borderLeft
//Let's try the easy way first
if(typeof sel.style[prop] !== "undefined")
{
sel.style[prop] = val;
//Short circuit
return;
}
//Let have an object with equivalent properties
//for `special` browsers, and other quirks
var equi = {
top: "",
right: "",
bottom: "",
left: ""
};
if(sel.style[equi[prop]])
{
sel.style[equi[prop]] = val;
return;
}
//No matches? Well, lets log it for now
console.log("Property " + prop + " nor an equivalent seems to exist");
}
d = {
each: function (sel, callback)
{
sel = $(sel);
2011-06-30 20:15:19 -04:00
if(!sel.length)
{
2011-06-30 20:15:19 -04:00
// sel is a DOM Element
callback(sel);
}
2011-06-30 20:15:19 -04:00
else
{
2011-06-30 20:15:19 -04:00
var len = sel.length;
2011-06-30 20:15:19 -04:00
if (len === 0)
{
return;
}
if (len === 1)
{
return callback(sel);
}
2011-07-05 19:19:32 -04:00
var selx;
2011-06-30 20:15:19 -04:00
for (var x = 0; x < sel.length; x++)
{
2011-07-05 19:19:32 -04:00
selx = (sel.item(x)) ? sel.item(x) : sel[x];
callback(selx);
2011-06-30 20:15:19 -04:00
}
}
},
addClass: function (sel, c)
{
sel = $(sel);
2011-06-29 11:45:39 -04:00
this.each(sel, function (e){
_class(e, c, true);
});
},
removeClass: function (sel, c)
{
sel = $(sel);
2011-06-29 11:45:39 -04:00
this.each(sel, function (e){
_class(e, c, false);
});
},
hide: function (sel)
{
sel = $(sel);
if (sel.length > 1)
{
2011-06-29 11:45:39 -04:00
this.each(sel, function (e){
e.style.display = "none";
});
}
else
{
if (sel.style)
{
sel.style.display = "none";
}
}
},
show: function (sel, type)
{
sel = $(sel);
if (typeof type === "undefined")
{
type = "block";
}
if (sel.length > 1)
{
2011-06-29 11:45:39 -04:00
this.each(sel, function (e){
e.style.display = type;
});
}
else
{
sel.style.display = type;
}
},
attr: function (sel, name, value)
{
sel = $(sel);
//Make sure you don't try to get a bunch of elements
if (sel.length > 1 && typeof value === "undefined")
{
console.log(sel);
console.log("Must be a singular element");
return;
}
else if (sel.length > 1 && typeof value !== "undefined") //You can set a bunch, though
{
2011-06-29 11:45:39 -04:00
this.each(sel, function (e){
_attr(e, name, value);
});
}
else //Normal behavior
{
return _attr(sel, name, value);
}
2011-06-29 15:52:33 -04:00
},
text: function(sel, value)
{
var oldValue, set, type;
sel = $(sel);
set = (typeof value !== "undefined") ? true : false;
type = (typeof sel.innerText !== "undefined")
? "innerText"
: (typeof sel.textContent !== "undefined")
? "textContent"
: "innerHTML";
oldValue = sel[type];
if(set)
{
sel[type] = value;
return value;
}
else
{
return oldValue;
}
},
css: function(sel, prop, val)
{
this.each(sel, function (e){
_css(e, prop, val);
});
}
};
$_.dom = d;
}());
}());