一、使用方法
新添加一个会话cookie:
$.cookie('the_cookie', 'the_value');
注:当没有指明cookie有效时间时,所创建的cookie有效期默认到用户关闭浏览器为止,所以被称为“会话cookie(session cookie)”
创建一个cookie并设置有效时间为7天:
$.cookie('the_cookie', 'the_value', { expires: 7 });
创建一个cookie并设置cookie的有效路径:
$.cookie('the_cookie', 'the_value', { expires: 7, path: '/' });
注:在默认情况下,只有设置cookie的网页才能读取该cookie。如果想让一个页面读取另一个页面设置的cookie,必须设置cookie的路径。
二、读取cookie:
$.cookie('the_cookie');
// cookie存在 => 'the_value' $.cookie('not_existing'); // cookie不存在 => null
删除cookie,通过传递null作为cookie的值即可:
$.cookie('the_cookie', null);
三、相关参数的解释
expires: 365
定义cookie的有效时间,值可以是一个(从创建cookie时算起,以天为单位)或一个Date。
如果省略,那么创建的cookie是会话cookie,将在用户退出浏览器时被删除。
path: '/'
默认情况:只有设置cookie的网页才能读取该cookie。
定义cookie的有效路径。默认情况下,该参数的值为创建cookie的网页所在路径(标准浏览器的行为)。
如果你想在整个网站中访问这个cookie需要这样设置有效路径:path: '/'。
如果你想删除一个定义了有效路径的cookie,你需要在调用函数时包含这个路径:$.cookie('the_cookie', null, { path: '/' });。
domain: 'example.com'
默认值:创建cookie的网页所拥有的域名。
secure: true
默认值:false。如果为true,cookie的传输需要使用安全协议(HTTPS)。
raw: true
默认值:false。 默认情况下,读取和写入cookie的时候自动进行编码和解码(使用encodeURIComponent编码,decodeURIComponent解码)。
要关闭这个功能设置raw: true即可。
$.cookie('the_cookie'); // get cookie $.cookie('the_cookie', 'the_value'); // set cookie $.cookie('the_cookie', 'the_value', { expires: 7 }); // set cookie with an expiration date seven days in the future $.cookie('the_cookie', '', { expires: -1 }); // delete cookie
$.cookie('the_cookie', null); // delete cookie
$.cookie('the_cookie','the_value', {expires: 7, path: '/', domain:'80tvb.com', secure: true});//完整调用方式
//或者这样:$.cookie('the_cookie','the_value');
//删除Cookie: $.cookie('the_cookie',null);
四、jquery设置cookie过期时间与检查cookies是否可用
让cookies在x分钟后过期
var date = new date();
date.settime(date.gettime() + (x * 60 * 1000));
$.cookie(‘example', ‘foo', { expires: date });
检查cookies是否可用
$(document).ready(function() {
var dt = new date();
dt.setseconds(dt.getseconds() + 60);
document.cookie = “cookietest=1; expires=” + dt.togmtstring();
var cookiesenabled = document.cookie.indexof(“cookietest=”) != -1;
if(!cookiesenabled){
//cookies不能用……..
}
});