Flutter 导航路由：构建流畅的应用导航体验

优质文章学习记录

— 6 min read

Flutter 导航路由：构建流畅的应用导航体验

代码如诗，导航如画。让我们用 Flutter 路由的强大能力，构建出既流畅又直观的应用导航系统。

什么是 Flutter 导航？

Flutter 导航是指在不同页面（或称为路由）之间进行切换的机制。良好的导航系统是应用用户体验的重要组成部分，它决定了用户如何在应用中浏览和找到所需内容。

基础导航

1. 使用 Navigator

import 'package:flutter/material.dart'; // 跳转到新页面 Navigator.push( context, MaterialPageRoute(builder: (context) => SecondPage()), ); // 返回上一页 Navigator.pop(context); // 替换当前页面 Navigator.pushReplacement( context, MaterialPageRoute(builder: (context) => SecondPage()), ); // 清除所有页面并跳转到新页面 Navigator.pushAndRemoveUntil( context, MaterialPageRoute(builder: (context) => HomePage()), (route) => false, );

2. 命名路由

// 在 MaterialApp 中定义路由 class MyApp extends StatelessWidget { @override Widget build(BuildContext context) { return MaterialApp( title: 'Flutter Demo', initialRoute: '/', routes: { '/': (context) => HomePage(), '/second': (context) => SecondPage(), '/third': (context) => ThirdPage(), }, ); } } // 使用命名路由导航 Navigator.pushNamed(context, '/second'); // 返回上一页 Navigator.pop(context); // 替换当前页面 Navigator.pushReplacementNamed(context, '/second'); // 清除所有页面并跳转到新页面 Navigator.pushNamedAndRemoveUntil(context, '/', (route) => false);

3. 传递参数

// 跳转到新页面并传递参数 Navigator.pushNamed( context, '/second', arguments: {'id': 1, 'name': 'Flutter'}, ); // 在新页面接收参数 class SecondPage extends StatelessWidget { @override Widget build(BuildContext context) { final Map<String, dynamic> args = ModalRoute.of(context)!.settings.arguments as Map<String, dynamic>; final int id = args['id']; final String name = args['name']; return Scaffold( appBar: AppBar(title: Text('Second Page')), body: Center( child: Text('ID: $id, Name: $name'), ), ); } }

高级路由管理

1. 使用 onGenerateRoute

class MyApp extends StatelessWidget { @override Widget build(BuildContext context) { return MaterialApp( title: 'Flutter Demo', initialRoute: '/', onGenerateRoute: (settings) { switch (settings.name) { case '/': return MaterialPageRoute(builder: (context) => HomePage()); case '/second': final args = settings.arguments as Map<String, dynamic>; return MaterialPageRoute( builder: (context) => SecondPage( id: args['id'], name: args['name'], ), ); default: return MaterialPageRoute(builder: (context) => NotFoundPage()); } }, ); } }

2. 自定义路由动画

// 自定义页面路由 class CustomPageRoute<T> extends PageRouteBuilder<T> { final Widget child; CustomPageRoute({required this.child}) : super( pageBuilder: (context, animation, secondaryAnimation) => child, transitionsBuilder: (context, animation, secondaryAnimation, child) { const begin = Offset(1.0, 0.0); const end = Offset.zero; const curve = Curves.easeInOut; var tween = Tween(begin: begin, end: end).chain(CurveTween(curve: curve)); var offsetAnimation = animation.drive(tween); return SlideTransition( position: offsetAnimation, child: child, ); }, ); } // 使用自定义路由 Navigator.push( context, CustomPageRoute(child: SecondPage()), );

3. 使用 PageRouteBuilder

Navigator.push( context, PageRouteBuilder( pageBuilder: (context, animation, secondaryAnimation) => SecondPage(), transitionsBuilder: (context, animation, secondaryAnimation, child) { return FadeTransition( opacity: animation, child: child, ); }, transitionDuration: Duration(milliseconds: 500), ), );

路由守卫和拦截

1. 登录验证

