CNGlassButtonGroup class

A group of buttons that can be rendered together for proper Liquid Glass blending effects.

This widget renders all buttons in a single SwiftUI view, allowing them to properly blend together when using glassEffectUnionId.

On iOS 26+ and macOS 26+, this uses native SwiftUI rendering for proper Liquid Glass effects. For older versions, it falls back to Flutter widgets.

Breaking Change in v1.1.0: This widget now accepts CNButtonData models instead of CNButton widgets. Use the CNGlassButtonGroup.fromWidgets constructor for backward compatibility.

Example:

CNGlassButtonGroup(
  buttons: [
    CNButtonData.icon(
      icon: CNSFSymbol.house,
      onPressed: () => print('Home'),
    ),
    CNButtonData.icon(
      icon: CNSFSymbol.gear,
      onPressed: () => print('Settings'),
    ),
    CNButtonData(
      label: 'More',
      icon: CNSFSymbol.ellipsis,
      onPressed: () => print('More'),
    ),
  ],
  axis: Axis.horizontal,
  spacing: 8.0,
)
Inheritance
Available extensions

Constructors

CNGlassButtonGroup({Key? key, required List<CNButtonData> buttons, Axis axis = Axis.horizontal, double spacing = 8.0, double spacingForGlass = 40.0, bool autoHideOnModal = true})
Creates a group of glass buttons using data models.
const
CNGlassButtonGroup.fromWidgets({Key? key, required List<CNButton> buttonWidgets, Axis axis = Axis.horizontal, double spacing = 8.0, double spacingForGlass = 40.0, bool autoHideOnModal = true})
Creates a group from existing CNButton widgets.
const

Properties

autoHideOnModal → bool
When true (default), destroys the native group's PlatformView while a modal sheet is presented above this widget's host route. Fixes the iOS hybrid-composition z-order bleed (Issue #53) where host-page PlatformView pixels can leak through a sheet that also contains CN-widgets. Requires CNTabBarRouteObserver() to be registered in the app's navigatorObservers. No effect on iOS < 26 / non-iOS (Flutter fallback).
final
axis → Axis
Layout axis for buttons.
final
buttons → List<CNButtonData>
List of button data models.
final
hashCode → int
The hash code for this object.
no setterinherited
key → Key?
Controls how one widget replaces another widget in the tree.
finalinherited
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
spacing → double
Spacing between buttons.
final
spacingForGlass → double
Spacing value for Liquid Glass blending (affects how glass effects merge).
final

Methods

createElement() → StatefulElement
Creates a StatefulElement to manage this widget's location in the tree.
inherited
createState() → State<CNGlassButtonGroup>
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