topCookie.js

Cookie的读取/创建器

Credits

based on the functions by Peter-Paul Koch (http://quirksmode.org)

Summary
Cookie.js Cookie的读取/创建器
Cookie 用于创建,读取,删除Cookie的类
属性
set 在浏览器中设置一个cookie
get 获取一个cookie中的一个值
remove 删除浏览器中的一个cookie

topCookie

用于创建,读取,删除Cookie的类

概要
属性
set 在浏览器中设置一个cookie
get 获取一个cookie中的一个值
remove 删除浏览器中的一个cookie

top属性

topset

在浏览器中设置一个cookie

参数

key cookie的键名
value 键值。其中不能包含分号
options 参见下面的可选项。默认值在Cookie.options中。

可选项

domain cookie属于的域。如果要在不同域上共享一个cookie,你就需要设置这个值。默认为当前域。
path cookie属于的路径。如果要在不同路径上共享一个cookie, 你就需要设置这个值,比如设置“/”来在整个域上面共享一个cookie。默认为当前路径。
duration cookie的生存时间。如果设置为false或0, 则这个cookie将作为一个会话cookie,将会在浏览器关闭后就过期,这也是duration的默认值。
secure 只有在安全的环境下才能访问 cookie

返回值

包含有设置的键值对和可选项的一个对象。使用Cookie.remove的时候它被作为这个方法的第一个参数。

示例

Cookie.set('username', 'Harald'); // session cookie (duration isfalse), or ...
Cookie.set('username', 'JackBauer', {duration: 1}); // save thisfor 1 day

topget

获取一个cookie中的一个值

参数

key 要获取的cookie值的键.

返回值

字符串形式的cookie值。如果没有找到该cookie值,则返回false。

示例

Cookie.get("username") //返回如: JackBauer

topremove

删除浏览器中的一个cookie

参数

cookie 要删除的cookie的名字,或者是前一个cookie(针对域之间)
options 参见 Cookie.set的可选项

示例

Cookie.remove('username') ; 
  
var myCookie = Cookie.set('username', 'Aaron', {domain: 'mootools.net'}); 
// Cookie.set 返回的对象中含有所有可用来删除这个cookie的信息
Cookie.remove(myCookie);

Documentation by Aaron Newton & Mootools Developers, generated by NaturalDocs and tidy, and GeSHi

文档中文翻译:zarknight 勘误Email:zarknight@gmail.com asp之家