一個輕量級的cookie 插件,可以讀取、寫入、刪除 cookie。
jquery.cookie.js 的配置
首先包含jQuery的庫文件,在後麵包含 jquery.cookie.js 的庫文件。
使用方法
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 即可。