Upgrade to ExtJS 4.0.7 - Released 10/19/2011
[extjs.git] / docs / source / Cookies.html
index 330c7c6..4371b9c 100644 (file)
+<!DOCTYPE html>
 <html>
 <head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   <title>The source code</title>
-    <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
-    <script type="text/javascript" src="../resources/prettify/prettify.js"></script>
+  <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
+  <script type="text/javascript" src="../resources/prettify/prettify.js"></script>
+  <style type="text/css">
+    .highlight { display: block; background-color: #ddd; }
+  </style>
+  <script type="text/javascript">
+    function highlight() {
+      document.getElementById(location.hash.replace(/#/, "")).className = "highlight";
+    }
+  </script>
 </head>
-<body  onload="prettyPrint();">
-    <pre class="prettyprint lang-js">/*!
- * Ext JS Library 3.0.3
- * Copyright(c) 2006-2009 Ext JS, LLC
- * licensing@extjs.com
- * http://www.extjs.com/license
+<body onload="prettyPrint(); highlight();">
+  <pre class="prettyprint lang-js"><span id='Ext-util-Cookies'>/**
+</span> * @class Ext.util.Cookies
+
+Utility class for setting/reading values from browser cookies.
+Values can be written using the {@link #set} method.
+Values can be read using the {@link #get} method.
+A cookie can be invalidated on the client machine using the {@link #clear} method.
+
+ * @markdown
+ * @singleton
  */
-<div id="cls-Ext.util.Cookies"></div>/**\r
- * @class Ext.util.Cookies\r
- * Utility class for managing and interacting with cookies.\r
- * @singleton\r
- */\r
-Ext.util.Cookies = {\r
-    <div id="method-Ext.util.Cookies-set"></div>/**\r
-     * Create a cookie with the specified name and value. Additional settings\r
-     * for the cookie may be optionally specified (for example: expiration,\r
-     * access restriction, SSL).\r
-     * @param {String} name The name of the cookie to set. \r
-     * @param {Mixed} value The value to set for the cookie.\r
-     * @param {Object} expires (Optional) Specify an expiration date the\r
-     * cookie is to persist until.  Note that the specified Date object will\r
-     * be converted to Greenwich Mean Time (GMT). \r
-     * @param {String} path (Optional) Setting a path on the cookie restricts\r
-     * access to pages that match that path. Defaults to all pages (<tt>'/'</tt>). \r
-     * @param {String} domain (Optional) Setting a domain restricts access to\r
-     * pages on a given domain (typically used to allow cookie access across\r
-     * subdomains). For example, "extjs.com" will create a cookie that can be\r
-     * accessed from any subdomain of extjs.com, including www.extjs.com,\r
-     * support.extjs.com, etc.\r
-     * @param {Boolean} secure (Optional) Specify true to indicate that the cookie\r
-     * should only be accessible via SSL on a page using the HTTPS protocol.\r
-     * Defaults to <tt>false</tt>. Note that this will only work if the page\r
-     * calling this code uses the HTTPS protocol, otherwise the cookie will be\r
-     * created with default options.\r
-     */\r
-    set : function(name, value){\r
-        var argv = arguments;\r
-        var argc = arguments.length;\r
-        var expires = (argc > 2) ? argv[2] : null;\r
-        var path = (argc > 3) ? argv[3] : '/';\r
-        var domain = (argc > 4) ? argv[4] : null;\r
-        var secure = (argc > 5) ? argv[5] : false;\r
-        document.cookie = name + "=" + escape(value) + ((expires === null) ? "" : ("; expires=" + expires.toGMTString())) + ((path === null) ? "" : ("; path=" + path)) + ((domain === null) ? "" : ("; domain=" + domain)) + ((secure === true) ? "; secure" : "");\r
-    },\r
-\r
-    <div id="method-Ext.util.Cookies-get"></div>/**\r
-     * Retrieves cookies that are accessible by the current page. If a cookie\r
-     * does not exist, <code>get()</code> returns <tt>null</tt>.  The following\r
-     * example retrieves the cookie called "valid" and stores the String value\r
-     * in the variable <tt>validStatus</tt>.\r
-     * <pre><code>\r
-     * var validStatus = Ext.util.Cookies.get("valid");\r
-     * </code></pre>\r
-     * @param {String} name The name of the cookie to get\r
-     * @return {Mixed} Returns the cookie value for the specified name;\r
-     * null if the cookie name does not exist.\r
-     */\r
-    get : function(name){\r
-        var arg = name + "=";\r
-        var alen = arg.length;\r
-        var clen = document.cookie.length;\r
-        var i = 0;\r
-        var j = 0;\r
-        while(i < clen){\r
-            j = i + alen;\r
-            if(document.cookie.substring(i, j) == arg){\r
-                return Ext.util.Cookies.getCookieVal(j);\r
-            }\r
-            i = document.cookie.indexOf(" ", i) + 1;\r
-            if(i === 0){\r
-                break;\r
-            }\r
-        }\r
-        return null;\r
-    },\r
-\r
-    <div id="method-Ext.util.Cookies-clear"></div>/**\r
-     * Removes a cookie with the provided name from the browser\r
-     * if found by setting its expiration date to sometime in the past. \r
-     * @param {String} name The name of the cookie to remove\r
-     */\r
-    clear : function(name){\r
-        if(Ext.util.Cookies.get(name)){\r
-            document.cookie = name + "=" + "; expires=Thu, 01-Jan-70 00:00:01 GMT";\r
-        }\r
-    },\r
-    /**\r
-     * @private\r
-     */\r
-    getCookieVal : function(offset){\r
-        var endstr = document.cookie.indexOf(";", offset);\r
-        if(endstr == -1){\r
-            endstr = document.cookie.length;\r
-        }\r
-        return unescape(document.cookie.substring(offset, endstr));\r
-    }\r
-};</pre>
+Ext.define('Ext.util.Cookies', {
+    singleton: true,
+    
+<span id='Ext-util-Cookies-method-set'>    /**
+</span>     * Create a cookie with the specified name and value. Additional settings
+     * for the cookie may be optionally specified (for example: expiration,
+     * access restriction, SSL).
+     * @param {String} name The name of the cookie to set. 
+     * @param {Object} value The value to set for the cookie.
+     * @param {Object} expires (Optional) Specify an expiration date the
+     * cookie is to persist until.  Note that the specified Date object will
+     * be converted to Greenwich Mean Time (GMT). 
+     * @param {String} path (Optional) Setting a path on the cookie restricts
+     * access to pages that match that path. Defaults to all pages (&lt;tt&gt;'/'&lt;/tt&gt;). 
+     * @param {String} domain (Optional) Setting a domain restricts access to
+     * pages on a given domain (typically used to allow cookie access across
+     * subdomains). For example, &quot;sencha.com&quot; will create a cookie that can be
+     * accessed from any subdomain of sencha.com, including www.sencha.com,
+     * support.sencha.com, etc.
+     * @param {Boolean} secure (Optional) Specify true to indicate that the cookie
+     * should only be accessible via SSL on a page using the HTTPS protocol.
+     * Defaults to &lt;tt&gt;false&lt;/tt&gt;. Note that this will only work if the page
+     * calling this code uses the HTTPS protocol, otherwise the cookie will be
+     * created with default options.
+     */
+    set : function(name, value){
+        var argv = arguments,
+            argc = arguments.length,
+            expires = (argc &gt; 2) ? argv[2] : null,
+            path = (argc &gt; 3) ? argv[3] : '/',
+            domain = (argc &gt; 4) ? argv[4] : null,
+            secure = (argc &gt; 5) ? argv[5] : false;
+            
+        document.cookie = name + &quot;=&quot; + escape(value) + ((expires === null) ? &quot;&quot; : (&quot;; expires=&quot; + expires.toGMTString())) + ((path === null) ? &quot;&quot; : (&quot;; path=&quot; + path)) + ((domain === null) ? &quot;&quot; : (&quot;; domain=&quot; + domain)) + ((secure === true) ? &quot;; secure&quot; : &quot;&quot;);
+    },
+
+<span id='Ext-util-Cookies-method-get'>    /**
+</span>     * Retrieves cookies that are accessible by the current page. If a cookie
+     * does not exist, &lt;code&gt;get()&lt;/code&gt; returns &lt;tt&gt;null&lt;/tt&gt;.  The following
+     * example retrieves the cookie called &quot;valid&quot; and stores the String value
+     * in the variable &lt;tt&gt;validStatus&lt;/tt&gt;.
+     * &lt;pre&gt;&lt;code&gt;
+     * var validStatus = Ext.util.Cookies.get(&quot;valid&quot;);
+     * &lt;/code&gt;&lt;/pre&gt;
+     * @param {String} name The name of the cookie to get
+     * @return {Object} Returns the cookie value for the specified name;
+     * null if the cookie name does not exist.
+     */
+    get : function(name){
+        var arg = name + &quot;=&quot;,
+            alen = arg.length,
+            clen = document.cookie.length,
+            i = 0,
+            j = 0;
+            
+        while(i &lt; clen){
+            j = i + alen;
+            if(document.cookie.substring(i, j) == arg){
+                return this.getCookieVal(j);
+            }
+            i = document.cookie.indexOf(&quot; &quot;, i) + 1;
+            if(i === 0){
+                break;
+            }
+        }
+        return null;
+    },
+
+<span id='Ext-util-Cookies-method-clear'>    /**
+</span>     * Removes a cookie with the provided name from the browser
+     * if found by setting its expiration date to sometime in the past. 
+     * @param {String} name The name of the cookie to remove
+     * @param {String} path (optional) The path for the cookie. This must be included if you included a path while setting the cookie.
+     */
+    clear : function(name, path){
+        if(this.get(name)){
+            path = path || '/';
+            document.cookie = name + '=' + '; expires=Thu, 01-Jan-70 00:00:01 GMT; path=' + path;
+        }
+    },
+    
+<span id='Ext-util-Cookies-method-getCookieVal'>    /**
+</span>     * @private
+     */
+    getCookieVal : function(offset){
+        var endstr = document.cookie.indexOf(&quot;;&quot;, offset);
+        if(endstr == -1){
+            endstr = document.cookie.length;
+        }
+        return unescape(document.cookie.substring(offset, endstr));
+    }
+});
+</pre>
 </body>
-</html>
\ No newline at end of file
+</html>