BaseBottomToolbar class

BaseBottomToolbar - Cross-platform bottom toolbar with expandable search

Provides native iOS bottom toolbar with expandable search with fallback to Material Design bottom app bar on other platforms. The iOS version provides a native toolbar experience with smooth animations and Apple HIG compliance.

Features:

  • Native iOS bottom toolbar with expandable search
  • Material Design fallback with similar functionality
  • Consistent API across platforms
  • Apple HIG compliant search behavior
  • Context-aware icon display during search
  • Smooth animations for search expansion

Apple HIG implementation:

  • Search in a bottom toolbar pattern
  • Expandable search that shows current context
  • Proper visual hierarchy and spacing
  • Platform-appropriate animations and behaviors

Updated: 2024.10.25

Example:

BaseBottomToolbar(
  leadingAction: CupertinoButton(
    child: Icon(CupertinoIcons.line_horizontal_3),
    onPressed: () => showMenu(),
  ),
  searchPlaceholder: 'Search',
  onSearchChanged: (text) => updateResults(text),
  trailingAction: CupertinoButton(
    child: Icon(CupertinoIcons.square_pencil),
    onPressed: () => compose(),
  ),
  currentTabIcon: CupertinoIcons.house_fill,
  currentTabLabel: 'Home',
)
Inheritance
Implementers

Constructors

BaseBottomToolbar({Key? key, Widget? leadingAction, Widget? trailingAction, String searchPlaceholder = 'Search', ValueChanged<String>? onSearchChanged, ValueChanged<String>? onSearchSubmitted, ValueChanged<bool>? onSearchFocusChanged, IconData? currentTabIcon, String? currentTabLabel, double height = 50.0, Color? backgroundColor, BaseParam? baseParam})
const

Properties

backgroundColor → Color?
Background color
final
baseParam → BaseParam?
Personalization parameters, gets platform parameters first, then mode parameters
finalinherited
currentTabIcon → IconData?
Icon to show when search is expanded (current tab context)
final
currentTabLabel → String?
Label to show when search is expanded (current tab context)
final
hashCode → int
The hash code for this object.
no setterinherited
height → double
Toolbar height
final
key → Key?
Controls how one widget replaces another widget in the tree.
finalinherited
leadingAction → Widget?
Optional leading button (e.g., menu, filter)
final
onSearchChanged → ValueChanged<String>?
Called when search text changes
final
onSearchFocusChanged → ValueChanged<bool>?
Called when search field gains/loses focus
final
onSearchSubmitted → ValueChanged<String>?
Called when search is submitted
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
searchPlaceholder → String
Placeholder text for the search field
final
trailingAction → Widget?
Optional trailing button (e.g., compose, add)
final

Methods

beforeBuild(BuildContext context) → void
Called before build
inherited
beforeBuildByCupertino(BuildContext context) → void
Called before buildByCupertino
inherited
beforeBuildByCupertinoNative(BuildContext context) → void
Called before buildByCupertinoNative (native iOS implementation)
inherited
beforeBuildByMaterial(BuildContext context) → void
Called before buildByMaterial
inherited
build(BuildContext context) → Widget
Describes the part of the user interface represented by this widget.
inherited
buildByCupertino(BuildContext context) → Widget
build on cupertino mode (Flutter implementation)
buildByCupertinoNative(BuildContext context) → dynamic
build on cupertino mode with native iOS components (cupertino_native package) This is called when baseParam.nativeIOS = true Default implementation falls back to buildByCupertino()
inherited
buildByMaterial(BuildContext context) → Widget
build on material mode
commonBuild(BuildContext context, BaseParam? baseParam) → dynamic
inherited
createElement() → StatelessElement
Creates a StatelessElement to manage this widget's location in the tree.
inherited
debugDescribeChildren() → List<DiagnosticsNode>
Returns a list of DiagnosticsNode objects describing this node's children.
inherited
debugFillProperties(DiagnosticPropertiesBuilder properties) → void
Add additional properties associated with the node.
inherited
getBuildMode(BaseParam? baseParam) → WidgetBuildMode
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) → DiagnosticsNode
Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep.
inherited
toString({DiagnosticLevel minLevel = DiagnosticLevel.info}) → String
A string representation of this object.
inherited
toStringDeep({String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug, int wrapWidth = 65}) → String
Returns a string representation of this node and its descendants.
inherited
toStringShallow({String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) → String
Returns a one-line detailed description of the object.
inherited
toStringShort() → String
A short, textual description of this widget.
inherited
valueOf(String key, dynamic value) → dynamic
inherited
valueOfBaseParam(BaseParam? baseParam, String key, dynamic value) → dynamic
No reflection available in Dart First get value from platform, then from mode, finally from value itself
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited