Events

This section describes events exposed by this widget.

cancelClick

Fires when the Cancel button is clicked.

Event Handler Argument:
e:

Object

Provides function parameters.

Object structure:
component:

Object

Provides access to the widget instance.

element:

jQuery

Indicates whether or not to cancel hiding the action sheet menu when clicking the Cancel button.

model:

Object

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

cancel:

Boolean

Indicates whether or not to cancel hiding the action sheet when the Cancel button is clicked.

In the handling function, use the cancel field of the object passed as a handler parameter. Set this field to true to prohibit the hiding of the action sheet menu when an end user clicks the Cancel button on it.

See Also
Show Example:
jQuery

contentReady

Fires when widget content is ready.

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.

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.

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.

itemClick

Fires when a widget item is clicked.

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.

itemData:

Object

The data that is bound to the clicked item.

itemElement:

jQuery

An HTML element of the item.

itemIndex:

Number

Specifies the index of the clicked item.

jQueryEvent:

jQuery.Event

Specifies the jQuery event that caused action execution.

Show Example:
jQuery

itemContextMenu

Fires when the the right mouse button is clicked when the pointer is over a widget item, or when the "sustained" (also known as a long press) touch action is performed.

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.

itemData:

Object

The data that is bound to the item.

itemElement:

jQuery

An HTML element of the item.

itemIndex:

Number

Specifies the index of the item.

jQueryEvent:

jQuery.Event

Specifies the jQuery event that caused action execution.

itemHold

Fires when the widget's collection item is being held for the time period specified by the itemHoldTimeout option.

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.

itemData:

Object

The data that is bound to the item being held.

itemElement:

jQuery

An HTML element of the item.

itemIndex:

Number

Specifies the index of the item being held.

itemRendered

Fires after a collection item is rendered.

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.

itemData:

Object

The data that is bound to the item to be rendered.

itemElement:

jQuery

An HTML element of the item.

itemIndex:

Number

Specifies the index of the rendered item.

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.