一个简单的,轻量级的jQuery插件用于读,写和删除cookies。
使用方法
1.新添加一个会话 cookie:
$.cookie('name', 'value');
注:当没有指明 cookie有效时间时,所创建的cookie有效期默认到用户关闭浏览器为止,所以被称为
“会话cookie(session cookie)”。
$.cookie('user','x-man')//user是cookie的用户名,x-man是内容。
其中的user是cookie的名称,x-man是cookie的内容。可以看到过期时间是“再会话结束时”。
2.创建一个cookie并设置有效时间为 7天:
$.cookie('name', 'value', { expires: 7 });
注:当指明了cookie有效时间时,所创建的cookie被称为“持久 cookie (persistent cookie)”。
3.创建一个cookie并设置 cookie的有效路径:
$.cookie('name', 'value', { expires: 7, path: '/' });
注:在默认情况下,只有设置 cookie的网页才能读取该 cookie。如果想让一个页面读取另一个页面设
置的cookie,必须设置cookie的路径。cookie的路径用于设置能够读取 cookie的顶级目录。将这
个路径设置为网站的根目录,可以让所有网页都能互相读取 cookie (一般不要这样设置,防止出现冲突) 。
4.读取cookie:
$.cookie('name'); // cookie存在 => 'value'
$.cookie('nothing'); // cookie不存在 => undefined
$.cookie.get();//读取所有的cookie=>('name','value')
5.删除cookie,通过传递null作为cookie的值即可:
// 返回true表示被成功删除,false表示没有成功。
Cookies.remove('name'); // => true
Cookies.remove('nothing'); // => false
// 需要相同的属性来删除
Cookies.set('name', 'value', { path: '/' });
// 不再起作用了
Cookies.remove('name'); // => false
// 还可以用
Cookies.remove('name', { path: '/' }); // => true
注意:当删除一个cookie,你必须通过精确的路径,域和安全的选项,来重新设置cookie,除非你依赖于默认选项。
----------相关参数的解释---------------
1).expires: 365
定义cookie的有效时间,值可以是一个数字(从创建cookie时算起,以天为单位)或一个Date 对
象。如果省略,那么创建的cookie是会话cookie,将在用户退出浏览器时被删除。
2).path: '/'
默认情况:只有设置cookie的网页才能读取该cookie。
定义cookie的有效路径。默认情况下, 该参数的值为创建 cookie 的网页所在路径(标准浏览器的行为) 。
如果你想在整个网站中访问这个cookie需要这样设置有效路径:path: '/'。如果你想删除一个定义
了有效路径的 cookie,你需要在调用函数时包含这个路径:$.cookie('the_cookie', null,
{ path: '/' });。 domain: 'example.com'
默认值:创建 cookie的网页所拥有的域名。
3).secure: true
默认值:false。如果为true,cookie的传输需要使用安全协议(HTTPS)。
4).raw: true
默认值:false。
默认情况下,读取和写入 cookie 的时候自动进行编码和解码(使用encodeURIComponent 编码,
decodeURIComponent 解码)。要关闭这个功能设置 raw: true 即可。
// 释放掉"$" var Cookies2 = Cookies.noConflict(); Cookies2.set('name', 'value');
为阅读提供一个可选的最后一个参数的转换函数,以便将该cookie的值更改为在传递中的不同表示形式。
Cookies.set('foo', '42'); Cookies.get('foo', Number); // => 42
Cookies.raw = true; Cookies.get('foo', unescape);你可以通过任意转换函数。