jquery.cookie使用方法
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
即可。
