Skip to main content
Version: 1.x

HeaderMotion.FlatList

A pre-wired Animated.FlatList that participates in Header Motion's scroll tracking and header offsetting.

Works identically to a standard FlatList with the same additional Header Motion props as HeaderMotion.ScrollView.

Usage

<HeaderMotion.FlatList
data={items}
renderItem={({ item }) => <ItemComponent item={item} />}
keyExtractor={(item) => item.id}
/>

Props

Accepts all Animated.FlatList props, plus the same Header Motion-specific props:

PropTypeDefaultDescription
scrollIdstringUnique identifier for multi-scroll setups.
headerOffsetStrategy'padding' | 'margin' | 'top' | 'translate' | 'none''padding'Controls how content is pushed below the header.
ensureScrollableContentMinHeightbooleanfalseExperimental. Adds minimum content height for short lists.
animatedRefAnimatedRefYour own animated ref for programmatic control.