在瀏覽器端讀寫 Cookie 是 Web 開發的常備技能。過去多半得自己手寫 document.cookie 的字串拼接與解碼,容易出錯;改用專門的 jQuery cookie 外掛後,設定、讀取、刪除都能壓縮成一行。
外掛可從 jQuery 官網取得。頁面中先載入 jQuery,再載入外掛,順序不能顛倒:
<script type="text/javascript" src="js/jquery.js"></script>
<script type="text/javascript" src="js/jquery.cookie.js"></script>
最簡短的寫法只需要名稱與值,這種沒有指定有效期的 Cookie 在瀏覽器關閉後即失效:
$.cookie("blog", "css9.net");
加上 expires 就能指定存活天數,成為持久性 Cookie:
$.cookie("blog", "css9.net", { expires: 7 });
若同時要控制作用範圍,可搭配 path。以下這份 Cookie 只在 /admin 路徑底下可讀,且七天後過期:
$.cookie("blog", "css9.net", { path: '/admin', expires: 7 });
只傳名稱就會回傳對應的字串值;不存在時通常得到 null:
alert($.cookie("blog"));
把值設為 null 是最直觀的刪除方式:
$.cookie("example", null);
要注意的是,刪除時若當初設定過 path 或 domain,必須帶上一樣的參數才能精準命中,否則會刪不掉。外掛原始檔的註解裡對各參數有相當完整的說明,值得掃過一遍。