ValidateBox

Override defaults with $.fn.validatebox.defaults.

The validatebox is designed to validate the form input fields. If users enter invalid values, it will change the background color, display the alarm icon and a tooltip message. The validatebox can be integrated with form plugin and will prevent invalid fields from submission.

Dependencies

  • tooltip

Usage

Create validatebox from markup.

Create validatebox using javascript.

To check password and retype password are same.


Validate Rule

The validate rule is defined by using required and validType property, here are the rules already implemented:

  • email: Match email regex rule.
  • url: Match URL regex rule.
  • length[0,100]: Between x and x characters allowed.
  • remote['http://.../action.do','paramName']: Send ajax request to do validate value, return 'true' when successfully.

To custom validate rule, override $.fn.validatebox.defaults.rules that defines a validator function and invalid message. For example, to define a minLength valid type:

Now you can use the minLength validtype to define an input box that should be inputed at least 5 characters:


Properties

Name Type Description Default
required boolean Defines if the field should be inputed. false
validType string,array Defines the field valid type, such as email, url, etc. Possible values are:
1) a valid type string, apply a single validate rule.
2) an valid type array, apply multiple validate rules. The multiple validate rules on a field are available since version 1.3.2.

Code example:

<input class="easyui-validatebox" data-options="required:true,validType:'url'">
<input class="easyui-validatebox" data-options="
	required:true,
	validType:['email','length[0,20]']
">
null
delay number Delay to validate from the last inputting value. This property is available since version 1.3.2. 200
missingMessage string Tooltip text that appears when the text box is empty. This field is required.
invalidMessage string Tooltip text that appears when the content of text box is invalid. null
tipPosition string Defines the position of tip message when the content of text box is invalid. Possible values: 'left','right'. This property is available since version 1.3.2. right
deltaX number Tooltip offset in the X direction. This property is available since version 1.3.3. 0

Methods

Name Parameter Description
destroy none Remove and destroy the component.
validate none Do the validation to determine whether the content of text box is valid.
isValid none Call validate method and return the validation result, true or false.