FlatList basics (data, renderItem, keyExtractor) in React Native

Introduction

FlatList helps show a list of items on the screen in a smooth and fast way. It makes scrolling easy and efficient.

When you want to show a list of messages in a chat app.

When you want to display a list of contacts or friends.

When you want to show a list of products in a shopping app.

When you want to show a list of tasks or reminders.

When you want to display any long list that can scroll.

Syntax

React Native

import { FlatList, Text, View } from 'react-native';

<FlatList
  data={arrayOfItems}
  renderItem={({ item }) => <Text>{item.name}</Text>}
  keyExtractor={item => item.id}
/>

data is the list of items you want to show.

renderItem tells how to show each item.

keyExtractor gives a unique key for each item to help React Native manage the list efficiently.

Examples

Shows a simple list of fruits with unique ids.

React Native

const fruits = [{ id: '1', name: 'Apple' }, { id: '2', name: 'Banana' }];

<FlatList
  data={fruits}
  renderItem={({ item }) => <Text>{item.name}</Text>}
  keyExtractor={item => item.id}
/>

Shows what happens if the list is empty: nothing is shown.

React Native

const emptyList = [];

<FlatList
  data={emptyList}
  renderItem={({ item }) => <Text>{item.name}</Text>}
  keyExtractor={item => item.id}
/>

Shows a list with only one item.

React Native

const singleItem = [{ id: '100', name: 'Only One' }];

<FlatList
  data={singleItem}
  renderItem={({ item }) => <Text>{item.name}</Text>}
  keyExtractor={item => item.id}
/>

Sample App

This app shows a list of animal names using FlatList. Each animal has a unique id used as the key. The list is scrollable if needed.

React Native

import React from 'react';
import { FlatList, Text, View, SafeAreaView } from 'react-native';

export default function App() {
  const animals = [
    { id: 'a1', name: 'Dog' },
    { id: 'a2', name: 'Cat' },
    { id: 'a3', name: 'Elephant' }
  ];

  return (
    <SafeAreaView style={{ flex: 1, marginTop: 50 }}>
      <FlatList
        data={animals}
        renderItem={({ item }) => <Text style={{ fontSize: 24, padding: 10 }}>{item.name}</Text>}
        keyExtractor={item => item.id}
      />
    </SafeAreaView>
  );
}

Important Notes

FlatList only renders items visible on the screen for better performance.

Always provide a unique keyExtractor to avoid warnings and improve list updates.

Common mistake: forgetting keyExtractor or using non-unique keys causes rendering issues.

Summary

FlatList shows lists efficiently by rendering only visible items.

Use data to give the list items, renderItem to show each item, and keyExtractor to give unique keys.

This helps your app run smoothly and look good when showing lists.

Practice

1. What is the main purpose of the keyExtractor prop in a React Native FlatList?

easy

A. To handle user taps on list items.

B. To define how each item should be displayed on the screen.

C. To specify the data source for the list.

D. To provide a unique key for each list item to help React identify items.

Solution

1. Step 1: Understand the role of keyExtractor

   The keyExtractor is used to give each item a unique key, which helps React track which items changed, added, or removed.

2. Step 2: Differentiate from other props

   renderItem defines how to show items, data is the list source, and tap handling is done separately.

3. Final Answer:

   To provide a unique key for each list item to help React identify items. -> Option D

4. Quick Check:

   keyExtractor = unique keys [OK]

Hint: Keys uniquely identify items in lists [OK]

Common Mistakes:

• Confusing keyExtractor with renderItem
• Using index as key without keyExtractor
• Thinking keyExtractor handles item display

2. Which of the following is the correct syntax to define a FlatList with data and renderItem props?

easy

A. {item}} />

B. {item}} />

C. {item}} />

D. {data}} />

Solution

1. Step 1: Check prop names

   The correct props are data for the list and renderItem for rendering each item.

2. Step 2: Check renderItem function parameter

   renderItem receives an object with item property, so it should be ({item}) => ....

