0Pricing
React Native Academy · Lección

Optimización del rendimiento de FlatList

Aplique getItemLayout para filas de altura fija, establezca initialNumToRender y windowSize, use keyExtractor correctamente y evite referencias a funciones anónimas en renderItem.

Optimización del rendimiento de FlatList es una lección gratuita de React Native Academy en CoddyKit. Esta es la lección 3 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de React Native Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de React Native Academy incluye 4 lecciones en total.

Partes de esta lección aún no han sido traducidas y se muestran en inglés.

Why FlatList Performance Matters

FlatList is the workhorse of React Native UIs — almost every app has at least one list. A poorly configured FlatList causes dropped frames during scroll, blank cells appearing as items load, and excessive memory use that can crash the app on older devices.

FlatList is a virtualized list, meaning it only renders items currently visible on screen plus a small buffer. The challenge is configuring that buffer and the rendering pipeline so scroll feels instantaneous and does not block the JS thread.

The keyExtractor Prop

The keyExtractor prop tells FlatList how to uniquely identify each item. React uses keys for efficient reconciliation — when the list data changes, React matches new items to existing rendered components using the key, then only updates items that actually changed.

Always use a stable, unique identifier like a database ID as the key. Never use the array index — if items are added, removed, or reordered, index-based keys cause React to re-render or mis-match components.

// ❌ Index-based keys — breaks on reorder/insert
<FlatList
  data={posts}
  keyExtractor={(item, index) => String(index)}
  renderItem={renderPost}
/>

// ✅ Stable ID-based keys
<FlatList
  data={posts}
  keyExtractor={(item) => item.id}
  renderItem={renderPost}
/>

getItemLayout for Fixed-Height Rows

By default, FlatList measures the height of each rendered item to build a scroll position map. This measurement happens on the JS thread and adds overhead. If all your rows have the same fixed height, you can skip measurement entirely with getItemLayout.

Provide a function that returns the height, offset, and index for each item. The offset is height * index. This allows FlatList to calculate scroll positions instantly and also enables scrollToIndex to work correctly.

const ITEM_HEIGHT = 72;

<FlatList
  data={contacts}
  keyExtractor={(item) => item.id}
  getItemLayout={(data, index) => ({
    length: ITEM_HEIGHT,
    offset: ITEM_HEIGHT * index,
    index,
  })}
  renderItem={({ item }) => <ContactRow contact={item} />}
/>

initialNumToRender and windowSize

initialNumToRender controls how many items are rendered on the first mount. Set it to the number of items visible on the screen without scrolling — rendering more wastes the initial render time. The default is 10, which is often too high or too low depending on your row height.

windowSize controls the size of the render window as a multiple of the visible viewport. A windowSize of 5 means FlatList renders 2.5 viewport-heights above and below the visible area. Lower values reduce memory; higher values reduce blank cell flashes when scrolling fast.

<FlatList
  data={posts}
  keyExtractor={(item) => item.id}
  renderItem={renderItem}
  initialNumToRender={8}     // Render 8 items on first paint
  windowSize={5}             // Render 2.5x viewport above/below
  maxToRenderPerBatch={5}    // Render up to 5 new items per JS frame
  updateCellsBatchingPeriod={50} // Check for updates every 50ms
/>

Avoiding Anonymous renderItem Functions

Defining renderItem as an inline arrow function inside JSX creates a new function reference on every parent render. This defeats the reconciliation optimization in FlatList and also defeats any React.memo you applied to the row component.

Define renderItem as a named function outside the component body (for pure renderers) or with useCallback inside the component when it needs to close over state or callbacks. The same applies to ItemSeparatorComponent and ListEmptyComponent.

// ❌ New reference on every render
return (
  <FlatList
    data={posts}
    renderItem={({ item }) => <PostRow post={item} onPress={handlePress} />}
  />
);

// ✅ Stable reference with useCallback
const renderItem = useCallback(
  ({ item }) => <PostRow post={item} onPress={handlePress} />,
  [handlePress]
);

return <FlatList data={posts} renderItem={renderItem} />;

removeClippedSubviews for Large Lists

Setting removeClippedSubviews={true} tells the native layer to detach views that are far outside the viewport from the native view hierarchy, freeing GPU memory. This is particularly effective on Android where keeping hundreds of off-screen views attached can degrade scroll performance.

Enable this option when your list has more than 50-100 items. There is a minor caveat on iOS: removed views may flash on very fast scrolling. If you see this issue, lower your windowSize instead.

<FlatList
  data={items}
  keyExtractor={(item) => item.id}
  renderItem={renderItem}
  removeClippedSubviews={true} // Detach off-screen views from native layer
  windowSize={5}
/>

Avoiding State in renderItem

Each call to renderItem should be a pure function of the item data and any stable callbacks. Avoid reading component state or context values inside renderItem unless they are stable references — every state change will re-render the entire list.

