MCPcopy Create free account
hub / github.com/bvaughn/react-virtualized

github.com/bvaughn/react-virtualized

Chat with this repo
repository ↗ · DeepWiki ↗ · release 10.0.1 ↗ · + Follow · compare 2 versions
783 symbols 2,017 edges 273 files 88 documented · 11% ● updated 5d ago10.0.1 · 2026-11-08★ 27,070

Browse by type

⨍ Functions 751◇ Types & classes 32
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Image

React components for efficiently rendering large lists and tabular data. Check out the documentation for live examples.

If you like this project, 🎉 become a sponsor or ☕ buy me a coffee

Sponsors

The following wonderful companies have sponsored react-virtualized:

Learn more about becoming a sponsor!

A word about react-window

If you're considering adding react-virtualized to a project, take a look at react-window as a possible lighter-weight alternative.

Getting started

Install react-virtualized using npm.

npm install react-virtualized --save

ES module and CommonJS builds are included, along with TypeScript type definitions. For example:

// Most of react-virtualized's styles are functional (eg position, size).
// Functional styles are applied directly to DOM elements.
// The Table component ships with a few presentational styles as well.
// They are optional, but if you want them you will need to also import the CSS file.
// This only needs to be done once; probably during your application's bootstrapping process.
import 'react-virtualized/styles.css';

// You can import any component you want as a named export from 'react-virtualized', eg
import {Column, Table} from 'react-virtualized';

The package is marked as side-effect free (other than its CSS), so bundlers will tree-shake any components you don't use.

TypeScript types are exported for each component's props (e.g. ListProps, GridProps, TableProps) along with the parameters passed to renderers (e.g. RowRendererParams, CellRendererParams, TableCellProps).

Now you're ready to start using the components. You can learn more about which components react-virtualized has to offer below.

Dependencies

React Virtualized has very few dependencies and most are managed by NPM automatically. However the following peer dependencies must be specified by your project in order to avoid version conflicts: react, react-dom. NPM will not automatically install these for you but it will show you a warning message with instructions on how to install them.

Pure Components

By default all react-virtualized components are wrapped in memo to avoid re-rendering unless props or state has changed. This occasionally confuses users when a collection's data changes (eg ['a','b','c'] => ['d','e','f']) but props do not (eg array.length).

The solution to this is to let react-virtualized know that something external has changed. This can be done a couple of different ways.

Pass-thru props

This shallow comparison will detect changes to any props, even ones a component doesn't use. This means you can also pass through additional properties that affect cell rendering to ensure changes are detected. For example, if you're using List to

Extension points exported contracts — how you extend this code

browse all types & interfaces →

Core symbols most depended-on inside this repo

browse all functions →

Shape

Function 615
Method 136
Class 20
Interface 12

Languages

TypeScript100%

Modules by API surface

lib/components/Grid/Grid.tsx35 symbols
lib/components/Grid/Grid.test.tsx33 symbols
lib/components/Table/Table.test.tsx24 symbols
lib/components/Table/Table.tsx19 symbols
lib/components/MultiGrid/MultiGrid.tsx18 symbols
lib/components/Grid/utils/ScalingCellSizeAndPositionManager.ts18 symbols
lib/components/Grid/utils/CellSizeAndPositionManager.ts18 symbols
lib/components/CellMeasurer/types.ts18 symbols
lib/components/InfiniteLoader/InfiniteLoader.test.tsx17 symbols
lib/utils/test/scrollElement.ts16 symbols
lib/components/MultiGrid/MultiGrid.test.tsx16 symbols
lib/components/Masonry/Masonry.tsx16 symbols

Dependencies from manifests, versioned

@csstools/postcss-oklab-function4.0.11 · 1×
@eslint/js9.30.1 · 1×
@playwright/test1 · 1×
@tailwindcss/vite4.1.11 · 1×
@testing-library/react16.3.0 · 1×
@types/bytes3.1.5 · 1×
@types/markdown-it14.1.2 · 1×
@types/node24.2.0 · 1×
@types/react19.2.3 · 1×
@types/react-dom19.2.3 · 1×
@vitejs/plugin-react-swc3.10.2 · 1×

For agents

$ claude mcp add react-virtualized \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page