DIV CSS 佈局教程網

jQuery Cookie 插件詳解:讀寫、過期時間與跨域設置
編輯:JQuery入門技巧     

記住使用者名稱、記住上次的篩選條件、記住是否看過引導頁——這些需求用 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);      // 刪除

option 參數說明

四個可選屬性,每一個都有實際影響:

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 請求攜帶。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved