RadListView: Item Selection

RadListView implements a mechanism for selecting or deselecting items. When using the selection mechanism, two selection modes are available:

  • Single selection
  • Multiple selection

RadListView also exposes convenient API for programmatically selecting or deselecting items and acquiring the currently selected items. The following methods are exposed by RadListView to manage selection:

Enabling Selection in RadListView

To enable the selection mechanism for RadListView you need to use the selectionBehavior property and set it to one of the following values:

  • None - items cannot be selected
  • Press - items are selected on simple press/tap
  • LongPress - items are selected by pressing and holding them

Additionally, to enable multiple selection you need to use the multipleSelection property:

Example 1: Enabling multiple selection on RadListView in XML:

<lv:RadListView id="listView" items="{{ dataItems }}" row="1" selectionBehavior="Press" multipleSelection="true">

Handling Selection Events

To notify you when the selection state of an item is changed, RadListView exposes the following events:

  • itemSelecting - fired before an item is selected. Can be used to cancel the operation
  • itemSelected - fired after an item is successfully selected. At this point the item is already in the selected items array returned by the getSelectedItems() method
  • itemDeselecting - fired before an item is deselected. Can be used to cancel the operation
  • itemDeselected - fired after an item has been successfully deselected. At this point the item is not part of the selected items array returned by the getSelectedItems() method.

References

Want to see this scenario in action?
Check our SDK examples repo on GitHub. You will find this and many other practical examples with NativeScript UI.