Movatterモバイル変換

React components for efficiently rendering large lists and tabular data.Check outthe demo for some examples.

The following wonderful companies have sponsored react-virtualized:

Learn more about becoming a sponsor!

If you're considering addingreact-virtualized to a project, take a look atreact-window as a possible lighter-weight alternative.Learn more about how the two libraries compare here.

Installreact-virtualized using npm.

npm install react-virtualized --save

ES6, CommonJS, and UMD builds are available with each distribution.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', egimport{Column,Table}from'react-virtualized';// But if you only use a few react-virtualized components,// And you're concerned about increasing your application's bundle size,// You can directly import only the components you need, like so:importAutoSizerfrom'react-virtualized/dist/commonjs/AutoSizer';importListfrom'react-virtualized/dist/commonjs/List';

Note webpack 4 makes this optimization itself, see thedocumentation.

If the above syntax looks too cumbersome, or you import react-virtualized components from a lot of places, you can also configure a Webpack alias. For example:

// Partial webpack.config.js{alias:{'react-virtualized/List':'react-virtualized/dist/es/List',},  ...rest}

Then you can just import like so:

importListfrom'react-virtualized/List';// Now you can use <List {...props} />

You can also use a global-friendly UMD build:

<linkrel="stylesheet"href="path-to-react-virtualized/styles.css"/><scriptsrc="path-to-react-virtualized/dist/umd/react-virtualized.js"></script>

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

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.

By default all react-virtualized components useshallowCompare 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 (egarray.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.

TheshallowCompare method will detect changes to any props, even if they aren't declared aspropTypes.This means you can also pass through additional properties that affect cell rendering to ensure changes are detected.For example, if you're usingList to render a list of items that may be re-sorted after initial render- react-virtualized would not normally detect the sort operation because none of the properties it deals with change.However you can pass through the additional sort property to trigger a re-render.For example:

<List{...listProps}sortBy={sortBy}/>

Grid andCollection components can be forcefully re-rendered usingforceUpdate.ForTable andList, you'll need to callforceUpdateGrid to ensure that the innerGrid is also updated. ForMultiGrid, you'll need to callforceUpdateGrids to ensure that the innerGrids are updated.

API documentation availablehere.

There are also a couple of how-to guides:

• Customizing classes and styles
• Displaying items in reverse order
• Using AutoSizer
• Creating an infinite-loading list
• Natural sort Table
• Sorting a Table by multiple columns

Examples for each component can be seen inthe documentation.

Here are some online demos of each component:

• ArrowKeyStepper
• AutoSizer
• CellMeasurer
• Collection
• ColumnSizer
• Grid
• InfiniteLoader
• List
• Masonry
• MultiGrid
• ScrollSync
• Table
• WindowScroller

And here are some "recipe" type demos:

• Table with resizable (drag and drop) columns
• Collapsable tree view
• Full-page grid (spreadsheet)
• Dynamic cell measuring
• Cell hover effects

react-virtualized aims to support all evergreen browsers and recent mobile browsers for iOS and Android. IE 9+ is also supported (although IE 9 will require some user-defined, custom CSS since flexbox layout is not supported).

If you find a browser-specific problem, please report it along with a repro case. The easiest way to do this is probably by forkingthis Plunker.

Here are some great components built on top of react-virtualized:

• react-infinite-calendar: Infinite scrolling date-picker with localization, themes, keyboard support, and more
• react-sortable-hoc: Higher-order components to turn any list into an animated, touch-friendly, sortable list
• react-sortable-tree: Drag-and-drop sortable representation of hierarchical data
• react-virtualized-checkbox: Checkbox group component with virtualization for large number of options
• react-virtualized-select: Drop-down menu for React with windowing to support large numbers of options.
• react-virtualized-tree: A reactive tree component that aims to render large sets of tree structured data in an elegant and performant way
• react-timeline-9000: A calendar timeline component that is capable of displaying and interacting with a large number of items

UseGitHub issues for requests.

I actively welcome pull requests; learn how tocontribute.

Changes are tracked in thechangelog.

react-virtualized is available under the MIT License.