Events

This section describes events exposed by this widget.

change

Fires when a change within the widget's input element is committed by an end user.

Event Handler Argument:
e:

Object

Provides function parameters.

Object structure:
component:

Object

Provides access to the widget instance.

element:

jQuery

An HTML element of the widget.

model:

Object

Provides access to the data that is available for binding against the element. Available only in the Knockout and AngularJS approaches.

jQueryEvent:

jQuery.Event

Specifies the jQuery event that caused action execution.

copy

Fires after the widget's input has been copied.

Event Handler Argument:
e:

Object

Provides function parameters.

Object structure:
component:

Object

Provides access to the widget instance.

element:

jQuery

An HTML element of the widget.

model:

Object

Provides access to the data that is available for binding against the element. Available only in the Knockout and AngularJS approaches.

jQueryEvent:

jQuery.Event

Specifies the jQuery event that caused action execution.

cut

Fires after the Cut DOM event has fired.

Event Handler Argument:
e:

Object

Provides function parameters.

Object structure:
component:

Object

Provides access to the widget instance.

element:

jQuery

An HTML element of the widget.

model:

Object

Provides access to the data that is available for binding against the element. Available only in the Knockout and AngularJS approaches.

jQueryEvent:

jQuery.Event

Specifies the jQuery event that caused action execution.

disposing

Fires when the widget is being removed.

Event Handler Argument:
e:

Object

Provides function parameters.

Object structure:
component:

Object

Provides access to the widget instance.

element:

jQuery

An HTML element of the widget.

model:

Object

Provides access to the data that is available for binding against the element. Available only in the Knockout and AngularJS approaches.

See Also
NOTE
This event fires only if the widget is removed using the remove(), empty(), or html() jQuery methods.

enterKey

Fires after a key has been entered within the widget's input element.

Event Handler Argument:
e:

Object

Provides function parameters.

Object structure:
component:

Object

Provides access to the widget instance.

element:

jQuery

An HTML element of the widget.

model:

Object

Provides access to the data that is available for binding against the element. Available only in the Knockout and AngularJS approaches.

jQueryEvent:

jQuery.Event

Specifies the jQuery event that caused action execution.

focusIn

Fires after the widget's input has been focused.

Event Handler Argument:
e:

Object

Provides function parameters.

Object structure:
component:

Object

Provides access to the widget instance.

element:

jQuery

An HTML element of the widget.

model:

Object

Provides access to the data that is available for binding against the element. Available only in the Knockout and AngularJS approaches.

jQueryEvent:

jQuery.Event

Specifies the jQuery event that caused action execution.

Use the on() method of the widget instance to attach a handler for the focusIn event.

See Also

To unsubscribe from this event, use the off() method of the widget instance.

Note that you can handle the focusIn event within the widget's configuration object by assigning your handler to the onFocusIn option.

focusOut

Fires after the widget's input element has lost focus.

Event Handler Argument:
e:

Object

Provides function parameters.

Object structure:
component:

Object

Provides access to the widget instance.

element:

jQuery

An HTML element of the widget.

model:

Object

Provides access to the data that is available for binding against the element. Available only in the Knockout and AngularJS approaches.

jQueryEvent:

jQuery.Event

Specifies the jQuery event that caused action execution.

initialized

Fires when the widget is initialized.

Event Handler Argument:
e:

Object

Provides function parameters.

Object structure:
component:

Object

Provides access to the widget instance.

element:

jQuery

An HTML element of the widget.

input

Fires when a value within the widget's input element is changed by an end user.

Event Handler Argument:
e:

Object

Provides function parameters.

Object structure:
component:

Object

Provides access to the widget instance.

element:

jQuery

An HTML element of the widget.

model:

Object

Provides access to the data that is available for binding against the element. Available only in the Knockout and AngularJS approaches.

jQueryEvent:

jQuery.Event

Specifies the jQuery event that caused the action execution.

keyDown

Fires when a key is pressed down within the widget's input element.

Event Handler Argument:
e:

Object

Provides function parameters.

Object structure:
component:

Object

Provides access to the widget instance.

element:

jQuery

An HTML element of the widget.

model:

Object

Provides access to the data that is available for binding against the element. Available only in the Knockout and AngularJS approaches.

jQueryEvent:

jQuery.Event

Specifies the jQuery event that caused the action execution.

keyPress

Fires when the keypress DOM event has been raised for the current input element.

Event Handler Argument:
e:

Object

Provides function parameters.

Object structure:
component:

Object

Provides access to the widget instance.

element:

jQuery

An HTML element of the widget.

model:

Object

Provides access to the data that is available for binding against the element. Available only in the Knockout and AngularJS approaches.

jQueryEvent:

jQuery.Event

Specifies the jQuery event that caused the action execution.

keyUp

Fires when a key is released within the widget's input element.

Event Handler Argument:
e:

Object

Provides function parameters.

Object structure:
component:

Object

Provides access to the widget instance.

element:

jQuery

An HTML element of the widget.

model:

Object

Provides access to the data that is available for binding against the element. Available only in the Knockout and AngularJS approaches.

jQueryEvent:

jQuery.Event

Specifies the jQuery event that caused the action execution.

optionChanged

Fires after an option of the component is changed.

Event Handler Argument:
e:

Object

Provides function parameters.

Object structure:
component:

Object

Provides access to the widget instance.

name:

String

Specifies the name of the option whose value is changed.

fullName:

String

Specifies a full name of the option whose value is changed. The full name is formed by concatenating the names of the options that are presented in the hierarchy of the given option. The names are delimited by commas.

value: any

Specifies a new value for the option.

element:

jQuery

An HTML element of the widget.

model:

Object

Provides access to the data that is available for binding against the element. Available only in the Knockout and AngularJS approaches.

paste

Fires after the widget's input has been pasted.

Event Handler Argument:
e:

Object

Provides function parameters.

Object structure:
component:

Object

Provides access to the widget instance.

element:

jQuery

An HTML element of the widget.

model:

Object

Provides access to the data that is available for binding against the element. Available only in the Knockout and AngularJS approaches.

jQueryEvent:

jQuery.Event

Specifies the jQuery event that caused the action execution.

valueChanged

Fires when the editor value changes.

Event Handler Argument:
e:

Object

Provides function parameters.

Object structure:
component:

Object

Provides access to the widget instance.

element:

jQuery

An HTML element of the widget.

model:

Object

Provides access to the data that is available for binding against the element. Available only in the Knockout and AngularJS approaches.

value:

Object

Returns the widget's new value.

previousValue:

Object

Returns the widget's previous value.

jQueryEvent:

jQuery.Event

Specifies the jQuery event that caused the action execution.