class AuthGuard { static bool isLoggedIn = false; static Route<dynamic>? onGenerateRoute(RouteSettings settings) { // 需要登录的页面 final authRoutes = ['/profile', '/settings']; if (authRoutes.contains(settings.name) && !isLoggedIn) { return MaterialPageRoute( builder: (context) => LoginPage(), settings: RouteSettings(name: '/login'), ); } // 正常路由 switch (settings.name) { case '/': return MaterialPageRoute(builder: (context) => HomePage()); case '/login': return MaterialPageRoute(builder: (context) => LoginPage()); case '/profile': return MaterialPageRoute(builder: (context) => ProfilePage()); default: return MaterialPageRoute(builder: (context) => NotFoundPage()); } } }

2. 路由拦截器

class RouteInterceptor extends NavigatorObserver { @override void didPush(Route<dynamic> route, Route<dynamic>? previousRoute) { super.didPush(route, previousRoute); print('Pushed: ${route.settings.name}'); // 可以在这里进行埋点、权限检查等 } @override void didPop(Route<dynamic> route, Route<dynamic>? previousRoute) { super.didPop(route, previousRoute); print('Popped: ${route.settings.name}'); } } // 在 MaterialApp 中使用 MaterialApp( navigatorObservers: [RouteInterceptor()], // ... )

底部导航栏

1. 基础底部导航

class HomePage extends StatefulWidget { @override _HomePageState createState() => _HomePageState(); } class _HomePageState extends State<HomePage> { int _selectedIndex = 0; final List<Widget> _pages = [ HomeTab(), SearchTab(), ProfileTab(), ]; void _onItemTapped(int index) { setState(() { _selectedIndex = index; }); } @override Widget build(BuildContext context) { return Scaffold( body: _pages[_selectedIndex], bottomNavigationBar: BottomNavigationBar( items: const <BottomNavigationBarItem>[ BottomNavigationBarItem( icon: Icon(Icons.home), label: '首页', ), BottomNavigationBarItem( icon: Icon(Icons.search), label: '搜索', ), BottomNavigationBarItem( icon: Icon(Icons.person), label: '我的', ), ], currentIndex: _selectedIndex, selectedItemColor: Colors.blue, onTap: _onItemTapped, ), ); } }

2. 使用 IndexedStack 保持页面状态

class HomePage extends StatefulWidget { @override _HomePageState createState() => _HomePageState(); } class _HomePageState extends State<HomePage> { int _selectedIndex = 0; final List<Widget> _pages = [ HomeTab(), SearchTab(), ProfileTab(), ]; @override Widget build(BuildContext context) { return Scaffold( body: IndexedStack( index: _selectedIndex, children: _pages, ), bottomNavigationBar: BottomNavigationBar( items: const <BottomNavigationBarItem>[ BottomNavigationBarItem( icon: Icon(Icons.home), label: '首页', ), BottomNavigationBarItem( icon: Icon(Icons.search), label: '搜索', ), BottomNavigationBarItem( icon: Icon(Icons.person), label: '我的', ), ], currentIndex: _selectedIndex, selectedItemColor: Colors.blue, onTap: (index) { setState(() { _selectedIndex = index; }); }, ), ); } }

抽屉导航

class HomePage extends StatelessWidget { @override Widget build(BuildContext context) { return Scaffold( appBar: AppBar(title: Text('首页')), drawer: Drawer( child: ListView( padding: EdgeInsets.zero, children: <Widget>[ DrawerHeader( decoration: BoxDecoration( color: Colors.blue, ), child: Text( '菜单', style: TextStyle( color: Colors.white, fontSize: 24, ), ), ), ListTile( leading: Icon(Icons.home), title: Text('首页'), onTap: () { Navigator.pop(context); Navigator.pushNamed(context, '/'); }, ), ListTile( leading: Icon(Icons.settings), title: Text('设置'), onTap: () { Navigator.pop(context); Navigator.pushNamed(context, '/settings'); }, ), ], ), ), body: Center(child: Text('首页内容')), ); } }

最佳实践

