jquery.cookie.js使用介绍
Cookies概述:
Cookies是一种能够让网站服务器把少量数据储存到客户端的硬盘或内存,或是从客户端的硬盘读取数据的一种技术。Cookies是当你浏览某网站时,由Web服务器置于你硬盘上的一个非常小的文本文件,它可以记录你的用户ID、密码、浏览过的网页、停留的时间等信息。当你再次来到该网站时,网站通过读取Cookies,得知你的相关信息,就可以做出相应的动作,如在页面显示欢迎你的标语,或者让你不用输入ID、密码就直接登录等等。
从本质上讲,它可以看作是你的身份证。但Cookies不能作为代码执行,也不会传送病毒,且为你所专有,并只能由提供它的服务器来读取。保存的信息片断以“名/值”对(name-value pairs)的形式储存,一个“名/值”对仅仅是一条命名的数据。一个网站只能取得它放在你的电脑中的信息,它无法从其它的Cookies文件中取得信息,也无法得到你的电脑上的其它任何东西。
Cookies中的内容大多数经过了加密处理,因此一般用户看来只是一些毫无意义的字母数字组合,只有服务器的CGI处理程序才知道它们真正的含义。
由于Cookies是我们浏览的网站传输到用户计算机硬盘中的文本文件或内存中的数据,因此它在硬盘中存放的位置与使用的操作系统和浏览器密切相关。在搜狗浏览器中(4.2版本)的Cookies文件的存放位置位置在搜狗浏览器的IE缓存位置。
硬盘中的Cookies文件可以被Web浏览器读取,它的命令格式为:Cookie:用户名@网站地址。比如我的搜狗浏览器的其中一个cookie文件是Cookie:administrator@matthew2012.blog.51cto.com。要注意的是:硬盘中的Cookies属于文本文件,不是程序。
jQuery.cookie.js参数解释:
一个轻量级的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>
使用方法
1.新添加一个会话 cookie:
$.cookie('the_cookie', 'the_value');
注:当没有指明 cookie有效时间时,所创建的cookie有效期默认到用户关闭浏览器为止,所以被称为 “会话cookie(session cookie)”。
2.创建一个cookie并设置有效时间为 7天:
$.cookie('the_cookie', 'the_value', { expires: 7 });
注:当指明了cookie有效时间时,所创建的cookie被称为“持久 cookie (persistent cookie)”。
3.创建一个cookie并设置 cookie的有效路径:
$.cookie('the_cookie', 'the_value', { expires: 7, path: '/' });
注:在默认情况下,只有设置 cookie的网页才能读取该 cookie。如果想让一个页面读取另一个页面设置的cookie,必须设置cookie的路径。cookie的路径用于设置能够读取 cookie的顶级目录。将这个路径设置为网站的根目录,可以让所有网页都能互相读取 cookie (一般不要这样设置,防止出现冲突) 。
4.读取cookie:
$.cookie('the_cookie'); // cookie存在 => 'the_value'
$.cookie('not_existing'); // cookie不存在 => null
5.删除cookie,通过传递null作为cookie的值即可:
$.cookie('the_cookie', null);
相关参数的解释
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 即可。
这个插件默认的过期是按天数计算的,我们可以修改下,按毫秒计算,修改如下:
if (typeof options.expires === 'number') { //var days = options.expires, t = options.expires = new Date(); //t.setDate(t.getDate() + days); var seconds = options.expires, t = options.expires = new Date(); t.setTime(t.getTime() + seconds); //t.setTime(t.getTime() + days); //date.setTime(date.getTime() + (1 * 24 * 60 * 60 * 1000)); }
jQuery.cookie.js使用举例:
这是一个jQuery cookie的使用例子,通过本示例的学习希望朋友们能熟悉在引入jquery.cookie.js插件后,如何去使用它,你可以了解到cookie天数设置、日期设置、多个cookie的设置、如何获取Cookie、通过 date 对象设置过期日期为 3 天后的那天、设置有效期天数等小技巧。
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> <html> <head> <meta http-equiv="Content-Script-Type" content="text/javascript"> <title>jQuery Cookie Plugin</title> <script src="http://www.codefans.net/ajaxjs/jquery1.3.2.js" type="text/javascript"></script> <script src="http://www.codefans.net/ajaxjs/jquery.cookie.js" type="text/javascript"></script> <script type="text/javascript"> $(function() { var COOKIE_NAME = 'test_cookie'; var ADDITIONAL_COOKIE_NAME = 'additional'; $('a').eq(0).click(function() { // 用天数设置 cookie $.cookie(COOKIE_NAME, 'test', { path: '/', expires: 10 }); return false; }); $('a').eq(1).click(function() { // 用日期设置 cookie var date = new Date(); date.setTime(date.getTime() + (3 * 24 * 60 * 60 * 1000)); $.cookie(COOKIE_NAME, 'test', { path: '/', expires: date }); return false; }); $('a').eq(2).click(function() { // 获取 cookie alert($.cookie(COOKIE_NAME)); return false; }); $('a').eq(3).click(function() { // 删除 cookie $.cookie(COOKIE_NAME, null, { path: '/' }); return false; }); $('a').eq(4).click(function() { // 设置第二个 cookie $.cookie(ADDITIONAL_COOKIE_NAME, 'foo', { expires: 10 }); return false; }); $('a').eq(5).click(function() { // 获取第二个 cookie alert($.cookie(ADDITIONAL_COOKIE_NAME)); return false; }); $('a').eq(6).click(function() { // 删除第二个 cookie $.cookie(ADDITIONAL_COOKIE_NAME, null); return false; }); }); </script> </head> <body> <p> <a href="#">设置 cookie (设置有效期天数为 10 天)</a><br> <a href="#">设置 cookie (通过 date 对象设置过期日期为 3 天后的那天)</a><br> <a href="#">获取 cookie</a><br> <a href="#">删除 cookie</a><br> <a href="#">设置另一个 cookie</a><br> <a href="#">获取另一个 cookie</a><br> <a href="#">删除另一个 cookie</a> </p> </body> </html>