鸿蒙Flutter实战：分类管理页BottomSheet CRUD

●VON2026-05-30 0:00

前言

备忘录的分类是动态的------用户需要能跟自己的需求变化新增、重命名、删除分类。"工作"和"个人"是初始分类，但随着时间推移，可能需要增加"健身"、"读书笔记"、"旅行计划"等分类。

鸿蒙 Flutter 备忘录提供了一个完整的分类管理页面，支持新增（BottomSheet 输入）、编辑（重命名）和删除（确认对话框）。本文拆解分类管理的完整 CRUD 实现，重点放在 BottomSheet 交互和删除时的数据迁移逻辑。

项目仓库：todo_flutter_harmony

分类管理页整体布局

dart 复制代码 
class CategoryPage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('分类管理'),
      ),
      body: Consumer<CategoryProvider>(
        builder: (context, provider, _) {
          final categories = provider.categories;

          if (categories.isEmpty) {
            return Center(
              child: Column(
                mainAxisSize: MainAxisSize.min,
                children: [
                  Icon(Icons.folder_outlined, size: 64, color: Colors.grey.shade300),
                  const SizedBox(height: 12),
                  Text('暂无分类', style: TextStyle(color: Colors.grey.shade500)),
                  const SizedBox(height: 16),
                  FilledButton.icon(
                    onPressed: () => _showAddCategorySheet(context, provider),
                    icon: const Icon(Icons.add),
                    label: const Text('新建分类'),
                  ),
                ],
              ),
            );
          }

          return ListView.builder(
            itemCount: categories.length,
            itemBuilder: (context, index) {
              return _buildCategoryItem(context, categories[index], provider);
            },
          );
        },
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: () => _showAddCategorySheet(context,
            context.read<CategoryProvider>()),
        child: const Icon(Icons.add),
      ),
    );
  }

新增分类：BottomSheet

新增分类不使用全屏页面导航，而是用 showModalBottomSheet------这是一个从底部弹出的半屏面板，交互更轻量：

dart 复制代码 
void _showAddCategorySheet(BuildContext context, CategoryProvider provider,
    {MemoCategory? existingCategory}) {
  final nameController = TextEditingController(text: existingCategory?.name ?? '');
  final emojiController = TextEditingController(text: existingCategory?.icon ?? '📋');
  final isEditing = existingCategory != null;

  showModalBottomSheet(
    context: context,
    isScrollControlled: true,  // 键盘弹出时 BottomSheet 跟着上移
    shape: const RoundedRectangleBorder(
      borderRadius: BorderRadius.vertical(top: Radius.circular(20)),
    ),
    builder: (ctx) {
      return Padding(
        padding: EdgeInsets.only(
          left: 20,
          right: 20,
          top: 20,
          bottom: MediaQuery.of(ctx).viewInsets.bottom + 20,  // 为键盘留空间
        ),
        child: Column(
          mainAxisSize: MainAxisSize.min,
          crossAxisAlignment: CrossAxisAlignment.stretch,
          children: [
            // 拖拽指示条
            Center(
              child: Container(
                width: 40,
                height: 4,
                decoration: BoxDecoration(
                  color: Colors.grey.shade300,
                  borderRadius: BorderRadius.circular(2),
                ),
              ),
            ),
            const SizedBox(height: 20),
            Text(
              isEditing ? '编辑分类' : '新建分类',
              style: const TextStyle(fontSize: 18, fontWeight: FontWeight.bold),
            ),
            const SizedBox(height: 20),
            // Emoji 输入
            TextField(
              controller: emojiController,
              maxLength: 2,
              decoration: const InputDecoration(
                labelText: '图标 (Emoji)',
                border: OutlineInputBorder(),
                counterText: '',
              ),
            ),
            const SizedBox(height: 16),
            // 分类名称输入
            TextField(
              controller: nameController,
              autofocus: true,
              decoration: InputDecoration(
                labelText: '分类名称',
                border: const OutlineInputBorder(),
                errorText: _validateName(nameController.text),
              ),
            ),
            const SizedBox(height: 20),
            // 确认按钮
            FilledButton(
              onPressed: () {
                final name = nameController.text.trim();
                if (name.isEmpty) return;

                if (isEditing) {
                  provider.updateCategory(
                    existingCategory!.copyWith(name: name, icon: emojiController.text),
                  );
                } else {
                  provider.addCategory(MemoCategory(
                    name: name,
                    icon: emojiController.text.isNotEmpty ? emojiController.text : '📋',
                    sortOrder: provider.categories.length,
                  ));
                }

                Navigator.pop(ctx);
              },
              child: Text(isEditing ? '保存' : '创建'),
            ),
            const SizedBox(height: 8),
          ],
        ),
      );
    },
  );
}

