jquery.cookie
使用方法
一个轻量级的
cookie
插件,可以读取、写入、删除
cookie
。
jquery.cookie.js
的配置
首先包含
jQuery
的库文件,在后面包含
jquery.cookie.js
的库文件。
<script type="text/javascript" src="js/jquery-1.6.2.min.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', { expires: 7 });
注:
当指明了
cookie
有效时间时,
所创建的
cookie
被称为
“持久
cookie
(
persistent
cookie
)
”
。
创建一个
cookie
并设置
cookie
的有效路径:
$.cookie('the_cookie', 'the_value', { expires: 7, path: '/' });
注:在默认情况下,只有设置
cookie
的网页才能读取该
cookie
。如果想让一个页面读取另一个页面设
置的
cookie
,必须设置
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
即可。