TableSelectionMulti

<ui5-table-selection-multi> | Since 2.8.0

The ui5-table-selection-multi component is used inside the ui5-table to add multi-selection capabilities to the ui5-table. Since selection is key-based, each ui5-table-row must define a unique row-key property.

Usage

The ui5-table-selection-multi component is a feature designed exclusively for use within the ui5-table component. It must be placed inside the features slot of ui5-table. This component is not intended for standalone use.

<ui5-table>
	<ui5-table-selection-multi slot="features" selected="Row1 Row3"></ui5-table-selection-multi>
</ui5-table>

ES6 Module Import

import "@ui5/webcomponents/dist/TableSelectionMulti.js";

Properties

behavior

Description	Defines the selection behavior.
Type	"RowOnly" | "RowSelector" (value descriptions in: TableSelectionBehavior)
Default	"RowSelector"
Since	2.11.0

headerSelector

Description	Defines the selector of the header row.
Type	"ClearAll" | "SelectAll" (value descriptions in: TableSelectionMultiHeaderSelector)
Default	"SelectAll"
Since	2.12.0

selected

Description	Defines the row-key values of selected rows, with each value separated by a space.
Type	string | undefined
Default	undefined

Slots

No slots available for this component.

Events

change

Description	Fired when the selection is changed by user interaction.
Type	CustomEvent
Bubbles	Yes
Cancelable	No

Methods

getRowByKey

Description	Returns the table row instance for the given row key.
Return type	TableRow | undefined
Parameters	rowKey: string The row key

getSelectedAsSet

Description	Returns the selected property as a set of unique row-key values.
Return type	Set<string>

getSelectedRows

Description	Returns an array of the selected rows.
Return type	Array<TableRow>

setSelectedAsSet

Description	Sets the selected property using the provided set of unique row-key values.
Return type	void
Parameters	selectedSet: Set<string> A set of row-key values

CSS Parts

No CSS parts available for this component.

CSS Custom States

No CSS custom states available for this component.