ListEmptyComponent in React Native

Introduction

ListEmptyComponent shows a message or view when a list has no items. It helps users understand the list is empty instead of seeing a blank screen.

When you have a list of items that might sometimes be empty.

When you want to show a friendly message like 'No items found' if the list is empty.

When you want to guide users to add new items if the list is empty.

When you want to improve user experience by avoiding a blank screen.

When you want to display an image or icon explaining the empty state.

Syntax

React Native

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

<FlatList
  data={dataArray}
  renderItem={({ item }) => <Text>{item.name}</Text>}
  ListEmptyComponent={() => (
    <View>
      <Text>No items available</Text>
    </View>
  )}
/>

The ListEmptyComponent prop accepts a React component or a function returning a component.

This component only shows when the data array is empty.

Examples

Simple text message shown when list is empty.

React Native

ListEmptyComponent={() => <Text>No data found</Text>}

Passing a component directly instead of a function.

React Native

ListEmptyComponent={<Text style={{color: 'gray'}}>Nothing here yet!</Text>}

Showing multiple lines with a container view.

React Native

ListEmptyComponent={() => (
  <View style={{alignItems: 'center'}}>
    <Text>No items</Text>
    <Text>Add some to get started.</Text>
  </View>
)}

Sample App

This app shows a list with no items. Because the list is empty, the ListEmptyComponent displays a friendly message in the center.

React Native

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

export default function App() {
  const emptyData = [];

  return (
    <SafeAreaView style={styles.container}>
      <FlatList
        data={emptyData}
        keyExtractor={(item, index) => index.toString()}
        renderItem={({ item }) => <Text style={styles.item}>{item}</Text>}
        ListEmptyComponent={() => (
          <View style={styles.emptyContainer}>
            <Text style={styles.emptyText}>No items to display</Text>
          </View>
        )}
      />
    </SafeAreaView>
  );
}

const styles = StyleSheet.create({
  container: { flex: 1, justifyContent: 'center', alignItems: 'center' },
  item: { fontSize: 18, padding: 10 },
  emptyContainer: { alignItems: 'center' },
  emptyText: { fontSize: 20, color: 'gray' }
});

Important Notes

The ListEmptyComponent only shows if the data array is empty or undefined.

Time complexity is not affected by this component; it just renders conditionally.

Common mistake: forgetting to provide a keyExtractor or unique keys for list items.

Use ListEmptyComponent to improve user experience by clearly showing empty states instead of blank screens.

Summary

ListEmptyComponent shows a message or view when the list has no data.

It helps users understand the list is empty and can guide them on what to do next.

You can pass a component or a function returning a component to ListEmptyComponent.

Practice

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

easy

A. To display a view when the list has no data

B. To style each item in the list

C. To handle item clicks in the list

D. To load more data when scrolling

Solution

1. Step 1: Understand the role of ListEmptyComponent

   This prop is designed to show a special view when the list has no items to display.

2. Step 2: Compare with other props

   Other props like styling or click handling do not relate to empty list views.

3. Final Answer:

   To display a view when the list has no data -> Option A

4. Quick Check:

   Empty list view = ListEmptyComponent [OK]

Hint: Empty list? Use ListEmptyComponent to show a message [OK]

Common Mistakes:

• Confusing ListEmptyComponent with item styling
• Thinking it handles clicks
• Assuming it loads more data

2. Which of the following is the correct way to use ListEmptyComponent in a FlatList?

easy

A. Text('No items')} />

B.

C. No items} />

D.

Solution

1. Step 1: Check the correct syntax for ListEmptyComponent

   It accepts a component or a function returning a component. No items} /> uses a function returning a Text component.

2. Step 2: Identify incorrect usages

   calls Text as a function incorrectly. Text('No items')} /> calls Text incorrectly inside the function. passes a string, which is invalid.

3. Final Answer:

   <FlatList data={[]} ListEmptyComponent={() => <Text>No items</Text>} /> -> Option C

4. Quick Check:

   Function or component = ListEmptyComponent [OK]

Hint: Use a function returning JSX for ListEmptyComponent [OK]

Common Mistakes:

• Passing a string instead of a component
• Calling component as a function incorrectly
• Not using a function when needed

3. Given this code snippet, what will be displayed when the list is empty?

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

export default function MyList() {
  return (
    <FlatList
      data={[]}
      renderItem={({ item }) => <Text>{item}</Text>}
      ListEmptyComponent={() => <Text>No data found</Text>}
    />
  );
}

medium

A. Nothing is displayed

B. No data found

C. An error occurs

D. The list shows empty spaces

Solution

1. Step 1: Check the data prop

   The data array is empty, so no items will render.

2. Step 2: Check ListEmptyComponent behavior

   Since the list is empty, the component returned by ListEmptyComponent will display the text "No data found".

3. Final Answer:

   No data found -> Option B

4. Quick Check:

   Empty list triggers ListEmptyComponent [OK]

Hint: Empty data triggers ListEmptyComponent display [OK]

Common Mistakes:

• Expecting no output when list is empty
• Thinking renderItem runs with empty data
• Assuming an error occurs

4. Identify the error in this FlatList usage:

<FlatList
  data={[]}
  renderItem={({ item }) => <Text>{item}</Text>}
  ListEmptyComponent={Text('No items')}
/>

medium

A. ListEmptyComponent should be a component or function, not a function call

B. renderItem is missing a key prop

C. data cannot be an empty array

D. Text component cannot be used inside FlatList

Solution

1. Step 1: Analyze ListEmptyComponent usage

   It is set to Text('No items'), which calls the Text function incorrectly instead of passing a component or function.

2. Step 2: Check other props

   renderItem is correct for empty data (though keys are recommended but not error here). Empty data is allowed. Text can be used inside FlatList.

3. Final Answer:

   ListEmptyComponent should be a component or function, not a function call -> Option A

4. Quick Check:

   Pass component/function, not call it [OK]

Hint: Pass component/function to ListEmptyComponent, not call it [OK]

Common Mistakes:

• Calling component instead of passing it
• Confusing renderItem keys with ListEmptyComponent errors
• Thinking empty data is invalid

5. You want to show a custom message with a button when your FlatList is empty. Which is the best way to implement ListEmptyComponent to achieve this?

hard

A. Set ListEmptyComponent to null and show message outside the list

B. Pass a string with the message directly to ListEmptyComponent

C. Use renderItem to render the message when data is empty

D. Pass a function returning a view with text and button JSX

Solution

1. Step 1: Understand the requirement

   You want a message plus a button inside the empty list view, so you need a component that returns JSX with both elements.

2. Step 2: Evaluate options

   Pass a function returning a view with text and button JSX correctly uses a function returning a view with text and button. Pass a string with the message directly to ListEmptyComponent is invalid because ListEmptyComponent does not accept strings. Use renderItem to render the message when data is empty misuses renderItem which only renders list items. Set ListEmptyComponent to null and show message outside the list moves the message outside the list, which is less integrated.

3. Final Answer:

   Pass a function returning a view with text and button JSX -> Option D

4. Quick Check:

   Use function returning JSX for custom empty view [OK]

Hint: Use function returning JSX with button for custom empty view [OK]

Common Mistakes:

• Passing string instead of component
• Misusing renderItem for empty state
• Placing message outside FlatList