SelectionManager

An interface for reading and updating multiple selection state.

installyarn add @react-stately/selection
version3.9.4
usageimport {SelectionManager} from '@react-stately/selection'

Introduction#


A SelectionManager provides a generic interface for reading and updating selection and focus state based on a Collection. As discussed in the selection introduction, a selection is represented by a Set of item keys. Focus is represented by a single item key.

Focus state is updated when navigating a collection with the keyboard. Selection state is updated when a user clicks or taps an item, or uses the keyboard to select an item. These interactions are handled by the useSelectableCollection hook in react-aria.

A SelectionManager wraps the state returned by useMultipleSelectionState. Oftentimes, you won't need to construct these directly because hooks like useListState and useTreeState already handle this and return a SelectionManager for you.

Interface#


Properties

NameTypeDescription
selectionModeSelectionModeThe type of selection that is allowed in the collection.
disallowEmptySelectionbooleanWhether the collection allows empty selection.
selectionBehaviorSelectionBehaviorThe selection behavior for the collection.
isFocusedbooleanWhether the collection is currently focused.
focusedKeyKeyThe current focused key in the collection.
childFocusStrategyFocusStrategyWhether the first or last child of the focused key should receive focus.
selectedKeysSet<Key>The currently selected keys in the collection.
rawSelectionSelection

The raw selection value for the collection. Either 'all' for select all, or a set of keys.

isEmptybooleanWhether the selection is empty.
isSelectAllbooleanWhether all items in the collection are selected.
firstSelectedKeyKeynull
lastSelectedKeyKeynull

Methods

MethodDescription
constructor( collection: Collection<Node<unknown>>, state: MultipleSelectionState, options?: SelectionManagerOptions ): void
setSelectionBehavior( (selectionBehavior: SelectionBehavior )): voidSets the selection behavior for the collection.
setFocused( (isFocused: boolean )): voidSets whether the collection is focused.
setFocusedKey( (key: Key, , childFocusStrategy?: FocusStrategy )): voidSets the focused key.
isSelected( (key: Key )): voidReturns whether a key is selected.
extendSelection( (toKey: Key )): voidExtends the selection to the given key.
toggleSelection( (key: Key )): voidToggles whether the given key is selected.
replaceSelection( (key: Key )): voidReplaces the selection with only the given key.
setSelectedKeys( (keys: Iterable<Key> )): voidReplaces the selection with the given keys.
selectAll(): voidSelects all items in the collection.
clearSelection(): voidRemoves all keys from the selection.
toggleSelectAll(): voidToggles between select all and an empty selection.
select( (key: Key, , e?: PressEventLongPressEventPointerEvent )): void
isSelectionEqual( (selection: Set<Key> )): voidReturns whether the current selection is equal to the given selection.
canSelectItem( (key: Key )): void