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 即可。

原文引用：http://wenku.baidu.com/view/0147277e27284b73f2425074.html