GlassPopover class

A liquid glass popover that morphs from its trigger button.

GlassPopover implements the same iOS 26 liquid morph animation as GlassMenu, but instead of presenting a list of menu items, it presents any custom widget. Use it for tooltips, mini forms, preview cards, colour pickers, or any content that should appear in a glass overlay.

The popover morphs from the trigger button using spring physics and the dual-blob metaball technique, creating a teardrop expansion effect.

Features

• Liquid morph animation: Same teardrop physics as GlassMenu
• Custom content: Any widget, not just menu items
• Self-closing: Content receives a close callback
• Auto-positioning: Detects best alignment from trigger position
• Screen-edge clamping: Keeps popover within safe area
• Barrier dismissal: Tap outside to close (configurable)
• Blur ramp: The backdrop blur eases in with the morph instead of paying its full raster cost from the first frame — see blurRampDuration

Usage

Basic Usage

GlassPopover(
  trigger: Icon(CupertinoIcons.info_circle, color: Colors.white),
  contentBuilder: (context, close) => Padding(
    padding: EdgeInsets.all(16),
    child: Text('Hello from the popover!',
      style: TextStyle(color: Colors.white)),
  ),
)

With Interactive Trigger

GlassPopover(
  triggerBuilder: (context, toggle) => GlassButton(
    onTap: toggle,
    child: Text('Show Details'),
  ),
  contentBuilder: (context, close) => Padding(
    padding: EdgeInsets.all(16),
    child: Column(
      mainAxisSize: MainAxisSize.min,
      children: [
        Text('Profile Details', style: TextStyle(color: Colors.white)),
        SizedBox(height: 12),
        GlassButton(onTap: close, child: Text('Done')),
      ],
    ),
  ),
)

With Fixed Height (Scrollable)

GlassPopover(
  popoverHeight: 300,
  trigger: Icon(CupertinoIcons.list_bullet),
  contentBuilder: (context, close) => ListView.builder(
    itemCount: 50,
    itemBuilder: (context, i) => ListTile(title: Text('Item $i')),
  ),
)

Custom Alignment

GlassPopover(
  alignment: GlassMenuAlignment.bottomCenter,
  trigger: Icon(CupertinoIcons.arrow_down),
  contentBuilder: (context, close) => Text('Below the trigger'),
)