ListEmptyComponent in React Native - UI Render Trace

Component - ListEmptyComponent

The ListEmptyComponent in React Native is a special component that shows a message or UI when a list has no items to display. It helps users understand that the list is empty instead of showing a blank screen.

Widget Tree

FlatList
├── ListEmptyComponent
│   └── View
│       └── Text
└── ListItem (not rendered when empty)

The main component is a FlatList that tries to show list items. When the list is empty, it renders the ListEmptyComponent instead. This component contains a View with a Text message telling the user the list is empty.

Render Trace - 2 Steps

Step 1: FlatList

Step 2: ListEmptyComponent (EmptyMessage)

State Change - Re-render

Trigger:Adding items to the list data

Before

data=[] (empty list), ListEmptyComponent visible

→

After

data=[item1, item2], ListEmptyComponent hidden, list items rendered

Re-renders:FlatList and its children re-render to show list items instead of the empty message

UI Quiz - 3 Questions

What does the ListEmptyComponent show when the list has no items?

A A loading spinner

B The first item in the list

C A message telling the list is empty

D Nothing, the screen is blank

Key Insight

Using ListEmptyComponent improves user experience by clearly communicating when a list has no data. It prevents confusion from a blank screen and guides users to understand the app state.

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