/react-native-atoz-list

(a fixed version of the rgovindji's atoz list) // React Native Listview which handles large data sets and can scroll to sections using an alphabetical scroll list

Primary LanguageJavaScript

This package is an updated and fixed version of the original https://github.com/rgovindji/react-native-atoz-list, allowing you to use it in the 21st century.


This package is just a fork of the work of brentvatne: https://github.com/brentvatne/fixed-height-windowed-list-view-experiment

I fixed some issues with the scrolling not working correctly and exposed the main listview component as AtoZList. The scroll performance is great for large lists which is why I switched to using brentvatne's implementation.

Alt text

##Install

npm i -S react-native-atoz-list

##Usage

import AtoZList from 'react-native-atoz-list';

..
...

let myData = {
    'A': [{..}, {...}, {...}],
    'B': [{..}, {..}, {..}],
    'C': [{..}, {..}, {..}]
}

render(
    return(
        <AtoZList
                sectionHeaderHeight={20}
                cellHeight={60}
                data={myData}
                renderCell={this._renderCellComponent}
                renderSection={this._renderSectionComponent}
        />
    );


);

##Props Note: You need to set the section height and cellHeight

property Description
sectionHeaderHeight The height of each header section
cellHeight The height of each cellheightred
data The data that will be displayed. This should be an object in the format { 'A': [{..}, {..}], 'B': [{..}]}
renderCell This function will render you cell componenet. It will be passed the objects from each element in the data arrays.
renderSection This function will render your section headers. It will be passed an object with key 'sectionId'. The value of 'sectionId' will be the keys from your data object. i.e 'A', 'B', 'C' etc..
onEndReached Called when all rows have been rendered and the list has been scrolled to within onEndReachedThreshold of the bottom. The native scroll event is provided.

Authors

Raheel Govindji rgovindji@gmail.com brentvatne https://github.com/brentvatne