記住使用者名稱、記住上次的篩選條件、記住是否看過引導頁——這些需求用 Cookie 就能搞定。而 jquery.cookie.js 把原生 document.cookie 那套繁瑣的字符串拼接封裝成了兩行 API,是輕量級項目裡的常見選擇。
先提醒一個高頻錯誤。如果同一頁面重複引入 jQuery 或 cookie 插件,Chrome 會報 has no method $.cookie,Firefox 則提示 $.cookie is not a function。原因在於後一次引入覆蓋了前一次已擴展好的 jQuery 對象。排查時第一步就是確認插件只被加載了一次。
<script src="jQuery.1.8.3.js" type="text/javascript"></script> <script src="jquery.cookie.js" type="text/javascript"></script>
核心只有一個函數:$.cookie(名稱, 值, [option])。傳一個參數是讀,傳兩個是寫,值設為 null 則刪除。
$.cookie("username"); // 讀取名為 username 的 cookie
$.cookie("username", "admin"); // 寫入
$.cookie("username", null); // 刪除
四個可選屬性,每一個都有實際影響:
expires:有效期,可為整數(天)或 Date 對象。不設置時,Cookie 屬於會話級別,瀏覽器一關閉就失效——這是最常被忽略的一點。
path:Cookie 生效的路徑,預設與當前頁面的路徑一致。若希望整站可讀,通常設為 "/"。
domain:Cookie 生效的域名,預設為當前域名。若需要讓二級域名共享,應設為 ".example.com" 這種以點開頭的形式,這一步是跨子域讀寫的關鍵。
secure:布爾值,設為 true 時要求通過 HTTPS 傳輸。
$.cookie("like", $(":radio[checked]").val(), { path: "/", expires: 7 });
下面的頁面實現了:載入時把上次保存的用戶名與偏好單選項回填,點擊保存按鈕後寫入 Cookie,有效期七天。
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<title>jQuery Cookie 示例</title>
<script src="jQuery.1.8.3.js" type="text/javascript"></script>
<script src="jquery.cookie.js" type="text/javascript"></script>
<script type="text/javascript">
$(function () {
$("#username").val($.cookie("username"));
if ($.cookie("like") == "劉德華") {
$(":radio[value='劉德華']").attr("checked", "checked");
} else {
$(":radio[value='張學友']").attr("checked", "checked");
}
$(":button").click(function () {
$.cookie("username", $("#username").val(), { path: "/", expires: 7 });
$.cookie("like", $(":radio[checked]").val(), { path: "/", expires: 7 });
});
});
</script>
</head>
<body>
<p><input type="text" id="username" value="" /></p>
<p>
<input type="radio" name="like" value="劉德華" />劉德華
<input type="radio" name="like" value="張學友" />張學友
</p>
<p><input type="button" value="保存" /></p>
</body>
</html>
補充一點:設定 radio 的 checked 狀態,在新版 jQuery 中建議改用 .prop("checked", true),原因下一篇文章會專門說明。
Cookie 本質上就是一段文本,只能保存字符串。要存放對象,必須先 JSON.stringify 序列化,讀出來時再 JSON.parse 反序列化。
$(function () {
if ($.cookie("o") == null) {
var o = { name: "張三", age: 24 };
var str = JSON.stringify(o); // 序列化後存入
$.cookie("o", str, {
expires: 7 // 留空則關閉瀏覽器即失效
});
alert("cookie 為空,已寫入默認值");
} else {
var o1 = JSON.parse($.cookie("o")); // 反序列化回對象
alert(o1.name);
}
});
Cookie 有大小限制(一般單個不超過 4KB,同域總數也有限制),因此適合存標識與小規模偏好,不要拿來存列表數據。另外 Cookie 明文可讀,切勿存放密碼、權杖等敏感資訊;需要記住登入狀態時,只存一個無意義的 session id,真正的校驗放在服務端。
最後,若你的項目只需要在瀏覽器本地保存數據、不涉及服務端讀取,localStorage 會是更好的選擇:容量更大、不會隨每次請求發送、API 也更直觀。Cookie 的價值主要在於它會自動隨 HTTP 請求攜帶。