jquery.cookie.js 是一款輕量級的 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(session cookie)」。
2. 建立 Cookie 並設定有效時間為 7 天:
$.cookie('the_cookie', 'the_value', { expires: 7 });
一旦指定有效時間,建立的便是「持久 Cookie(persistent cookie)」。
3. 建立 Cookie 並設定有效路徑:
$.cookie('the_cookie', 'the_value', { expires: 7, path: '/' });
預設情況下,只有設定 Cookie 的網頁才能讀取該 Cookie。若要讓全站頁面都能互相讀取,可將路徑設為根目錄 /(但一般不建议這麼做,以免造成衝突)。
4. 讀取 Cookie:
$.cookie('the_cookie'); // Cookie 存在 => 'the_value'
$.cookie('not_existing'); // Cookie 不存在 => null
5. 刪除 Cookie: 傳入 null 作為值即可。
$.cookie('the_cookie', null);
expires:定義有效時間,可為數字(自建立起算的天數)或 Date 物件;省略則為工作階段 Cookie。path:定義有效路徑,預設為建立 Cookie 的網頁所在路徑;設為 / 可在全站存取。刪除帶路徑的 Cookie 時需一併指定,如 $.cookie('the_cookie', null, { path: '/' })。domain:預設為建立 Cookie 的網頁所屬網域。secure:預設 false;設為 true 時,Cookie 需透過 HTTPS 傳輸。raw:預設 false。預設會自動以 encodeURIComponent 編碼、decodeURIComponent 解碼;設為 true 可關閉此功能。