跨平台开发 / 系统课时

显示 SnackBar 和对话框反馈

显示 SnackBar 和对话框反馈

本节学习如何在 Flutter 应用中向用户反馈操作结果,以及在执行关键操作前展示确认提示。你将使用 ScaffoldMessenger 和 showDialog 实现常见的成功提示、错误提示和确认交互。

学习目标

  • 理解 SnackBar 和 Dialog 在交互反馈中的职责区别。
  • 掌握 ScaffoldMessenger 显示临时消息的方法。
  • 掌握 showDialog 创建确认弹窗的基本流程。

使用 SnackBar 提供轻量反馈

SnackBar 适合展示不会打断当前操作流程的信息,例如保存成功、网络失败或撤销提示。它通常由 ScaffoldMessenger 管理,而不是直接通过 Scaffold 获取状态。

下面示例展示点击按钮后显示操作结果:

dart
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('保存'),
            ),
          ),
        ),
      ),
    );
  }
}

预期输出

text
点击“保存”按钮后,页面底部出现“保存成功”的 SnackBar 提示。

使用 Dialog 请求用户确认

Dialog 适合需要用户明确选择的场景,例如删除数据、退出登录或提交不可逆操作。与 SnackBar 不同,Dialog 会阻塞当前交互,直到用户完成选择。

下面是片段示例:用它替换上面完整应用中按钮的 onPressed 回调,并将按钮文字改为“删除”。它沿用 Builder 提供的页面 context,演示等待弹窗结果后再显示反馈;示例只显示消息,不会删除真实数据。

dart
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('已确认删除(演示)')));
  },

预期结果

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。

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

目录与阅读设置

阅读设置

17

记录一个想法

显示 SnackBar 和对话框反馈

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

登录哪都通