jquery.cookie 使用方法 |
一个轻量级的 cookie 插件,可以读取、写入、删除 cookie 。 |
jquery.cookie.js 的配置 |
首先包含 jQuery 的库文件,在后面包含 jquery.cookie.js 的库文件。
|
使用方法 |
新添加一个会话 cookie : |
$.cookie('the_cookie', 'the_value');
|
注:当没有指明 cookie 有效时间时,所创建的 cookie 有效期默认到用户关闭浏览器为止,所以被称为 “会话 cookie ( session cookie ) ” 。 |
创建一个 cookie 并设置有效时间为 7 天: |
$.cookie('the_cookie', 'the_value', { expires: 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 即可。 |