[译]使用jquery.cookie操作Cookie说明

jquery.cookie是一个轻量级JQuery插件，用来读、写、删除Cookie

安装

将jquery.cookie脚本的引用放在jQuery库引用之后

使用方法

创建session cookie:

$.cookie('the_cookie', 'the_value');

创建一个带有7 天生存周期的Cookie

$.cookie('the_cookie', 'the_value', { expires: 7 });

创建一个带有生存周期的Cookie, 整个站点有效:

$.cookie('the_cookie', 'the_value', { expires: 7, path: '/' });

读取cookie:

$.cookie('the_cookie'); // => "the_value"
$.cookie('not_existing'); // => undefined

读取所有有效的Cookie:

$.cookie(); // => { "the_cookie": "the_value", "...remaining": "cookies" }

删除cookie:

// 删除成功返回true，失败返回false
$.removeCookie('the_cookie');

//删除与cookie写入时，相同路径下的
$.removeCookie('the_cookie', { path: '/' });

注意：在删除一个Cookie的时候，你必须要传入与设置cookie相同的路径、域名、安全设置，除非你用的是默认设置。

配置

raw

在写入/读取Cookie的时候，值默认被加密/解密（使用encodeURIComponent/decodeURIComponent），设置raw=true，让cookie不进行加密

$.cookie.raw = true;

Cookie选项
Cookie属性可以进行全局设置，通过设置$.cookie.defaults 对象 或单独向$.cookie()传递一个简单的对象作为设置的参数。

生存周期(expires)

expires: 365

定义cookie的生命周期。生命周期的单位是数值，我们可以通过传递time或者date对象来创建生命周期。如果省略,Cookie变成会话cookie。

路径（path）

path: '/'

定义cookie在什么路径下有效。默认的设置:Cookie在创建Cookie本身的路径下有效。如果，你想要让Cookie在整个域名内有效，那就定义path:’/’.

域名（domain）

domain: 'example.com'

定义Cookie在什么域名下有效。默认的设置是：cookie在创建Cookie本身的域名下有效。

安全（secure）

secure: true

如果为真,cookie通过安全协议(https)传递。默认值:假。

源地址