3 * Provides a simple interface for storing data such as user preferences.
\r
4 * Storage is useful for saving and retreiving data from the user's browser.
\r
5 * For newer browsers, localStorage is used.
\r
6 * If localStorage isn't supported, then cookies are used instead.
\r
7 * Retrievable data is limited to the same domain as this file.
\r
10 * This plugin extends jQuery by adding itself as a static method.
\r
11 * $.Storage - is the class name, which represents the user's data store, whether it's cookies or local storage.
\r
12 * <code>if ($.Storage)</code> will tell you if the plugin is loaded.
\r
13 * $.Storage.set("name", "value") - Stores a named value in the data store.
\r
14 * $.Storage.set({"name1":"value1", "name2":"value2", etc}) - Stores multiple name/value pairs in the data store.
\r
15 * $.Storage.get("name") - Retrieves the value of the given name from the data store.
\r
16 * $.Storage.remove("name") - Permanently deletes the name/value pair from the data store.
\r
18 * @author Dave Schindler
\r
20 * Distributed under the MIT License
\r
22 * Copyright (c) 2010 Dave Schindler
\r
24 * Permission is hereby granted, free of charge, to any person obtaining a copy
\r
25 * of this software and associated documentation files (the "Software"), to deal
\r
26 * in the Software without restriction, including without limitation the rights
\r
27 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
\r
28 * copies of the Software, and to permit persons to whom the Software is
\r
29 * furnished to do so, subject to the following conditions:
\r
31 * The above copyright notice and this permission notice shall be included in
\r
32 * all copies or substantial portions of the Software.
\r
34 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
\r
35 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
\r
36 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
\r
37 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
\r
38 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
\r
39 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
\r
44 var isLS=typeof window.localStorage!=='undefined';
\r
45 // Private functions
\r
46 function wls(n,v){var c;if(typeof n==="string"&&typeof v==="string"){localStorage[n]=v;return true;}else if(typeof n==="object"&&typeof v==="undefined"){for(c in n){if(n.hasOwnProperty(c)){localStorage[c]=n[c];}}return true;}return false;}
\r
47 function wc(n,v){var dt,e,c;dt=new Date();dt.setTime(dt.getTime()+31536000000);e="; expires="+dt.toGMTString();if(typeof n==="string"&&typeof v==="string"){document.cookie=n+"="+v+e+"; path=/";return true;}else if(typeof n==="object"&&typeof v==="undefined"){for(c in n) {if(n.hasOwnProperty(c)){document.cookie=c+"="+n[c]+e+"; path=/";}}return true;}return false;}
\r
48 function rls(n){return localStorage[n];}
\r
49 function rc(n){var nn, ca, i, c;nn=n+"=";ca=document.cookie.split(';');for(i=0;i<ca.length;i++){c=ca[i];while(c.charAt(0)===' '){c=c.substring(1,c.length);}if(c.indexOf(nn)===0){return c.substring(nn.length,c.length);}}return null;}
\r
50 function dls(n){return delete localStorage[n];}
\r
51 function dc(n){return wc(n,"",-1);}
\r
55 * $.Storage - Represents the user's data store, whether it's cookies or local storage.
\r
56 * $.Storage.set("name", "value") - Stores a named value in the data store.
\r
57 * $.Storage.set({"name1":"value1", "name2":"value2", etc}) - Stores multiple name/value pairs in the data store.
\r
58 * $.Storage.get("name") - Retrieves the value of the given name from the data store.
\r
59 * $.Storage.remove("name") - Permanently deletes the name/value pair from the data store.
\r
63 set: isLS ? wls : wc,
\r
64 get: isLS ? rls : rc,
\r
65 remove: isLS ? dls :dc
\r