969 lines
20 KiB
JavaScript
Executable File
969 lines
20 KiB
JavaScript
Executable File
/**
|
|
Kis JS Keep It Simple JS Library
|
|
Copyright Timothy J. Warren
|
|
License Public Domain
|
|
Version 0.8.0
|
|
*/
|
|
(function (undefined){
|
|
|
|
"use strict";
|
|
|
|
var $_, $, sel;
|
|
|
|
|
|
/**
|
|
* $_
|
|
*
|
|
* Constructor function
|
|
*
|
|
* @constuctor
|
|
* @namespace
|
|
* @param string selector
|
|
* @return object
|
|
*/
|
|
$_ = function(s)
|
|
{
|
|
// Have documentElement be default selector, just in case
|
|
if (s === undefined)
|
|
{
|
|
// Defines a "global" selector for that instance
|
|
sel = ($_.el !== undefined)
|
|
? $_.el
|
|
: document.documentElement;
|
|
}
|
|
else
|
|
{
|
|
sel = $(s);
|
|
}
|
|
|
|
// Add the selector to the prototype
|
|
$_.prototype.el = sel;
|
|
|
|
// Use the $_ object as it's own prototype
|
|
var self = Object.create($_);
|
|
|
|
// Give sel to each extension.
|
|
for(var i in self)
|
|
{
|
|
if(typeof self[i] === "object")
|
|
{
|
|
self[i].el = sel;
|
|
}
|
|
}
|
|
|
|
self.el = sel;
|
|
|
|
return self;
|
|
};
|
|
|
|
/**
|
|
* Simple DOM selector function
|
|
*
|
|
* @memberOf $_
|
|
* @param string selector
|
|
* @param object context
|
|
* @return object
|
|
* @type object
|
|
*/
|
|
$ = function (a, context)
|
|
{
|
|
var x, c;
|
|
|
|
if (typeof a != "string" || a === undefined){ return a;}
|
|
|
|
//Check for a context of a specific element, otherwise, just run on the document
|
|
c = (context != null && context.nodeType === 1)
|
|
? context
|
|
: document;
|
|
|
|
//Pick the quickest method for each kind of selector
|
|
if (a.match(/^#([\w\-]+$)/))
|
|
{
|
|
return document.getElementById(a.split('#')[1]);
|
|
}
|
|
else
|
|
{
|
|
x = c.querySelectorAll(a);
|
|
}
|
|
|
|
//Return the single object if applicable
|
|
return (x.length === 1) ? x[0] : x;
|
|
};
|
|
|
|
/**
|
|
* Adds the property `obj` to the $_ object, calling it `name`
|
|
*
|
|
* @param string name
|
|
* @param object obj
|
|
*/
|
|
$_.ext = function(name, obj)
|
|
{
|
|
obj.el = sel;
|
|
$_[name] = obj;
|
|
};
|
|
|
|
/**
|
|
* Iterates over a $_ object, applying a callback to each item
|
|
*
|
|
* @name $_.each
|
|
* @function
|
|
* @param function callback
|
|
*/
|
|
$_.ext('each', function (callback)
|
|
{
|
|
if(sel.length !== undefined && sel !== window)
|
|
{
|
|
[].forEach.call(sel, callback);
|
|
}
|
|
else
|
|
{
|
|
callback.call(sel, sel);
|
|
}
|
|
});
|
|
|
|
/**
|
|
* Retrieves the type of the passed variable
|
|
*
|
|
* @param mixed obj
|
|
* @return string
|
|
* @type string
|
|
*/
|
|
$_.type = function(obj)
|
|
{
|
|
if((function() {return obj && (obj !== this)}).call(obj))
|
|
{
|
|
//fallback on 'typeof' for truthy primitive values
|
|
return (typeof obj).toLowerCase();
|
|
}
|
|
|
|
//Strip x from [object x] and return
|
|
return ({}).toString.call(obj).match(/\s([a-z|A-Z]+)/)[1].toLowerCase();
|
|
};
|
|
|
|
//Set global variables
|
|
$_ = window.$_ = window.$_ || $_;
|
|
$_.$ = $;
|
|
}());
|
|
|
|
|
|
// --------------------------------------------------------------------------
|
|
|
|
/**
|
|
* A module of various browser polyfills
|
|
* @file polyfill.js
|
|
*/
|
|
|
|
/**
|
|
* String trim function polyfill
|
|
*/
|
|
if(typeof String.prototype.trim === "undefined")
|
|
{
|
|
/**
|
|
* @private
|
|
*/
|
|
String.prototype.trim = function()
|
|
{
|
|
return this.replace(/^[\s\uFEFF]+|[\s\uFEFF]+$/g, "");
|
|
};
|
|
}
|
|
|
|
// --------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Array.isArray polyfill
|
|
*/
|
|
if (typeof Array.isArray === "undefined")
|
|
{
|
|
Array.isArray = function(v)
|
|
{
|
|
return Object.prototype.toString.apply(v) === '[object Array]';
|
|
}
|
|
}
|
|
|
|
|
|
// --------------------------------------------------------------------------
|
|
|
|
|
|
(function ($_, undefined){
|
|
|
|
"use strict"
|
|
|
|
// --------------------------------------------------------------------------
|
|
|
|
//This is used so IE can use the classList api
|
|
/*! @source http://purl.eligrey.com/github/classList.js/blob/master/classList.js*/
|
|
if(typeof document!=="undefined"&&!("classList" in document.createElement("a"))){(function(j){if(!("HTMLElement" in j)&&!("Element" in j)){return}var a="classList",f="prototype",m=(j.HTMLElement||j.Element)[f],b=Object,k=String[f].trim||function(){return this.replace(/^\s+|\s+$/g,"")},c=Array[f].indexOf||function(q){var p=0,o=this.length;for(;p<o;p++){if(p in this&&this[p]===q){return p}}return -1},n=function(o,p){this.name=o;this.code=DOMException[o];this.message=p},g=function(p,o){if(o===""){throw new n("SYNTAX_ERR","An invalid or illegal string was specified")}if(/\s/.test(o)){throw new n("INVALID_CHARACTER_ERR","String contains an invalid character")}return c.call(p,o)},d=function(s){var r=k.call(s.className),q=r?r.split(/\s+/):[],p=0,o=q.length;for(;p<o;p++){this.push(q[p])}this._updateClassName=function(){s.className=this.toString()}},e=d[f]=[],i=function(){return new d(this)};n[f]=Error[f];e.item=function(o){return this[o]||null};e.contains=function(o){o+="";return g(this,o)!==-1};e.add=function(){var s=arguments,r=0,p=s.length,q,o=false;do{q=s[r]+"";if(g(this,q)===-1){this.push(q);o=true}}while(++r<p);if(o){this._updateClassName()}};e.remove=function(){var t=arguments,s=0,p=t.length,r,o=false;do{r=t[s]+"";var q=g(this,r);if(q!==-1){this.splice(q,1);o=true}}while(++s<p);if(o){this._updateClassName()}};e.toggle=function(p,q){p+="";var o=this.contains(p),r=o?q!==true&&"remove":q!==false&&"add";if(r){this[r](p)}return !o};e.toString=function(){return this.join(" ")};if(b.defineProperty){var l={get:i,enumerable:true,configurable:true};try{b.defineProperty(m,a,l)}catch(h){if(h.number===-2146823252){l.enumerable=false;b.defineProperty(m,a,l)}}}else{if(b[f].__defineGetter__){m.__defineGetter__(a,i)}}}(self))};
|
|
|
|
/**
|
|
* DOM
|
|
*
|
|
* Dom manipulation module
|
|
*/
|
|
|
|
|
|
var d;
|
|
|
|
//Private function for getting/setting attributes/properties
|
|
function _attr(sel, name, value)
|
|
{
|
|
var oldVal, doAttr;
|
|
|
|
//Get the value of the attribute, if it exists
|
|
if (sel.hasAttribute !== undefined)
|
|
{
|
|
if (sel.hasAttribute(name))
|
|
{
|
|
oldVal = sel.getAttribute(name);
|
|
}
|
|
|
|
doAttr = true;
|
|
}
|
|
else if (sel[name] !== undefined)
|
|
{
|
|
oldVal = sel[name];
|
|
doAttr = false;
|
|
}
|
|
else if (name === "class" && sel.className !== undefined) //className attribute
|
|
{
|
|
name = "className";
|
|
oldVal = sel.className;
|
|
doAttr = false;
|
|
}
|
|
|
|
//Well, I guess that attribute doesn't exist
|
|
if (oldVal === undefined && (value === undefined || value === null))
|
|
{
|
|
return null;
|
|
}
|
|
|
|
//No value to set? Return the current value
|
|
if (value === undefined)
|
|
{
|
|
return oldVal;
|
|
}
|
|
|
|
//Determine what to do with the attribute
|
|
if (value !== undefined && value !== null)
|
|
{
|
|
if(doAttr === true)
|
|
{
|
|
sel.setAttribute(name, value);
|
|
}
|
|
else
|
|
{
|
|
sel[name] = value;
|
|
}
|
|
}
|
|
else if (value === null)
|
|
{
|
|
if(doAttr === true)
|
|
{
|
|
sel.removeAttribute(name);
|
|
}
|
|
else
|
|
{
|
|
delete sel[name];
|
|
}
|
|
}
|
|
|
|
return (value !== undefined) ? value : oldVal;
|
|
}
|
|
|
|
/**
|
|
* Change css property name to it's
|
|
* javascript camel case equivalent
|
|
*/
|
|
function _toCamel(s)
|
|
{
|
|
return s.replace(/(\-[a-z])/g, function($1){
|
|
return $1.toUpperCase().replace('-','');
|
|
});
|
|
}
|
|
|
|
function _css(sel, prop, val)
|
|
{
|
|
var equi;
|
|
|
|
//Camel-case
|
|
prop = _toCamel(prop);
|
|
|
|
//Equivalent properties for 'special' browsers
|
|
equi = {
|
|
outerHeight: "offsetHeight",
|
|
outerWidth: "offsetWidth",
|
|
top: "posTop"
|
|
};
|
|
|
|
|
|
//If you don't define a value, try returning the existing value
|
|
if(val === undefined && sel.style[prop] !== undefined)
|
|
{
|
|
return sel.style[prop];
|
|
}
|
|
else if(val === undefined && sel.style[equi[prop]] !== undefined)
|
|
{
|
|
return sel.style[equi[prop]];
|
|
}
|
|
|
|
//Let's try the easy way first
|
|
if(sel.style[prop] !== undefined)
|
|
{
|
|
sel.style[prop] = val;
|
|
|
|
//Short circuit
|
|
return null;
|
|
}
|
|
else if(sel.style[equi[prop]])
|
|
{
|
|
sel.style[equi[prop]] = val;
|
|
return null;
|
|
}
|
|
}
|
|
|
|
// --------------------------------------------------------------------------
|
|
|
|
/**
|
|
* DOM
|
|
*
|
|
* Dom manipulation module
|
|
* @namespace
|
|
* @memberOf $_
|
|
* @name dom
|
|
*/
|
|
d = {
|
|
/**
|
|
* Adds a class to the element(s) specified by the current
|
|
* selector
|
|
*
|
|
* @name addClass
|
|
* @memberOf $_.dom
|
|
* @function
|
|
* @param string class
|
|
*/
|
|
addClass: function (c)
|
|
{
|
|
$_.each(function (e){
|
|
e.classList.add(c);
|
|
});
|
|
},
|
|
/**
|
|
* Removes a class from the element(s) specified by the current
|
|
* selector
|
|
*
|
|
* @name removeClass
|
|
* @memberOf $_.dom
|
|
* @function
|
|
* @param string class
|
|
*/
|
|
removeClass: function (c)
|
|
{
|
|
$_.each(function (e){
|
|
e.classList.remove(c);
|
|
});
|
|
},
|
|
/**
|
|
* Hides the element(s) specified by the current selector
|
|
*
|
|
* @name hide
|
|
* @memberOf $_.dom
|
|
* @function
|
|
*/
|
|
hide: function ()
|
|
{
|
|
this.css('display', 'none');
|
|
},
|
|
/**
|
|
* Shows the element(s) specified by the current selector.
|
|
* if type is specified, the element will have it's style
|
|
* property set to "display:[your type]". If type is not
|
|
* specified, the element is set to "display:block".
|
|
*
|
|
* @name show
|
|
* @memberOf $_.dom
|
|
* @function
|
|
* @param [string] type
|
|
*/
|
|
show: function (type)
|
|
{
|
|
if (type === undefined)
|
|
{
|
|
type = "block";
|
|
}
|
|
|
|
this.css("display", type);
|
|
},
|
|
/**
|
|
* Sets attributes on element(s) specified by the current
|
|
* selector, or, if name is not specified, returns the
|
|
* value of the attribute of the element specified by the
|
|
* current selector.
|
|
*
|
|
* @name attr
|
|
* @memberOf $_.dom
|
|
* @function
|
|
* @param string name
|
|
* @param [string] value
|
|
* @return string
|
|
* @type string
|
|
*/
|
|
attr: function (name, value)
|
|
{
|
|
var sel = this.el;
|
|
|
|
//Make sure you don't try to get a bunch of elements
|
|
if (sel.length > 1 && value === undefined)
|
|
{
|
|
return null;
|
|
}
|
|
else if (sel.length > 1 && value !== undefined) //You can set a bunch, though
|
|
{
|
|
$_.each(function (e){
|
|
return _attr(e, name, value);
|
|
});
|
|
}
|
|
else //Normal behavior
|
|
{
|
|
return _attr(sel, name, value);
|
|
}
|
|
},
|
|
/**
|
|
* Sets or retrieves the text content of the element
|
|
* specified by the current selector. If a value is
|
|
* passed, it will set that value on the current element,
|
|
* otherwise it will return the value of the current element
|
|
*
|
|
* @name text
|
|
* @memberOf $_.dom
|
|
* @function
|
|
* @param [string] value
|
|
* @return string
|
|
* @type string
|
|
*/
|
|
text: function (value)
|
|
{
|
|
var oldValue, set, sel;
|
|
|
|
sel = this.el;
|
|
|
|
set = (value !== undefined) ? true : false;
|
|
|
|
oldValue = sel.textContent;
|
|
|
|
if(set)
|
|
{
|
|
sel.textContent = value;
|
|
return value;
|
|
}
|
|
else
|
|
{
|
|
return oldValue;
|
|
}
|
|
},
|
|
/**
|
|
* Sets or retrieves a css property of the element
|
|
* specified by the current selector. If a value is
|
|
* passed, it will set that value on the current element,
|
|
* otherwise it will return the value of the css property
|
|
* on the current element
|
|
*
|
|
* @name css
|
|
* @memberOf $_.dom
|
|
* @function
|
|
* @param string property
|
|
* @param [string] value
|
|
* @return string
|
|
* @type string
|
|
*/
|
|
css: function (prop, val)
|
|
{
|
|
//Return the current value if a value is not set
|
|
if(val === undefined)
|
|
{
|
|
return _css(this.el, prop);
|
|
}
|
|
|
|
$_.each(function (e){
|
|
_css(e, prop, val);
|
|
});
|
|
},
|
|
/**
|
|
* Adds to the innerHTML of the current element, after the last child.
|
|
*
|
|
* @example $_("ul").dom.append("<li></li>") adds an li element to the end of the selected ul element
|
|
* @name append
|
|
* @memberOf $_.dom
|
|
* @function
|
|
* @param string htm
|
|
*/
|
|
append: function(htm)
|
|
{
|
|
this.el.insertAdjacentHTML('beforeend', htm);
|
|
},
|
|
/**
|
|
* Adds to the innerHTML of the selected element, before the current children
|
|
*
|
|
* @name prepend
|
|
* @memberOf $_.dom
|
|
* @function
|
|
* @param string htm
|
|
*/
|
|
prepend: function(htm)
|
|
{
|
|
this.el.insertAdjacentHTML('afterbegin', htm);
|
|
},
|
|
/**
|
|
* Sets or gets the innerHTML propery of the element(s) passed
|
|
*
|
|
* @name html
|
|
* @memberOf $_.dom
|
|
* @function
|
|
* @param [string] htm
|
|
* @return string
|
|
* @type string
|
|
*/
|
|
html: function(htm)
|
|
{
|
|
|
|
if(htm !== undefined)
|
|
{
|
|
this.el.innerHTML = htm;
|
|
}
|
|
|
|
//If the parameter is undefined, just return the current value
|
|
return this.el.innerHTML;
|
|
}
|
|
};
|
|
|
|
$_.ext('dom', d);
|
|
|
|
|
|
|
|
// --------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Ajax
|
|
*
|
|
* Module for making ajax requests
|
|
*/
|
|
|
|
|
|
var ajax = {
|
|
_do: function (url, data, success_callback, error_callback, isPost)
|
|
{
|
|
var type,
|
|
request = new XMLHttpRequest();
|
|
|
|
if (success_callback === undefined)
|
|
{
|
|
/**
|
|
* @private
|
|
*/
|
|
success_callback = function (){};
|
|
}
|
|
|
|
type = (isPost) ? "POST" : "GET";
|
|
|
|
if (type === "GET")
|
|
{
|
|
url += (url.match(/\?/))
|
|
? this._serialize(data)
|
|
: "?" + this._serialize(data);
|
|
}
|
|
|
|
request.open(type, url);
|
|
|
|
request.onreadystatechange = function ()
|
|
{
|
|
if (request.readyState === 4)
|
|
{
|
|
if (request.status === 200)
|
|
{
|
|
success_callback.call(request.responseText, request.responseText);
|
|
}
|
|
else
|
|
{
|
|
if (error_callback !== undefined)
|
|
{
|
|
error_callback.call(request.status, request.status);
|
|
}
|
|
}
|
|
|
|
}
|
|
};
|
|
|
|
if (type === "POST")
|
|
{
|
|
request.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
|
|
request.send(this._serialize(data));
|
|
}
|
|
else
|
|
{
|
|
request.send(null);
|
|
}
|
|
},
|
|
_serialize: function (data)
|
|
{
|
|
var name,
|
|
value,
|
|
pairs = [];
|
|
|
|
for (name in data)
|
|
{
|
|
if ( ! data.hasOwnProperty(name) || $_.type(data[name]) === "function")
|
|
{
|
|
continue;
|
|
}
|
|
|
|
value = data[name].toString();
|
|
|
|
name = encodeURIComponent(name);
|
|
value = encodeURIComponent(value);
|
|
|
|
pairs.push(name + "=" + value);
|
|
}
|
|
|
|
return pairs.join("&");
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Sends a GET type ajax request
|
|
*
|
|
* @name get
|
|
* @function
|
|
* @memberOf $_
|
|
* @param string url
|
|
* @param object data
|
|
* @param function success_callback
|
|
* @param function error_callback
|
|
*/
|
|
$_.ext('get', function (url, data, success_callback, error_callback){
|
|
ajax._do(url, data, success_callback, error_callback, false);
|
|
});
|
|
|
|
/**
|
|
* Sends a POST type ajax request
|
|
*
|
|
* @name post
|
|
* @function
|
|
* @memberOf $_
|
|
* @param string url
|
|
* @param object data
|
|
* @param function success_callback
|
|
* @param function error_callback
|
|
*/
|
|
$_.ext('post', function (url, data, success_callback, error_callback){
|
|
ajax._do(url, data, success_callback, error_callback, true);
|
|
});
|
|
|
|
|
|
// --------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Event
|
|
*
|
|
* Event api wrapper
|
|
* @todo Add method for triggering events
|
|
*/
|
|
|
|
|
|
var _add_remove, e, _attach_delegate;
|
|
|
|
_add_remove = function (sel, event, callback, add)
|
|
{
|
|
var i, len;
|
|
|
|
// 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;
|
|
}
|
|
|
|
// Bind the event
|
|
(add === true)
|
|
? sel.addEventListener(event, callback, false)
|
|
: sel.removeEventListener(event, callback, false);
|
|
};
|
|
|
|
_attach_delegate = function(sel, target, event, callback)
|
|
{
|
|
// attach the listener to the parent object
|
|
_add_remove(sel, event, function(e){
|
|
|
|
var elem, t;
|
|
|
|
// Get the live version of the target selector
|
|
t = $_.$(target, sel);
|
|
|
|
// Check each element to see if it matches the target
|
|
for(elem in t)
|
|
{
|
|
// Fire target callback when event bubbles from target
|
|
if(e.target == t[elem])
|
|
{
|
|
// Trigger the event callback
|
|
callback.call(t[elem], e);
|
|
|
|
// Stop event propegation
|
|
e.stopPropagation();
|
|
}
|
|
}
|
|
|
|
}, true);
|
|
};
|
|
|
|
// --------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Event Listener module
|
|
*
|
|
* @namespace
|
|
* @name event
|
|
* @memberOf $_
|
|
*/
|
|
e = {
|
|
/**
|
|
* Create a custom event
|
|
*
|
|
* @memberOf $_.event
|
|
* @name create
|
|
* @function
|
|
* @example Eg. var event = $_("#selector").event.create('foo', {});
|
|
* @param string name
|
|
* @param [object] data
|
|
* @return object
|
|
*/
|
|
create: function(name, data)
|
|
{
|
|
// Do a terrible browser-sniffic hack because I don't know of a good
|
|
// feature test
|
|
if (/MSIE|Trident/i.test(navigator.userAgent))
|
|
{
|
|
// Okay, I guess we have to do this the hard way... :(
|
|
// Microsoft, your browser still sucks
|
|
var e = document.createEvent('CustomEvent');
|
|
e.initCustomEvent(name, true, true, data);
|
|
|
|
return e;
|
|
}
|
|
else
|
|
{
|
|
return new CustomEvent(name, data);
|
|
}
|
|
},
|
|
/**
|
|
* Adds an event that returns a callback when triggered on the selected
|
|
* event and selector
|
|
*
|
|
* @memberOf $_.event
|
|
* @name add
|
|
* @function
|
|
* @example Eg. $_("#selector").event.add("click", do_something());
|
|
* @param string event
|
|
* @param function callback
|
|
*/
|
|
add: function (event, callback)
|
|
{
|
|
$_.each(function(e){
|
|
_add_remove(e, event, callback, true);
|
|
});
|
|
},
|
|
/**
|
|
* Removes an event bound the the specified selector, event type, and callback
|
|
*
|
|
* @memberOf $_.event
|
|
* @name remove
|
|
* @function
|
|
* @example Eg. $_("#selector").event.remove("click", do_something());
|
|
* @param string event
|
|
* @param string callback
|
|
*/
|
|
remove: function (event, callback)
|
|
{
|
|
$_.each(function(e){
|
|
_add_remove(e, event, callback, false);
|
|
});
|
|
},
|
|
/**
|
|
* Binds a persistent event to the document
|
|
*
|
|
* @memberOf $_.event
|
|
* @name live
|
|
* @function
|
|
* @example Eg. $_.event.live(".button", "click", do_something());
|
|
* @param string target
|
|
* @param string event
|
|
* @param function callback
|
|
*/
|
|
live: function (target, event, callback)
|
|
{
|
|
_attach_delegate(document.documentElement, target, event, callback);
|
|
},
|
|
/**
|
|
* Binds an event to a parent object
|
|
*
|
|
* @memberOf $_.event
|
|
* @name delegate
|
|
* @function
|
|
* @example Eg. $_("#parent").delegate(".button", "click", do_something());
|
|
* @param string target
|
|
* @param string event_type
|
|
* @param function callback
|
|
*/
|
|
delegate: function (target, event, callback)
|
|
{
|
|
$_.each(function(e){
|
|
_attach_delegate(e, target, event, callback);
|
|
});
|
|
},
|
|
/**
|
|
* Trigger an event to fire
|
|
*
|
|
* @memberOf $_.event
|
|
* @name trigger
|
|
* @function
|
|
* @example Eg. $_("#my_id").trigger('click');
|
|
* @param string target
|
|
* @param object event
|
|
* @return bool
|
|
*/
|
|
trigger: function(event)
|
|
{
|
|
var target = this.el;
|
|
return target.dispatchEvent(event);
|
|
}
|
|
};
|
|
|
|
$_.ext('event', e);
|
|
|
|
|
|
|
|
// --------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Store
|
|
*
|
|
* Wrapper for local / sessionstorage
|
|
*/
|
|
|
|
|
|
//Shortcuts for wrapper
|
|
var l = localStorage,
|
|
s = sessionStorage;
|
|
|
|
/**
|
|
* Wrapper for localstorage / sessionstorage data serialization.
|
|
* Each method has a boolean parameter, that when set as true switches the method
|
|
* to use sessionStorage rather than the default localStorage.
|
|
*
|
|
* @name store
|
|
* @namespace
|
|
* @memberOf $_
|
|
*/
|
|
var store = {
|
|
/**
|
|
* Retrieves and deserializes a value from localstorage,
|
|
* based on the specified key
|
|
*
|
|
* @param string key
|
|
* @param bool session
|
|
* @name get
|
|
* @memberOf $_.store
|
|
* @function
|
|
* @return object
|
|
* @type object
|
|
*/
|
|
get: function (key, sess)
|
|
{
|
|
var val = (sess) ? s.getItem(key) : l.getItem(key);
|
|
|
|
return JSON.parse(val);
|
|
},
|
|
/**
|
|
* Puts a value into localstorage at the specified key,
|
|
* and JSON-encodes the value if not a string
|
|
*
|
|
* @param string key
|
|
* @param mixed value
|
|
* @param bool session
|
|
* @name set
|
|
* @memberOf $_.store
|
|
* @function
|
|
*/
|
|
set: function (key, value, sess)
|
|
{
|
|
// Localstorage generally only accepts strings
|
|
value = JSON.stringify(value);
|
|
|
|
(sess) ? s.setItem(key, value) : l.setItem(key, value);
|
|
},
|
|
/**
|
|
* Removes the specified item from storage
|
|
*
|
|
* @param string key
|
|
* @param bool session
|
|
* @name remove
|
|
* @memberOf $_.store
|
|
* @function
|
|
*/
|
|
remove: function (key, sess)
|
|
{
|
|
(sess) ? s.removeItem(key) : l.removeItem(key);
|
|
},
|
|
/**
|
|
* Returns an object of all the raw values in storage
|
|
*
|
|
* @param bool session
|
|
* @name getAll
|
|
* @memberOf $_.store
|
|
* @function
|
|
* @return object
|
|
* @type object
|
|
*/
|
|
getAll: function (sess)
|
|
{
|
|
var i,
|
|
len,
|
|
data = {},
|
|
k,
|
|
o;
|
|
|
|
//Reference to session/localstorage
|
|
o = (sess) ? l : s;
|
|
|
|
len = o.length;
|
|
|
|
for (i = 0; i < len; i++)
|
|
{
|
|
k = o.key(i);
|
|
data[k] = o.getItem(k);
|
|
}
|
|
|
|
return data;
|
|
},
|
|
/**
|
|
* Removes all values from the same domain storage
|
|
*
|
|
* @param bool session
|
|
* @name clear
|
|
* @memberOf $_.store
|
|
* @function
|
|
*/
|
|
clear: function(sess)
|
|
{
|
|
(sess) ? s.clear() : l.clear();
|
|
}
|
|
};
|
|
|
|
$_.ext('store', store);
|
|
|
|
}($_)); |