| Name | Value | Default | Required | Responsive | Description |
|---|---|---|---|---|---|
color | - | - | Color applied to the surface behind list items. | ||
ensureVisibleIndex | number | - | - | - | Index of the item that should be kept fully visible within the list viewport. When provided, the list scrolls only if needed to ensure this item remains in view. |
intent | - | - | Color tone applied to the surface behind list items. | ||
itemHeight | number | - | - | Height of a single list item in pixels. | |
items | Array<T> | - | - | Data array used to generate virtualized items. | |
overscan | number | - | - | - | Number of extra items rendered outside the visible range. If not provided the list renders one full visible range before and after. |
renderItem | - | - | Render function called for each visible list item. | ||
scrollAlign | start, center, end | start | - | - | Defines how the item targeted by the "scrollToIndex" prop is positioned within the scroll area. |
scrollToIndex | number | 0 | - | - | Scrolls the list to the item at the given index on render. |
tagAttrs | HTML tag attributes | - | - | - | Additional HTML attributes applied to the root tag. |
tagRef | RefObject | - | - | - | Reference to the root HTML tag. |
visibleItemsCount | number | - | - | Specifies the number of list items visible before scrolling is enabled. |