Superposiciones

Represent dialogs y sheets con OverlayRequest? y render them through ScreenOverlayHost o AnimatedScreenOverlayHost.

Un solo espacio de overlay

Model overlay as OverlayRequest? y clear it a dismiss.

Dialog y sheet soporte

Use DialogRequest y BottomSheetRequest con optional payload data.

Control del orden de retorno

Primero cierra el overlay y luego haz pop de las páginas mediante widgets back-scope.

Patrón de overlay host

Keep overlay en state y build overlay UI through overlayBuilder.

Regla del estado del overlay

Overlay host animado

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

Cuando el overlay está visible, block pop gestures con canPopTop a avoid back-swipe inconsistency on iOS.