jquery.cookie是一个轻量级JQuery插件,用来读、写、删除Cookie
安装
将jquery.cookie脚本的引用放在jQuery库引用之后
使用方法
创建session cookie:
$.cookie('the_cookie', 'the_value');
创建一个带有7 天生存周期的Cookie
$.cookie('the_cookie', 'the_value', { expires: 7 });
创建一个带有生存周期的Cookie, 整个站点有效:
$.cookie('the_cookie', 'the_value', { expires: 7, path: '/' });
读取cookie:
$.cookie('the_cookie'); // => "the_value" $.cookie('not_existing'); // => undefined
读取所有有效的Cookie:
$.cookie(); // => { "the_cookie": "the_value", "...remaining": "cookies" }
删除cookie:
// 删除成功返回true,失败返回false $.removeCookie('the_cookie');
//删除与cookie写入时,相同路径下的 $.removeCookie('the_cookie', { path: '/' });
注意:在删除一个Cookie的时候,你必须要传入与设置cookie相同的路径、域名、安全设置,除非你用的是默认设置。
配置
raw
在写入/读取Cookie的时候,值默认被加密/解密(使用encodeURIComponent
/decodeURIComponent
),设置raw=true,让cookie不进行加密
$.cookie.raw = true;
Cookie选项
Cookie属性可以进行全局设置,通过设置$.cookie.defaults
对象 或单独向$.cookie()传递一个简单的对象作为设置的参数。
生存周期(
expires)
expires: 365
定义cookie的生命周期。生命周期的单位是数值,我们可以通过传递time或者date对象来创建生命周期。如果省略,Cookie变成会话cookie。
路径(path)
path: '/'
定义cookie在什么路径下有效。默认的设置:Cookie在创建Cookie本身的路径下有效。如果,你想要让Cookie在整个域名内有效,那就定义path:’/’.
域名(domain)
domain: 'example.com'
定义Cookie在什么域名下有效。默认的设置是:cookie在创建Cookie本身的域名下有效。
安全(secure)
secure: true
如果为真,cookie通过安全协议(https)传递。默认值:假。