跨平台开发 / 系统课时
显示 SnackBar 和对话框反馈
显示 SnackBar 和对话框反馈
本节学习如何在 Flutter 应用中向用户反馈操作结果,以及在执行关键操作前展示确认提示。你将使用 ScaffoldMessenger 和 showDialog 实现常见的成功提示、错误提示和确认交互。
学习目标
- 理解 SnackBar 和 Dialog 在交互反馈中的职责区别。
- 掌握 ScaffoldMessenger 显示临时消息的方法。
- 掌握 showDialog 创建确认弹窗的基本流程。
使用 SnackBar 提供轻量反馈
SnackBar 适合展示不会打断当前操作流程的信息,例如保存成功、网络失败或撤销提示。它通常由 ScaffoldMessenger 管理,而不是直接通过 Scaffold 获取状态。
下面示例展示点击按钮后显示操作结果:
import 'package:flutter/material.dart';
void main() {
runApp(const FeedbackApp());
}
class FeedbackApp extends StatelessWidget {
const FeedbackApp({super.key});
@override
Widget build(BuildContext context) {
return MaterialApp(
home: Scaffold(
appBar: AppBar(title: const Text('反馈示例')),
body: Center(
child: Builder(
builder: (context) => ElevatedButton(
onPressed: () {
ScaffoldMessenger.of(context).showSnackBar(
const SnackBar(content: Text('保存成功')),
);
},
child: const Text('保存'),
),
),
),
),
);
}
}预期输出
点击“保存”按钮后,页面底部出现“保存成功”的 SnackBar 提示。使用 Dialog 请求用户确认
Dialog 适合需要用户明确选择的场景,例如删除数据、退出登录或提交不可逆操作。与 SnackBar 不同,Dialog 会阻塞当前交互,直到用户完成选择。
下面是片段示例:用它替换上面完整应用中按钮的 onPressed 回调,并将按钮文字改为“删除”。它沿用 Builder 提供的页面 context,演示等待弹窗结果后再显示反馈;示例只显示消息,不会删除真实数据。
onPressed: () async {
final confirmed = await showDialog<bool>(
context: context,
builder: (dialogContext) => AlertDialog(
title: const Text('删除确认'),
content: const Text('确定删除这条数据吗?'),
actions: [
TextButton(
onPressed: () => Navigator.of(dialogContext).pop(false),
child: const Text('取消'),
),
TextButton(
onPressed: () => Navigator.of(dialogContext).pop(true),
child: const Text('删除'),
),
],
),
);
// await 期间页面可能被移除;只有明确确认才继续。
if (!context.mounted || confirmed != true) return;
ScaffoldMessenger.of(context)
..hideCurrentSnackBar()
..showSnackBar(const SnackBar(content: Text('已确认删除(演示)')));
},预期结果
调用 showDialog 后显示确认窗口。
点击取消返回 false,点击删除返回 true。
点击删除后,页面底部显示“已确认删除(演示)”。
点击遮罩关闭弹窗时不会显示确认消息。选择合适的反馈方式
| 场景 | 推荐组件 |
|---|---|
| 保存成功、提示失败 | SnackBar |
| 需要用户确认 | Dialog |
| 展示短暂状态变化 | SnackBar |
| 防止误操作 | Dialog |
实际开发中应避免滥用弹窗。普通状态变化使用 SnackBar 即可,只有影响数据或流程的重要决定才需要 Dialog。
返回结果和页面生命周期的边界
showDialog<bool> 返回的类型是 Future<bool?>。取消按钮可以主动返回 false,点击默认可关闭的遮罩时可能没有返回值,因此必须使用 confirmed == true 作为执行条件。不要把“不是 false”当作确认,否则 null 也可能误触发业务操作。
弹窗有自己的路由。示例用 dialogContext 关闭弹窗,再用仍然有效的页面 context 显示 SnackBar;如果页面含嵌套 Navigator,还应核对打开和关闭使用的是同一层 Navigator。异步等待后检查 mounted,解决的是页面已退出的问题;它不代表网络请求成功。真实删除接口应等待服务端返回成功后再提示“删除成功”,请求失败时保留数据并给出重试入口。
连续点击保存会让 SnackBar 排队。对于“当前一次保存结果”这种会过时的消息,可先关闭当前消息再展示最新结果;对于每条都必须读到的通知,则应考虑持久的页面提示。需要“撤销”时要同时设计数据恢复逻辑,SnackBar 上出现一个按钮并不会自动撤销数据库中的变更。
可用三个动作验收:点击取消时数据保持不变;点击确认时只执行一次操作;弹窗打开后退出当前页面,关闭弹窗不应触发已销毁页面上的 setState 或 context 调用。返回值与生命周期规则见 showDialog 和 BuildContext.mounted。