关键细节：

  1. isScrollControlled: true：让 BottomSheet 在键盘弹出时自动上移，输入框不会被键盘遮挡
  2. MediaQuery.of(ctx).viewInsets.bottom：底部 padding 动态跟随键盘高度
  3. 拖拽指示条：顶部一个 40×4 的灰色小横条，暗示 BottomSheet 可以下拉关闭
  4. autofocus: true：打开 BottomSheet 后键盘自动弹出，聚焦到名称输入框
  5. 同一组件处理新增和编辑 ：通过 isEditing 参数区分

编辑分类

编辑复用同一个 BottomSheet，传入 existingCategory 参数即可：

dart 复制代码 
Widget _buildCategoryItem(
    BuildContext context, MemoCategory category, CategoryProvider provider) {
  return ListTile(
    leading: Text(category.icon, style: const TextStyle(fontSize: 24)),
    title: Text(category.name),
    trailing: PopupMenuButton<String>(
      onSelected: (value) {
        switch (value) {
          case 'edit':
            _showAddCategorySheet(context, provider, existingCategory: category);
            break;
          case 'delete':
            _confirmDeleteCategory(context, provider, category);
            break;
        }
      },
      itemBuilder: (ctx) => [
        const PopupMenuItem(value: 'edit', child: Text('编辑')),
        const PopupMenuItem(value: 'delete', child: Text('删除')),
      ],
    ),
  );
}

删除分类 + 数据迁移

删除分类时有一个关键问题：该分类下的备忘录怎么办？粗暴的做法是直接删除关联备忘录，但这对用户来说是数据丢失。更好的做法是：将关联的备忘录迁移到"未分类"（即 categoryId = null）。

dart 复制代码 
void _confirmDeleteCategory(
    BuildContext context, CategoryProvider provider, MemoCategory category) {
  showDialog(
    context: context,
    builder: (ctx) => AlertDialog(
      title: const Text('删除分类'),
      content: Text(
        '确定要删除「${category.name}」分类吗？\n\n该分类下的备忘录将被移至"未分类"。',
      ),
      actions: [
        TextButton(
          onPressed: () => Navigator.pop(ctx),
          child: const Text('取消'),
        ),
        TextButton(
          onPressed: () async {
            await provider.deleteCategory(category.id!);
            if (ctx.mounted) {
              Navigator.pop(ctx);
              ScaffoldMessenger.of(context).showSnackBar(
                SnackBar(content: Text('已删除分类「${category.name}」')),
              );
            }
          },
          style: TextButton.styleFrom(foregroundColor: Colors.red),
          child: const Text('删除'),
        ),
      ],
    ),
  );
}

Provider 中的删除逻辑负责数据迁移：

dart 复制代码 
Future<void> deleteCategory(int id) async {
  // 1. 将该分类下的所有备忘录设为"未分类"
  final db = DatabaseHelper.instance;
  final memos = await db.getAllMemos();
  for (final memo in memos) {
    if (memo.categoryId == id) {
      await db.updateMemo(memo.copyWith(categoryId: null));
    }
  }

  // 2. 删除分类本身
  await db.deleteCategory(id);

  // 3. 如果当前筛选器选中该分类，回退到"全部"
  if (_selectedCategoryId == id) {
    _selectedCategoryId = null;
  }

  // 4. 重新加载
  await loadCategories();
  // 注意：需要通知 MemoProvider 也重新加载
}

重名检测

新增分类时应检测同名：

dart 复制代码 
String? _validateName(String name, CategoryProvider provider,
    {MemoCategory? exclude}) {
  if (name.trim().isEmpty) return '名称不能为空';

  final exists = provider.categories.any((c) =>
    c.name.trim().toLowerCase() == name.trim().toLowerCase() &&
    c.id != exclude?.id  // 编辑时排除自身
  );

  if (exists) return '该分类名称已存在';
  return null;
}

