Methods

This section describes members used to manipulate the widget.

element()

Returns the root HTML element of the widget.

Return Value: jQuery

The root element of the widget.

focus()

Sets focus to the editor associated with the current Validator object.

instance()

Returns an instance of this component class.

Return Value: Object

An instance of this component class

Use this method to access other methods of the component.

off(eventName)

Detaches all event handlers from the specified event.

Parameters:
eventName: String

The name of the event to unsubscribe from.

Return Value: Object

The object for which this method is called.

off(eventName, eventHandler)

Detaches a particular event handler from the specified event.

Parameters:
eventName: String

The name of the event to unsubscribe from.

eventHandler: function

The handler to be detached from the specified event.

Return Value: Object

The object for which this method is called.

on(eventName, eventHandler)

Subscribes to a specified event.

Parameters:
eventName: String

The name of the event to be subscribed.

eventHandler: function

An event handler for the specified event.

Return Value: Object

The object for which this method is called.

Use this method to subscribe to one of the events listed in the Events section.

See Also

on(events)

Subscribes to the specified events.

Parameters:
events: Object

An object of the following structure: { "eventName1": handler1, "eventName2": handler2, ...}

Return Value: Object

The object for which this method is called.

Use this method to subscribe to several events at one method call. Available events are listed in the Events section.

See Also

option()

Returns the configuration options of this component.

Return Value: Object

An object representing the configuration options of this component.

option(optionName)

Gets the value of the specified configuration option of this component.

Parameters:
optionName: String

The name of the option to get.

Return Value: any

The value of the specified option.

If you need to get the value of a configuration option field, specify the path to the required field.

option(optionName, optionValue)

Sets a value to the specified configuration option of this component.

Parameters:
optionName: String

The name of the required option.

optionValue: any

The value you wish to assign to the required option.

To set a value to the configuration option field, specify the path to the required field.

option(options)

Sets one or more options of this component.

Parameters:
options: Object

An object containing the required configuration options.

reset()

Resets the value and validation result of the editor associated with the current Validator object.

Use this method to "refresh" the editor controlled by the current Validator object. As a result, the editor's value becomes undefined, without validation errors, as it was before validating the editor.

validate()

Validates the value of the editor that is controlled by the current Validator object against the list of the specified validation rules.

Return Value: Object

An object defining the validation result.

The object returned by the validate() function has the following structure.

  • isValid
    Indicates whether all the rules checked for the validator are satisfied.
  • brokenRule
    The broken rule. The structure of the rule object is described in the validation Rules section.
  • validator
    The current Validator widget.
  • value
    The current editor value.
  • validationRules
    An array of validation rules specified for the current validator. The structure of a rule object is described in the validation Rules section.