Components

Overview

A virtualised, infinitely loading collection for mailboxes, file browsers, record queues, and other high-volume selectable data. It follows familiar desktop selection conventions without coupling the primitive to email.

Selection behaviour

• With no selection indicator, click selects one row.
• In checkbox or radio display mode, clicking anywhere on a row toggles it without clearing the other selected rows.
• Ctrl/Cmd+click always adds a row to the existing selection; repeating it never removes an already selected row.
• Shift+click selects the range from the selection anchor.
• Drag across rows selects a contiguous range; hold Ctrl/Cmd to add that range.
• Arrow keys move and select, Shift+Arrow extends, Ctrl/Cmd+Arrow moves focus only, Ctrl/Cmd+Space always adds the focused row, and Ctrl/Cmd+A selects every loaded row.
• Enter and double-click call onItemActivate.

Selection controls

Set selectionIndicator to "none", "checkbox", or "radio". Checkbox and radio are visual treatments for multiple selection; both retain the full desktop multi-selection model. The complete row is the toggle target, so releasing slightly beside the glyph cannot clear earlier selections. The indicator is rendered by the component, so row renderers do not need to recreate ticks or choice controls. onSelectionChange returns every selected ID and every corresponding loaded item.

Data and loading

The host owns items and appends the next page in onLoadMore. By default the scrollbar represents the rows loaded so far. Pass totalItemCount only when the server knows the total and the scrollbar should represent the complete result set. Selection callbacks return both stable IDs and the corresponding loaded items.

Accessibility

Uses a labelled multi-select listbox, option rows, aria-selected, aria-activedescendant, roving visual focus, keyboard selection, and a polite loading status. Disabled IDs are exposed with aria-disabled and excluded from ranges and select-all.

Props