DIV CSS 佈局教程網

jQuery Cookie 外掛:設定、讀取、刪除與原始碼解析
編輯:JQuery特效代碼     

原生 document.cookie 只能操作字串,讀寫都頗麻煩。jQuery 的 cookie 外掛把這件事包成一行 API。

使用範例

<html>
<head>
<title>JQuery-Cookie 插件</title>
<script type="text/javascript" src="jquery-1.4.js"></script>
<script type="text/javascript" src="jquery.cookie.js"></script>
</head>
<body>
<a href="#">設置 cookie1</a><br>
<a href="#">設置 cookie2</a><br>
<a href="#">獲取 cookie</a><br>
<a href="#">刪除 cookie</a><br>
</body>
</html>
<script type="text/javascript">
$(function() {
    var COOKIE_NAME = 'test_cookie';

    // 以「天數」設定過期
    $('a').eq(0).click(function() {
        $.cookie(COOKIE_NAME, 'test', { path: '/', expires: 1 });
        return false;
    });

    // 以明確日期設定過期
    $('a').eq(1).click(function() {
        var date = new Date();
        date.setTime(date.getTime() + (1 * 24 * 60 * 60 * 1000));
        $.cookie(COOKIE_NAME, 'test', { path: '/', expires: date });
        return false;
    });

    // 讀取
    $('a').eq(2).click(function() {
        alert($.cookie(COOKIE_NAME));
        return false;
    });

    // 刪除(把值設為 null)
    $('a').eq(3).click(function() {
        $.cookie(COOKIE_NAME, null, { path: '/' });
        return false;
    });
});
</script>

原始碼解析

整個外掛只有一個函式,透過「有沒有傳 value」來區分寫入與讀取:

jQuery.cookie = function(name, value, options) {
    if (typeof value != 'undefined') {
        // 有 value:寫入 cookie
        options = options || {};

        if (value === null) {
            value = '';
            options.expires = -1;          // 負的過期時間 = 立即失效
        }

        var expires = '';
        if (options.expires && (typeof options.expires == 'number' || options.expires.toUTCString)) {
            var date;
            if (typeof options.expires == 'number') {
                date = new Date();
                date.setTime(date.getTime() + (options.expires * 24 * 60 * 60 * 1000));
            } else {
                date = options.expires;
            }
            expires = '; expires=' + date.toUTCString();
        }

        var path   = options.path   ? '; path='   + options.path   : '';
        var domain = options.domain ? '; domain=' + options.domain : '';
        var secure = options.secure ? '; secure' : '';

        document.cookie = [name, '=', encodeURIComponent(value),
                           expires, path, domain, secure].join('');
    } else {
        // 沒傳 value:讀取 cookie
        var cookieValue = null;
        if (document.cookie && document.cookie != '') {
            var cookies = document.cookie.split(';');
            for (var i = 0; i < cookies.length; i++) {
                var cookie = jQuery.trim(cookies[i]);
                if (cookie.substring(0, name.length + 1) == (name + '=')) {
                    cookieValue = decodeURIComponent(cookie.substring(name.length + 1));
                    break;
                }
            }
        }
        return cookieValue;
    }
};

幾個容易忽略的細節

  • path 一定要一致。 設定時沒帶 path,刪除時帶了 /,就會刪不掉——這是最常見的「cookie 刪除失敗」原因。
  • expires 的兩種形式。 傳數字代表「幾天後過期」,傳 Date 物件則是直接指定時間點。
  • 值會被 URL 編碼。 所以中文也不會出問題,讀取時會自動解碼。
  • 不要把敏感資料放進 cookie。 它會隨每次請求送到伺服器,且使用者可任意修改;session 識別資訊應加上 secure 與 HttpOnly(後者需由伺服器設定)。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved