jQuery插件 -- Cookie插件jquery.cookie.js

jQuery插件 -- Cookie插件jquery.cookie.js（轉）

Cookie是網站設計者放置在客戶端的小文本文件。Cookie能爲用戶提供不少的使得，例如購物網站存儲用戶曾經瀏覽過的產品列表，或者門戶網站記住用戶喜歡選擇瀏覽哪類新聞。 在用戶容許的狀況下，還能夠存儲用戶的登陸信息，使得用戶在訪問網站時沒必要每次都鍵入這些信息

Cookie下載地址：  http://plugins.jquery.com/project/cookie

使用方法：

1.引入jquery.cookie.js

<script src="scripts/jquery-1.6.4.js" type="text/javascript"></script>  
<script src="scripts/jquery.cookie.js" type="text/javascript"></script>

2.使用方法

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);

3.將cookie寫入文件

var COOKIE_NAME = 'username';  
    if( $.cookie(COOKIE_NAME) ){  
        $("#username").val(  $.cookie(COOKIE_NAME) );  
    }  
    $("#check").click(function(){  
        if(this.checked){  
            $.cookie(COOKIE_NAME, $("#username").val() , { path: '/', expires: 10, domain: 'jquery.com', secure: true });  
            //var date = new Date();  
            //date.setTime(date.getTime() + (3 * 24 * 60 * 60 * 1000)); //三天後的這個時候過時  
            //$.cookie(COOKIE_NAME, $("#username").val(), { path: '/', expires: date });  
        }else{  
            $.cookie(COOKIE_NAME, null, { path: '/' });  //刪除cookie  
        }  
    });

參數設置：
expires: (Number | Date)      有效期，能夠設置一個整數做爲有效期（單位：天），也能夠設置一個日期對象做爲Cookie的過時日期。若是指定日期爲負數，那麼此cookie將被刪除；若是不設置或者設置爲null，那麼此cookie將被看成Session Cookie處理，而且在瀏覽器關閉後刪除

path:  (String)          Cookie的路徑屬性，默認是建立該cookie的頁面路徑

domain: (String)     Cookie的域名屬性，默認是建立該cookie的頁面域名

secure: (Boolean)  若是設爲true，那麼此cookie的傳輸會要求一個安全協議，例如HTTPS