Flutter路由管理插件flext_go_router的使用

Flutter路由管理插件flext_go_router的使用

flext_go_router 是一个为 go_router 包提供扩展功能的库。你可以通过它来简化路由管理和状态管理。

安装

首先，你需要在你的项目中安装 flext_go_router 包。运行以下命令：

flutter pub add flext_go_router

然后你就可以导入该包并使用其所有扩展功能了。

特性

BuildContext 扩展

BuildContext 提供了一些有用的扩展方法来方便地获取当前的路由器和路由器状态。

router
final router = context.router;

通过 context.router 可以快速获取当前的 GoRouter 实例。

routerState
final routerState = context.routerState;

通过 context.routerState 可以快速获取当前的 GoRouterState 实例。

完整示例Demo

下面是一个完整的示例，展示了如何使用 flext_go_router 来管理路由。

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp.router(
      title: 'Flutter Demo',
      routeInformationParser: GoRouteInformationParser(),
      routerDelegate: GoRouterDelegate(
        routes: [
          GoRoute(
            path: '/',
            builder: (context, state) => HomeScreen(),
          ),
          GoRoute(
            path: '/details/:id',
            builder: (context, state) => DetailsScreen(id: state.pathParameters['id']),
          ),
        ],
      ),
    );
  }
}

class HomeScreen extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Home Screen'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            // 使用 context.router 跳转到详情页
            context.router.go('/details/123');
          },
          child: Text('Go to Details'),
        ),
      ),
    );
  }
}

class DetailsScreen extends StatelessWidget {
  final String id;

  DetailsScreen({required this.id});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Details Screen'),
      ),
      body: Center(
        child: Text('Details for ID: $id'),
      ),
    );
  }
}

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

1 回复

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


flext_go_router 是一个基于 go_router 的 Flutter 路由管理插件，旨在简化路由配置和管理。它提供了一种更简洁的方式来定义路由和处理导航逻辑。以下是使用 flext_go_router 的基本步骤和示例。

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 flext_go_router 的依赖：

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

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

2. 基本使用

2.1 创建路由

使用 flext_go_router 定义路由非常简单。你可以通过 FlexRouter 类来定义路由，并将其传递给 MaterialApp.router。

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

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

class MyApp extends StatelessWidget {
  MyApp({Key? key}) : super(key: key);

  final FlexRouter _router = FlexRouter(
    routes: [
      FlexRoute(
        path: '/',
        builder: (context, state) => HomeScreen(),
      ),
      FlexRoute(
        path: '/details',
        builder: (context, state) => DetailsScreen(),
      ),
    ],
  );

  @override
  Widget build(BuildContext context) {
    return MaterialApp.router(
      routerConfig: _router,
      title: 'FlexRouter Example',
    );
  }
}

class HomeScreen extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Home')),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            // 导航到详情页
            context.push('/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: () {
            // 返回上一页
            context.pop();
          },
          child: Text('Go Back'),
        ),
      ),
    );
  }
}

2.2 路由参数

你可以通过 state.params 来获取路由参数：

FlexRoute(
  path: '/details/:id',
  builder: (context, state) {
    final id = state.params['id'];
    return DetailsScreen(id: id);
  },
),

在导航时传递参数：

context.push('/details/123');

2.3 路由守卫

flext_go_router 支持路由守卫，可以在导航前进行一些验证操作：

FlexRouter(
  routes: [
    FlexRoute(
      path: '/',
      builder: (context, state) => HomeScreen(),
    ),
    FlexRoute(
      path: '/details',
      builder: (context, state) => DetailsScreen(),
      guards: [
        (context, state) {
          // 检查用户是否登录
          if (!isLoggedIn) {
            return '/login';
          }
          return null; // 继续导航
        },
      ],
    ),
  ],
);

2.4 嵌套路由

flext_go_router 支持嵌套路由，可以通过 FlexRoute.children 来定义嵌套路由：

FlexRouter(
  routes: [
    FlexRoute(
      path: '/',
      builder: (context, state) => HomeScreen(),
      children: [
        FlexRoute(
          path: 'profile',
          builder: (context, state) => ProfileScreen(),
        ),
        FlexRoute(
          path: 'settings',
          builder: (context, state) => SettingsScreen(),
        ),
      ],
    ),
  ],
);
回到顶部