跨平台开发 / 系统课时
用 Dialog 处理确认操作
用 Dialog 处理确认操作
本篇学习如何使用 Flutter 的 Dialog 完成删除确认、风险提示等模态交互,让用户在执行重要操作前获得明确反馈,并保持页面流程清晰。
学习目标
- 理解 Dialog 在 Flutter 中的使用场景。
- 掌握创建确认弹窗和处理用户选择结果的方法。
- 能将弹窗交互接入实际业务按钮。
Dialog 解决什么问题
当操作具有不可逆风险,例如删除数据、退出账号或提交重要配置时,直接执行会增加误操作概率。Dialog 可以暂时阻断当前页面流程,让用户明确选择继续还是取消。
Flutter 中常用 showDialog 打开模态弹窗,并通过返回值获取用户选择。
创建确认弹窗
下面示例展示一个删除确认流程,用户点击确认后返回 true,取消返回 false。在已有 Flutter 项目中将它保存为 lib/main.dart,即可运行。页面中的“演示条目”是内存数据,重启应用会恢复;没有隐藏的 deleteItem 方法或后端依赖。
import 'package:flutter/material.dart';
void main() => runApp(const MaterialApp(home: ConfirmPage()));
Future<bool?> showDeleteDialog(BuildContext context) {
return showDialog<bool>(
context: context,
builder: (dialogContext) {
return AlertDialog(
title: const Text('删除数据'),
content: const Text('删除后无法恢复,是否继续?'),
actions: [
TextButton(
onPressed: () => Navigator.of(dialogContext).pop(false),
child: const Text('取消'),
),
FilledButton(
onPressed: () => Navigator.of(dialogContext).pop(true),
child: const Text('删除'),
),
],
);
},
);
}
class ConfirmPage extends StatefulWidget {
const ConfirmPage({super.key});
@override
State<ConfirmPage> createState() => _ConfirmPageState();
}
class _ConfirmPageState extends State<ConfirmPage> {
bool _exists = true;
bool _asking = false;
Future<void> _confirmDelete() async {
// 防止快速点击叠出多个确认窗口。
if (_asking || !_exists) return;
setState(() => _asking = true);
final confirmed = await showDeleteDialog(context);
if (!mounted) return;
setState(() {
_asking = false;
if (confirmed == true) _exists = false;
});
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: const Text('确认删除')),
body: Center(
child: _exists
? Column(
mainAxisSize: MainAxisSize.min,
children: [
const Text('演示条目'),
FilledButton(
onPressed: _asking ? null : _confirmDelete,
child: const Text('删除'),
),
],
)
: const Text('暂无条目'),
),
);
}
}预期结果
调用 showDeleteDialog 后显示确认弹窗。
点击取消返回 false。
点击删除返回 true。
确认后页面变为“暂无条目”;取消或点击遮罩时条目保留。在按钮操作中处理结果
弹窗本身只负责收集用户选择,实际业务动作应该由调用方决定。上面的 _confirmDelete 先等待结果,再更新条目状态,因此取消不会触碰数据。_asking 在等待期间禁用入口,避免同一操作弹出两层窗口;等待结束后恢复按钮,不把取消误判为错误。
返回值必须按三种情况理解:true 表示确认,false 表示取消,null 表示没有显式结果。默认允许点击遮罩关闭,因此只在 confirmed == true 时执行删除。如果确实不能通过遮罩关闭,可设置 barrierDismissible: false,但这不等于自动禁用了所有平台返回操作;有更严格需求时应单独设计返回键策略并验收。
异步操作怎样接回页面
打开弹窗后,调用页面可能因导航被移除。Future 完成时先检查 mounted,才能调用 setState 或使用页面 context;判断结果为 true 与判断页面仍存活解决的是两件事,不能省掉其中一个。
真实删除还包含网络请求。顺序应是“确认、请求、成功后移除条目”,失败时保留条目并显示可理解的错误。请求期间继续禁用操作入口;若后端支持幂等键,应把它用于同一次删除请求的重试。仅在客户端关掉按钮无法防止超时重试在服务端重复执行。
弹窗内的关闭按钮使用 dialogContext,明确关闭弹窗所在路由。如果页面拥有嵌套 Navigator,showDialog 默认使用根 Navigator,关闭时也应对应到同一层。不要用已经销毁的弹窗 context 去显示后续 SnackBar;应在调用页面仍然 mounted 时使用页面的 context。
使用 Dialog 时的注意事项
确认弹窗应该用于需要用户决策的场景,而不是普通提示。频繁弹窗会打断操作流程,降低使用体验。
对于简单信息展示可以使用其他组件,例如 SnackBar。对于复杂表单或多步骤操作,则可以考虑底部面板或独立页面,避免 Dialog 内容过于拥挤。
验收时分别测试确认、取消、点击遮罩和快速连点。确认只移除一条数据,其他关闭方式均保留条目;快速连点只出现一个窗口。弹窗返回值、context 与 Navigator 的规则见 Flutter showDialog 文档。