docs: add mobile OA detail footer fold and default comment design

Capture scheme A (⋯ + return + approve), ActionSheet more actions, and default remark copy for pending approval detail.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
zlwuandCursor committed 2026-08-12 18:09:59 +08:00
1 parent e4934dc64e
commit 1c844398a9
2 files changed
+1077

No files matched your search

@@ -0,0 +1,113 @@
# 移动端 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;关闭/打印进更多。 |