Flutter静态路由管理插件static_route的使用

Flutter静态路由管理插件static_route的使用

static_route 是一个用于静态页面导航路由模板库。

获取开始

  1. pubspec.yaml 文件中添加 static_route

    dependencies:
      static_route: ^版本号
    
  2. 导入 static_route 包。

    import 'package:static_route/static_route.dart';
    

在每个可导航页面中增加 StaticRouteFactory 类型的静态 route 变量:

class HomePage extends StatelessWidget {

  // 定义一个静态路由
  static final route = StaticRouteFactory(
    name: 'HomePage', // 路由名称
    builder: (BuildContext context, Object? arguments) {
      return HomePage();
    },
  );

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('HomePage')),
      body: Center(
        child: ElevatedButton(
          child: Text('Next page'),
          onPressed: () {
            // 导航到下一个页面
            Navigator.pushNamed(context, NextPage.route.name, arguments: 'from HomePage');
          },
        ),
      ),
    );
  }
}

class NextPage extends StatefulWidget {
  NextPage(this.content);

  final String content;

  // 定义一个静态路由
  static final route = StaticRouteFactory(
    name: 'NextPage',
    builder: (BuildContext context, Object? arguments) {
      return NextPage(arguments as String);
    },
  );

  [@override](/user/override)
  State createState() => _NextPageState();
}

在某个 Dart 文件中(例如 pages.dart)中注册每个可导航页面的 route 列表:

// 注册所有可导航页面的路由
final routeTable = <StaticRoute>[
  HomePage.route,
  NextPage.route,
  // 其他页面...
];

在应用入口点 MaterialApponGenerateRoute 中调用 Iterable<StaticRoute> 的扩展方法 generateRoute 注册 routeTable 中的路由器:

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      onGenerateRoute: routeTable.generateRoute,
      initialRoute: HomePage.route.name,
    );
  }
}

使用示例

main.dart 文件中,可以这样使用:

import 'package:flutter/material.dart';
import 'package:static_route/static_route.dart';

// 主应用类
void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      onGenerateRoute: routeTable.generateRoute,
      initialRoute: HomePage.route.name,
    );
  }
}

// 注册所有可导航页面的路由
final routeTable = <StaticRoute>[
  HomePage.route,
  NextPage.route,
];

// 主页面
class HomePage extends StatelessWidget {
  static final route = StaticRoute(
    name: 'HomePage',
    builder: (RouteSettings settings) {
      return MaterialPageRoute(
        settings: settings,
        builder: (context) => HomePage(),
      );
    },
  );

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('HomePage')),
      body: Center(
        child: ElevatedButton(
          child: Text('Next page'),
          onPressed: () {
            // 导航到下一个页面
            Navigator.pushNamed(context, NextPage.route.name, arguments: 'from HomePage');
          },
        ),
      ),
    );
  }
}

// 下一个页面
class NextPage extends StatefulWidget {
  NextPage(this.content);

  final String content;

  static final route = StaticRouteFactory(
    name: 'NextPage',
    builder: (BuildContext context, Object? arguments) {
      return NextPage(arguments as String);
    },
  );

  [@override](/user/override)
  State createState() => _NextPageState();
}

// 下一个页面的状态类
class _NextPageState extends State<NextPage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('NextPage')),
      body: Center(
        child: Text(widget.content),
      ),
    );
  }
}

更多关于Flutter静态路由管理插件static_route的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter静态路由管理插件static_route的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


static_route 是 Flutter 中用于管理静态路由的一个插件。它允许你在应用程序中定义一组静态路由,并在需要时进行导航。这种管理方式特别适合那些路由结构相对固定且不需要动态生成的应用程序。

安装 static_route

首先,你需要在 pubspec.yaml 文件中添加 static_route 插件的依赖:

dependencies:
  flutter:
    sdk: flutter
  static_route: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来安装依赖。

使用 static_route

1. 定义静态路由

在使用 static_route 之前,你需要在应用程序中定义一组静态路由。你可以通过创建一个 StaticRoute 对象并将其添加到 StaticRouter 中来实现。

import 'package:flutter/material.dart';
import 'package:static_route/static_route.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Static Route Example',
      // 使用 StaticRouter 来管理路由
      onGenerateRoute: StaticRouter(
        routes: [
          StaticRoute(
            path: '/',
            builder: (context) => HomeScreen(),
          ),
          StaticRoute(
            path: '/details',
            builder: (context) => DetailsScreen(),
          ),
        ],
      ).onGenerateRoute,
      initialRoute: '/',
    );
  }
}

class HomeScreen extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Home'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            // 导航到 DetailsScreen
            Navigator.pushNamed(context, '/details');
          },
          child: Text('Go to Details'),
        ),
      ),
    );
  }
}

class DetailsScreen extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Details'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            // 返回到 HomeScreen
            Navigator.pop(context);
          },
          child: Text('Go back to Home'),
        ),
      ),
    );
  }
}

2. 导航到静态路由

在上面的例子中,HomeScreen 中有一个按钮,点击后会导航到 DetailsScreen。你可以使用 Navigator.pushNamed 方法来导航到定义好的静态路由。

3. 传递参数

如果你需要在路由之间传递参数,可以通过 StaticRoutearguments 参数来实现。

StaticRoute(
  path: '/details',
  builder: (context) {
    final args = ModalRoute.of(context)!.settings.arguments as Map<String, dynamic>;
    return DetailsScreen(args: args);
  },
),

在导航时传递参数:

Navigator.pushNamed(
  context,
  '/details',
  arguments: {'id': 123, 'name': 'Flutter'},
);

4. 处理未知路由

StaticRouter 还支持处理未知路由。你可以通过 unknownRoute 参数来定义一个默认的未知路由页面。

StaticRouter(
  routes: [
    StaticRoute(
      path: '/',
      builder: (context) => HomeScreen(),
    ),
    StaticRoute(
      path: '/details',
      builder: (context) => DetailsScreen(),
    ),
  ],
  unknownRoute: StaticRoute(
    path: '/404',
    builder: (context) => UnknownScreen(),
  ),
).onGenerateRoute,
回到顶部