fluidtabs.
API reference

Tab bar values

The values supplied to your renderTabBar function.

Library source ↗

Type: TabBarRenderProps. View library source.

tabs

Required

TabConfig[]

Tab metadata in page order.

scrollY

Required

SharedValue<number>

Active page's mirrored offset; negative values represent overscroll.

perPageScrollY

Required

SharedValue<number>[]

Tracked offsets for each page. Custom chrome should also account for scrollToTopOffset during re-taps and negative scrollY during a stretched pull.

scrollToTopIndex

Optional

SharedValue<number>

Active during same-tab scroll-to-top so header chrome can follow the UI-thread driven target instead of waiting on native scroll events.

scrollToTopOffset

Optional

SharedValue<number>

Animated offset to read while scrollToTopIndex matches the active page.

tabCount

Required

number

Number of pages.

headerHeight

Required

SharedValue<number>

Collapsible header height, initially estimated and then measured.

activeIndex

Required

SharedValue<number>

Selected target index; changes before a paging animation finishes.

pagerOffset

Required

DerivedValue<number>

Fractional visual page position, clamped to the first and last pages.

pillWidth

Required

SharedValue<number>

Width of one equal-width tab slot, measured by the default tab bar.

pinnedHeaderHeight

Required

number

Pinned header height, excluding topInset.

tabBarHeight

Required

number

Reserved tab bar height. Custom tab bars should fit this height.

topInset

Required

number

Reserved top inset.

pullDownBehavior

Required

PullDownBehavior

Chrome behavior while the list is pulled below its start.

onTabPress

Required

(index: number) => void

Select a page, or scroll the selected page to its top when enabled.