2026-08-12-mobile-oa-detail-actions-fold-design.md 4.2 KB

移动端 OA 待办详情 · 底栏操作折叠与默认备注

项 内容
日期 2026-08-12
范围 mobile-oa-h5 审批详情底栏(待办中心 webview);意见 / 加签 / 转交默认备注
视觉 Demo mobile-ui/zkxw-mobile-oa-detail-actions-demo.html(方案 A)
关联 2026-08-12-mobile-oa-task-centers-design.md(详情办理能力)

1. 背景

待办中心打开审批详情(mode=approve)时,底栏一次性展示关闭、打印、拒绝、打回、加签、转交、同意,按钮过多、字号被迫缩小,主路径不清晰。

产品要求:

  1. 默认只展示 同意、打回;其余收入 ⋯ 更多。
  2. 点击同意等需要备注的操作时弹出意见输入,并 预填默认备注(可改)。

2. 目标与非目标

目标

  • 审批态底栏:⋯ + 打回(若允许)+ 同意。
  • 更多:底部 ActionSheet,含拒绝 / 加签(若允许) / 转交 / 打印 / 关闭。
  • 同意、打回、拒绝、加签说明、转交说明均预填默认备注。

非目标

  • 不改 mobile-h5 列表页。
  • 不改后端 API / 意见必填引擎规则(打回仍前端必填校验)。
  • 不改非审批态底栏(只读关闭/打印、撤销、复制并重新发起)。
  • 不做 Web 管理端详情底栏同步(除非另开变更)。

3. 方案选择

采用 Demo 方案 A:

方案 说明 结论
A ⋯ + 打回 + 同意;更多 = ActionSheet 采用
B 关闭常显 + ⋯ + 打回 + 同意 未采用
C 文字「更多」+ 气泡菜单 未采用

4. UI 与交互

4.1 审批态底栏(canApprove === true)

从左到右:

  1. ⋯(更多):打开 ActionSheet。
  2. 打回:仅当 detail.allowReturn !== false;否则不渲染,底栏为 ⋯ + 同意。
  3. 同意:主色实心按钮;打开意见弹窗。

样式对齐现有 oa-detail__btn*:⋯ 为固定宽度描边按钮(约 44px),打回 ghost,同意 primary。

4.2 更多 ActionSheet

顺序固定:

  1. 拒绝
  2. 加签(仅 detail.allowAddSign !== false)
  3. 转交
  4. 打印
  5. 关闭
  • 使用 Vant van-action-sheet(或等价底部 Popup 列表)。
  • 点击某项后关闭 Sheet,再执行对应逻辑(意见弹窗 / 加签选人 / 转交选人 / onPrint / onClose)。
  • acting 或 printing 时底栏与更多项禁用。

4.3 非审批态

保持现状:关闭、打印、(条件)撤销、(条件)复制并重新发起。不引入「更多」。

5. 默认备注

打开对应输入时预填;用户可修改或清空;提交前 trim。

操作 默认备注 必填
同意 同意 否
打回 请修改后重新提交 是(清空则 Toast「打回意见必填」,不关闭弹窗)
拒绝 拒绝 否
加签说明 加签 否
转交说明 转交 否

实现要点:

  • openComment(kind):按 kind 写入 commentText 默认值(不再置 '')。
  • openAddSign / openTransfer:说明字段预填「加签」「转交」(不再置 '')。
  • 提交仍走现有 fetchApproveOaTask / fetchRejectOaTask / fetchReturnOaTask / fetchAddSignOaTask / fetchTransferOaTask;成功后 closeToMini 行为不变。

6. 实现落点

文件 变更
mobile-oa-h5/src/views/OaDetail.vue 审批态底栏折叠;ActionSheet;默认备注
mobile-ui/zkxw-mobile-oa-detail-actions-demo.html 已存在,作视觉权威

无需新 API、无需改 mobile-h5。

7. 验收

  1. 待办详情审批态默认只见 ⋯、打回、同意(无打回权限时仅 ⋯、同意)。
  2. 更多含拒绝、加签(若允许)、转交、打印、关闭,顺序正确。
  3. 同意 / 打回 / 拒绝弹窗预填默认备注;打回清空后无法提交。
  4. 加签 / 转交面板说明预填「加签」「转交」。
  5. 操作成功后仍通知宿主关闭并刷新列表(与现网一致)。

8. 决策记录

日期 决策
2026-08-12 采用方案 A;默认备注文案按 §5;关闭/打印进更多。