liquid_tab_bar library
An iOS 26-style floating liquid-glass tab bar.
Three material tiers (refraction shader, backdrop blur, opaque), a selection lens that slides on a spring, stretches with its speed and disperses light like a soap bubble while a finger drags it, and a bar that folds into a pill as the page scrolls. See LiquidTabBar.
Classes
- DropletRefractionStyle
- Optical refraction configuration for the moving selection droplet lens.
- GlassStyle
- One outer-bar glass material — every knob the bar shader exposes, in logical pixels.
- LiquidBadgeStyle
- Visual styling configuration for badges in LiquidTabBar and LiquidTabItem.
- LiquidBarStyle
- LiquidDropletShadow
- The shadow controls supported by the moving selection droplet renderer.
- LiquidDropletSurfaceStyle
- Surface styling for the moving selection droplet across material tiers.
- LiquidGlass
- The glass shader — loaded once at startup, gated at runtime.
- LiquidGovernorConfig
- Configuration for LiquidTabBarController's performance frame governor.
- LiquidScrollPadding
-
A zero-friction wrapper widget that automatically reserves bottom space for
a LiquidTabBar when used with
extendBody: true. - LiquidScrollPaddingScope
- Inherited marker registered by LiquidScrollPadding and SliverLiquidScrollPadding to inform the debug safety net that bottom scroll padding is being handled.
- LiquidTabAction
- A standalone action button displayed alongside the LiquidTabBar (such as a search, filter, or create button), styled with the exact same liquid glass / surface material as the bar.
- LiquidTabActionStyle
- Visual styling for a separate action's selected marker.
- LiquidTabBar
- The floating tab bar — built to iOS 26's own numbers and manners, so an app's bar and the system apps beside it behave as one.
- LiquidTabBarController
- The bar's shared state: whether it is folded, and which material tier it renders. Give one to every LiquidTabBar that should move together, and feed it the pages' scroll notifications through handleScroll.
- LiquidTabBarScaffold
- A convenience Scaffold preconfigured for LiquidTabBar.
- LiquidTabBarSearch
- Configuration for the interactive search field transition in LiquidTabBar.
- LiquidTabBarTheme
- Every colour and number a LiquidTabBar draws with. Unspecified palette fields follow the ambient brightness when the bar builds; explicitly supplied fields keep their values.
- LiquidTabItem
- One tab of a LiquidTabBar.
- SliverLiquidScrollPadding
-
A sliver that reserves bottom space for a LiquidTabBar when used inside
a CustomScrollView with
Scaffold(extendBody: true).
Enums
- LiquidFoldedShape
- The geometric shape of the tab bar capsule when folded or minimized on scroll.
- LiquidTabActionPlacement
- Placement of a separate action button relative to the main tab bar.
- LiquidTabBarMaterial
- How the bar's surface is drawn. auto picks the richest tier the device can carry; the others pin one.
Typedefs
- LiquidTabIconBuilder = Widget Function(Color color, bool selected)
-
Builds a tab's glyph in
color;selectedis true for the active tab, so a filled variant can stand in for the outline.