X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/6746dc89c47ed01b165cc1152533605f97eb8e8d..f562e4c6e5fac7bcb445985b99acbea4d706e6f0:/docs/source/Boolean.html diff --git a/docs/source/Boolean.html b/docs/source/Boolean.html index b80c1512..7a287031 100644 --- a/docs/source/Boolean.html +++ b/docs/source/Boolean.html @@ -3,8 +3,8 @@ The source code - - + + @@ -15,93 +15,115 @@ -
/**
- * @class Ext.grid.column.Boolean
- * @extends Ext.grid.column.Column
- * <p>A Column definition class which renders boolean data fields.  See the {@link Ext.grid.column.Column#xtype xtype}
- * config option of {@link Ext.grid.column.Column} for more details.</p>
- *
- * {@img Ext.grid.column.Boolean/Ext.grid.column.Boolean.png Ext.grid.column.Boolean grid column}
- *
- * ## Code
- *     Ext.create('Ext.data.Store', {
- *        storeId:'sampleStore',
- *        fields:[
- *            {name: 'framework', type: 'string'},
- *            {name: 'rocks', type: 'boolean'}
- *        ],
- *        data:{'items':[
- *            {"framework":"Ext JS 4", "rocks":true},
- *            {"framework":"Sencha Touch", "rocks":true},
- *            {"framework":"Ext GWT", "rocks":true},            
- *            {"framework":"Other Guys", "rocks":false}            
- *        ]},
- *        proxy: {
- *            type: 'memory',
- *            reader: {
- *                type: 'json',
- *                root: 'items'
- *            }
- *        }
- *     });
- *     
- *     Ext.create('Ext.grid.Panel', {
- *         title: 'Boolean Column Demo',
- *         store: Ext.data.StoreManager.lookup('sampleStore'),
- *         columns: [
- *             {text: 'Framework',  dataIndex: 'framework', flex: 1},
- *             {
- *                 xtype: 'booleancolumn', 
- *                 text: 'Rocks',
- *                 trueText: 'Yes',
- *                 falseText: 'No', 
- *                 dataIndex: 'rocks'}
- *         ],
- *         height: 200,
- *         width: 400,
- *         renderTo: Ext.getBody()
- *     });
+  
/**
+ * @class Boolean
+ *
+ * The `Boolean` object is an object wrapper for a boolean value.
+ *
+ * The value passed as the first parameter is converted to a boolean value, if necessary. If value is
+ * omitted or is 0, -0, null, false, `NaN`, undefined, or the empty string (""), the object has an
+ * initial value of false. All other values, including any object or the string `"false"`, create an
+ * object with an initial value of true.
+ *
+ * Do not confuse the primitive Boolean values true and false with the true and false values of the
+ * Boolean object.
+ *
+ * Any object whose value is not `undefined` or `null`, including a Boolean object whose value is false,
+ * evaluates to true when passed to a conditional statement. For example, the condition in the following
+ * if statement evaluates to true:
+ *
+ *     x = new Boolean(false);
+ *     if (x) {
+ *         // . . . this code is executed
+ *     }
+ *
+ * This behavior does not apply to Boolean primitives. For example, the condition in the following if
+ * statement evaluates to `false`:
+ *     x = false;
+ *     if (x) {
+ *         // . . . this code is not executed
+ *     }
+ *
+ * Do not use a `Boolean` object to convert a non-boolean value to a boolean value. Instead, use Boolean
+ * as a function to perform this task:
+ *
+ *     x = Boolean(expression);     // preferred
+ *     x = new Boolean(expression); // don't use
+ *
+ * If you specify any object, including a Boolean object whose value is false, as the initial value of a
+ * Boolean object, the new Boolean object has a value of true.
+ *
+ *     myFalse = new Boolean(false);   // initial value of false
+ *     g = new Boolean(myFalse);       // initial value of true
+ *     myString = new String("Hello"); // string object
+ *     s = new Boolean(myString);      // initial value of true
+ *
+ * Do not use a Boolean object in place of a Boolean primitive.
+ *
+ * # Creating Boolean objects with an initial value of false
+ *
+ *     bNoParam = new Boolean();
+ *     bZero = new Boolean(0);
+ *     bNull = new Boolean(null);
+ *     bEmptyString = new Boolean("");
+ *     bfalse = new Boolean(false);
+ *
+ * # Creating Boolean objects with an initial value of true
+ *
+ *     btrue = new Boolean(true);
+ *     btrueString = new Boolean("true");
+ *     bfalseString = new Boolean("false");
+ *     bSuLin = new Boolean("Su Lin");
+ *
+ * <div class="notice">
+ * Documentation for this class comes from <a href="https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Boolean">MDN</a>
+ * and is available under <a href="http://creativecommons.org/licenses/by-sa/2.0/">Creative Commons: Attribution-Sharealike license</a>.
+ * </div>
  */
-Ext.define('Ext.grid.column.Boolean', {
-    extend: 'Ext.grid.column.Column',
-    alias: ['widget.booleancolumn'],
-    alternateClassName: 'Ext.grid.BooleanColumn',
-
-    /**
-     * @cfg {String} trueText
-     * The string returned by the renderer when the column value is not falsey (defaults to <tt>'true'</tt>).
-     */
-    trueText: 'true',
 
-    /**
-     * @cfg {String} falseText
-     * The string returned by the renderer when the column value is falsey (but not undefined) (defaults to
-     * <tt>'false'</tt>).
-     */
-    falseText: 'false',
+/**
+ * @method constructor
+ * Creates a new boolean object.
+ * @param {Object} value Either a truthy or falsy value to create the corresponding Boolean object.
+ */
 
-    /**
-     * @cfg {String} undefinedText
-     * The string returned by the renderer when the column value is undefined (defaults to <tt>'&#160;'</tt>).
-     */
-    undefinedText: '&#160;',
+//Methods
 
-    constructor: function(cfg){
-        this.callParent(arguments);
-        var trueText      = this.trueText,
-            falseText     = this.falseText,
-            undefinedText = this.undefinedText;
+/**
+ * @method toString
+ * Returns a string of either "true" or "false" depending upon the value of the object.
+ * Overrides the `Object.prototype.toString` method.
+ *
+ * The Boolean object overrides the `toString` method of the `Object` object; it does not inherit
+ * `Object.toString`. For Boolean objects, the `toString` method returns a string representation of
+ * the object.
+ *
+ * JavaScript calls the `toString` method automatically when a Boolean is to be represented as a text
+ * value or when a Boolean is referred to in a string concatenation.
+ *
+ * For Boolean objects and values, the built-in `toString` method returns the string `"true"` or
+ * `"false"` depending on the value of the boolean object. In the following code, `flag.toString`
+ * returns `"true"`.
+ *
+ *     var flag = new Boolean(true)
+ *     var myVar = flag.toString()
+ *
+ * @return {String} The boolean value represented as a string.
+ */
 
-        this.renderer = function(value){
-            if(value === undefined){
-                return undefinedText;
-            }
-            if(!value || value === 'false'){
-                return falseText;
-            }
-            return trueText;
-        };
-    }
-});
+/** + * @method valueOf + * Returns the primitive value of the `Boolean` object. Overrides the `Object.prototype.valueOf` method. + * + * The `valueOf` method of Boolean returns the primitive value of a Boolean object or literal Boolean + * as a Boolean data type. + * + * This method is usually called internally by JavaScript and not explicitly in code. + * + * x = new Boolean(); + * myVar = x.valueOf() //assigns false to myVar + * + * @return {Boolean} The primitive value. + */