OudsBottomSheetScaffold class

A scaffold that displays a standard (persistent) bottom sheet anchored to the bottom of the screen, co-existing with the main content.

Unlike a modal bottom sheet, a standard bottom sheet remains visible while the user interacts with the rest of the screen.

States

The sheet has two states:

Gestures

When sheetSwipeEnabled is true:

• Swipe up → expands the sheet from partially expanded.
• Swipe down → collapses the sheet from expanded to peek height.

Programmatic control

Use a GlobalKey to call OudsBottomSheetScaffoldState.expand or OudsBottomSheetScaffoldState.partialExpand:

final scaffoldKey = GlobalKey<OudsBottomSheetScaffoldState>();

OudsBottomSheetScaffold(
  key: scaffoldKey,
  topBar: AppBar(title: Text('My screen')),
  sheetContent: (context) => Text('Sheet content'),
  content: (context) => Text('Main content'),
);

// Expand programmatically:
scaffoldKey.currentState?.expand();

// Collapse back to peek height:
scaffoldKey.currentState?.partialExpand();

Parameters

• sheetContent – Builder for the bottom sheet body.
• content – Builder for the main screen body.
• sheetPeekHeight – Height when partially expanded (default 56 dp).
• sheetDragHandle – Whether to show the drag handle pill (default true).
• sheetSwipeEnabled – Whether swipe gestures are active (default true).
• topBar – Optional top app bar.
• onExpansionChanged – Called with true when expanded, false when collapsed.

See also

• OudsModalBottomSheet for a modal variant that blocks the main content.
• Flutter's Scaffold which this widget wraps internally.