Skip to content

List adapters

Drop-in FlatList, ScrollView, SectionList, FlashList v2 & LegendList.

Each adapter is a drop-in replacement with the same props as the underlying component. It automatically pads content below the header + tab bar, guarantees short content can still fully collapse the header, restores saved offsets when a lazy tab mounts, sets sensible scrollIndicatorInsets / progressViewOffset, and feeds the header collapse + snap logic.

import { TabFlashList } from 'react-native-collapsible-tab/flash-list';
import { TabLegendList } from 'react-native-collapsible-tab/legend-list';

Sticky section headers

Sticky SectionList headers stick to the real viewport top, which sits under the collapsible header until it collapses. This matches native sticky behavior — design your section headers with that in mind.

Note · Building your own adapter? The contract is small — see useTabContentStyle, useRegisterTabList, useRestoreTabOffset, useTabScrollLifecycle, and the LegendList.tsx source (~100 lines).

Reference

Tabs.ScrollView / FlatList / SectionList component

Same props as the underlying component, minus onScroll (the adapter owns it).

TabFlashList from '.../flash-list'

FlashList v2 (New Architecture only). maintainVisibleContentPosition is disabled by default — it issues corrective scrolls that fight tab-switch sync; pass your own to opt back in.

TabLegendList from '.../legend-list'

LegendList adapter.