Angular List Events
This section describes events fired by this widget.
contentReady
Raised when the widget's content is ready.
Event
Information about the event.
| Name | Type | Description |
|---|---|---|
| component |
The widget's instance. |
|
| element |
The widget's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| model |
The model data. Available only when using Knockout. |
Main article: onContentReady.
See Also
disposing
Raised before the widget is disposed of.
Event
Information about the event.
| Name | Type | Description |
|---|---|---|
| component |
The widget instance. |
|
| element |
The widget's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| model |
The model data. Available only if you use Knockout. |
Main article: onDisposing
See Also
groupRendered
Raised when a group element is rendered.
Event
Information about the event.
| Name | Type | Description |
|---|---|---|
| component |
The widget's instance. |
|
| element |
The widget's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| model |
The model data. Available only if Knockout is used. |
|
| groupData |
The current group's data. |
|
| groupElement |
The group's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| groupIndex |
The group's index. |
Main article: onGroupRendered
See Also
initialized
Raised only once, after the widget is initialized.
Event
Information about the event.
| Name | Type | Description |
|---|---|---|
| component |
The widget's instance. |
|
| element |
The widget's container. It is an HTML Element or a jQuery Element when you use jQuery. |
Main article: onInitialized
See Also
itemClick
Raised when a collection item is clicked or tapped.
Event
Information about the event.
| Name | Type | Description |
|---|---|---|
| event | Event (jQuery or EventObject) |
The event that caused the function's execution. It is a dxEvent or a jQuery.Event when you use jQuery. |
| jQueryEvent |
The jQuery event that caused the function's execution. Deprecated in favor of the event field. |
|
| itemIndex | | |
The clicked item's index. In a grouped list, the index represents an object defining group and item indexes: { group: 0, item: 0 }. |
| itemElement |
The clicked item's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| itemData |
The clicked item's data object. |
|
| model |
The model data. Available only if Knockout is used. |
|
| element |
The widget's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| component |
The widget's instance. |
Main article: onItemClick.
See Also
itemContextMenu
Raised when a collection item is right-clicked or pressed.
Event
Information about the event.
| Name | Type | Description |
|---|---|---|
| event | Event (jQuery or EventObject) |
The event that caused the function's execution. It is a dxEvent or a jQuery.Event when you use jQuery. |
| jQueryEvent |
The jQuery event that caused the function's execution. Deprecated in favor of the event field. |
|
| itemIndex | | |
The target item's index. In a grouped list, the index is specified as an object defining group and item indexes: { group: 0, item: 0 }. |
| itemElement |
The target item's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| itemData |
The target item's data object. |
|
| model |
The model data. Available only if Knockout is used. |
|
| element |
The widget's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| component |
The widget's instance. |
Main article: onItemContextMenu
See Also
itemDeleted
Raised after a list item is deleted from the data source.
Event
Information about the event.
| Name | Type | Description |
|---|---|---|
| itemIndex | | |
The removed item's index. In a grouped list, the index represents an object defining the group and item indexes: { group: 0, item: 0 }. |
| itemElement |
The item's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| itemData |
The removed item's data. |
|
| model |
The model data. Available only if Knockout is used. |
|
| element |
The widget's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| component |
The widget's instance. |
Main article: onItemDeleted
See Also
- List - Handle Deletion-Related Events
- Handle Events: jQuery | Angular | AngularJS | Knockout | Vue | React | ASP.NET MVC
itemDeleting
Raised before a collection item is deleted from the data source.
Event
Information about the event.
| Name | Type | Description |
|---|---|---|
| cancel | | |
Allows you to cancel the item deletion. |
| itemIndex | | |
The item's index. In a grouped list, the index represents an object defining group and item indexes: { group: 0, item: 0 }. |
| itemElement |
The item's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| itemData |
The data of the item to be removed. |
|
| model |
The model data. Available only if you use Knockout. |
|
| element |
The widget's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| component |
The widget's instance. |
Main article: onItemDeleting
See Also
itemHold
Raised when a collection item has been held for a specified period.
Event
Information about the event.
| Name | Type | Description |
|---|---|---|
| jQueryEvent |
The jQuery event that caused the function's execution. Deprecated in favor of the event field. |
|
| itemIndex | | |
The index of the item being held. In a grouped list, the index represents an object defining the group and item indexes: { group: 0, item: 0 }. |
| itemElement |
The container of the item being held. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| itemData |
The data object of the item being held. |
|
| model |
The model data. Available only if Knockout is used. |
|
| element |
The widget's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| component |
The widget's instance. |
|
| event | Event (jQuery or EventObject) |
The event that caused the function's execution. It is a dxEvent or a jQuery.Event when you use jQuery. |
Main article: onItemHold
See Also
itemRendered
Raised after a collection item is rendered.
Event
Information about the event.
| Name | Type | Description |
|---|---|---|
| component |
The widget's instance. |
|
| element |
The widget's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| model |
The model data. Available only if you use Knockout. |
|
| itemData |
The current item's data. |
|
| itemElement |
The item's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| itemIndex |
The current item's index. |
Main article: onItemRendered
See Also
itemReordered
Raised after a list item is moved to another position.
Event
Information about the event.
| Name | Type | Description |
|---|---|---|
| toIndex |
The item's current index. In a grouped list, the index represents an object defining the group and item indexes: { group: 0, item: 0 }. |
|
| fromIndex |
The item's previous index. In a grouped list, the index represents an object defining the group and item indexes: { group: 0, item: 0 }. |
|
| itemIndex | | |
The item's index after reordering. This field holds the same value as toIndex. |
| itemElement |
The item's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| itemData |
The reordered item's data. |
|
| model |
The model data. Available only if Knockout is used. |
|
| element |
The widget's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| component |
The widget's instance. |
Main article: onItemReordered
See Also
- List - Handle Reordering-Related Events
- Handle Events: jQuery | Angular | AngularJS | Knockout | Vue | React | ASP.NET MVC
itemSwipe
Raised when a list item is swiped.
Event
Information about the event.
| Name | Type | Description |
|---|---|---|
| component |
The widget's instance. |
|
| element |
The widget's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| model |
The model data. Available only if Knockout is used. |
|
| jQueryEvent |
Use 'event' instead. The jQuery event that caused the handler execution. Deprecated in favor of the event field. |
|
| event | Event (jQuery or EventObject) |
The event that caused the handler execution. It is a dxEvent or a jQuery.Event when you use jQuery. |
| itemData |
The swiped item's data. |
|
| itemElement |
The item's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| itemIndex | | |
The item's index. In a grouped list, the index represents an object defining the group and item indexes: { group: 0, item: 0 }. |
| direction |
The direction in which the item is swiped. |
Main article: onItemSwipe
See Also
- List - Touch-Screen Gestures
- Handle Events: jQuery | Angular | AngularJS | Knockout | Vue | React | ASP.NET MVC
optionChanged
Raised after a widget option is changed.
Event
Information about the event.
| Name | Type | Description |
|---|---|---|
| name |
The modified option if it belongs to the first level. Otherwise, the first-level option it is nested into. |
|
| model |
The model data. Available only if you use Knockout. |
|
| element |
The widget's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| component |
The widget's instance. |
|
| fullName |
The path to the modified option that includes all parent options. |
|
| value | any |
The modified option's new value. |
Main article: onOptionChanged
See Also
pageLoading
Raised before the next page is loaded.
Event
Information about the event.
| Name | Type | Description |
|---|---|---|
| component |
The widget's instance. |
|
| element |
The widget's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| model |
The model data. Available only if Knockout is used. |
Main article: onPageLoading
See Also
pullRefresh
Raised when the "pull to refresh" gesture is performed.
Event
Information about the event.
| Name | Type | Description |
|---|---|---|
| component |
The widget's instance. |
|
| element |
The widget's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| model |
The model data. Available only if Knockout is used. |
Main article: onPullRefresh
See Also
- List - Touch-Screen Gestures
- Handle Events: jQuery | Angular | AngularJS | Knockout | Vue | React | ASP.NET MVC
scroll
Raised on each scroll gesture.
Event
Information about the event.
| Name | Type | Description |
|---|---|---|
| component |
The widget's instance. |
|
| element |
The widget's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| model |
The model data. Available only if Knockout is used. |
|
| jQueryEvent |
Use 'event' instead. The jQuery event that caused the handler execution. Deprecated in favor of the event field. |
|
| event | Event (jQuery or EventObject) |
The event that caused the handler execution. It is a dxEvent or a jQuery.Event when you use jQuery. |
| scrollOffset |
The current scroll offset in the following format { top: topOffset, left: leftOffset }. |
|
| reachedLeft |
Indicates whether the container's left boundary is reached. |
|
| reachedRight |
Indicates whether the container's right boundary is reached. |
|
| reachedTop |
Indicates whether the container's top boundary is reached. |
|
| reachedBottom |
Indicates whether the container's bottom boundary is reached. |
Main article: onScroll
See Also
- List - Handle Scrolling-Related Events
- Handle Events: jQuery | Angular | AngularJS | Knockout | Vue | React | ASP.NET MVC
selectAllValueChanged
Raised when the "Select All" check box value is changed.
Event
Information about the event.
| Name | Type | Description |
|---|---|---|
| component |
The widget's instance. |
|
| element |
The widget's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| model |
The model data. Available only if Knockout is used. |
|
| value |
The "Select All" check box's state. |
Main article: onSelectAllValueChanged
See Also
- List - Handle Selection-Related Events
- Handle Events: jQuery | Angular | AngularJS | Knockout | Vue | React | ASP.NET MVC
selectionChanged
Raised when a collection item is selected or selection is canceled.
Event
Information about the event.
| Name | Type | Description |
|---|---|---|
| component |
The widget's instance. |
|
| element |
The widget's container. It is an HTML Element or a jQuery Element when you use jQuery. |
|
| model |
The model data. Available only if you use Knockout. |
|
| addedItems | Array<any> |
The data of the items that have been selected. |
| removedItems | Array<any> |
The data of the items whose selection has been canceled. |
Main article: onSelectionChanged
See Also
If you have technical questions, please create a support ticket in the DevExpress Support Center.