Skip to Content

List

A list displays a collection of items and allows a user to select one or more of them.

Separators

Sections

Single select

Multiple select

Preselected

Component props

List

NameTypeDescription
itemsany[]Array of items to render
selectionModeSelectionMode"none" | "single" | "multiple"
selectedKeysstring[]Controlled selected keys
defaultSelectedKeysstring[]Default selected keys
onSelectionChange(keys: Selection) => voidCalled when selection changes

ListItem

NameTypeDescription
idstringUnique item identifier
textValuestringText value for accessibility
isDisabledbooleanDisables the item