一個輕量級的cookie 插件,可以讀取、寫入、刪除 cookie。
jquery.cookie.js 的配置
首先包含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有效期默認到用戶關閉浏覽器為止,所以被稱為
“會話cookie(session cookie)”。
2.創建一個cookie並設置有效時間為 7天:
$.cookie('the_cookie', 'the_value', { expires: 7 });
注:當指明了cookie有效時間時,所創建的cookie被稱為“持久 cookie (persistent cookie)”。
3.創建一個cookie並設置 cookie的有效路徑:
$.cookie('the_cookie', 'the_value', { expires: 7, path: '/' });
注:在默認情況下,只有設置 cookie的網頁才能讀取該 cookie。如果想讓一個頁面讀取另一個頁面設
置的cookie,必須設置cookie的路徑。cookie的路徑用於設置能夠讀取 cookie的頂級目錄。將這
個路徑設置為網站的根目錄,可以讓所有網頁都能互相讀取 cookie (一般不要這樣設置,防止出現沖突) 。
4.讀取cookie:
$.cookie('the_cookie'); // cookie存在 => 'the_value'
$.cookie('not_existing'); // cookie不存在 => null
5.刪除cookie,通過傳遞null作為cookie的值即可:
$.cookie('the_cookie', null);
----------相關參數的解釋---------------
1).expires: 365
定義cookie的有效時間,值可以是一個數字(從創建cookie時算起,以天為單位)或一個Date 對
象。如果省略,那麼創建的cookie是會話cookie,將在用戶退出浏覽器時被刪除。
2).path: '/'
默認情況:只有設置cookie的網頁才能讀取該cookie。
定義cookie的有效路徑。默認情況下, 該參數的值為創建 cookie 的網頁所在路徑(標准浏覽器的行為) 。
如果你想在整個網站中訪問這個cookie需要這樣設置有效路徑:path: '/'。如果你想刪除一個定義
了有效路徑的 cookie,你需要在調用函數時包含這個路徑:$.cookie('the_cookie', null,
{ path: '/' });。 domain: 'example.com'
默認值:創建 cookie的網頁所擁有的域名。
3).secure: true
默認值:false。如果為true,cookie的傳輸需要使用安全協議(HTTPS)。
4).raw: true
默認值:false。
默認情況下,讀取和寫入 cookie 的時候自動進行編碼和解碼(使用encodeURIComponent 編碼,
decodeURIComponent 解碼)。要關閉這個功能設置 raw: true 即可。