跨平台开发 / 系统课时

用 Dialog 处理确认操作

用 Dialog 处理确认操作

本篇学习如何使用 Flutter 的 Dialog 完成删除确认、风险提示等模态交互,让用户在执行重要操作前获得明确反馈,并保持页面流程清晰。

学习目标

  • 理解 Dialog 在 Flutter 中的使用场景。
  • 掌握创建确认弹窗和处理用户选择结果的方法。
  • 能将弹窗交互接入实际业务按钮。

Dialog 解决什么问题

当操作具有不可逆风险,例如删除数据、退出账号或提交重要配置时,直接执行会增加误操作概率。Dialog 可以暂时阻断当前页面流程,让用户明确选择继续还是取消。

Flutter 中常用 showDialog 打开模态弹窗,并通过返回值获取用户选择。

创建确认弹窗

下面示例展示一个删除确认流程,用户点击确认后返回 true,取消返回 false。在已有 Flutter 项目中将它保存为 lib/main.dart,即可运行。页面中的“演示条目”是内存数据,重启应用会恢复;没有隐藏的 deleteItem 方法或后端依赖。

dart
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('暂无条目'),
      ),
    );
  }
}

预期结果

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 文档。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 Dialog 处理确认操作

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通