DooTask 项目视图切换详解:看板 / 列表 / 甘特图三视图的 menuType 机制与持久化实现
DooTask 项目视图切换详解:看板 / 列表 / 甘特图三视图的 menuType 机制与持久化实现
本文基于 DooTask 的 AI 知识库条目 切换看板 / 列表 / 甘特图视图 展开,讲清楚项目详情页右上角三视图切换条的入口位置、三个按钮与 menuType 取值的对应关系、按「项目 × 用户」维度的本地持久化机制,以及源码中从点击事件到 IndexedDB 落盘的完整调用链。读完你可以准确回答「视图按钮在哪」「切换后为什么立即重排」「视图选择为什么不跨设备同步」这些问题,并定位到对应的 Vue 组件与 Vuex 模块。
需要先说明背景:该条目位于 resources/ai-kb/ 目录,是专为大语言模型检索维护的功能知识库(不是面向人类的产品手册),每个条目都有严格 frontmatter(id、aliases、negative、last_verified 等),其中的 last_verified: v1.9.18 表示该行为最近核对到的版本。以下行为描述以当前仓库前端源码为准。
入口与操作步骤
入口位置:
- 桌面端 Web:项目详情页右上角,3 个图标排成一行的切换条;
- 移动端:项目详情页顶部同位置(图标更小)。
操作步骤:
- 进入项目详情页;
- 点切换条上对应图标;
- 数据立即按新视图重排,切换过程不重新请求数据(已在前端);
- 选择记录在
cacheParameter.menuType,下次进入该项目仍是此视图。
「切换不重新请求数据」这一点有明确源码依据:三个视图共享同一份 Vuex 中的任务缓存(cacheTasks 等),切换只是改变渲染分支。ProjectPanel.vue 中模板以 tabTypeActive 为条件渲染三种结构:v-if="tabTypeActive === 'column'" 渲染看板(<Draggable> 分栏)、v-else-if="tabTypeActive === 'table'" 渲染表格、v-else-if="tabTypeActive === 'gantt'" 渲染甘特图(见 ProjectPanel.vue#L134 与 L451),数据本身在切换前已由 getColumns / 任务拉取动作填充完毕。
三个切换按钮与 menuType 取值
从左到右依次是三个按钮:
| 顺序 | 视图 | menuType 取值 |
说明 |
|---|---|---|---|
| 1 | 看板(图标:方块阵列) | column |
默认视图,任务按项目列(column_id)水平分栏,最像 Trello |
| 2 | 列表(图标:横线列表) | table |
按「我的 / 协助 / 未完成 / 已完成」等分组显示表格行 |
| 3 | 甘特图(图标:时间轴) | gantt |
横向时间轴展示 start_at → end_at,用于查看排期与重叠 |
切换器底部有一条滑块(slider)会跟随高亮,所选视图按钮变色。这一交互的实现见 ProjectPanel.vue#L125-L130:.project-switch-button 容器内先渲染一个 .slider 元素,再并列三个图标按钮,分别绑定 tabTypeChange('column') / tabTypeChange('table') / tabTypeChange('gantt'),图标使用 taskfont 字体字符 (看板)、(列表)、(甘特图):
<div class="project-switch-button">
<div class="slider" :style="tabTypeStyle"></div>
<div @click="tabTypeChange('column')" :class="{ 'active': tabTypeActive === 'column'}"><i class="taskfont"></i></div>
<div @click="tabTypeChange('table')" :class="{ 'active': tabTypeActive === 'table'}"><i class="taskfont"></i></div>
<div @click="tabTypeChange('gantt')" :class="{ 'active': tabTypeActive === 'gantt'}"><i class="taskfont"></i></div>
</div>
滑块位置由计算属性 tabTypeStyle 控制(ProjectPanel.vue#L859-L875):column 时 left: 0、table 时 left: 33.33%、gantt 时 left: 66.66%,未知取值则 display: none——三个等宽按钮 + 等分偏移正是「滑块三等分跟随」的由来。
点击后的调用链
tabTypeChange(type)(ProjectPanel.vue#L2092-L2116)把 type 映射为 {project_id, key: 'menuType', value} 三元组并走 toggleParameter,后者 dispatch Vuex action toggleProjectParameter,随后触发 handleColumnDebounce()(约 10ms 防抖)按当前视图补做滚动/可见性计算。toggleProjectParameter(store/actions.js#L542-L565)的关键行为:
- 先调用
$A.syncDispatch("toggleProjectParameter", data),把参数变更广播给同端其他打开的页面/窗口,保持多标签一致; - 在
state.cacheProjectParameter中按project_id查找记录,不存在则用$A.projectParameterTemplate(project_id)创建并 push; - commit
project/parameter/splice写回新值。
对应 mutation(store/mutations.js#L237-L249)在修改内存数组后紧跟一行 $A.IDBSave("cacheProjectParameter", state.cacheProjectParameter)——这就是视图选择落盘到本地 IndexedDB 的位置。cacheProjectParameter 是一个数组,初始值在 store/state.js#L106 声明为 [],数组中每个元素是一条「项目 × 用户」维度的参数记录。
默认值与单列表格特判
默认值 column(看板)在源码中出现于两处,且相互兜底:
- 参数模板
$A.projectParameterTemplate(functions/web.js#L127-L139)返回{project_id, menuInit: false, menuType: 'column', chat: false, showMy: true, showHelp: true, showUndone: true, showCompleted: false, completedTask: false}; - getter
projectData(store/getters.js#L28-L47)在组装cacheParameter时补一句if (cacheParameter.menuType === undefined) cacheParameter.menuType = 'column'。
另有一个文档未展开的隐含默认:项目只有 1 个列表(column)时,首次进入会自动切到表格模式。见 getColumns 中的判断(store/actions.js#L2145-L2157):当本项目列数等于 1 且 menuInit 尚未置位时,dispatch menuInit: true, menuType: 'table'。即「单列项目默认看板意义不大,直接给表格」,且 menuInit 标记保证该特判只执行一次,之后用户的显式选择优先。
持久化维度与限制
- 视图状态按
项目 ID × 当前用户维度记录——载体就是cacheProjectParameter数组里project_id字段对应的记录,数据只存在于当前浏览器/客户端的 IndexedDB; - 不跨设备同步(本地缓存),因此换设备、换浏览器后回到默认
column; - 默认值为
column(看板)。
表格模式专属:分组齿轮菜单
原文档中这一段信息量最大,完整继承如下:仅在表格模式下,悬停切换组前的设置齿轮图标会弹出分组复选下拉菜单;触屏切换表格后点击齿轮打开。菜单与项目筛选弹层风格一致,无箭头和标题栏,勾选后保持打开。列表图标只切换视图,不触发菜单。切走表格后齿轮隐藏、菜单关闭。
可选项共 10 组:我的、协助、未完成、已完成、本周到期、下周到期、本周排期、下周排期、已逾期、未排期,至少保留一项;默认只选择我的、协助、未完成,其余默认不选。选择按项目本地缓存,与折叠状态独立,详见 使用列表视图查看任务。
源码对应 ProjectPanel.vue#L114-L124:<ProjectTableGroupDropdown> 带 v-if="tabTypeActive === 'table'"——这就是「切走表格后齿轮隐藏」的实现;touch 属性取 $isEEUIApp || windowTouch,区分桌面悬停打开与触屏点击打开,正好对应文档里「悬停弹出 / 触屏点击打开」两种交互。分组选中逻辑在 setTableGroupVisible(ProjectPanel.vue#L2051-L2063):
setTableGroupVisible(group, visible) {
const selected = this.visibleTableGroups;
// 至少保留一项:最后一个被取消时直接忽略
if (!visible && selected.length === 1 && selected.includes(group.key)) return;
const tableGroups = visible
? this.tableGroupOptions.filter(item => item.key === group.key || selected.includes(item.key)).map(item => item.key)
: selected.filter(key => key !== group.key);
this.toggleParameter({
project_id: this.projectId,
key: visible ? {tableGroups, [group.expandedKey]: true} : {tableGroups},
});
// ...
}
可见「至少保留一项」是前端硬约束(最后一项不可取消);勾选结果连同该分组的展开状态一起写入 cacheParameter.tableGroups,与 menuType 共用同一套 toggleProjectParameter → IDBSave 持久化通道,因此同样按项目本地缓存、不跨设备同步。勾选后自动展开并滚动定位到该分组的行为由 tests/scroll-to-stable-target.test.mjs 与 tests/project-table-groups.test.mjs 覆盖,分组匹配函数 taskMatchesProjectGroup、周范围口径(周一零点)等细节见 view.list.howto 条目。
与「全部项目页」的区分
- 项目列表页(
projectId='all')有自己的视图(项目卡片 / 项目列表),与单项目的三视图无关。源码中onBack(ProjectPanel.vue#L2130-L2137)返回时会跳转到params: {projectId: 'all'}的项目总览路由,该路由下渲染的是项目集合而非任务面板,二者不共享cacheParameter.menuType。
明确的边界(不支持清单)
知识库条目以 negative 字段显式声明了否定信息,这部分同样值得原样继承,避免使用者产生错误预期:
- 视图切换没有键盘快捷键(项目快捷键清单里也没有对应项);
- 不能强制所有项目用同一视图——每个项目的
menuType独立记录; - 不能新增第 5 种自定义视图。从源码看切换条只有 3 个硬编码按钮,
menuType的合法取值只有column/table/gantt;概念条目 项目视图概览 提到项目共 4 种视图,第 4 种「工作流视图(flow)」不是顶部切换的项目视图,而是通过顶部工作流筛选 Cascader 叠加的展示方式(ProjectPanel.vue#L108-L113 的Cascader组件); - 部门只读模式下视图仍可切换(只是不能编辑任务):模板里限制拖拽的是看板列容器的
:disabled="sortDisabled || isDepartmentReadonly || $isEEUIApp || windowTouch"(ProjectPanel.vue#L134-L142),切换条本身不受该条件影响。
延伸阅读与相关源码
- 项目视图概览(4 种):概念层条目,说明看板/列表/甘特图/工作流四种视图的定义与「视图 vs 筛选正交」关系;
- 使用甘特图视图:
gantt视图的操作能力与限制(如移动端/触屏端不支持拖拽改时间); - 使用列表视图查看任务:
table视图的分组表、列结构与行内操作; - 主组件:ProjectPanel.vue;状态层:store/actions.js、store/mutations.js、store/getters.js、store/state.js、functions/web.js;
- ai-kb 知识库的维护规则(frontmatter 规范、
last_verified版本核对、容器按文件 hash reconcile 增量更新)见 resources/ai-kb/README.md。