GlassGroupedSection class

A convenience wrapper that groups GlassListTiles inside a card (GlassContainer.card).

GlassGroupedSection automatically injects GlassDividers between tiles, with smart leading-indent detection — 56px when the preceding tile has a GlassListTile.leading widget, 16px otherwise.

iOS 26 pattern

In iOS 26, Settings-style screens group related rows inside UITableView grouped sections. GlassGroupedSection provides the glass equivalent of that pattern.

Usage

GlassGroupedSection(
  header: const Text('NETWORK'),
  children: [
    GlassListTile(
      leading: Icon(CupertinoIcons.wifi, color: CupertinoColors.white),
      title: Text('Wi-Fi'),
      trailing: GlassListTile.chevron,
    ),
    GlassListTile(
      leading: Icon(CupertinoIcons.bluetooth, color: CupertinoColors.white),
      title: Text('Bluetooth'),
      trailing: GlassListTile.chevron,
    ),
    GlassListTile(
      leading: Icon(CupertinoIcons.antenna_radiowaves_left_right,
          color: CupertinoColors.white),
      title: Text('VPN'),
      trailing: GlassListTile.chevron,
    ),
  ],
)

Children

GlassGroupedSection is designed to contain GlassListTile rows and standard Flutter content. Do not place interactive glass controls (GlassSegmentedControl, GlassSlider, GlassSwitch, GlassButton) as direct children — this is a glass-in-glass anti-pattern that degrades refraction and can clip indicator animations. See GlassContainer for the full explanation.

Surface style

surfaceStyle defaults to GlassSurfaceStyle.glass in 1.x. iOS renders inset-grouped cards as flat, opaque surfaces, so use GlassSurfaceStyle.solid for sections in a scrolling page to match:

GlassGroupedSection(
  surfaceStyle: GlassSurfaceStyle.solid,
  children: [...],
)