Estado de overlay local à tela

Represente diálogos e sheets com OverlayRequest? e renderize-os por ScreenOverlayHost ou AnimatedScreenOverlayHost.

Próximo: Abas declarativas Voltar para Páginas e Resolver

Uma única vaga de overlay

Modele o overlay como OverlayRequest? e limpe-o para descartá-lo.

Suporte a diálogos e sheets

Use DialogRequest e BottomSheetRequest com dados de payload opcionais.

Controle da ordem de voltar

Feche primeiro o overlay e depois dê pop nas páginas via widgets back-scope.

Padrão de overlay host

Mantenha o overlay no estado e construa a UI do overlay via overlayBuilder.

Regra de estado do 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,
  ),
);

Importante

Quando o overlay estiver visível, bloqueie gestos de pop com canPopTop para evitar inconsistências do gesto de voltar no iOS.

Páginas como dados

Abas declarativas