面向 Flutter 的宣告式導覽與覆層。

不使用 Navigator.push/pop 或 showDialog，就能驅動 Navigator 2.0 頁面與螢幕區域覆層。

快速上手查看 GitHub

頁面就是資料

PageEntry 只保存中繼資料，UI 由你的 resolver 生成。

螢幕區域覆層

對話框與底部彈層按螢幕隔離，不需全域狀態。

與狀態解耦

可使用 setState、Riverpod、Bloc 或 Provider，無需依賴。

入門步驟

安裝 declarative_nav，並透過 resolver 回呼渲染頁面。

安裝

flutter pub add declarative_nav

使用指南

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

重要說明

此套件避免使用 Navigator.push/pop 與 showDialog。請以狀態驅動導覽與覆層。

概覽

安裝