g1455

Sheet

A floating glass bottom sheet with a grabber that follows the finger: dragged down to dismiss, pulled up to a large detent, and awaited for the value it was closed with.

showGlassSheet shows your content in a glass sheet that rises from the bottom of the screen over a 20% dim, like an iOS 26 sheet at its medium height. The sheet floats 8 px in from the screen's sides and bottom, has 36 px corners and a grabber, and sizes itself to its content, up to the safe area.

The sheet follows the finger. Drag it down past a third of its height, or flick it, and it goes; let go earlier and it springs back. A tap on the dim closes it too. Like showDialog, it returns a Future that completes with the value the sheet was popped with.

On a narrow window, this site's own navigation (the menu button at the left of the top bar) opens in a glass sheet.

When to use

  • Share sheets, action sheets, pickers and short forms.
  • Details about one item that the user glances at and dismisses.
  • A list or a form that wants the whole height when the user asks for it: give it a large detent, below.
  • Not for a flow of several screens. Push a page instead.
  • Not for a yes/no confirmation. That's an alert.

Usage

final String? colour = await showGlassSheet<String>(
  context: context,
  builder: (BuildContext context) => Padding(
    padding: const EdgeInsets.fromLTRB(20, 8, 20, 24),
    child: Column(
      mainAxisSize: MainAxisSize.min,
      crossAxisAlignment: CrossAxisAlignment.stretch,
      children: <Widget>[
        for (final String c in <String>['Red', 'Green', 'Blue'])
          Padding(
            padding: const EdgeInsets.only(bottom: 8),
            child: GlassButton(onPressed: () => Navigator.pop(context, c), child: Text(c)),
          ),
      ],
    ),
  ),
);

Detents

detents are the heights the sheet rests at, UIKit's UISheetPresentationController.Detent. By default it has one, GlassSheetDetent.medium: the sheet at its content's height, as above. Add GlassSheetDetent.large and a drag up pulls it to the whole height below the top safe area less 8 px, its top under the finger the whole way and its inset going to nothing as it rises; a release settles at the nearer detent, or the one a flick was heading for.

showGlassSheet<void>(
  context: context,
  detents: const <GlassSheetDetent>[GlassSheetDetent.medium, GlassSheetDetent.large],
  initialDetent: GlassSheetDetent.medium, // the first of detents when null
  onDetentChanged: (GlassSheetDetent detent) => debugPrint('now $detent'),
  builder: (BuildContext context) => const NotesList(),
);

The content is laid out at the height the sheet has, so a list in it shows more rows at large. Apple's medium detent is half the window whatever the content; this one is the content's height.

An opaque large sheet

At large the glass is largeFinish: by default finish with its tint at full alpha, which passes through every level between as the sheet rises. A sheet whose tint covers fully reads no backdrop, since it would show nothing of what it captured, so once it is all the way up it is drawn on the cheap tier: the same tint over nothing, and nothing to capture. Headless, a 400 × 800 window with a glass bar under the sheet: one surface of two captured instead of two, and 20,608 px² of capture against 337,408.

The other way: once it reads nothing, the sheet is ordinary content to the capture of the glass around it, so a change inside it is a retake for that glass, one where a glass sheet took none. A sheet whose content animates while it is up may be cheaper with a translucent largeFinish, which keeps it glass, and keeps its capture. Glass inside the sheet stays on the theme's tier and sees the sheet behind it either way.

The gap above a large sheet and its keeping the corner radius at the bottom are layout taste: the medium detent is the one that was measured.

Moving