CategoryProvider 完整接口

dart 复制代码 
class CategoryProvider extends ChangeNotifier {
  List<MemoCategory> _categories = [];

  List<MemoCategory> get categories => List.unmodifiable(_categories);

  Future<void> loadCategories() async {
    _categories = await DatabaseHelper.instance.getAllCategories();
    _categories.sort((a, b) => a.sortOrder.compareTo(b.sortOrder));
    notifyListeners();
  }

  Future<void> addCategory(MemoCategory category) async {
    await DatabaseHelper.instance.insertCategory(category);
    await loadCategories();
  }

  Future<void> updateCategory(MemoCategory category) async {
    await DatabaseHelper.instance.updateCategory(category);
    await loadCategories();
  }

  Future<void> deleteCategory(int id) async {
    // 迁移关联备忘录到"未分类"
    final db = DatabaseHelper.instance;
    final memos = await db.getAllMemos();
    for (final memo in memos) {
      if (memo.categoryId == id) {
        await db.updateMemo(memo.copyWith(categoryId: null));
      }
    }
    await db.deleteCategory(id);
    await loadCategories();
  }
}

鸿蒙兼容性

  • showModalBottomSheet：Material 组件，Flutter 框架层实现
  • MediaQuery.viewInsets：Flutter 框架从引擎获取键盘高度信息------这在鸿蒙上依赖 flutter_ohos 引擎正确报告键盘状态
  • 数据迁移逻辑：纯 Dart 代码，与平台无关

如果鸿蒙引擎在键盘高度报告上有不准确的情况，viewInsets.bottom 可能不会是期望的值。这可以通过在 OHOS 端 EntryAbility 中做额外处理来修正。

总结

分类管理的 CRUD 实现关键点：

  1. 新增/编辑 ：showModalBottomSheet + isScrollControlled，轻量半屏交互
  2. 删除：确认对话框 + 关联数据迁移到"未分类"，防止数据丢失
  3. 重名检测：大小写不敏感的字符串比较
  4. BottomSheet 键盘适配 ：viewInsets.bottom 动态调整底部间距

完整项目代码见：todo_flutter_harmony

相关推荐
Cosolar42 分钟前
Chroma向量库面试学习指南
数据库·人工智能·面试·职场和发展·数据库架构
企服AI产品测评局2 小时前
Agent适配信创环境实测：企业级自动化如何实现国产操作系统与数据库全兼容？
运维·数据库·人工智能·ai·chatgpt·自动化
cfm_29142 小时前
Redis数据安全性解析
数据库·redis·缓存
DIY源码阁2 小时前
JavaSwing学生成绩管理系统 - MySQL版
java·数据库·mysql·eclipse
NiceCloud喜云4 小时前
Claude Code Routines 实战：三种触发器跑通云端自动化编码
android·运维·数据库·人工智能·自动化·json·飞书
辞忧九千七4 小时前
Redis 单机一主二从主从复制完整搭建指南
数据库·redis·缓存
lzhdim4 小时前
SQL 入门 16：SQL 事务隔离级别与死锁解析（易懂）
数据库·sql
GitCode官方4 小时前
开源鸿蒙 PC 直播回顾｜从环境搭建到真机验证：鸿蒙 PC 命令行迁移全链路。
华为·开源·harmonyos
热门推荐
01GitHub 镜像站点02DeepSeek V4 + Claude Code thinking mode 400 错误修复方案03Codex 接入 DeepSeek API 完整配置文档04【踩坑记录 | 第一篇】微软商店无法使用时，如何手动安装 OpenAI Codex？附`.msix`文件系统错误解决方法05【AI】2026 年具身智能模型和世界模型总结06CC-Switch & Claude 基于 Linux 服务器安装使用指南07裂开！ChatGPT 居然开始要手机号验证，附详细解决方法08CC-Switch 全平台下载、安装与使用全指南（Windows/macOS/Linux）09API Key 登录 Codex 也能用插件了，还支持会话删除和导出102026年AI编程工具终极横评：Cursor vs Claude Code vs Copilot