Состояние оверлея на уровне экрана

Представляйте диалоги и панели с помощью OverlayRequest? и отображайте их через ScreenOverlayHost или AnimatedScreenOverlayHost.

Единый слот оверлея

Моделируйте оверлей как OverlayRequest? и очищайте его, чтобы закрыть.

Поддержка диалогов и панелей

Используйте DialogRequest и BottomSheetRequest с необязательными данными полезной нагрузки.

Управление порядком назад

Сначала закрывайте оверлей, затем выполняйте pop страниц через виджеты back-scope.

Шаблон хоста оверлея

Держите оверлей в состоянии и собирайте UI оверлея через overlayBuilder.

Правило состояния оверлея

Анимированный хост оверлея

return AnimatedScreenOverlayHost(
  overlay: _overlay,
  onDismiss: _dismissOverlay,
  overlayBuilder: (context, req, dismiss) => switch (req) {
    DialogRequest(key: 'hello') => AlertDialog(
      title: const Text('Hello'),
      actions: [TextButton(onPressed: dismiss, child: const Text('Close'))],
    ),
    _ => null,
  },
  child: DeclarativePagesNavigator(
    pages: _pages,
    buildPage: _buildPage,
    onPopTop: _popTop,
    canPopTop: () => _overlay == null,
  ),
);
Важно

Когда оверлей виден, Блокируйте жесты pop с помощью canPopTop чтобы избежать несогласованности back-swipe в iOS.