一個(gè)輕量級的cookie 插件,可以讀取、寫入、刪除 cookie。
使用方法
1.新添加一個(gè)會(huì)話 cookie:
$.cookie('the_cookie', 'the_value');
注:當(dāng)沒有指明 cookie有效時(shí)間時(shí),所創(chuàng)建的cookie有效期默認(rèn)到用戶關(guān)閉瀏覽器為止,所以被稱為
“會(huì)話cookie(session cookie)”。
2.創(chuàng)建一個(gè)cookie并設(shè)置有效時(shí)間為 7天:
$.cookie('the_cookie', 'the_value', { expires: 7 });
注:當(dāng)指明了cookie有效時(shí)間時(shí),所創(chuàng)建的cookie被稱為“持久 cookie (persistent cookie)”。
3.創(chuàng)建一個(gè)cookie并設(shè)置 cookie的有效路徑:
$.cookie('the_cookie', 'the_value', { expires: 7, path: '/' });
注:在默認(rèn)情況下,只有設(shè)置 cookie的網(wǎng)頁才能讀取該 cookie。如果想讓一個(gè)頁面讀取另一個(gè)頁面設(shè)
置的cookie,必須設(shè)置cookie的路徑。cookie的路徑用于設(shè)置能夠讀取 cookie的頂級目錄。將這
個(gè)路徑設(shè)置為網(wǎng)站的根目錄,可以讓所有網(wǎng)頁都能互相讀取 cookie (一般不要這樣設(shè)置,防止出現(xiàn)沖突) 。
4.讀取cookie:
$.cookie('the_cookie'); // cookie存在 => 'the_value'
$.cookie('not_existing'); // cookie不存在 => null
5.刪除cookie,通過傳遞null作為cookie的值即可:
$.cookie('the_cookie', null);
----------相關(guān)參數(shù)的解釋---------------
1).expires: 365
定義cookie的有效時(shí)間,值可以是一個(gè)數(shù)字(從創(chuàng)建cookie時(shí)算起,以天為單位)或一個(gè)Date 對
象。如果省略,那么創(chuàng)建的cookie是會(huì)話cookie,將在用戶退出瀏覽器時(shí)被刪除。
2).path: '/'
默認(rèn)情況:只有設(shè)置cookie的網(wǎng)頁才能讀取該cookie。
定義cookie的有效路徑。默認(rèn)情況下, 該參數(shù)的值為創(chuàng)建 cookie 的網(wǎng)頁所在路徑(標(biāo)準(zhǔn)瀏覽器的行為) 。
如果你想在整個(gè)網(wǎng)站中訪問這個(gè)cookie需要這樣設(shè)置有效路徑:path: '/'。如果你想刪除一個(gè)定義
了有效路徑的 cookie,你需要在調(diào)用函數(shù)時(shí)包含這個(gè)路徑:$.cookie('the_cookie', null,
{ path: '/' });。 domain: 'example.com'
默認(rèn)值:創(chuàng)建 cookie的網(wǎng)頁所擁有的域名。
3).secure: true
默認(rèn)值:false。如果為true,cookie的傳輸需要使用安全協(xié)議(HTTPS)。
4).raw: true
默認(rèn)值:false。
默認(rèn)情況下,讀取和寫入 cookie 的時(shí)候自動(dòng)進(jìn)行編碼和解碼(使用encodeURIComponent 編碼,
decodeURIComponent 解碼)。要關(guān)閉這個(gè)功能設(shè)置 raw: true 即可。