地址:http://plugins.jquery.com/cookie/
GitHub地址:https://github.com/carhartl/jquery-cookie
使用场景:
比如网站的换肤、黑白模式切换、关闭弹窗广告等,不依赖服务端进行数据存储,使用cookie来实现,相对就容易多了。
引入jquery和jquery.cookie.js
需要依赖jquery,所以必须首先引入jquery
<script src="js/jquery-3.1.1.min.js"></script> <script src="js/jquery.cookie2.js"></script>
使用方法和示例
(一)创建cookie
添加cookie
$.cookie("skin","red");//添加cookie名是skin,值是red
注意:没有设置cookie的有效期,所以当用户关闭浏览器,则cookie自动销毁。
添加cookie,设置3天有效期
$.cookie("skin","red",{ expires: 3 });
添加cookie,设置3天有效期,路径为网站根目录
$.cookie('skin', 'red', { expires: 3, path: '/' });
注意:在默认情况下,只有设置了 cookie 的网页才能读取该 cookie,如果想要整站都可以读取cookie,就设置路径
添加cookie,设置30秒后过期
var now = new Date(); now.setTime(now.getTime() 0.5 * 60 * 1000);//0.5就是30s,10分钟则将0.5改成10 $.cookie('skin', 'red', { expires: now ,path: "/", }); //说明:setTime() 方法以毫秒设置 Date 对象。
(二)读取cookie
$.cookie('skin'); // 输出red $.cookie('name');//没有设置name,所以输出undefined //下面是读取所有的cookie $.cookie(); // 输出{ "skin": "red" }
(三)删除cookie
$.removeCookie('skin');//成功返回true,失败返回false $.removeCookie('skin', { path: '/' });//成功返回true,失败返回false $.cookie('skin',null);//设置为null也可以当作是删除
(四)参数的说明
参数 | 说明 |
expires | 定义 cookie 的有效时间,值可以是一个数字(从创建 cookie 时算起,以天为单位)或一个 Date 对象。如果省略,那么创建的 cookie 是会话 cookie,将在用户退出浏览器时被删除。 |
path | 默认情况:只有设置 cookie 的网页才能读取该 cookie。 定义 cookie 的有效路径。默认情况下, 该参数的值为创建 cookie 的网页所在路径(标准浏览器的行为)。 如果你想在整个网站中访问这个 cookie 需要这样设置有效路径:path: '/'。如果你想删除一个定义了有效路径的 cookie,你需要在调用函数时包含这个路径: $.cookie('skin', null,{ path: '/' }); |
domain | 创建 cookie 的网页所拥有的域名。 domain: 'yusan.cn' |
secure | 默认值:false。如果为 true,cookie 的传输需要使用安全协议(HTTPS)。 |