import 'package:flutter/material.dart'; /// 胶囊样式全局 Toast:体积小、大圆角、清爽,数秒后自动消失。 /// 通过根 Overlay 展示,不依赖调用方 BuildContext 和 Navigator, /// 适用于页面销毁(dispose)后仍需弹出提示的场景。 class CapsuleToast { static OverlayEntry? _entry; static bool _showing = false; /// 显示胶囊提示 /// [message] 提示文案 /// [duration] 显示时长,默认 2 秒 /// [showCheck] 是否显示对勾图标 static void show( String message, { Duration duration = const Duration(seconds: 2), bool showCheck = true, }) { // 从根 Element 向下遍历子树,查找第一个 OverlayState // (Overlay 是根的子节点,不能用 findAncestorStateOfType 向上找), // 无需依赖调用方 context,页面销毁后也能正常弹出。 final root = WidgetsBinding.instance.rootElement; if (root == null) return; final overlay = _findOverlayState(root); if (overlay == null) { debugPrint('💊 [CapsuleToast] 未找到 Overlay,无法弹出: $message'); return; } debugPrint('💊 [CapsuleToast] 弹出: $message'); // 延到下一帧再插入:页面退出(dispose)瞬间 Overlay 可能正在重建, // 直接插入可能随旧页面一起被销毁。 WidgetsBinding.instance.addPostFrameCallback((_) { _insertEntry(message, overlay, duration: duration, showCheck: showCheck); }); } /// 真正插入 OverlayEntry static void _insertEntry( String message, OverlayState overlay, { required Duration duration, required bool showCheck, }) { if (!overlay.mounted) return; // 有新的提示时先移除旧的 if (_showing) { _entry?.remove(); _showing = false; } _entry = OverlayEntry( builder: (context) => IgnorePointer( child: SafeArea( child: Align( alignment: Alignment.topCenter, child: Container( margin: const EdgeInsets.only(top: 64), padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 8), decoration: BoxDecoration( color: const Color(0xE62C2C2C), borderRadius: BorderRadius.circular(100), boxShadow: [ BoxShadow( color: Colors.black.withValues(alpha: 0.15), blurRadius: 8, offset: const Offset(0, 2), ), ], ), child: Row( mainAxisSize: MainAxisSize.min, children: [ if (showCheck) ...[ const Icon( Icons.check_circle, size: 14, color: Color(0xFF4CD964), ), const SizedBox(width: 6), ], Text( message, style: const TextStyle( color: Colors.white, fontSize: 13, fontWeight: FontWeight.w500, ), ), ], ), ), ), ), ), ); overlay.insert(_entry!); _showing = true; Future.delayed(duration, () { if (_showing) { _entry?.remove(); _showing = false; } }); } /// 从指定 Element 开始深度优先遍历子树,找到第一个 OverlayState static OverlayState? _findOverlayState(Element root) { OverlayState? result; void visitor(Element element) { if (result != null) return; if (element is StatefulElement && element.state is OverlayState) { result = element.state as OverlayState; return; } element.visitChildElements(visitor); } root.visitChildElements(visitor); return result; } }