????

Represent dialogs ? sheets ?? OverlayRequest? ? render them through ScreenOverlayHost ?? AnimatedScreenOverlayHost.

단일 오버레이 슬롯

Model overlay as OverlayRequest? ? clear it ? dismiss.

Dialog ? sheet ??

Use DialogRequest ? BottomSheetRequest ?? optional payload data.

뒤로 순서 제어

먼저 오버레이를 닫고, 그다음 back-scope 위젯으로 페이지를 pop합니다.

오버레이 호스트 패턴

Keep overlay ?? state ? build overlay UI through 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,
  ),
);
Important

오버레이가 보일 때, block pop gestures ?? canPopTop ? avoid back-swipe inconsistency on iOS.