Локальний для екрана стан оверлею

Представляйте діалоги й sheets через OverlayRequest? і відображайте їх через ScreenOverlayHost або AnimatedScreenOverlayHost.

Один слот оверлею

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

Підтримка діалогів і sheets

Використовуйте DialogRequest і BottomSheetRequest з необов'язковими даними payload.

Контроль порядку назад

Спочатку закрийте оверлей, а потім pop-айте сторінки через back-scope widgets.

Шаблон overlay host

Тримайте оверлей у стані й будуйте UI оверлею через overlayBuilder.

Правило стану оверлею

Анімований overlay host

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,
  ),
);
Important

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