Package: | Ext.form |
Defined In: | VTypes.js |
Class: | VTypes |
Extends: | Object |
This is a singleton object which contains a set of commonly used field validation functions.
+The validations provided are basic and intended to be easily customizable and extended.
+
To add custom VTypes specify the vtype
validation
+test function, and optionally specify any corresponding error text to display and any keystroke
+filtering mask to apply. For example:
+
// custom Vtype for vtype:'time'
+var timeTest = /^([1-9]|1[0-9]):([0-5][0-9])(\s[a|p]m)$/i;
+Ext.apply(Ext.form.VTypes, {
+ // vtype validation function
+ time: function(val, field) {
+ return timeTest.test(val);
+ },
+ // vtype Text property: The error text to display when the validation function returns false
+ timeText: 'Not a valid time. Must be in the format "12:34 PM".',
+ // vtype Mask property: The keystroke filter mask
+ timeMask: /[\d\s:amp]/i
+});
+Another example:
+
// custom Vtype for vtype:'IPAddress'
+Ext.apply(Ext.form.VTypes, {
IPAddress: function(v) {
return /^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(v);
},
- IPAddressText: 'Must be a numeric IP address'
-});
This class is a singleton and cannot be created directly.
-
-
-
-
Public Properties
-
-
-
-
-
-
- |
-
-
- alphaMask : RegExp
- The keystroke filter mask to be applied on alpha input
- |
- VTypes |
-
-
- |
-
-
- alphaText : String
- The error text to display when the alpha validation function returns false
- |
- VTypes |
-
-
- |
-
-
- alphanumMask : RegExp
- The keystroke filter mask to be applied on alphanumeric input
- |
- VTypes |
-
-
- |
-
-
- alphanumText : String
- The error text to display when the alphanumeric validation function returns false
- |
- VTypes |
-
-
- |
-
-
- emailMask : RegExp
- The keystroke filter mask to be applied on email input. See the email method for
-information about more complex ema...
-
- The keystroke filter mask to be applied on email input. See the email method for
-information about more complex email validation.
-
- |
- VTypes |
-
-
- |
-
-
- emailText : String
- The error text to display when the email validation function returns false
- |
- VTypes |
-
-
- |
-
-
- urlText : String
- The error text to display when the url validation function returns false
- |
- VTypes |
-
-
-
-
Public Methods
-
-
-
-
-
-
- |
-
-
- alpha( String value ) : void
- The function used to validate alpha values
-
- The function used to validate alpha values
- Parameters:
-
- Returns:
-
-
-
-
- |
- VTypes |
-
-
- |
-
-
- alphanum( String value ) : void
- The function used to validate alphanumeric values
-
- The function used to validate alphanumeric values
- Parameters:
-
- Returns:
-
-
-
-
- |
- VTypes |
-
-
- |
-
-
- email( String value ) : void
- The function used to validate email addresses. Note that this is a very basic validation -- complete
-validation per ...
-
- The function used to validate email addresses. Note that this is a very basic validation -- complete
+ IPAddressText: 'Must be a numeric IP address',
+ IPAddressMask: /[\d\.]/i
+});
This class is a singleton and cannot be created directly. Public Properties|
| alphaMask : RegExp The keystroke filter mask to be applied on alpha input. Defaults to:
+/[a-z_]/i | VTypes | | alphaText : StringThe error text to display when the alpha validation function returns false. Defaults to:
+'This field should only con... The error text to display when the alpha validation function returns false. Defaults to:
+'This field should only contain letters and _' | VTypes | | alphanumMask : RegExp The keystroke filter mask to be applied on alphanumeric input. Defaults to:
+/[a-z0-9_]/i | VTypes | | alphanumText : StringThe error text to display when the alphanumeric validation function returns false. Defaults to:
+'This field should o... The error text to display when the alphanumeric validation function returns false. Defaults to:
+'This field should only contain letters, numbers and _' | VTypes | | emailMask : RegExpThe keystroke filter mask to be applied on email input. See the email method for
+information about more complex ema... The keystroke filter mask to be applied on email input. See the email method for
+information about more complex email validation. Defaults to:
+ /[a-z0-9_\.\-@]/i | VTypes | | emailText : StringThe error text to display when the email validation function returns false. Defaults to:
+'This field should be an e-... The error text to display when the email validation function returns false. Defaults to:
+'This field should be an e-mail address in the format "user@example.com"' | VTypes | | urlText : StringThe error text to display when the url validation function returns false. Defaults to:
+'This field should be a URL i... The error text to display when the url validation function returns false. Defaults to:
+'This field should be a URL in the format "http:/'+'/www.example.com"' | VTypes |
Public Methods|
| alpha( String value )
+ :
+ BooleanThe function used to validate alpha values The function used to validate alpha values | VTypes | | alphanum( String value )
+ :
+ BooleanThe function used to validate alphanumeric values The function used to validate alphanumeric values | VTypes | | email( String value )
+ :
+ BooleanThe function used to validate email addresses. Note that this is a very basic validation -- complete
+validation per ... The function used to validate email addresses. Note that this is a very basic validation -- complete
validation per the email RFC specifications is very complex and beyond the scope of this class, although
this function can be overridden if a more comprehensive validation scheme is desired. See the validation
section of the Wikipedia article on email addresses
-for additional information.
- Parameters:
- value : StringThe email address
- Returns:
-
-
-
-
- |
- VTypes |
-
-
- |
-
-
- url( String value ) : void
- The function used to validate URLs
-
- The function used to validate URLs
- Parameters:
-
- Returns:
-
-
-
-
- |
- VTypes |
-
-
-
- Public Events
- This class has no public events.
-
\ No newline at end of file
+for additional information. This implementation is intended to validate the following emails:
+'barney@example.de', 'barney.rubble@example.com', 'barney-rubble@example.coop', 'barney+rubble@example.com'
+.Parameters:value : StringThe email address Returns: | VTypes |
| url( String value )
+ :
+ BooleanThe function used to validate URLs The function used to validate URLs | VTypes |
Public Events
This class has no public events.
\ No newline at end of file