DooTask 仪表盘布局切换指南:列表视图与四象限视图的完整使用说明

原创2026-10-14 21:13:471,721 阅读
文章标签:后端前端桌面应用协同办公

DooTask 仪表盘布局切换指南:列表视图与四象限视图的完整使用说明

本指南围绕 DooTask 仪表盘个人视角的两种布局——「列表」与「四象限」展开,说明其切换入口、布局偏好保存机制、分组构成、显示数量与空状态等细节。读者在阅读后将能熟练切换并理解两种布局各自的分组规则、默认展开策略以及布局偏好为何只保存在当前浏览器。

入口与切换方式

进入仪表盘的个人视角后,页面右上角会出现「列表」「四象限」两个切换项(对应源码中的 header-seg 分段控件,见 dashboard.vue):

  • 点击「列表」切换到分组式任务表格;
  • 点击「四象限」切换到四宫格卡片视图。

需要特别注意的是,该布局切换器仅在个人视角显示。当系统开启部门负责人视角(systemConfig.department_owner_project_view === 'open' 且当前用户管理了部门)时,右上角会显示「个人视角 / 部门负责人」的切换按钮,部门负责人视角使用独立的 DashboardTeam 组件渲染「部门任务总览」,不参与列表/四象限布局切换。

布局偏好只保存在当前浏览器

所选布局保存在当前浏览器,下次进入仪表盘时继续使用该布局。这一行为在源码中有清晰的实现依据:

  • 进入页面时,通过 IndexedDB 读取上次偏好:$A.IDBString("dashboardLayout", "list"),读取失败时回退到默认值 list(见 dashboard.vue);
  • 切换布局时,将当前选择写入 IndexedDB:$A.IDBSave("dashboardLayout", layout)(见 dashboard.vue);
  • 页面初始化时还会校验读到的值,仅 <a href="https://link.gitcode.com/i/3935797c2996c11c1129d94b32b5c087" target="_blank">'list', 'quad'] 两个合法值被接受,其余一律回退为 list(见 [dashboard.vue)。

限制:由于偏好存储在浏览器本地,清除浏览器缓存、更换浏览器或更换设备后,布局偏好不会保留,会重新回到默认的「列表」布局。

列表布局:分组表格

列表布局是默认布局,将个人任务按时间紧迫程度组织成多个分组,每个分组是一个可独立展开/收起的表格区块。

顶部四张摘要卡

列表布局顶部固定显示四张摘要卡(见 dashboard.vue):

摘要卡 数据来源 配色与提示
已超期 dashboardTask.overdue_count 数字使用红色(num-red),悬停显示「最久 (*) 天」超期时长
今日到期 dashboardTask.today_count 数字使用橙色(num-orange),悬停显示最近的到期时间
待完成 dashboardTask.todo_count 默认数字配色;右侧可附「待开始」角标
我协助的 assistTask.length 悬停显示「今天 (*) 项到期」(assistTodayCount)

摘要卡使用不同颜色区分任务类别,零值仍保留配色(通过 card-off 类控制视觉效果,而非隐藏卡片)。点击摘要卡会平滑滚动到对应分组并高亮闪烁(scrollTo + flashType,见 dashboard.vue)。

补充统计通过悬停查看:当「待开始」任务数非零时,待完成摘要卡右侧会显示「待开始」角标(含数量),点击可跳转到待开始分组(见 dashboard.vue)。

分组构成与顺序

列表布局的任务分组依次为:已超期 → 今日到期 → 待完成 → 待开始 → 我协助的;当存在稳定完成记录时,末尾还会附加一个本周完成分组。

从源码的 listAllColumns 计算属性(见 dashboard.vue)可以确认:「待开始」分组是列表布局独有的,它被插入在待完成之后、我协助的之前。而「本周完成」分组仅在本周一到下周一(weeklyCompleted 的统计窗口,见 dashboard.vue)内有已完成任务且仍存在当前任务分组时才附加到末尾(见 dashboard.vue)。

表头列与窄屏适配

每个展开的分组各自显示表头。文档描述的桌面端列顺序为:任务、子任务、项目、优先级、截止时间、状态;从实际模板渲染看,表头依次渲染为:任务、项目、状态、优先级、子任务、截止时间(见 dashboard.vue)。窄屏(竖屏)时会隐藏部分辅助列,保证核心信息可读。

任务行内还包含:状态标签(可点击展开状态菜单)、子任务进度条(如 2/5)、优先级色块与名称、截止时间(按超期情况着色)等元素(见 dashboard.vue)。

默认展示数量

  • 普通任务分组(已超期、今日到期、待完成、待开始、我协助的)默认展示前 10 条(groupLimit: 10,见 dashboard.vue);
  • 本周完成分组默认展示最近 5 条(completedLimit: 5,见 dashboard.vue);
  • 分组内任务超过展示上限时,底部出现「还有 (*) 项 →」按钮,点击后展开该分组全部任务。

分组折叠与默认策略

每个分组可独立收起/展开,规则详见 折叠和展开个人视角任务分组。核心策略(takeSnapshot,见 dashboard.vue)为:

  • 存在已超期或今日到期任务时,「待开始」分组默认收起,优先突出需要立即行动的任务;
  • 其余显示中的分组默认展开。

用户手动打开或收起某分组后,该选择只记忆到当天(记录到 IndexedDB 的 dashboardCollapsed 键中,含日期戳),当天内优先于默认策略;日期变化后重新按默认策略计算,且不会跨设备同步。

四象限布局:四宫格卡片

切换到「四象限」后,页面以 2×2 的宫格形式展示任务,固定为四个象限:已超期、今日到期、待完成、我协助的(对应 columns 计算属性中的 overdue/today/todo/assist,见 dashboard.vue)。

展示数量与展开控制

  • 每个象限默认显示前 7 条任务(quadLimit: 7,见 dashboard.vue);
  • 超过 7 条时,象限底部出现「展开显示更多」按钮,点击后显示该象限全部任务,按钮变为「收起」,可再次点击恢复(见 dashboard.vue);
  • 任务数量在 1~7 条时显示「全部显示完毕」;
  • 今日到期象限恰好只有 1 条时,文案会改为「今天只有这一项,处理完就轻松了」(见 dashboard.vue)。

空状态与任务操作

空象限会显示插图和对应的空状态提示,例如「没有超期任务,保持住」「今日无到期任务」「暂无待完成任务」「暂无协助的任务」(quadEmptyText,见 dashboard.vue)。即使任务所在的象限为空,任务行本身仍然可以点击打开详情,或通过行内的状态菜单、协助者头像等入口进行操作。

四象限与列表布局的差异

待开始和本周完成只出现在列表布局,不会加入四象限。原因是四象限的 columns 只包含 overdue/today/todo/assist 四个分组,而「待开始」由列表布局专属的 listAllColumns 计算属性额外插入、「本周完成」由 listColumns 附加(见 dashboard.vue)。

布局能力边界(负向说明)

为帮助读者准确理解产品边界,这里汇总两种布局不支持的能力:

  • 布局切换只适用于个人视角,部门负责人视角使用独立的任务总览页面;
  • 四象限布局不显示「待开始」和「本周完成」分组;
  • 用户不能自定义象限名称或象限顺序;
  • 分组收起状态只在列表布局中使用,四象限通过卡片底部按钮控制显示数量;
  • 手动收起状态只记忆到当天,不会跨设备同步。

相关文档与源码索引

登录后查看全文
dootask