3. Final Answer:

   <FlatList data={items} renderItem={({item}) => <Text>{item}</Text>} /> -> Option A

4. Quick Check:

   Correct props and destructuring = C [OK]

Hint: Use data and renderItem with ({item}) parameter [OK]

Common Mistakes:

• Using wrong prop names like 'items' or 'render'
• Not destructuring item in renderItem
• Passing item directly without braces

3. Given this code snippet, what will be displayed on the screen?

const data = [{id: '1', name: 'Apple'}, {id: '2', name: 'Banana'}];

<FlatList
  data={data}
  keyExtractor={item => item.id}
  renderItem={({item}) => <Text>{item.name}</Text>}
/>

medium

A. A blank screen because keyExtractor is missing.

B. A list showing 'Apple' and 'Banana' as text items.

C. An error because renderItem is not a function.

D. A list showing '1' and '2' as text items.

Solution

1. Step 1: Analyze data and keyExtractor

   Data has two objects with ids and names. keyExtractor returns item.id, which is correct.

2. Step 2: Analyze renderItem output

   renderItem shows item.name, so it will display 'Apple' and 'Banana'.

3. Final Answer:

   A list showing 'Apple' and 'Banana' as text items. -> Option B

4. Quick Check:

   renderItem shows item.name = Apple, Banana [OK]

Hint: renderItem shows item.name, so names appear [OK]

Common Mistakes:

• Thinking keyExtractor missing causes blank screen
• Confusing item.id with item.name in renderItem
• Assuming renderItem is missing or wrong

4. What is wrong with this FlatList usage?

const data = [{id: 'a'}, {id: 'b'}];

<FlatList
  data={data}
  renderItem={({item}) => <Text>{item.id}</Text>}
/>

medium

A. FlatList requires a style prop to render.

B. renderItem should not use destructuring for item.

C. Missing keyExtractor prop, which may cause warnings or errors.

D. data should be an array of strings, not objects.

Solution

1. Step 1: Check for keyExtractor

   The code does not provide a keyExtractor, so React Native will warn because keys are needed for list items.

2. Step 2: Validate other props

   renderItem correctly destructures item, data can be objects, and style is optional.

3. Final Answer:

   Missing keyExtractor prop, which may cause warnings or errors. -> Option C

4. Quick Check:

   keyExtractor missing = warning [OK]

Hint: Always add keyExtractor for unique keys [OK]

Common Mistakes:

• Ignoring missing keyExtractor warnings
• Thinking renderItem destructuring is wrong
• Believing style prop is mandatory

5. You want to display a list of users with unique IDs, but your data array has duplicate IDs. How should you modify the keyExtractor to avoid key conflicts in FlatList?

const users = [
  {id: '1', name: 'Alice'},
  {id: '1', name: 'Bob'},
  {id: '2', name: 'Charlie'}
];

<FlatList
  data={users}
  keyExtractor={item => item.id}
  renderItem={({item}) => <Text>{item.name}</Text>}
/>

hard

A. Change keyExtractor to combine id and index: (item, index) => item.id + index

B. Remove keyExtractor and use default keys.

C. Use only index as keyExtractor: (item, index) => index.toString()

D. Keep keyExtractor as item.id because duplicates don't matter.

Solution

1. Step 1: Identify duplicate keys problem

   Using only item.id causes duplicate keys for '1', which React warns against.

2. Step 2: Fix keyExtractor to ensure uniqueness

   Combining item.id with index creates unique keys like '11', '12', '20'.

3. Final Answer:

   Change keyExtractor to combine id and index: (item, index) => item.id + index -> Option A

4. Quick Check:

   Unique keys prevent warnings = Change keyExtractor to combine id and index: (item, index) => item.id + index [OK]

Hint: Combine id and index for unique keys [OK]

Common Mistakes:

• Ignoring duplicate keys causing warnings
• Using only index loses stable keys
• Removing keyExtractor causes errors