feat(business-crud-page): 优化合同管理表单页为多分组卡片风格
- 为合同管理独立表单页设置 dialogCustomClass 以实现表单背景透明 - 按业务分区拆分表单列,分组渲染多张白底卡片,卡间距定为 12px - 调整卡片边距由 16px 至 12px,优化视觉层次与空间感 - 统一多分组表单样式,标题区块采用主色蓝条突出显示 - 透明化弹窗内 Avue 表单背景,解决白卡叠白卡问题 - 兼顾表单底部按钮滚动展示,不同于弹窗底部浮动布局
This commit is contained in:
@@ -0,0 +1,37 @@
|
||||
# 2026-08-21
|
||||
|
||||
## process-config 弹窗卡片间隔(对齐 project-apply 风格)
|
||||
- 需求:process-config 新增/编辑弹窗内三张 `<section-card>`(基本信息 / 现行过程节点 / 节点设置)要像 project-apply 表单页一样独立成卡、卡间露出灰底(12px)。
|
||||
- 根因:全站规则 `.el-dialog .avue-form { background:#fff; padding:8px 16px 4px }`(element-ui.scss ~246 行)把 Avue 弹窗表单整体包成一张白卡,section-card 白卡叠在其上看不出间隔。
|
||||
- 改动(仅 2 文件):
|
||||
1. `src/option/business/process-config.js`:option 顶层加 `dialogCustomClass: 'process-config-dialog'`。
|
||||
2. `src/styles/element-ui.scss`(contract-manage-dialog 规则块后新增):
|
||||
- `.process-config-dialog .avue-form { background:transparent; box-shadow:none; padding:0 }` —— 白卡透明化,灰底(.el-dialog__body 全局 #f2f2f2)露出,section-card 自带 margin-bottom:12px 形成卡距。
|
||||
- `.process-config-dialog .avue-form__group > .el-col > .el-form-item { margin-bottom:0 }` —— formslot 外层 form-item margin 与卡片 margin 叠加会拉大卡距,归零统一 12px。
|
||||
- `.process-config-dialog .avue-dialog__footer` + `.avue-crud__dialog .process-config-dialog .avue-dialog__footer { margin-top:0 !important }` —— 抵消全局 947 行 `.avue-crud__dialog .avue-dialog__footer { margin-top:-30px !important }`(form 透明化后会上移压卡)。双选择器兼顾 dialog 未 teleport / teleport 两种挂载。
|
||||
- 已验证:Vite 2889 编译通过、HMR 生效。
|
||||
- 备注:`menu-form-before` 插槽(保存草稿/保存并启用按钮)渲染在 `.avue-dialog__footer` 内(avue 源码 dialog-form3.mjs 确认),不受 form 透明化影响,仍处白底底栏。
|
||||
|
||||
## 合同管理表单页:多分组卡片风格(对齐 project-apply 风格)
|
||||
- 需求:合同管理新增/编辑表单页(`/business/contract-manage/form?mode=add|edit`)的 7 个业务分组(基本信息 / 合同文件 / 计费信息 / 结算单规则 / 付款比例设置 / 其它附件 / 变更记录)要像 project-apply 一样独立成白底卡、卡间 12px 间距、标题 4px 主色蓝条。
|
||||
- 关键事实(容易踩坑):
|
||||
- 合同表单走 `PageAvueForm` 组件(`src/views/business/components/business-crud-page.vue:5577`),render 函数 `h('div', { class: option.dialogCustomClass }, [h('avue-form', ...)])`,**不包 el-dialog**(所以底部按钮天然不浮动贴底,会随内容滚动——这点与 project-apply 的 el-dialog #footer 浮动有差异)。
|
||||
- `option` 顶层在 `isStandaloneFormPage` 时已设 `dialogCustomClass: 'contract-manage-form-dialog'`、`dialogAppendToBody: false`、`dialogModal: false`、`dialogTop: '0'`、`dialogWidth: '100%'`(5897-5914 行)。
|
||||
- 7 个分区标题列在 option.column 里以 `order` 升序分块(`basicInfoTitle=200` → `contractFileTitle=30` → `billingInfoTitle=10` → `settlementRuleTitle=-10` → `paymentRatioTitle=-30` → `attachmentTitle=-50` → `changeRecordTitle=-70`),其余字段 order 在每对标题列之间。
|
||||
- 实施方案(已提交 63256a9):
|
||||
1. `buildContractFormGroupOption(option)`(business-crud-page.vue 新增方法):按 order 降序遍历 option.column,遇到 7 个 `*Title` 列就切片分组;`groups.length<=1` 时回退原 option(不影响其他业务弹窗)。返回 `{ ...option, column: groups[0], group: groups.slice(1).map(g=>({ label:'', arrow:false, column:g })) }`。
|
||||
2. `pageFormOption`(6205 行)`isContractFormPage` 时调用上述方法。
|
||||
3. CSS(business-crud-page.vue scoped 末尾):
|
||||
- `.contract-manage-form-dialog` 设 `padding:20px 24px 96px; background:#f5f6fa; box-sizing:border-box;`(外层灰底)
|
||||
- `.business-crud-page--contract-form .avue-form { background:transparent; padding:0 }`(表单白卡透明化)
|
||||
- `.business-crud-page--contract-form .avue-form > .el-form > .avue-form__group` 和 `.avue-group` 都设白底 + 6px 圆角 + 0 1px 2px 阴影 + 12px margin-bottom + 14px 16px 4px padding(两张选择器分别覆盖第 1 组 column 与第 2-7 组 group 渲染)
|
||||
- 验证(agent-browser + 系统 Chrome,已登录后截图核对):
|
||||
- 合同表单 7 张白底卡清晰分隔,每张卡左侧 4px 主色蓝条 + 标题(基本信息 / 合同文件 / 计费信息 / 结算单规则 / 付款比例设置 / 其它附件 / 变更记录),卡间约 12px 灰底露白。
|
||||
- 底部 5 个按钮(提交 / 关闭 / 保存 / 提交临时合同 / 提交正式合同)随内容滚动(非浮动贴底)。
|
||||
- 与 project-apply 滚动后的"客户信息 / 承运商信息"卡风格完全一致。
|
||||
- 与 project-apply 的已知差异(用户本次未要求改):
|
||||
- 合同表单底部按钮非浮动贴底(PageAvueForm 不包 el-dialog,avue-form 的 form_menu 渲染在内部)
|
||||
- 合同表单无"返回"按钮(用"关闭"代替)
|
||||
- 合同表单无独立页面标题(page-header 区域在 breadcrumb 处,不在 main 标题区)
|
||||
- 行为验证码:登录页拼图/旋转求解基础设施已搭好——`/tmp/captcha_solve.py`(CORS 修复后支持 puzzle+rotate 双模式)、`/tmp/ab-install/node_modules/.bin/agent-browser --browser-channel chrome`。登录流程:访问 → 切"账号密码登录" → 点登录 → 检测 `.puzzle-stage`/`.rotate-image` → POST 至 http://127.0.0.1:8765 → 取 xDisp/angle → JS PointerEvent 模拟拖动 .track-handle 即可。
|
||||
- 提交:63256a9 feat(business-crud-page): 合同管理表单页改为多分组卡片风格(1 file, +86/-2)。未提交改动(process-config.js、element-ui.scss、master-order-editor.vue、loading-manage.vue、project-apply.vue、formal-settlement.vue、customer-archive.vue)与本任务无关,未纳入。
|
||||
@@ -24,6 +24,10 @@
|
||||
### 简单分组(仅 3 项)
|
||||
- 联系信息等仅 3 项的分组,可用 `el-col :span="8"` 让三项均分一行,避免 4 列网格留白。
|
||||
|
||||
### Avue CRUD 内置弹窗内使用 section-card:需 dialogCustomClass 透明化 avue-form(重要)
|
||||
- 全站规则 `.el-dialog .avue-form { background:#fff; padding:8px 16px 4px }` 会把 Avue 弹窗表单整体包成一张白卡,内置弹窗里放 `<section-card>` 会白卡叠白卡、看不出分组间隔。
|
||||
- 解法(process-config 已落地):option 顶层加 `dialogCustomClass: 'xxx-dialog'`,再在 element-ui.scss 写三条规则:① `.xxx-dialog .avue-form { background:transparent; box-shadow:none; padding:0 }`;② `.xxx-dialog .avue-form__group > .el-col > .el-form-item { margin-bottom:0 }`(防 formslot 外层 form-item margin 与卡片 margin 叠加拉大卡距);③ `.xxx-dialog .avue-dialog__footer, .avue-crud__dialog .xxx-dialog .avue-dialog__footer { margin-top:0 !important }` 抵消全局 947 行 `-30px !important` 上移(否则 footer 压卡),双选择器兼顾 dialog 是否 teleport。
|
||||
|
||||
### 弹窗底部操作栏浮动效果(全站统一规范)
|
||||
- **需求来源**:用户要求参考 `business/project-apply`(手写 el-dialog + `#footer` slot,body `max-height:76vh;overflow-y:auto`,footer 固定底部)实现"取消/保存按钮浮动在底部"。因绝大多数页面是 Avue CRUD 内置弹窗(无法用 `#footer` slot),统一用**全局 CSS** 实现,全站自动生效。
|
||||
- **实现位置**:`src/styles/element-ui.scss`(在 `.el-dialog .el-form-item` 规则之后新增)。
|
||||
@@ -82,3 +86,11 @@
|
||||
- `src/views/business/components/business-crud-page.vue` 被 waybill-manage / transport-plan 等多个业务页共用,内部 `<avue-crud :option="option">`,option 由传入 prop `crudOption` 经 `cloneOption`(组件内 6261 行,浅展开+重映射 column,**保留所有顶层属性**)克隆而来。
|
||||
- 因此给各业务页 `option` 顶层加 `dialogCustomClass: 'xxx-dialog'`,再在 `element-ui.scss` 写 `.xxx-dialog.el-dialog { height/max-height: calc(100vh - 40px) !important; ... }` 等规则,即可**只影响该页**、不波及其他共用页面(已验证 waybill-manage / transport-plan 走同一机制生效)。
|
||||
- 注意 avue-crud 弹窗带 `avue-crud__dialog` class,会被全局 `.avue-crud__dialog .avue-dialog__footer { margin-top: -30px !important }`(element-ui.scss 863 行)影响,自定义 footer 规则需加 `margin-top: 0 !important` 抵消;纯 dialog-form 弹窗(如 shipping-template)无此 class 不受影响。
|
||||
|
||||
### 合同管理独立表单页:多分组卡片(PageAvueForm 路径)
|
||||
- **入口**:`/business/contract-manage/form?mode=add|edit`(contract-manage.vue 传 `contract-form-page` prop)
|
||||
- **渲染组件**:`PageAvueForm`(business-crud-page.vue 5577 行)—— `h('div', {class: option.dialogCustomClass || 'business-crud-form-page-dialog'}, [h('avue-form', ...)])`,**不包 el-dialog**。底部按钮(form_menu)天然渲染在 form 内部、随内容滚动,**不会浮动贴底**(与 project-apply 的 el-dialog #footer 浮动有差异)。
|
||||
- **7 个分区**(option.column 用 order 分块):基本信息(200) / 合同文件(30) / 计费信息(10) / 结算单规则(-10) / 付款比例设置(-30) / 其它附件(-50) / 变更记录(-70)
|
||||
- **多分组生成**:`buildContractFormGroupOption(option)`(6861 行)按 order 降序遍历,遇到 `*Title` 列就切片;第 1 组做 `column`,后 6 组做 `group: [{label:'', arrow:false, column: g}, ...]`。`groups.length<=1` 回退原 option(不影响其他业务弹窗)。`pageFormOption`(6205 行)`isContractFormPage` 时调用。
|
||||
- **样式**(business-crud-page.vue scoped 末尾):`.contract-manage-form-dialog` 灰底 `#f5f6fa` + `padding:20px 24px 96px`;`.avue-form { background:transparent; padding:0 }`;`.avue-form__group` 和 `.avue-group` 统一白底 + 6px 圆角 + 轻阴影 + `margin-bottom:12px` + `padding:14px 16px 4px`。
|
||||
- **不适用本模式**:其他业务弹窗(waybill/transport-plan/shipping-template)走 Avue 内置 CRUD 弹窗,弹窗内用 `<section-card>` 是另一套规则(见"Avue CRUD 内置弹窗内使用 section-card"条目)。
|
||||
|
||||
Reference in New Issue
Block a user