droplet library
The droplet tab bar: a second bar in this package, contributed by Mohammed Hafiz.
Where the default bar (package:liquid_tab_bar/liquid_tab_bar.dart) makes
its selection lens a pane of glass in its own right, this one keeps the
lens a contained pill and refracts the icons and labels behind it
through a dedicated shader, only while it moves. It also carries a
LiquidTabBarScaffold that wires up scroll folding and bottom padding for
you, an expandable search field, separate action buttons and badges.
Import one bar or the other. Their type names overlap by design — both
call their widget LiquidTabBar and their theme LiquidTabBarTheme — so
an app that wants both must prefix at least one:
import 'package:liquid_tab_bar/liquid_tab_bar.dart';
import 'package:liquid_tab_bar/droplet.dart' as droplet;
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
- Canonical surface styling for the tab bar across its material tiers.
- LiquidDropletSurfaceStyle
- Surface styling for the moving selection droplet on the blur and opaque 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. The defaults are the white glass the bar was measured against iOS 26 with; an app usually sets activeColor, inactiveColor and labelStyle and leaves the rest.
- 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.