這是一個輕量級的 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>
新增一個會話 cookie:
$.cookie('the_cookie', 'the_value');
當未指明有效時間時,cookie 預設到使用者關閉瀏覽器為止,稱為「會話 cookie(session cookie)」。
建立並設定有效時間為 7 天(此時稱為「持久 cookie」):
$.cookie('the_cookie', 'the_value', { expires: 7 });
建立並設定有效路徑:
$.cookie('the_cookie', 'the_value', { expires: 7, path: '/' });
預設情況下只有設定 cookie 的網頁才能讀取它。若想讓其他頁面也能讀取,必須設定 path,將其設為網站根目錄可讓所有頁面共享(但一般不建议這麼設,以免衝突)。
$.cookie('the_cookie'); // 存在回傳 'the_value',不存在回傳 null
$.cookie('the_cookie', null); // 刪除 cookie
expires:有效時間,可為天數或 Date 物件;省略則為會話 cookie。
path:有效路徑,預設為建立 cookie 的網頁路徑;設為 '/' 可全站存取;刪除有路徑設定的 cookie 時也要帶上相同路徑。
domain:預設為建立 cookie 的網域。
secure:預設 false,設為 true 時 cookie 需經 HTTPS 傳輸。
raw:預設 false,會自動以 encodeURIComponent 編碼、decodeURIComponent 解碼;設為 true 可關閉此功能。
完整呼叫範例:
$.cookie('the_cookie','the_value', {expires: 7, path: '/', domain:'80tvb.com', secure: true});
讓 cookie 在 x 分鐘後過期:
var date = new Date();
date.setTime(date.getTime() + (x * 60 * 1000));
$.cookie('example', 'foo', { expires: date });
檢查瀏覽器是否啟用 cookie:
$(document).ready(function() {
var dt = new Date();
dt.setSeconds(dt.getSeconds() + 60);
document.cookie = "cookietest=1; expires=" + dt.toGMTString();
var cookiesenabled = document.cookie.indexOf("cookietest=") != -1;
if(!cookiesenabled){ /* cookies 不能用... */ }
});