Creating cards list in react native the right way

Image source:Pixabay

As an application developer we often need to display information in card views for mobile apps related to news,media and social apps.In one my recent projects I had to display around 300-400 cards on a certain topic in vertical scrollable list.Rendering them all at once would have terribly slowed down my application.So I created a listview to render 10 cards at a time,with a spinner until next ones are loaded.Here is a demo of what I created in the end:

I am using react-native-navigation-module from wix for handling navigation needs.You can find tutorial on setting it up here or download example app directly from here.

The steps are as follows:

Create a new component/class in your reactnative application.In my case I have created TopicsList Class:

I have used setTimeout in componentDidMount to simply add a delay which might happen until data is loaded  from remote api in real use case scenarios.

I am using a simple  activity indicator in ProgressBar component to display loading spinner until app is loaded:

Now we are going to use cards from nativebase module and SGListview module to render list which is a is a memory minded implementation of the React Native’s ListView.Install them by running the following command:

Now I have passed a json array as prop using redux to this component which contains cards related data as follows:

We will first create a SGListView in the render method and initialize datasource as the above props in constructor as follows:

In the constructor method we have initialized the data source with our json array prop and initialized SGListview in render with following parameters:

  •  dataSource: This is the input data that listview needs to render items
  • renderRow: This parameter is responsible for rendering each item in list.We will define our cardview in renderCards method next
  • pageSize:This parameter defines no of items to render per event loop.Simply speaking this parameter is useful to display 10 items at a time from several items and then progressively load next 10 items when we reach at the end of first page
  • stickyheaderIndices: This parameter can be used if you want any of the items in list to stick at the top when scrolling. It is a mandatory parameter in SGListView so keep it blank if you don’t need it
  • onEndReachedThreshold: Specifies no of pixels for calling onEndReached
  • initialListSize: No of items to be displayed in initial render
  • renderFooter:We can specify some views to be displayed at the end of the list. We have used this method to show spinner at the end of the each page in list in renderLoader
  • scrollRenderAheadDistance: Specifies how early to start rendering rows before they come on screen, in pixels.
  • onEndReached: We can specify some tasks to be done when end of list is hit.We have used this to hide loader/footer once all items are loaded.

Let us start with renderCards function.We need to import some components from native base as follows:

By default the renderCard function recieves each list item as input parameter from listview renderRow function.We have created simple card view with title,image container and related text.Now I found a few days back that the default Image component does not have offline/loading placeholder capability in android so I created custom progressiveimage component for the purpose.You can find the tutorial to set it up here.

Next let us cover renderLoader and hideLoader function which shows spinner at the end of page and remove it once data is loaded respectively.Now you have the option to either use spinner from nativebase or progressbar component we created earlier:

The spinner is shown on the basis of showLoader flag which is set to true initially and reset to false in hideLoader. In ideal cases we will reset it after getting data from some api and I have used setTimeOut to simply simulate delay in getting data.

Note:I have used setTimeout in some places just to keep the tutorial simple but it should be avoided as far as possible when developing production level applications.

Connect Deeper: In the next tutorial I plan to cover click event of card items along with marking favorite functionality(heart icon click) in cards so follow our facebook page to get notified about the article in future here: Technoetics

Share post-
About Saurabh Mhatre 70 Articles
Currently working in web and hybrid application development
  • dotnethubs

    where to find working source code?

    • smhatre59

      I am planning to opensource the application code once it is complete. I have not opensourced the source code since it is still a work in progress.

      • kraken holic

        its been 10months plus now
        still not done completing the card list code yet ?