react-component/virtual-list

๐Ÿ“œ Virtual scrolling list component for React.

TypeScript

812

393 commits

updated Oct 12, 2026

See the code

README

@rc-component/virtual-list

Ant Design Part of the Ant Design ecosystem.

๐Ÿ“œ Virtual scrolling list component for React.

NPM version npm downloads build status Codecov bundle size dumi

English | ็ฎ€ไฝ“ไธญๆ–‡

Highlights

  • Built for React and maintained by the rc-component team.
  • Used by Ant Design and other React component libraries.
  • Ships TypeScript declarations with both ES module and CommonJS outputs.
  • Keeps examples, tests, and preview builds aligned with the package source.

Install

npm install @rc-component/virtual-list

Usage

import List from '@rc-component/virtual-list';

const data = Array.from({ length: 1000 }).map((_, index) => ({
  id: index,
  label: `Item ${index}`,
}));

export default () => (
  <List data={data} height={240} itemHeight={32} itemKey="id">
    {(item) => <div>{item.label}</div>}
  </List>
);

Examples

Run the local dumi site:

npm install
npm start

Then open http://localhost:8000.

API

List

PropDescriptionTypeDefault
childrenRender function for each item. The third argument contains measuring props used by legacy browser compatibility paths.(item, index, props) => ReactElement-
componentCustom list container element.string | ComponentTypediv
dataItems rendered by the virtual list.T[]-
fullHeightWhether the holder should keep full height.booleantrue
heightVisible list height.number-
itemHeightMinimum item height used to calculate the virtual range.number-
itemKeyKey field or key getter for items.string | (item) => React.Key-
onScrollCalled when the list scrolls.React.UIEventHandler<HTMLElement>-
stylesCustom scrollbar part styles.object-
virtualEnable virtual rendering.booleantrue

Development

npm install
npm start
npm test
npm run build

The dumi site runs at http://localhost:8000 by default.

Release

npm run prepublishOnly

The release flow is handled by @rc-component/np through the rc-np command after the package build.

License

@rc-component/virtual-list is released under the MIT license.

antd
ant-design
javascript
react
react-component

react-component/virtual-list

๐Ÿ“œ Virtual scrolling list component for React.

TypeScript

812

393 commits

updated Oct 12, 2026

See the code

README

@rc-component/virtual-list

Ant Design Part of the Ant Design ecosystem.

๐Ÿ“œ Virtual scrolling list component for React.

NPM version npm downloads build status Codecov bundle size dumi

English | ็ฎ€ไฝ“ไธญๆ–‡

Highlights

  • Built for React and maintained by the rc-component team.
  • Used by Ant Design and other React component libraries.
  • Ships TypeScript declarations with both ES module and CommonJS outputs.
  • Keeps examples, tests, and preview builds aligned with the package source.

Install

npm install @rc-component/virtual-list

Usage

import List from '@rc-component/virtual-list';

const data = Array.from({ length: 1000 }).map((_, index) => ({
  id: index,
  label: `Item ${index}`,
}));

export default () => (
  <List data={data} height={240} itemHeight={32} itemKey="id">
    {(item) => <div>{item.label}</div>}
  </List>
);

Examples

Run the local dumi site:

npm install
npm start

Then open http://localhost:8000.

API

List

PropDescriptionTypeDefault
childrenRender function for each item. The third argument contains measuring props used by legacy browser compatibility paths.(item, index, props) => ReactElement-
componentCustom list container element.string | ComponentTypediv
dataItems rendered by the virtual list.T[]-
fullHeightWhether the holder should keep full height.booleantrue
heightVisible list height.number-
itemHeightMinimum item height used to calculate the virtual range.number-
itemKeyKey field or key getter for items.string | (item) => React.Key-
onScrollCalled when the list scrolls.React.UIEventHandler<HTMLElement>-
stylesCustom scrollbar part styles.object-
virtualEnable virtual rendering.booleantrue

Development

npm install
npm start
npm test
npm run build

The dumi site runs at http://localhost:8000 by default.

Release

npm run prepublishOnly

The release flow is handled by @rc-component/np through the rc-np command after the package build.

License

@rc-component/virtual-list is released under the MIT license.

antd
ant-design
javascript
react
react-component

Project health

Overall

5.6/10

Maintained

8/10

Code review

3/10
OpenSSF Scorecard

Latest release

1.5.2 ยท Sep 18, 2026

Releases this year

7

Significant stargazers

็™ฝ้›พไธ‰่ฏญ

823 followers ยท starred Nov 2024

inokawa

477 followers ยท starred Dec 2025