Info

VirtualList

pro


NameValueDefaultRequiredResponsiveDescription

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.