开发记录

StoreX 桌面 重构
January 6, 2026
2 min read
By devshan

Table of Contents

This is a list of all the sections in this post. Click on any of them to jump to that section.

”# 文件列表交互简化：从双击打开到单击进入的重构

背景

在桌面端文件列表中，我们之前实现了类似桌面端文件管理器的双击打开机制：

  • 单击：在多选模式下切换选中状态
  • 双击：打开文件/进入文件夹

这种设计增加了不必要的复杂性，使用上需要双击才能打开文件，与移动端单击打开的体验不一致。根据我这边用的时候发现，这种刻意模拟桌面端双击的行为意义不大，应该简化为统一的单击进入机制。

重构目标

  1. 统一桌面端和移动端的文件列表交互：单击进入文件/文件夹
  2. 移除复杂的双击逻辑，简化代码结构
  3. 提升使用体验一致性

技术方案

1. 组件接口重构

FileTableView 组件

  • 移除 onDoubleTap 回调参数
  • 保留 onTap 回调，用于单击打开文件/文件夹

_FileTableRow 组件

  • 移除 onDoubleTap 回调参数
  • 在 GestureDetector 中移除 onDoubleTap 处理

2. 交互逻辑简化

桌面端文件列表

  • 原逻辑：onTap 调用 _handleDesktopClick（多选模式下切换选中，非多选模式下无操作），onDoubleTap 调用 _handleFileTap（打开文件/进入文件夹）
  • 新逻辑：onTap 直接调用 _handleFileTap（打开文件/进入文件夹），移除双击逻辑

实施过程

第一步：修改 FileTableView 接口

  1. 移除 onDoubleTap 参数声明
  2. 更新组件构造函数参数列表

第二步：修改 _FileTableRow 组件

  1. 移除 onDoubleTap 参数声明
  2. 从 GestureDetector 中移除 onDoubleTap 属性

第三步：更新 FileTableView 使用逻辑

  1. 在 FileTableView 中，onTap 直接调用传入的 onTap 回调
  2. 移除对 onDoubleTap 的调用

第四步：修改 files_page.dart

  1. 移除对 onDoubleTap 的传入
  2. 将 onTap 直接连接到 _handleFileTap
  3. 删除 _handleDesktopClick 方法

代码变更详情

file_tiles.dart 变更

  1. 移除 FileTableView 中的 onDoubleTap 参数
  2. 移除 _FileTableRow 中的 onDoubleTap 参数
  3. 从 GestureDetector 中移除 onDoubleTap 处理
  4. 更新注释，从 “响应单击选中、双击打开” 改为 “响应单击打开”

files_page.dart 变更

  1. 移除 onDoubleTap 参数传入
  2. 将 onTap 从 _handleDesktopClick 改为 _handleFileTap
  3. 删除 _handleDesktopClick 方法

验证结果

执行 flutter analyze 验证代码：

  • 无编译错误
  • 无类型问题
  • 代码逻辑清晰

使用体验改进

  1. 交互一致性：桌面端和移动端都使用单击进入，使用体验一致
  2. 操作简化：无需学习双击操作，降低使用复杂度
  3. 代码简化：移除了不必要的双击逻辑，代码更简洁易维护

设计决策

选择移除双击逻辑而非保留，基于以下考虑：

  1. 与移动端交互保持一致，降低学习成本
  2. 简化代码结构，减少维护复杂度
  3. 避免模拟桌面端双击行为的复杂逻辑
  4. 单击进入是更直观的操作方式