Upgrade to ExtJS 3.2.0 - Released 03/30/2010

[extjs.git] / docs / source / NumberField.html
diff --git a/docs/source/NumberField.html b/docs/source/NumberField.html

index 10c49ed..932cd76 100644 (file)
--- a/docs/source/NumberField.html
+++ b/docs/source/NumberField.html
@@ -1,13 +1,14 @@
  <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>
  </head>
  <body  onload="prettyPrint();">
      <pre class="prettyprint lang-js">/*!
- * Ext JS Library 3.0.3
- * Copyright(c) 2006-2009 Ext JS, LLC
+ * Ext JS Library 3.2.0
+ * Copyright(c) 2006-2010 Ext JS, Inc.
   * licensing@extjs.com
   * http://www.extjs.com/license
   */
@@ -85,30 +86,41 @@ Ext.form.NumberField = Ext.extend(Ext.form.TextField,  {
          this.maskRe = new RegExp('[' + Ext.escapeRe(allowed) + ']');
          Ext.form.NumberField.superclass.initEvents.call(this);
      },
-
-    // private
-    validateValue : function(value){
-        if(!Ext.form.NumberField.superclass.validateValue.call(this, value)){
-            return false;
-        }
-        if(value.length < 1){ // if it's blank and textfield didn't flag it then it's valid
-             return true;
+    
+    <div id="method-Ext.form.NumberField-getErrors"></div>/**
+     * Runs all of NumberFields validations and returns an array of any errors. Note that this first
+     * runs TextField's validations, so the returned array is an amalgamation of all field errors.
+     * The additional validations run test that the value is a number, and that it is within the
+     * configured min and max values.
+     * @param {Mixed} value The value to get errors for (defaults to the current field value)
+     * @return {Array} All validation errors for this field
+     */
+    getErrors: function(value) {
+        var errors = Ext.form.NumberField.superclass.getErrors.apply(this, arguments);
+        
+        value = value || this.processValue(this.getRawValue());
+        
+        if (value.length < 1) { // if it's blank and textfield didn't flag it then it's valid
+             return errors;
          }
+        
          value = String(value).replace(this.decimalSeparator, ".");
+        
          if(isNaN(value)){
-            this.markInvalid(String.format(this.nanText, value));
-            return false;
+            errors.push(String.format(this.nanText, value));
          }
+        
          var num = this.parseValue(value);
+        
          if(num < this.minValue){
-            this.markInvalid(String.format(this.minText, this.minValue));
-            return false;
+            errors.push(String.format(this.minText, this.minValue));
          }
+        
          if(num > this.maxValue){
-            this.markInvalid(String.format(this.maxText, this.maxValue));
-            return false;
+            errors.push(String.format(this.maxText, this.maxValue));
          }
-        return true;
+        
+        return errors;
      },
  
      getValue : function(){
@@ -116,10 +128,26 @@ Ext.form.NumberField = Ext.extend(Ext.form.TextField,  {
      },
  
      setValue : function(v){
-       v = typeof v == 'number' ? v : parseFloat(String(v).replace(this.decimalSeparator, "."));
+       v = Ext.isNumber(v) ? v : parseFloat(String(v).replace(this.decimalSeparator, "."));
          v = isNaN(v) ? '' : String(v).replace(".", this.decimalSeparator);
          return Ext.form.NumberField.superclass.setValue.call(this, v);
      },
+    
+    <div id="method-Ext.form.NumberField-setMinValue"></div>/**
+     * Replaces any existing {@link #minValue} with the new value.
+     * @param {Number} value The minimum value
+     */
+    setMinValue : function(value){
+        this.minValue = Ext.num(value, Number.NEGATIVE_INFINITY);
+    },
+    
+    <div id="method-Ext.form.NumberField-setMaxValue"></div>/**
+     * Replaces any existing {@link #maxValue} with the new value.
+     * @param {Number} value The maximum value
+     */
+    setMaxValue : function(value){
+        this.maxValue = Ext.num(value, Number.MAX_VALUE);    
+    },
  
      // private
      parseValue : function(value){
@@ -143,6 +171,6 @@ Ext.form.NumberField = Ext.extend(Ext.form.TextField,  {
          }
      }
  });
-Ext.reg('numberfield', Ext.form.NumberField);</pre>
+Ext.reg('numberfield', Ext.form.NumberField);</pre>    
  </body>
  </html>
 \ No newline at end of file