Navigation déclarative et overlays pour Flutter.

Pilotez les pages Navigator 2.0 et les overlays locaux à l’écran sans Navigator.push/pop ni showDialog.

Les pages sont des données

PageEntry ne stocke que des métadonnées. L’UI est créée par votre résolveur.

Overlays locaux à l’écran

Les dialogues et bottom sheets sont limités par écran sans état global.

Indépendant de l’état

Utilisez setState, Riverpod, Bloc ou Provider. Aucune dépendance requise.

Premiers pas

Installez declarative_nav et rendez les pages via un callback de résolveur.

Installation

flutter pub add declarative_nav

Guide d’utilisation

app_root.dart
class AppRoot extends StatefulWidget {
  const AppRoot({super.key});

  @override
  State<AppRoot> createState() => _AppRootState();
}

class _AppRootState extends State<AppRoot> {
  OverlayRequest? _overlay;
  late List<PageEntry> _pages;

  @override
  void initState() {
    super.initState();
    _pages = const [PageEntry(key: 'home', name: '/home')];
  }

  Widget buildPage(BuildContext context, PageEntry page) {
    return HomePage(onOpenDialog: _openDialog);
  }

  @override
  Widget build(BuildContext context) {
    return DeclarativePagesNavigator(
      pages: _pages,
      buildPage: buildPage,
      onPopTop: _popTop,
      canPopTop: () => _overlay == null,
    );
  }
}
Note importante

Ce paquet évite Navigator.push/pop et les appels à showDialog. Pilotez navigation et overlays depuis l’état.