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

github.com/bvaughn/react-window

Chat with this repo
repository ↗ · DeepWiki ↗ · release 2.5.3 ↗ · + Follow · compare 5 versions
373 symbols 1,005 edges 251 files ⚖ MIT 3 documented · 1% ● updated 4d ago2.5.3 · 2026-11-01★ 17,212

Browse by type

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

react-window logo

react-window is a component library that helps render large lists of data quickly and without the performance problems that often go along with rendering a lot of data. It's used in a lot of places, from React DevTools to the Replay browser.

Support

If you like this project there are several ways to support it:

The following wonderful companies and individuals have sponsored react-window:

Installation

Begin by installing the library from NPM:

npm install react-window

TypeScript types

TypeScript definitions are included within the published dist folder

FAQs

Frequently asked questions can be found here.

Documentation

Documentation for this project is available at react-window.vercel.app.

List

Renders data with many rows.

Required props

Name Description
rowComponent React component responsible for rendering a row. This component will receive an index and style prop by default. Additionally it will receive prop values passed to rowProps. ℹ️ Spread ariaAttributes onto the row element; they identify it as a row (e.g. so that dynamic row heights are measured reliably) ℹ️ The prop types for this component are exported as RowComponentProps
rowCount Number of items to be rendered in the list.
rowHeight Row height; the following formats are supported:
  • number of pixels (number)
  • percentage of the list's current height (string)
  • function that returns the row height (in pixels) given an index and rowProps
  • dynamic row height cache returned by the useDynamicRowHeight hook
ℹ️ Percentage heights can't be resolved during server rendering unless a defaultHeight (or a pixel height via the style prop) is specified. ⚠️ Dynamic row heights are not as efficient as predetermined sizes. It's recommended to provide your own height values if they can be determined ahead of time.
rowProps Additional props to be passed to the row-rendering component. List will automatically re-render rows when values in this object change. ⚠️ This object must not contain ariaAttributes, index, or style props.

Optional props

Name Description
className CSS class name.
style Optional CSS properties. The list of rows will fill the height defined by this style.
children Additional content to be rendered within the list (above rows). This property can be used to render things like overlays or tooltips.
defaultHeight Default height of list (in pixels) for initial render, before its actual height has been measured. ℹ️ Lists can't be measured during server rendering, so this value determines how many rows are server rendered. It's recommended to set this to the expected height of the list (or to specify a pixel height via the style prop).
defaultScrollOffset Initial scroll offset (in pixels) of the list. This value is only applied

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 357
Method 7
Interface 5
Class 4

Languages

TypeScript100%

Modules by API surface

lib/components/list/List.test.tsx14 symbols
lib/utils/test/mockResizeObserver.ts13 symbols
lib/hydration.test.tsx10 symbols
src/routes/components/animated/AnimatedList.tsx9 symbols
lib/utils/scrollElement.ts9 symbols
integrations/vite/src/routes/ScrollElement.tsx8 symbols
lib/components/virtualizer/useVirtualizer.test.tsx7 symbols
integrations/tests/tests/scroll-element.spec.tsx7 symbols
lib/ssr.test.tsx6 symbols
lib/components/grid/Grid.test.tsx6 symbols
src/routes/list/examples/ListWithStickyRows.tsx5 symbols
lib/virtualization.test.tsx5 symbols

Dependencies from manifests, versioned

@csstools/postcss-oklab-function4.0.11 · 1×
@eslint/js9.30.1 · 1×
@headlessui/react2.2.4 · 1×
@headlessui/tailwindcss0.2.2 · 1×
@heroicons/react2.2.0 · 1×
@playwright/test1 · 1×
@tailwindcss/vite4.1.11 · 1×
@tailwindplus/elements1.0.5 · 1×
@testing-library/react16.3.0 · 1×

For agents

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

⬇ download graph artifact

Ask about this repo answers extend the page