jQuery.storage.js
Usage
It's quite simple!
Standard prozedure, include jquery
and jquery.storage.js
:
<script src="jquery.js"></script>
<script src="jquery.storage.js"></script>
<!--
You can optional include a $.cookie plugin
to support older browsers (e.q. IE lt 7)
I recommend the plugin from Klaus Hartl:
https://github.com/carhartl/jquery-cookie
(but you can of course use any other plugin with an equal syntax)
<script src="jquery.cookie.js"></script>
-->
Create or update an item
localStorage
$.localStorage('foo', 'bar');
sessionStorage
$.sessionStorage('foo', 'bar');
Get an item or items
localStorage
To get a single value just pass your key as a string
:
$.localStorage('foo'); // 'bar'
for multiple returns use an array instead:
$.localStorage(['key1', 'key2']); // ['value1', 'value2']
sessionStorage
To get a single value just pass your key as a string
:
$.sessionStorage('foo'); // 'bar'
for multiple returns use an array instead:
$.sessionStorage(['key1', 'key2']); // ['value1', 'value2']
Remove an item
localStorage
$.localStorage('foo', null);
sessionStorage
$.sessionStorage('foo', null);
Options
option | description | default |
---|---|---|
cookiePrefix |
Defines a prefix to prepend to your cookie-fallback | 'fallback:' + method + ':' |
path |
The cookie path to use. | '/' |
domain |
The cookie domain to use. | document.domain |
expires |
The time when your cookie has to expire. | ('localStorage' === method) ? { expires: 365 } : undefined |
$.localStorage.options = {
cookiePrefix : 'fallback:' + method + ':',
cookieOptions : {
path : '/',
domain : document.domain,
expires : ('localStorage' === method) ? { expires: 365 } : undefined
}
};
Public Methods
There're some public methods which you can use instead of the default syntax.
...by the way the following methods can (of course) also used with $.sessionStorage()
:
var ls = $.localStorage();
var ss = $.sessionStorage();
setItem()
To set a storage-item you can attach setItem
to your storage
-instance:
ls.setItem('foo', 'bar');
getItem()
gets an earlier setted, it is just as easy as setItem
.
Attach getItem
to your instance and pass the key/s (as a string
) to it:
ls.getItem('foo'); // 'bar'
If you need to get more than one value
pass your keys
as an array
to getItem
:
ls.getItem(['key1', 'key2']); // ['value1', 'value2']
removeItem()
removes an earlier defined item:
ls.removeItem('foo') // null
clear()
Sometimes you need to remove all key-value pairs, dont worry this is just as easy as anything else:
ls.clear();
Extras
Storage gives you two new jQuery.support
-properties:
$.support.localStorage
| Tests forlocalStorage
-support$.support.sessionStorage
| Tests forsessionStorage
-support
Both return true
or false
, depending on the availability.
Download
Get the raw script, download the complete package or fork it on GitHub.
Support
@yckart #jquery #storage
Todo
Make it possible to pass the options as object to the $.storage
-method, like this:
var ls = $.localStorage({
cookiePrefix : 'fallback:' + method + ':',
cookieOptions : {
path : '/',
domain : document.domain,
expires : ('localStorage' === method) ? { expires: 365 } : undefined
}
});
###License Copyright (c) 2013 Yannick Albert (http://yckart.com/)
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.