CNToolbar class

A Cupertino-native toolbar with liquid glass translucent effect.

Uses native UINavigationBar on iOS and NSToolbar on macOS for authentic translucent blur effects. The toolbar automatically blurs content behind it, creating the signature iOS/macOS "liquid glass" appearance.

Inheritance

Constructors

CNToolbar({Key? key, List<CNToolbarAction>? leading, List<CNToolbarAction>? middle, List<CNToolbarAction>? trailing, CNToolbarMiddleAlignment middleAlignment = CNToolbarMiddleAlignment.center, bool transparent = false, Color? tint, double? height, double? pillHeight})
Creates a native translucent toolbar.
const
CNToolbar.search({Key? key, List<CNToolbarAction>? leading, List<CNToolbarAction>? middle, List<CNToolbarAction>? trailing, required CNSearchConfig? searchConfig, CNSymbol? contextIcon, CNToolbarMiddleAlignment middleAlignment = CNToolbarMiddleAlignment.center, bool transparent = false, Color? tint, double? height, double? pillHeight})
Creates a toolbar with integrated search functionality.
const

Properties

contextIcon → CNSymbol?
Optional icon to show when search is active (represents previous context).
final
hashCode → int
The hash code for this object.
no setterinherited
height → double?
Fixed height (if null, uses intrinsic platform height).
final
key → Key?
Controls how one widget replaces another widget in the tree.
finalinherited
leading → List<CNToolbarAction>?
Leading actions (buttons/icons on the left).
final
middle → List<CNToolbarAction>?
Middle actions (buttons/icons in the center).
final
middleAlignment → CNToolbarMiddleAlignment
Alignment of middle actions.
final
pillHeight → double?
Height of button group pills. If null, uses default platform height. Controls the vertical size of the pill-shaped button groups.
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
searchConfig → CNSearchConfig?
Search configuration (only for search-enabled toolbar).
final
tint → Color?
Tint color for buttons and icons.
final
trailing → List<CNToolbarAction>?
Trailing actions (buttons/icons on the right). For search-enabled toolbar, search button is added automatically.
final
transparent → bool
Use completely transparent background (no blur).
final

Methods

createElement() → StatefulElement
Creates a StatefulElement to manage this widget's location in the tree.
inherited
createState() → State<CNToolbar>
Creates the mutable state for this widget at a given location in the tree.
override
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
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

Operators

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