  1. 使用命名路由：便于管理和维护
  2. 参数类型安全：使用强类型传递参数
  3. 路由守卫：在关键页面进行权限验证
  4. 动画一致性：保持应用内导航动画的一致性
  5. 状态保持：使用 IndexedStack 保持页面状态
  6. 错误处理：处理路由不存在的情况

实践案例：完整的导航系统

import 'package:flutter/material.dart'; void main() { runApp(MyApp()); } class MyApp extends StatelessWidget { @override Widget build(BuildContext context) { return MaterialApp( title: 'Flutter Navigation Demo', theme: ThemeData( primarySwatch: Colors.blue, ), initialRoute: '/', routes: { '/': (context) => HomePage(), '/second': (context) => SecondPage(), '/third': (context) => ThirdPage(), }, onUnknownRoute: (settings) { return MaterialPageRoute( builder: (context) => NotFoundPage(), ); }, ); } } class HomePage extends StatelessWidget { @override Widget build(BuildContext context) { return Scaffold( appBar: AppBar( title: Text('首页'), ), body: Center( child: Column( mainAxisAlignment: MainAxisAlignment.center, children: [ Text( '首页', style: TextStyle(fontSize: 24), ), SizedBox(height: 20), ElevatedButton( onPressed: () { Navigator.pushNamed( context, '/second', arguments: {'message': '来自首页的问候'}, ); }, child: Text('跳转到第二页'), ), ], ), ), ); } } class SecondPage extends StatelessWidget { @override Widget build(BuildContext context) { final args = ModalRoute.of(context)!.settings.arguments as Map<String, dynamic>; final message = args['message']; return Scaffold( appBar: AppBar( title: Text('第二页'), ), body: Center( child: Column( mainAxisAlignment: MainAxisAlignment.center, children: [ Text( '第二页', style: TextStyle(fontSize: 24), ), SizedBox(height: 10), Text( message, style: TextStyle(fontSize: 16, color: Colors.grey), ), SizedBox(height: 20), ElevatedButton( onPressed: () { Navigator.pushNamed(context, '/third'); }, child: Text('跳转到第三页'), ), SizedBox(height: 10), ElevatedButton( onPressed: () { Navigator.pop(context); }, child: Text('返回上一页'), ), ], ), ), ); } } class ThirdPage extends StatelessWidget { @override Widget build(BuildContext context) { return Scaffold( appBar: AppBar( title: Text('第三页'), ), body: Center( child: Column( mainAxisAlignment: MainAxisAlignment.center, children: [ Text( '第三页', style: TextStyle(fontSize: 24), ), SizedBox(height: 20), ElevatedButton( onPressed: () { Navigator.pushNamedAndRemoveUntil( context, '/', (route) => false, ); }, child: Text('返回首页'), ), ], ), ), ); } } class NotFoundPage extends StatelessWidget { @override Widget build(BuildContext context) { return Scaffold( appBar: AppBar( title: Text('页面未找到'), ), body: Center( child: Column( mainAxisAlignment: MainAxisAlignment.center, children: [ Icon( Icons.error_outline, size: 64, color: Colors.red, ), SizedBox(height: 16), Text( '404', style: TextStyle( fontSize: 48, fontWeight: FontWeight.bold, ), ), SizedBox(height: 8), Text( '页面未找到', style: TextStyle(fontSize: 18), ), SizedBox(height: 20), ElevatedButton( onPressed: () { Navigator.pushReplacementNamed(context, '/'); }, child: Text('返回首页'), ), ], ), ), ); } }

总结

Flutter 的导航系统提供了丰富的功能来构建流畅的应用导航体验。通过合理使用命名路由、自定义动画、路由守卫等技术，我们可以创建出既美观又实用的导航系统。

导航不仅仅是页面的切换，更是用户体验的引导。让我们用 Flutter 路由的强大能力，构建出令人惊叹的应用导航系统，展现前端技术的无限可能。

Read more

前端防范 XSS（跨站脚本攻击）

目录 一、防范措施 1.layui util  核心转义的特殊字符 示例 2.js-xss.js库 安装 1. Node.js 环境（npm/yarn） 2. 浏览器环境 核心 API 基础使用 1. 基础过滤（默认规则） 2. 自定义过滤规则 （1）允许特定标签 （2）允许特定属性 （3）自定义标签处理 （4）自定义属性处理 （5）转义特定字符 常见场景示例 1. 过滤用户输入的评论内容 2. 允许特定富文本标签（如富文本编辑器内容） 注意事项 更多配置 XSS（跨站脚本攻击）是一种常见的网络攻击手段，它允许攻击者将恶意脚本注入到其他用户的浏览器中。
详细教程：如何从前端查看调用接口、传参及返回结果（附带图片案例）

详细教程：如何从前端查看调用接口、传参及返回结果（附带图片案例）

目录 1. 打开浏览器开发者工具 2. 使用 Network 面板 3. 查看具体的API请求 a. Headers b. Payload c. Response d. Preview e. Timing 4. 实际操作步骤 5. 常见问题及解决方法 a. 无法看到API请求 b. 请求失败 c. 跨域问题（CORS） 作为一名后端工程师，理解前端如何调用接口、传递参数以及接收返回值是非常重要的。下面将详细介绍如何通过浏览器开发者工具（F12）查看和分析这些信息，并附带图片案例帮助你更好地理解。 1. 打开浏览器开发者工具 按下 F12 或右键点击页面选择“检查”可以打开浏览器的开发者工具。常用的浏览器如Chrome、Firefox等都内置了开发者工具。下面是我选择我的一篇文章，打开开发者工具进行演示。 2. 使用

Cursor+Codex隐藏技巧：用截图秒修前端Bug的保姆级教程（React/Chakra UI案例）

Cursor+Codex隐藏技巧：用截图秒修前端Bug的保姆级教程（React/Chakra UI案例） 前端开发中最令人头疼的莫过于那些难以定位的UI问题——元素错位、样式冲突、响应式失效...传统调试方式往往需要反复修改代码、刷新页面、检查元素。现在，通过Cursor编辑器集成的Codex功能，你可以直接用截图交互快速定位和修复这些问题。本文将带你从零开始，掌握这套革命性的调试工作流。 1. 环境准备与基础配置 在开始之前，确保你已经具备以下环境： * Cursor编辑器最新版（v2.5+） * Node.js 18.x及以上版本 * React 18项目（本文以Chakra UI 2.x为例） 首先在Cursor中安装Codex插件： 1. 点击左侧扩展图标 2. 搜索"Codex"并安装 3. 登录你的OpenAI账户（需要ChatGPT Plus订阅） 关键配置项： // 在项目根目录创建.