This is a high performance list view for React Native with support for complex layouts using a similar FlatList usage to make easy the replacement. This list implementation for big list rendering on React Native works with a recycler focused on performance and memory usage and so it permits processing thousands items on the list.
Try it on the published demo web app (sticky headers at the moment doesn't work on web version): https://marcocesarato.github.io/react-native-big-list/
React Native's FlatList is great but when it comes to big lists it has some flaws because of its item caching.
Exists some alternatives like react-native-largelist
and recyclerlistview
but both have some issues.
The react-native-largelist
isn't compatible with web and Expo, has native code that sometimes need to be readjusted and maintained, have a weird list item recycles (because it never has blank items), need data restructure and have some issues when trying to process a lot of data (eg: 100,000 items) because it would freeze the CPU.
The recyclerlistview
is performant but suffers from an empty frame on mount, weird scroll positions when trying to scroll to an element on mount, and the implementation of sticky headers conflicts with Animated
.
Recycler makes it easy to efficiently display large sets of data. You supply the data and define how each item looks, and the recycler library dynamically creates the elements when they're needed. As the name implies, the recycler recycles those individual elements. When an item scrolls off the screen, the recycler doesn't destroy its view. Instead, the recycler reuses the view for new items that have scrolled onscreen. This reuse vastly improves performance, improving your app's responsiveness and reducing power consumption.
When list can't render your items fast enough the non-rendered components will appear as blank space.
This library is fully JS native, so it's compatible with all available platforms: Android, iOS, Windows, MacOS, Web (sticky headers not available on web yet) and Expo.
Install the library from npm or yarn just running one of the following command lines:
npm | yarn |
---|---|
npm install react-native-big-list --save |
yarn add react-native-big-list |
Read also How to migrate from FlatList
Simple usage:
import BigList from "react-native-big-list";
// ...
const MyExample = ({ data }) => {
const renderItem = ({ item, index }) => <MyListItem item={item} />;
return <BigList data={data} renderItem={renderItem} itemHeight={50} />;
};
Usage with empty item, header and footer:
import BigList from "react-native-big-list";
/* ... */
const data = [
{ label: "1", value: 1 /* ... */ },
{ label: "2", value: 2 /* ... */ },
{ label: "3", value: 3 /* ... */ },
{ label: "4", value: 4 /* ... */ },
{ label: "5", value: 5 /* ... */ },
/* ... */
];
const renderItem = ({ item, index }) => (
<MyListItem label={item.label} value={item.value} />
);
const renderEmpty = () => <MyEmpty />;
const renderHeader = () => <MyHeader />;
const renderFooter = () => <MyFooter />;
return (
<BigList
data={data}
renderItem={renderItem}
renderEmpty={renderEmpty}
renderHeader={renderHeader}
renderFooter={renderFooter}
itemHeight={50}
headerHeight={90}
footerHeight={100}
/>
);
This list will auto stick the section rendered on the top of the list
PS: Sticky headers at the moment doesn't work on web version
import BigList from "react-native-big-list";
/* ... */
const sections = [
[
// Section 0
{ label: "1", value: 1 /* ... */ },
{ label: "2", value: 2 /* ... */ },
],
[
// Section 1
{ label: "3", value: 3 /* ... */ },
{ label: "4", value: 4 /* ... */ },
],
[
// Section 2
{ label: "6", value: 6 /* ... */ },
{ label: "6", value: 6 /* ... */ },
],
/* ... */
];
const renderItem = ({ item, index }) => (
<MyListItem label={item.label} value={item.value} />
);
const renderHeader = () => <MyHeader />;
const renderFooter = () => <MyFooter />;
const renderSectionHeader = () => <MySectionHeader />;
const renderSectionFooter = () => <MySectionFooter />;
return (
<BigList
sections={sections}
renderItem={renderItem}
renderHeader={renderHeader}
renderFooter={renderFooter}
renderSectionHeader={renderSectionHeader}
renderSectionFooter={renderSectionFooter}
itemHeight={50}
headerHeight={90}
footerHeight={100}
sectionHeaderHeight={90}
sectionFooterHeight={100}
/>
);
For more examples check the example
directory the list
directory
BigList vs FlatList | Section List |
---|---|
![]() |
![]() |
Clone or download repo and after:
cd Example
yarn install # or npm install
expo start
Open Expo Client on your device. Use it to scan the QR code printed by expo start
. You may have to wait a minute while your project bundles and loads for the first time.
The list has the same props of the ScrollView in addition to its specific Props and Methods.
Have an idea? Found a bug? Please raise to ISSUES. Contributions are welcome and are greatly appreciated! Every little bit helps, and credit will always be given.