While the sheet is dragged between detents it declares where it travels, so the drag is one retake rather than one a frame (1 against 16 in the package's tests), and so is a pull below its lowest detent. Dragged down to close, the dim behind it fades with it, and that drag is retaken on every frame: the dim is under the glass, and the glass shows the screen brightening. A known gap: a list inside the sheet does not hand the drag over to the sheet when it reaches its top.

Content

Warning

The sheet does not colour its content for legibility. Text inherits the style of the page that opened the sheet, which may not read on the glass. Ask the theme for the label colour and apply it yourself:

final Color label = GlassTheme.of(context).legibility(finish).label;

Glass components inside the sheet, such as GlassButton, pick their own colour.

  • The content is laid out in a Flexible under the grabber. Long content should scroll: a SingleChildScrollView works, and a ListView needs shrinkWrap: true or a bounded height. At a large detent the content is given the sheet's whole height.
  • The sheet stands on the keyboard, as an iOS sheet does: at medium 8 px above it, at large on it, with the content laid out in the height that is left, so a focused text field in it stays in sight. Unlike showModalBottomSheet, there is nothing to add: the content's MediaQuery.viewInsets has its bottom taken out, so content already padded by it is not padded twice.
  • The route has no Material. Widgets that need one, such as InkWell or ListTile, need a Material(type: MaterialType.transparency) around them.
  • finish sets the glass of this sheet only. Pass the same finish to legibility so the text matches it.

Setup

The GlassHost must be above the navigator (in MaterialApp(builder: ...)), as for every modal. The sheet lifts itself above page glass and bars on its own.

Accessibility

  • With barrierDismissible on (the default), the dim is announced with barrierLabel.
  • Dragging is not the only way out: give the sheet a visible close or cancel action as well.

Code

import 'package:flutter/material.dart';
import 'package:g1455/g1455.dart';

/// Opens a glass sheet to choose who to share with, and returns the name.
/// Assumes a GlassHost above the navigator, e.g. in MaterialApp.builder.
Future<String?> shareWith(BuildContext context) => showGlassSheet<String>(
  context: context,
  builder: (BuildContext context) {
    // The sheet doesn't colour its content: ask the theme what reads on it.
    final Color label = GlassTheme.of(context).legibility().label;
    return DefaultTextStyle.merge(
      style: TextStyle(color: label, fontSize: 17),
      child: IconTheme.merge(
        data: IconThemeData(color: label),
        child: SingleChildScrollView(
          padding: const EdgeInsets.fromLTRB(20, 8, 20, 24),
          child: Column(
            mainAxisSize: MainAxisSize.min,
            crossAxisAlignment: CrossAxisAlignment.stretch,
            children: <Widget>[
              const Text('Share with', style: TextStyle(fontWeight: FontWeight.w600)),
              const SizedBox(height: 12),
              for (final String name in <String>['Anna', 'Ben', 'Chiara'])
                Semantics(
                  button: true,
                  child: GestureDetector(
                    behavior: HitTestBehavior.opaque,
                    onTap: () => Navigator.pop(context, name),
                    child: SizedBox(
                      height: 48,
                      child: Row(
                        children: <Widget>[
                          const Icon(Icons.person_outline),
                          const SizedBox(width: 12),
                          Text(name),
                        ],
                      ),
                    ),
                  ),
                ),
              const SizedBox(height: 12),
              GlassButton(onPressed: () => Navigator.pop(context), child: const Text('Cancel')),
            ],
          ),
        ),
      ),
    );
  },
);

/// A button that opens the sheet and shows the choice.
class ShareButton extends StatelessWidget {
  const ShareButton({super.key});

  @override
  Widget build(BuildContext context) => GlassButton(
    onPressed: () async {
      final String? name = await shareWith(context);
      if (name != null && context.mounted) {
        ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text('Sent to $name')));
      }
    },
    child: const Text('Share'),
  );
}

API

showGlassSheet<T>

Parameter Type Default Description
context BuildContext required Where to find the navigator.
builder WidgetBuilder required The sheet's content, laid out in a Flexible under the grabber.
finish GlassFinish? null The glass. Null takes the theme's.
showGrabber bool true Draws the 36 × 5 grabber at the top.
barrierDismissible bool true Whether a tap on the dim closes the sheet (with null).
barrierLabel String 'Dismiss' What a screen reader says for the dim.
constraints BoxConstraints? null Bounds the sheet inside the window's margins; a maxWidth keeps it centred on a wide window.
detents List<GlassSheetDetent> [GlassSheetDetent.medium] The heights the sheet rests at. Not empty.
initialDetent GlassSheetDetent? null The one it opens at; the first of detents when null.
onDetentChanged ValueChanged<GlassSheetDetent>? null Told each time the sheet settles at another detent.
largeFinish GlassFinish? null The glass at the large detent. Null is finish with its tint at full alpha, which reads no backdrop.
returns Future<T?> The value passed to Navigator.pop, or null.

GlassSheetDetent: medium, the content's height, floating kGlassSheetInset in; large, the whole height below the top safe area less kGlassSheetInset, edge to edge.

Constants

Name Value Description
kGlassSheetInset 8 The sheet's distance from the screen's sides and bottom.
kGlassSheetRadius 36 The sheet's corner radius.
kGlassModalDim Color.fromRGBO(0, 0, 0, 0.20) The dim behind the sheet.