jQuery.cookie的使用指南

標籤：strong   定義   res   com   使用方法   衝突   需要   網域名稱   6.2   

　　一個輕量級的cookie 外掛程式，可以讀取、寫入、刪除 cookie。 

配置 

　　首先包含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: ‘/‘ });預設值：建立 cookie的網頁所擁有的網域名稱。

　　3).secure: true 

　　預設值：false。如果為true，cookie的傳輸需要使用安全性通訊協定（HTTPS）。 

　　4).raw: true 

　　預設值：false。 
　　預設情況下，讀取和寫入 cookie 的時候自動進行編碼和解碼（使用encodeURIComponent 編碼，decodeURIComponent 解碼）。要關閉這個功能設定 raw: true 即可。 

　　

jQuery.cookie的使用指南