CNPopupMenuButton class

A Cupertino-native popup menu button.

On iOS/macOS this embeds a native popup button and shows a native menu.

Inheritance
Available extensions

Constructors

CNPopupMenuButton({Key? key, required String? buttonLabel, required List<CNPopupMenuEntry> items, required ValueChanged<int> onSelected, Color? tint, double height = 32.0, bool shrinkWrap = false, CNButtonStyle buttonStyle = CNButtonStyle.plain, bool preserveTopToBottomOrder = false, TextStyle? labelStyle})
Creates a text-labeled popup menu button.
const
CNPopupMenuButton.icon({Key? key, CNSymbol? buttonIcon, IconData? buttonCustomIcon, CNIcon? buttonImageAsset, required List<CNPopupMenuEntry> items, required ValueChanged<int> onSelected, Color? tint, double size = 44.0, CNButtonStyle buttonStyle = CNButtonStyle.glass, bool preserveTopToBottomOrder = false})
Creates a round, icon-only popup menu button.

Properties

buttonCustomIcon → IconData?
Custom icon from CupertinoIcons, Icons, or any IconData. Takes precedence over buttonIcon but not buttonImageAsset.
final
buttonIcon → CNSymbol?
SF Symbol icon for the button. Priority: buttonImageAsset > buttonCustomIcon > buttonIcon.
final
buttonImageAsset → CNIcon?
Image asset (SVG, PNG, etc.) for the button icon. Takes precedence over both buttonIcon and buttonCustomIcon.
final
buttonLabel → String?
Text label for the button. null in icon-only mode.
final
buttonStyle → CNButtonStyle
Visual style to apply to the button.
final
hashCode → int
The hash code for this object.
no setterinherited
height → double
Control height; icon mode uses diameter semantics.
final
isIconButton → bool
Whether this instance is configured as an icon button variant.
no setter
items → List<CNPopupMenuEntry>
Entries that populate the popup menu.
final
key → Key?
Controls how one widget replaces another widget in the tree.
finalinherited
labelStyle → TextStyle?
Optional text style for the trigger button label.
final
onSelected → ValueChanged<int>
Called with the selected index when the user makes a selection.
final
preserveTopToBottomOrder → bool
When true, items maintain top-to-bottom order even when menu opens upward.
final
round → bool
true when using the round icon variant, false for the text variant.
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
shrinkWrap → bool
If true, sizes the control to its intrinsic width.
final
tint → Color?
Tint color for the control.
final
width → double?
Fixed width. In icon mode this equals the button diameter.
final

Methods

createElement() → StatefulElement
Creates a StatefulElement to manage this widget's location in the tree.
inherited
createState() → State<CNPopupMenuButton>
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
liquidGlass({CNGlassEffect effect = CNGlassEffect.regular, CNGlassEffectShape shape = CNGlassEffectShape.capsule, double? cornerRadius, Color? tint, bool interactive = false}) → Widget

Available on Widget, provided by the LiquidGlassExtension extension

Applies a Liquid Glass effect to this widget.
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