背景:我所开发的应用是一个点餐的平板应用,有着大量从左边或右边打开 drawer 的场景,最终完成的效果如上图所示
默认的 drawer 组件
flutter 默认的 drawer 是集成在
Scaffold
组件上的,简单代码示例如下:Scaffold( drawer: Widget, // 从左边弹起一个抽屉 endDrawer: Widget, // 从右边弹起一个抽屉 );
- 关闭该抽屉可使用
Navigator.pop(context);
,从此可以看出打开 Drawer 其实是打开了一个新的路由页面 除了使用上述 Navigator 的方式关闭抽屉,还有下面两种方法参考自这里,这两种方法的原理都是通过获取
ScaffoldState
对象然后调用其内部的 open、close 方法进行操作,下面是代码演示查找父级最近的 Scaffold 对应的
ScaffoldState
对象ScaffoldState _state = context.findAncestorStateOfType<ScaffoldState>()!; // 打开抽屉菜单 _state.openDrawer(); // 或者直接使用 Scaffold.of(contenxt) 在 Flutter 开发中便有了一个默认的约定:如果 StatefulWidget 的状态是希望暴露出的, 应当在 StatefulWidget 中提供一个`of` 静态方法来获取其 State 对象, 开发者便可直接通过该方法来获取;如果 State不希望暴露,则不提供`of`方法
借助 GlobalKey 来获取
ScaffoldState
对象(我下面的自定义 drawer 就是借助这种方式),代码演示如下:// 定义一个globalKey, 由于GlobalKey要保持全局唯一性,我们使用静态变量存储 static GlobalKey<ScaffoldState> _globalKey= GlobalKey(); Scaffold( key: _globalKey , //设置key ... ) // 然后就可以这样打开 drawer 了 _globalKey.currentState.openDrawer()
上面的默认 drawer 使用方式介绍完了,很容易发现这种方式必须依赖
Scaffold
,但通常一个路由页面只有一个 Scaffold 而且是在最外层,况且他只能接收一个 drawer (当然可以通过条件判断来展示多个 drawer),如果是页面中打开 drawer 的场景特别多的话,使用起来就会特别麻烦,所以我写了一个自定义的 drawer 组件
自定义 Drawer - RDrawer
- 基本思路是参考这篇文章,从上面的分析中我们得出打开一个 drawer 其实就是打开一个新的路由页面(页面背景是透明的可以看到上一个页面的内容,flutter 里面的
showDialog
,bottomSheet
都是这种处理) 先说一下 RDrawer 的使用方法
// 打开drawer ElevatedButton(onPressed: () => RDrawer.open(Widget child)); // 关闭drawer ElevatedButton(onPressed: () => RDrawer.close()); // 此处 child 组件可根据自己的 UI 图封装一个包含 title、body、footer 的 DrawerBody 组件,让外界更方便使用 // 打开和关闭动作可以在任意地方使用不必依赖 Scaffold
实现思路
- 分析: 打开、关闭路由页面,抽屉打开、关闭时的动画(如果不考虑抽屉动画就会变得非常简单和 showDialog 没啥两样)
打开一个新的路由页面主要依赖这个 Widget
PageRouteBuilder
,从 chatgpt 上知道他有这么多属性(感叹一下 chatgpt 真是一个神器呀)Flutter 的 `PageRouteBuilder` 是一个用于自定义页面过渡动画的小部件,它可以让开发者根据自己的需求创建各种自定义过渡动画。以下是 `PageRouteBuilder` 中可用的参数: - `pageBuilder`: 必须提供一个 `WidgetBuilder` 函数,用于构建将要过渡到的页面。 - `transitionDuration`: 定义页面过渡的持续时间,类型为 `Duration`。 - `reverseTransitionDuration`: 定义页面返回时的过渡持续时间,类型为 `Duration`。 - `transitionsBuilder`: 定义过渡动画的方式,接受一个 `Widget` 和一个 `Animation<double>` 参数,返回一个 `Widget`。 - `opaque`: 定义页面是否不透明,默认值为 `true`。 - `barrierDismissible`: 定义点击遮罩区域是否可以关闭页面,默认值为 `false`。 - `barrierColor`: 定义遮罩区域的颜色,默认值为半透明黑色。 - `barrierLabel`: 定义遮罩区域的语义标签,默认值为 `null`。 - `maintainState`: 定义页面是否保持在内存中,默认值为 `true`。 - `fullscreenDialog`: 定义页面是否是全屏对话框,默认值为 `false`。 这些参数可以帮助开发者创建各种自定义过渡动画,并控制页面过渡的各个方面,例如过渡时间、透明度、遮罩等。
- 打开一个新的页面
Navigator.of(Get.context!).push(PageRouteBuilder(...))
- 关闭一个新的新页面
Navigator.pop(context);
其实如果不考虑抽屉动画现在的工作已经完成了,但 drawer 怎么可能没有动画,动画借助
AnimateBuilder
实现,利用 Tween 自定义一个动画@override void initState() { super.initState(); controller = AnimationController( duration: const Duration(milliseconds: 300), vsync: this, ); // drawer 宽度为 563,动画是借助 Stack 让其从 -563 的位置到 0 animation = Tween<double>(begin: -563, end: 0).animate( CurvedAnimation(parent: controller, curve: Curves.easeInOut), ); controller.forward(); }
动画的启动时机是 initState 时这个不需要特殊处理,drawer关闭时机却要需要等动画完成时在执行
Navigator.pop(context);
这个地方处理就麻烦一点,大概思路是这样void close() { controller.reverse().then((value) { Navigator.pop(context); }); }
但是这个 close 方法是写在
DrawerState
对象里面外界无法访问到,这时候就需要借助上文提到的 GlobalKey了,来让外界能访问到 close 方法,大概代码如下:// 创建一个类型为 DrawerState 的 GlobalKey static final GlobalKey<DrawerState> drawerStateKey = GlobalKey<DrawerState>(); /// 打开 drawer static open(Widget child) { Navigator.of(Get.context!).push( PageRouteBuilder( // ... 参数省略 pageBuilder: (_, __, ___) => RDrawer(key: drawerStateKey, child: child), ), ); } /// 通过 drawerStateKey 来关闭 drawer static close() => drawerStateKey.currentState?.close();
完整代码如下
enum DrawerDirEnum { left, right } /// Drawer 核心组件 class RDrawer extends StatefulWidget { /// drawer宽度 final double width; /// 展开方向 final DrawerDirEnum dir; /// 点击遮罩层是否允许关闭 final bool? maskClose; /// drawer 内容,此处可在封装一个 DrawerBody 来定制自己的样式,更方便使用 final Widget child; const RDrawer({ super.key, required this.child, this.width = 536, this.dir = DrawerDirEnum.right, this.maskClose = false, }); // 定义用于访问 state 对象的 key static final GlobalKey<DrawerState> drawerStateKey = GlobalKey<DrawerState>(); /// 打开 drawer static open( Widget child, { DrawerDirEnum? dir = DrawerDirEnum.right, double? width = 536, bool? maskClose = false, }) { Navigator.of(Get.context!).push( // 具体参数含义上文已介绍过 PageRouteBuilder( opaque: false, transitionDuration: const Duration(milliseconds: 300), barrierColor: const Color.fromRGBO(0, 0, 0, 0.7), fullscreenDialog: true, pageBuilder: (_, __, ___) => RDrawer( // 很重要:绑定 globalKey 以是 DrawerState 能被外界访问到 key: drawerStateKey, width: width!, dir: dir!, maskClose: maskClose!, child: child, ), ), ); } /// 关闭 drawer static close() => drawerStateKey.currentState?.close(); @override State<RDrawer> createState() => DrawerState(); } /// Drawer 核心逻辑 class DrawerState extends State<RDrawer> with SingleTickerProviderStateMixin { late AnimationController controller; late Animation<double> animation; @override void initState() { super.initState(); controller = AnimationController( duration: const Duration(milliseconds: 300), vsync: this, ); animation = Tween<double>(begin: -widget.width, end: 0).animate( CurvedAnimation(parent: controller, curve: Curves.easeInOut), ); controller.forward(); } /// 关闭 drawer void close() { // 待抽屉动画完成后在关闭页面 controller.reverse().then((value) { Navigator.pop(context); }); } @override Widget build(BuildContext context) { return Stack( children: [ // 为了实现 drawer 关闭动画不能直接借助 barrierDismissible 来控制点击遮罩层 GestureDetector(onTap: () => widget.maskClose! ? close() : null), AnimatedBuilder( animation: animation, builder: (BuildContext context, Widget? child) { return Positioned( top: 0, bottom: 0, right: widget.dir == DrawerDirEnum.right ? animation.value : null, left: widget.dir == DrawerDirEnum.left ? animation.value : null, child: SizedBox(width: widget.width, child: widget.child), ); }, ), ], ); } @override void dispose() { controller.dispose(); super.dispose(); } }