一個輕量級的cookie插件,能夠讀取、寫入、刪除cookie。
jquery.cookie.js的配置
首先包含jQuery的庫文件,在後麪包含jquery.cookie.js的庫文件。 javascript
<script type="text/javascript" src="js/jquery-1.6.2.min.js"></script>java
<script type="text/javascript" src="js/jquery.cookie.js"></script>jquery
使用方法
新添加一個會話cookie: $.cookie('the_cookie', 'the_value'); 瀏覽器
注:當沒有指明cookie有效時間時,所建立的cookie有效期默認到用戶關閉瀏覽器爲止,因此被稱爲「會話cookie(session cookie)」。
建立一個cookie並設置有效時間爲7天: $.cookie('the_cookie', 'the_value', { expires: 7 }); 安全
注:當指明瞭cookie有效時間時,所建立的cookie被稱爲「持久cookie(persistent cookie)」。
建立一個cookie並設置cookie的有效路徑: $.cookie('the_cookie', 'the_value', { expires: 7, path: '/' }); cookie
注:在默認狀況下,只有設置cookie的網頁才能讀取該cookie。若是想讓一個頁面讀取另外一個頁面設置的cookie,必須設置cookie的路徑。cookie的路徑用於設置可以讀取cookie的頂級目錄。將這個路徑設置爲網站的根目錄,能夠讓全部網頁都能互相讀取cookie(通常不要這樣設置,防止出現衝突)。
讀取cookie: $.cookie('the_cookie'); // cookie存在 => 'the_value' $.cookie('not_existing'); // cookie不存在 => null
刪除cookie,經過傳遞null做爲cookie的值便可: $.cookie('the_cookie', null);
相關參數的解釋 expires: 365
定義cookie的有效時間,值能夠是一個數字(從建立cookie時算起,以天爲單位)或一個Date對象。若是省略,那麼建立的cookie是會話cookie,將在用戶退出瀏覽器時被刪除。 path: '/'
默認狀況:只有設置cookie的網頁才能讀取該cookie。
定義cookie的有效路徑。默認狀況下,該參數的值爲建立cookie的網頁所在路徑(標準瀏覽器的行爲)。若是你想在整個網站中訪問這個cookie須要這樣設置有效路徑:path: '/'。若是你想刪除一個定義了有效路徑的cookie,你須要在調用函數時包含這個路徑:$.cookie('the_cookie', null, { path: '/' });。
domain: 'example.com'默認值:建立cookie的網頁所擁有的域名。 session
secure: true默認值:false。若是爲true,cookie的傳輸須要使用安全協議(HTTPS)。dom
raw: true默認值:false。
默認狀況下,讀取和寫入cookie的時候自動進行編碼和解碼(使用encodeURIComponent編碼,decodeURIComponent解碼)。要關閉這個功能設置raw: true便可。函數