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

即可。