If each row needs dynamic data (like whether the current user has liked a post), include that data in the item object itself or pass it as a prop from a stable selector. This keeps FlatList's reconciliation efficient.

// ❌ Reading volatile state inside renderItem
const renderItem = ({ item }) => (
  <PostRow post={item} isLiked={likedPostIds.includes(item.id)} />
);
// If likedPostIds is in state, all rows re-render on every like

// ✅ Merge liked status into the data array before passing to FlatList
const enrichedPosts = useMemo(
  () => posts.map((p) => ({ ...p, isLiked: likedPostIds.has(p.id) })),
  [posts, likedPostIds]
);

<FlatList data={enrichedPosts} renderItem={({ item }) => (
  <PostRow post={item} />
)} />

Pull-to-Refresh Performance

The onRefresh and refreshing props add a pull-to-refresh control. Set refreshing to true while your data fetch is in progress, and back to false when it completes. This shows the native RefreshControl spinner.

For performance, avoid setState calls that cause unnecessary FlatList updates during the refresh. Only update the data when the fetch is complete so FlatList does a single reconciliation pass, not multiple intermediate ones.

const [refreshing, setRefreshing] = useState(false);

async function handleRefresh() {
  setRefreshing(true);
  try {
    const fresh = await fetchPosts();
    setPosts(fresh); // Single state update
  } finally {
    setRefreshing(false);
  }
}

<FlatList
  data={posts}
  renderItem={renderItem}
  refreshing={refreshing}
  onRefresh={handleRefresh}
/>

Measuring List Performance with InteractionManager

InteractionManager defers expensive work until after pending animations and interactions complete. This is useful for loading initial screen content: animate the screen transition first, then fetch and render heavy list data after the animation finishes.

Wrap expensive initial data loads in InteractionManager.runAfterInteractions to keep screen transitions at 60fps. Without this, a heavy first fetch can block the JS thread during the transition, causing a janky slide-in animation.

import { InteractionManager } from 'react-native';

useEffect(() => {
  // Defer data load until screen transition completes
  const task = InteractionManager.runAfterInteractions(async () => {
    const data = await fetchLargeDataset();
    setPosts(data);
  });

  return () => task.cancel();
}, []);

FlashList: A Faster Alternative

FlashList by Shopify is a drop-in replacement for FlatList that is significantly faster for large lists. It recycles native cell components (similar to RecyclerView on Android) instead of creating new ones, which reduces memory allocation and garbage collection pressure.

Replace FlatList with FlashList and provide the estimatedItemSize prop instead of getItemLayout. Most other FlatList props are compatible. FlashList is the recommended choice for lists with more than 100 items.

import { FlashList } from '@shopify/flash-list';

// Install: npx expo install @shopify/flash-list

<FlashList
  data={posts}
  keyExtractor={(item) => item.id}
  estimatedItemSize={72}   // Average row height in pixels
  renderItem={renderItem}
  onEndReached={loadMore}
  onEndReachedThreshold={0.5}
/>

Profiling FlatList with the JS Thread Monitor

After tuning your FlatList, verify the improvement with the Performance Monitor (developer menu). While scrolling, watch the JS FPS counter. If it stays near 60fps, your list is rendering efficiently. A sustained drop below 50fps indicates the JS thread is overloaded during scroll.

The most common remaining bottleneck after applying the above optimizations is image loading. Large remote images decode on the main thread. Use FastImage (react-native-fast-image) to add caching and progressive loading, which prevents image decode from blocking scroll frames.

Quick Check

Test your understanding of React Native Mobile Development concepts from this lesson.

Lesson Recap

In this lesson you learned: how getItemLayout eliminates runtime height measurements for fixed-height rows, how initialNumToRender and windowSize control how many items are rendered around the viewport, and why stable renderItem references are critical for FlatList reconciliation efficiency. Next up we analyze the JavaScript bundle size and apply lazy loading to reduce app startup time.

Preguntas frecuentes

¿La lección «Optimización del rendimiento de FlatList» es gratis?

Sí — el texto completo de «Optimización del rendimiento de FlatList» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de React Native Academy, actualiza a CoddyKit PRO. El curso de React Native Academy incluye 4 lecciones en total.

¿Qué aprenderé en «Optimización del rendimiento de FlatList»?

Aplique getItemLayout para filas de altura fija, establezca initialNumToRender y windowSize, use keyExtractor correctamente y evite referencias a funciones anónimas en renderItem. Practicas React Native Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar React Native Academy?

No se requiere experiencia previa. React Native Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 3 de 4.

¿Cuánto tiempo toma la lección «Optimización del rendimiento de FlatList»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de React Native Academy?

Sí. Cada lección de React Native Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

  1. Perfilado con Flipper y React DevTools
  2. Memoización con React.memo, useCallback y useMemo
  3. Optimización del rendimiento de FlatList
  4. Tamaño del bundle y carga diferida
← Volver a React Native Academy