jquery.cookie是一个轻量级的cookie插件,可以读取,写入,删除cookie。
jquery.cookie.js的配置:
首先包含jQuery的库文件,在后面包含jquery.cookie.js的库文件。
- <script type="text/javascript" src="js/jquery-1.7.1.js"></script>
- <script type="text/javascript" src="js/jquery.cookie.js"></script>
使用方法:
新添加一个会话cookie:
- $.cookie('the_cookie','the_value');
- 注:当没有指明cookie有效时间时,所创建的cookie有效期默认到用户关闭浏览器为止,所以被称为“会话cookie(session cookie)”。
创建一个cookie并设置有效时间为7天:
- $.cookie('the_cookie,'the_value',{expire:7,path:'/'});
- 注:在默认情况下,只有设置cookie的网页才能读取该cookie,如果想让一个页面读取另一个页面设置的cookie,必须设置cookie的路径,cookies的路径用于设置能够读取cookie的顶级目录,将这个路径设置为网站的根目录,可以让所有网页都能互相读取cookie(一般不要这样设置,防止出现冲突)
读取cookie:
- $.cookie('the_cookie'); //cookie存在==>'the value'
- $.cookie('not_existing'); //cookie不存在==>不存在
删除cookie,通过传递null作为cookie的值即可:
- $.cookie('the_cookie',null);
相关参数的解释:
- expire:365
定义cookie的有效时间,值可以是一个数字(从创建cookie时算起,以天为单位)或一个Date对象,如果省略,那么创建的cookie是会话cookie,并在用户退出浏览器时被删除。
- path:'/'
默认情况,只有设置cookie的网页才能读取该cookie。
定义cookie的有效路径。默认情况下,该参数的值为创建cookie的网页所在路径(标准浏览器的行为)。如果你想在整个网站中访问这个cookie需要这样设置有效路径:path:'/'。如果你想删除一个定义了有效路径的cookie,你需要在调用函数时包含这个路径:$.cookie('the_cookie',null,{path:'/'});
- <span style="color:#000000;">domain:'example.com'
- </span>
默认值:创建cookie的网页所拥有的域名。
- secure:true
默认值:false,如果为true,cookie的传输需要使用安全协议(HTTPS)
- raw:true
默认值:false
默认情况下,读取和写入cookie的时候自动进行编码和解码(使用encodeURIComponent编码,decodeURICompont解码)。要关闭这个功能设置raw:true即可。