37 KiB
手机端表单版式:手机上摆哪几格、怎么摆能配,段跟着表单上的分组走
原话是这一句:「手机端的流程详情里面表单内容里面分:费用报销基本信息、系统取数、完整单据。 我不希望这样,我就希望只有费用报销基本信息。但是费用报销基本信息里面展示哪些字段、怎么排放 我需要有地方可以配置。」
这一档刚上线时手机上真的只出一节。后来又挨了一句:「手机端展示是否可以将我在表单中配置的 分组那个组件也展示出来,这样我在手机端也可以看出来表单字段是哪个分组,这样手机端看着也比较舒服。」 ——「分组标题」那一格在电脑上有抬头、有色标、有线,手机上整块丢了,配表的人等于白起那些名字。 于是「只出一节」这一条改成了**「一节还是几节由表单上摆的『分组标题』决定」**:没摆就还是一节, 摆了几枚就切几段(见 §2 末尾)。要的还是原来那句"只认这份清单",只是段名不再被吞掉。
这份文档写的是这一档怎么落的:配置长什么样、存在哪儿、手机上怎么读、哪些东西一个字没动、 怎么验。不往库里造测试数据——一张表单上的几个键而已,配在真实表单上就行。
0. 一页看完
| 要做的事 | 配在哪儿 | 生效范围 |
|---|---|---|
| 手机上照这份清单摆(不再走自动归置) | 表单设计器 → 工具栏「手机端」→ 勾「按这份配置展示」 | 只影响手机版式(待办详情 + 单据详情) |
| 手机上切几段 | 不在这一份配置里,就是表单上摆的那几枚「分组标题」:摆几枚切几段,段名照那一格写的名字 | 手机版式两屏(摘要 + 「完整单据」)都跟着切 |
| 就是不要分段,一整节滚到底 | 同一面板 → 「严格只出一节(不分段)」(表单上没有「分组标题」时这一颗不出现) | 同上 |
| 第一段叫什么 | 同一面板 → 「第一节的标题」(只管第一个「分组标题」之前那一截;留空取第一个页签名;既没配也没页签就不摆标题行,那一节从头到尾就是正文) | 同上 |
| 摆哪几格、什么顺序 | 同一面板 → 那张清单,从上到下就是手机上从上到下,两颗粒子改一格 | 同上 |
| 某一格上不上屏 | 清单上那颗「展示 / 不展示」,或属性面板那颗「手机上不展示」(同一个键) | 同上 |
| 那一格怎么摆(一行 / 整段 / 置顶 / 缩略图 / 收成一行 / 逐条展开) | 清单上那一格右侧的下拉(可选项按字段类型给,选不出摆不出来的组合)。明细那两档都不推弹层:收成一行是点一下就在它底下摊开、再点收回,逐条展开是直接摊开,摊出来是同一段模板 | 同上 |
| 「标签页」里那一整页外部页面要不要给一张「打开」卡片 | 同一面板 → 清单里那一行的「展示 / 不展示」(那颗开关记在这份配置里,属性面板上没这一颗) | 同上 |
| 末尾还要不要「完整单据」那一屏 | 同一面板 → 「末尾留『完整单据』入口」(默认不留) | 待办那一屏的 ··· 里始终有这条路 |
| 配到一半想退回自动归置 | 把开关关掉即可,配好的顺序留在配置里 | — |
| 电脑上「默认隐藏」的那几格要不要在手机上露 | 就在那张清单上:给它点上「展示」= 点名(配置里记一笔 show) |
只影响手机版式;没点过的仍旧不摆 |
| 三十几格翻不动 | 清单顶上那颗筛选(全部 / 已上屏 / 已收起)+ 那一格搜索 | 只影响面板,不改配置 |
三条贯穿全文的分寸:
- 不开这一档就等于不存在。没配过的表单走的还是原来那套按字段类型的自动归置,
判据在
components/oa/mobile/useFormPlan.ts,那一段代码这条路一行没改。 - 配置只管"摆不摆、怎么摆",不管"能不能看"。开了这一档之后手机上那一屏只认两份说法: 这份清单(含逐格那颗「手机上不展示」)与本环节的字段权限——整单「默认隐藏」不再压它 (那一档管的是电脑上填单那一屏),本环节要人填的那几格仍归上面的填写块(见 §4)。 这一条是后来改的:原先整单「默认隐藏」也压得住,于是面板上写着「展示」、 手机上那一格自己消失,配表的人只能对着单子猜(见 §4.1)。
- 格子自己那句「显示条件」不在这一层抢话,但也不被它漏掉。配了
visibleWhen的那一格 露不露归条件说:待办那一屏(人正在改条件里那些值)跟着电脑上一起露、一起藏, 单据详情那一屏(那份值已经是死的)拿存过的那一份只放行、不收格子——与桌面只读渲染 那句utils/formRuntime.readbackHidden一句对一句(见 §4.2)。 - 后端一行没动。这份配置住在
oa_form.content.layout.mobile里,api/design.py:clean_formats只按类型收字段上那几栏展现配置,layout里的东西原样存回。
1. 那份配置长什么样
// oa_form.content
{
"fields": [ /* 桌面那张 12 列表,一个键都没多 */ ],
"layout": {
"columns": 12,
"grid": 12,
"mobile": {
"enabled": true,
"title": "费用报销基本信息",
"showFullSheet": false,
// 只有想要"一整节滚到底"才写这一笔:把表单上的「分组标题」当空气(见 §2 末尾)
// "singleSection": true,
"fields": [
{ "key": "reason", "style": "block", "label": "事由" },
{ "key": "amount", "style": "float" },
{ "key": "days" },
// 电脑上「默认隐藏」的那一格:清单上点了「展示」才写这一笔(见 §2 末尾与 §4.1)
{ "key": "pms_code", "show": true },
{ "key": "rows", "style": "list" },
{ "key": "invoices", "style": "gallery" },
// 外部页面那一格的键带着页签:宿主格子key#页签key
{ "key": "tabs_host#tab_2", "style": "embed" }
]
}
}
}
类型定义:frontend/src/types/index.ts 的 MobileLayout / MobileFieldLayout / MobileFieldStyle。
为什么存在 layout 而不是新开一张表:它和 layout.columns、layout.label_width
是同一层东西——只讲"这一张表怎么摆",不参与流转、不参与校验、不参与权限。存成一张表
要么加一次迁移、要么加一次 join,换来的只是把一件事说两遍。为什么整份存而不是散在字段上:
要配的是顺序,顺序是格子之间的事;散在 32 个格子上就得给每格存一个序号,
挪一格要改一片,还会漂(删一格后面的序号全乱)。
段名也不在这里。那一格是表单上的「分组标题」(type: 'group'),它没有值、不进这份清单,
配了版式之后手机上照样按它分段——段名归它自己说,title 只管第一个分组之前那一截(见 §2 末尾)。
再加一份"手机端分组清单"就是第三份说法,早晚和画布上那几枚对不上。
某一格上不上屏不在这里,它写的还是格子上的 mobileHidden——那颗键在属性面板里已经存在了
(见 mobile-approval-layout.md §4.3),面板上那颗"展示 / 不展示"
改的就是它。两份开关早晚会变成"属性面板勾了、手机端面板没勾"。
这颗例外记在这儿:show。它不是第三份开关,是对整单「默认隐藏」的一次表态——
mobileHidden 说的是"手机上别摆",show 说的是"电脑上那句默认隐藏管不到手机上这一屏",
两句不是一句话。没点过「展示」的格子配置里不会多出这一笔,所以关掉再打开这一档不会
把藏着的格子一次性放出来;判它们的是同一处(mobileVisibilityOf),不会两处各说一遍。
style 的可选项由字段类型给(utils/mobileLayout.ts:styleOptionsFor):文本类 row / block,
数字金额多一档 float,附件与图片 gallery / count,明细 card / list,签名只有一档。
配置里写了这一档新类型吃不下去(换了类型、从别的表单粘过来),styleFor 回落到该类型的默认档,
不会摆出一个空白的格子。
明细那两档只差点不点:list(逐条展开)直接摊在这一节里,card(收成一行)摆一行
「明细 · 12 条 · 合计」,点一下就在这一行底下摊开、再点收回。从前 card 那一下是推一层
全屏弹层,与 list 各长一副面孔;现在两档共用同一段摊开的模板(见 §2 末尾
「两版共用一条逐格链子」)。
2. 手机上怎么读这一份
utils/mobileLayout.ts 是这一层的口径(读配置、排序、挑摆法、对账),
components/oa/mobile/useFormPlan.ts:planForm 在最开头分岔:
const mobile = mobileLayoutOf(schema) // 只有 enabled 为真才回一份,否则 null
if (mobile) return planByMobileLayout(mobile)
// 下面那套自动归置原封不动
开了这一档之后出来的是:auto / media / signature 三个桶全空、custom: true、
showFull 照配置,groups 是一节还是几节由表单上的「分组标题」决定(见本节末尾)。
MobileFormSummary.vue 认 plan.custom 走另一段模板,按 groups 逐节、每节按 items 的顺序
逐格摆,每格照自己的 kind + style 渲染。三处与自动归置那版不一样:
| 自动归置 | 按配置摆 | |
|---|---|---|
| 分节的依据 | 页签 + 分隔条(「分组标题」从前不认,现在认,见本节末尾) | 配置管摆哪些格,段由「分组标题」切 |
| 系统取数那几格 | 并成一行「系统取数 6 项」,折叠 | 配了它就是自己那一段里的一格,跟别的格平起平坐 |
| 空着的格子 | 不渲染,只报"折了几个空的" | 照样摆,右边一个 — |
| 一节里超过六行 | 折起来,按一颗「展开更早 N 条」 | 不折:点名要的格子不该再被收起来 |
| 明细 | 收成一行摆在最前面,点了就地摊开,不推弹层(见本节末尾) | 跟着格子自己的位置摆在这一节里,两档只差点不点 |
| 附件 / 签名 | 各归各的桶,位置不由格子说了算 | 跟着格子自己的位置摆在这一节里 |
| 末尾「完整单据」 | 永远有 | 配置说了算 |
空值为什么改成照样摆:这一屏要答的是"我要看的这几格填了没有"。配表的人点了名, 格子却因为没值自己消失,他就得先猜"是没填,还是被我配丢了"。摘要那版反过来—— 四十几格里挑能看的,空的不占行。两处口径不一样是各自要答的问题不一样,不是漂移。
段跟着表单上的「分组标题」切(见本节末尾「手机上出几节」)。切出来的每一段自己折自己、 自己数自己的格子,与自动归置那版按分隔条分节是同一套机制,只是切段的那一枚换了。
节名没配就不摆那一行标题。planForm 给每一节标一个 generic:名字是配表的人起的
(面板上那一栏)、表单上现成的(第一个页签名、那一枚「分组标题」写的段名)就算名字,generic: false;两头都没有、
由代码补一句「表单内容」的算兜底,generic: true。MobileFormSummary.vue 与
MobileFormReader.vue 在这种节上把 title 传空串(条件是「整屏只有这一节」),MobileFold
没有标题就把标题行、条数、折叠箭头一起不摆,内容直接摊开——上面那排页签已经写着「表单内容」,
同一句话不该在 390 的屏上占两行。内容一行不少,顺序也照配置;好几节的时候(「完整单据」里
连着「系统取数」那一节就是这种)兜底那节照旧摆标题,那时候节名是把正文分开的记号。
预览台 form=custom&title=none 摆的就是这一档。
「置顶」那几格不住在这一节里:它摆到抬头那一排大字(plan.floats,MOBILE_FLOAT_MAX = 3),
超出三格的回到节里按顺序摆,不丢。抬头本来就在讲"这单大概是什么",摆四五个数就成了报表。
配了却没写到的格子排在后面,不是不摆。配完之后又往表单上加格子是常事,
这时候新格子该出现——凭空消失是那种要查半天的错。设计器每次开门都按现在的表把清单重算一遍
(pruneMobileLayout:删掉的收掉、新加的补在最后),所以清单和表单永远对得上。
电脑上「默认隐藏」的那几格听这一屏的。field.hidden 本来说的是"电脑上填单那一屏别占位"
(值照常存、带出与公式照算,哪个环节明给只读 / 可编辑它就露出来),不该顺手管住手机上那一屏。
现在开了这一档之后:清单上点了「展示」= 给它表了态,配置里记一笔 fields[].show: true,
手机上就摆;没点过的仍旧按电脑上那句不摆——否则一开开关,整张表里藏着的格子会一次性涌出来。
环节那边明着给了只读 / 可编辑 / 必填,也算它要露出来(与桌面 effectivePerm 同一句话)。
预览台上那两格 PMS项目编号(点了名,摆)与 VDI项目编号(没点名,不摆)就是给这一档对的照。
这一档现在只压没配「显示条件」的格子。勾了默认隐藏又配了条件的那一格,说话的是条件而不是
那个默认值(formRuntime.hiddenByDefault 同一句),手机上跟着电脑上那一屏一起露一起藏,
不需要配表的人在清单上再点一次「展示」;清单上它标的是「按显示条件」,角标点出去写的是
格子上的 mobileHidden,不代它记一笔 show(见 §4.2)。
「标签页」里那一整页外部页面也算一格(mobileCells 把它合成出来,键是 宿主格子key#页签key)。
手机上不内嵌别人的系统,摆的是一张「打开」卡片,点了新窗口看——与「完整单据」那一屏同一个口径
(390px 里嵌一整张 ERP 表等于没法看)。它没有格子可以挂「手机上不展示」,那颗开关因此记在
这份配置的 fields[].hidden 上,是整个方案里唯一的一个例外。
压在它那一页上的普通格子照样能配:桌面上那几个值藏在别人的页面里,手机上反而可以单独摆出来看。
两版共用一条逐格链子(components/oa/mobile/MobileFormSummary.vue)。这一屏从前是两段
模板各摆各的:按配置摆那一版走逐格那条链子,自动归置那一版自己拼「明细卡 + 分节 + 系统取数」,
于是「明细摊开长什么样」在两处各自演化,同一张单在两处能念出两种样子。现在自动归置那一版
那张漂在节外的明细卡被当成没有节名的一节排进同一条链子(autoTable() 交出一份
kind: 'table' 的行,sections 把它塞在 plan.groups 前面;没有节名就不摆标题行,
看着还是从前那张卡),链子只有一份,摊开那一段也就只有一份:
- 点了就地摊开,不推弹层:在那一行底下逐条摆出来,再点收回(展开状态按那一格的键记在
openedRows里),箭头转 90 度当展开态,aria-expanded跟着走。从前那一下推的是 「完整单据」用的那层full弹层——盖住整屏、没有上下文,划两下就忘了自己在看哪张单的 哪一节。card(收成一行)与list(逐条展开)从此只差「点不点」,在屏幕上不可能长出 两副面孔(用例把两档摊出来的那一段逐字比过); - 摊的是那张子表的全部行:
planForm只在plan.table里留下条数与合计,行本身回data拿;列走useFormPlan.mobileRowCells那一份读法,与「完整单据」、与list同一份——勾了「隐藏此列」的那一列不摆,空着的列不占行; - 换一张单子不把上一张摊到第几条带过来(
plan.total一变,展开状态清回去)。
只在摘要里这么摆。「完整单据」那一屏本来就把明细逐条摊着,那条路一个字没动;
MobileTaskView.vue 与 MobileWorkView.vue 里 rowsOpen 那条弹层分支连同它自己那份
行渲染一起删了(两处各写了一遍「第几条 · 花在什么上 · 多少钱」,删之前那两份已经开始不一样),
「完整单据」那层弹层照旧留着、标题与说明也还写着「完整单据」。「一节最多摆六行」与那颗
「展开更早 N 条」照旧只在自动归置那一版生效(shown() 与 more() 开头都先问
plan.custom),这条没改。
2.1 手机上出几节:跟着表单上的「分组标题」走
原话:「手机端展示是否可以将我在表单中配置的分组那个组件也展示出来,这样我在手机端也可以 看出来表单字段是哪个分组,这样手机端看着也比较舒服。」
「分组标题」(type: 'group')是画布上那一行带色标的抬头,不产生值,摆它就是为了让人看出
下面这几格属于哪一段。这一版之前手机上不认它:自动归置那一版只认分隔条,配了手机端版式之后
更是硬成一节,于是配表的人在电脑上切好的三四段,到了手机上是一整坨,那些名字等于白起。
现在三屏一起认(判据整份方案只有一处:utils/mobileLayout.ts:mobileSectionMarkers):
| 屏 | 切段的依据 | 段名 |
|---|---|---|
| 摘要 · 按配置摆 | 「分组标题」 | 那一格写的名字(没写用桌面那句「分组标题」,不摆 key) |
| 摘要 · 自动归置 | 「分组标题」+ 分隔条,谁离格子近听谁的 | 有页签时拼成 页签名 · 段名,与从前分隔条同一写法 |
| 「完整单据」 | 同上 | 同上 |
四条分寸:
- 段按表单上的次序认,不按清单上的次序。配表的人把「目的地」在清单里挪到「报销事由」前面, 它仍旧属于原来那一段;跟着清单那一串走,挪一次就把字段挪进了别人的段里,而他在设计器里 根本没动过分段。段的先后则由清单里第一次出现这一段格子的那个位置决定,所以那串仍旧 大致是手机上从上到下。
- 「按配置摆」那一屏不认分隔条(
ignoreDividers)。分隔条压根不在这份清单里, 一道手机上看不见的线不该把段落切开;另外两屏分隔条本来就要当段名用,照旧算一枚标记。 - 「这一节的名字」只管第一个「分组标题」之前那一截。表单上摆了分组,那一截一个格子都没有时 这一节整个不摆——不会多出一行没人要的空标题。
- 整段被闸掉就不出现。那一格里的格子全被环节权限藏了 / 都勾了「手机上不展示」, 就留一个只有标题的空段更难看(与自动归置那版滤掉空节同一分寸)。
给了一整节滚到底的退路:面板上那颗「严格只出一节(不分段)」(layout.mobile.singleSection)。
勾了就无视那些「分组标题」,回到这一档刚上线时那一版。表单上一枚「分组标题」都没摆时这颗开关
整块不出现——不给配表的人看一颗不起作用的勾。「完整单据」那一屏不吃这一档:它本来就按分隔条
分段,摘要切、它不切,反而成了"同一张单两副面孔"里最难解释的一种。
折叠状态认段身份,不认段名那几个字(PlanGroup.key,按配置摆那一版写 g:<分组格子key>)。
用段名当钥匙,配表的人改完段名又改回来、或者两页里出现同名段,谁摊开的状态就漂到另一段上了。
group 因此不进那份清单:它没有值、没有摆法、没有那颗「展示 / 不展示」,列进去只会多出一行
空转的设置,点了还不知道管的是什么。它也不是"手机上哪儿都不出现"——INELIGIBLE 那一列说的
是"当不了一格",段名是另一回事。
3. 设计器那一侧
入口在表单设计器工具栏:「手机端」,旁边一枚角标写着此刻是「自动」还是「已配置」。
面板是 components/oa/design/MobileLayoutPanel.vue。
为什么做成一张清单而不是往属性面板里再塞几栏:属性面板一次只看一格, 而顺序是格子之间的事——摊在 32 个属性面板里没人能看出整张单子在手机上读起来是什么样。 清单从上往下就是手机上从上往下。
改动当场交回画布,面板上没有"确定"这一步(只有一颗「关闭」)。因此撤销栈与
「未保存」那颗黄点必须认这份配置:FormDesignerView.vue 的签名从"格子 + 整表设置"
扩成"格子 + 整表设置 + 手机端那份"。这一条是补回来的——原先 extras 不在签名里,
排完一版顺序关掉弹窗,画布看着什么都没发生,保存按钮也不亮,配的东西静悄悄就丢了
(FormDesignerView.mobile.spec.ts 里有一条专门钉这个)。
排版件(分隔条、说明、空白、隐藏、标题)与「标签页」容器本身不进清单:前者没有值, 摆上去只是一行空白;后者是个壳,进去的是它那一页一页的内容——外部页面那几页会以 「外部页面」这一类出现在清单里,名字取页签名,摆法只有「打开卡片」一档。
「分组标题」也不进清单,但它不是"手机上不摆"。那一格的用处是把正文切开,不是一行值, 所以清单里没有它的位置,手机上却照样照它分段(见 §2.1)。表单上摆了它,面板上就多一颗 「严格只出一节(不分段)」——默认不勾,勾了才把那些分组当空气。
清单能搜能筛:顶上那颗筛选(全部 / 已上屏 / 已收起)加一个搜字段名的框。 三十几格的单子想知道"到底哪几格没配上屏",翻是翻不动的。筛着的时候上移下移停用—— 顺序是整张单子的事,隔着筛选挪一格说不清挪到哪儿去了,位次那一列写的也还是它在整份清单里的位置。 每行那颗「展示 / 不展示」挂着 tooltip,不上屏时说清是谁拦的(面板勾的 / 环节藏的 / 电脑上默认隐藏且没点名的),别让人以为按钮坏了。
筛出来那一批可以一次改完:筛着或搜着的时候,那一行右侧多两颗「这一批 N 格全上屏 / 全收起」,
只作用于当前列出来的那些行。要"手机上只摆我点的这几格",路径是:筛「已上屏」→ 全收起 →
再逐格把自己要的那几格点开。没筛的时候这两颗不出现——一按就把整张表收掉,那是误操作现场。
它们走的是与逐颗按钮同一条路:普通格子写 mobileHidden,外部页面那一页与电脑上默认隐藏
那几格写这份配置,一颗都没动就不 emit(面板上没有"确定",空发一次会把画布标成未保存)。
4. 只剩两道闸:这一屏听这份清单
开了这一档之后,手机上那一屏只认两份说法,判据全项目只有一处——
utils/mobileLayout.ts:mobileVisibilityOf,摘要、完整单据、设计器面板、底部那句"上屏几格"
读的都是它(从前是四地各写一遍,才会出现"面板写着展示、手机上没有那一格"):
- 这份清单本身:逐格那颗「手机上不展示」(
field.mobileHidden,与属性面板那颗同一个键; 外部页面那一格记配置的hidden)——记在plan.hiddenMobile; - 本环节字段权限说「隐藏」(
perms[field.key] === 'hidden')——记在plan.dropped。 权限问的是"这个人此刻能不能看",配表的人说了不算,所以它压在配置之上。 - 这一格配的「显示条件」此刻不成立——记在
plan.dropped。只有待办那一屏给得出那份表单值, 单据详情与设计器面板给不出,那一档就不评(判据与分寸见 §4.2)。
不在闸里的两件事:整单「默认隐藏」(见 §2 与 §4.1,清单点过名就摆,没点名算 dropped)、
本环节要人填的那几格(needKeys,由顶上那个「本环节要填」的填写块负责,这一节里不重复摆——
两版都一样)。
4.1 为什么这一版把它从闸里摘出来
原话:「手机端配置的字段显示,感觉还是被默认隐藏遮住了——手机这边完全按手机端的配置来展示,
我配置哪些字段显示就展示。」 生产那张单上 PMS项目编号 / PMS项目名称 / VDI项目编号 / 行政项目编号 / 定制项目编码… 全挂着「默认隐藏」(电脑上不占位,取数照跑),于是清单上每一行都写着「展示」、
底下统计也把这几格算成"上屏",手机上那一格却一个都不出现——配了和没配一个样。
摘出来之后仍留了一道"没表态就不摆"(fields[].show 只有点过「展示」才写),
因为这两件事本来就不同:默认隐藏是配表的人在电脑上定的,这一屏是他在手机上定的,
谁最近表过态听谁的。真想让某一格在哪儿都不露,属性面板那颗「手机上不展示」比它更直接,
而那一颗压得住 show。
那一页外部页面还多一档:环节把整个「标签页」那一格藏了,或者只藏了那一页
(formPerms 里那个 标签页格子key#页签key),卡片都不摆,记进 plan.dropped。
「完整单据」那一屏(MobileFormReader.vue)没改:它要答的是"这张单还少填了什么",
所以照旧一格一行、空值也留、按页签与分隔条分节。把它的入口从摘要末尾撤掉之后,
单据详情那一屏(MobileWorkView.vue)原本就没第二条路了,于是那条入口收进顶栏的 ···
——要的是"只有一节",不是"这一单在手机上看不全"。待办那一屏的 ··· 本来就有这一条。
这一版给它补了一句:摆哪几格改成跟摘要共用 mobileVisibilityOf,短名也照配置里的
fields[].label 念。它自己的分节、空值留行、外部页面给卡片那些一条没动——
但摘要里摆得出来的格子,到「完整单据」里不该因为整单「默认隐藏」又消失一次。
两屏对不上号比哪儿少摆几格难查得多。待办那一屏的 ··· 也跟着这条走:摘要末尾那一行还在时
不重复列,配置说不要那一行时才挪进 ···。
4.2 「显示条件」也归这一句判据管:只有办单那一屏给得出那份值
原话:「我的电脑端与手机端表单中默认隐藏,是不是都可以根据表单中字段的判断来控制是否展示呢?」
电脑上那一寸早就挪到条件后面了(formruntime.hidden_by_default / formRuntime.hiddenByDefault:
勾了「默认隐藏」又配了「显示条件」的格子归条件管,见 README.md「字段自己也能说『我默认不显示』」
那一段)。手机上没挪——mobileVisibilityOf 与 useFormPlan 里那三处读的都是裸 field.hidden,
visibleWhen 一个字都不评。于是同一张单两屏各说各话:费用类型 在电脑上一拨条件就露出来,
手机上划到底也没有它;反过来条件已经翻走的格子,电脑上不摆了,手机上还留着一行谁也改不动的值。
现在四道闸一句排到底,与桌面 effectivePerm 一一对应:手机上不展示 → 本环节隐藏 →
显示条件不成立 → 整单默认隐藏,前两道压得住后两道。判据多出来的那个取值叫 cond,
摘要、完整单据、面板统计都据它把这一格算进"收起"。
给得出那份值的才评条件,这是分寸不是偷懒:
- 待办那一屏给(
MobileTaskView里canProcess ? ctx.formData : null那一句)。办单的人正在改 条件里那些值,格子就该跟着露跟着藏,与桌面TaskDetailView那句:readonly="!canProcess"同一判据; 这条待办已经不在他手上(已办、挂起、只是回来看看),退回下一条那一寸。 - 单据详情那一屏不给"正在填的那一份",但手上还有存过的那一份(
MobileWorkView传下来的data)。 那一屏说的是"存过的都摊开给他看",所以条件在这一屏只放行不收:勾了「默认隐藏」又配了 显示条件的那一组,按存过的那份值评,成立就上屏;只配了条件、没勾默认隐藏的格子照旧摊开, 不凭条件把已经存了值的一行划走。判据utils/formRuntime.readbackHidden,桌面只读渲染读的是 同一句,两屏不分家。这一寸是 2026-11 补的:从前这两屏连条件都不评(那句props.readonly ? null : model.value明摆着承认算不了),于是出差备案申请按「项目分类」 放行那八格项目 / 客户,办理那一屏露得好好的,办结之后回看一格不剩。 - 设计器面板给不出值,但也不按回看那一寸报:那儿问的是"这一格归谁管",所以按
hiddenByDefault报——条件格在清单上显示成「按显示条件」而不是「电脑端默认隐藏」, 那颗开关点出去写的是格子上的mobileHidden,面板不代它记一笔show。要记也没用:show压的是整单默认隐藏那一档,而那一档对配了条件的格子本来就不说话;更糟的是那一笔 会把回看那一屏里本不露的格子凭空放出来。
后端这一头不用跟着改:service/formruntime.field_hidden 一直都算联动,提交收哪些键
(editable_keys)、必填缺哪些(missing_required)、阈值额度挡不挡人(quota.hidden_keys)
认的都是这一句。改的只是手机上那两屏读不读它。
5. 验收
不改代码就能看的两条:
cd frontend && pnpm dev
# 配过的样子(含"电脑上默认隐藏、清单点了名"那一格 PMS项目编号;VDI 那格没点名,不摆):
# http://localhost:3000/preview-mobile.html?screen=detail&form=custom
# 节名留空(那一节标题不摆):http://localhost:3000/preview-mobile.html?screen=detail&form=custom&title=none
# 表单上摆三枚「分组标题」(一、报销基本信息 / 二、费用明细 / 三、票据),手机上跟着切三段:
# http://localhost:3000/preview-mobile.html?screen=work&form=custom&groups=on
# 同一张单勾上「严格只出一节」:http://localhost:3000/preview-mobile.html?screen=work&form=custom&groups=on&single=1
# 待办那一屏(办理中)看同一档:http://localhost:3000/preview-mobile.html?screen=detail&form=custom&groups=on
# 没配的样子(对照):http://localhost:3000/preview-mobile.html?screen=detail&form=tabs
# 面板本身(清单上那颗筛选、搜字段名、两格"电脑端默认隐藏"的角标):
# http://localhost:3000/preview-mobile.html?screen=panel
title=none 这一档看的是「配了开关但没起名字」:节名回落到第一个页签名(那张假单子有页签,
所以标题行照摆),部门那一格念的是路径末段 软件开发事业部,不是整条 紫光汇智\软件开发事业部。
groups=on 那一档眼看三件事:摘要切成三段、段名照那一格写的名字、「完整单据」那屏切的是
同样三段(groups=on&single=1 就该退回一整节,摘要一段到底、末尾不留「完整单据」那一行)。
三段都在的预览是 screen=work(单据详情,只读,那一屏摊全部格子);screen=detail 是办理那一屏,
出差天数 / 明细 / 发票那几格归上面的填写块,摘要里只剩两段——段没少,是格子换了地方摆。
预览台是 dev only 的(src/dev/mobilePreview.ts),吃真的版式组件、真的词条、真的 Tailwind,
数据用 mobileFixtures.ts 那份假报销单——不打后端、不碰数据库。
form=custom 那份配置照面板存盘的形状补齐:清单没点名的格子一律标成 mobileHidden,
所以那一屏摆的正好是清单上写了「展示」的那几条——与在真设计器里点过一遍的表单同形。
测试(cd frontend && npx vitest run,这一轮跑完是 204 个文件 / 2149 条):
| 文件 | 盯什么 |
|---|---|
utils/mobileLayout.spec.ts |
配置读不读得出来、清单顺序、摆法回落、删格补格对账、外部页面那一格的键与开关,「分组标题」那枚分节标记(按表单上的次序认、换页不跟、ignoreDividers 只在那一屏、段名没写时走桌面那句兜底),以及那一句判据的整张真值表(默认隐藏点没点名 / 环节说隐藏 / 环节明给只读 / mobileHidden 压过 show / 条件成立与翻走的四种问法:{data} 评条件、{data, readback} 只放行不收、不给值不评、{design} 按"条件说了算"报) |
components/oa/mobile/useFormPlan.spec.ts |
照清单摆那一版一节与几节两种、段跟着「分组标题」切而归属认表单上的次序(清单里挪格子不换段)、段先后照清单第一次出现的位置、第一个分组之前那一截归 title 且没有这一截时不出现、整段被闸掉不留空段、分隔条不切段、singleSection 退回一节、自动归置那一版同样认分组(段里再挂分隔条时谁近听谁的)、三屏切同样的段、系统取数不再并走、空值照样摆、三道闸、整单默认隐藏点名的那格上屏、条件成立时它自己就上屏而条件翻走后与普通条件格一起下去(配了版式与自动归置两条路各一条、condData 给不给两种)、回看那一屏拿存过的那份值只放行「默认隐藏 + 显示条件」那一组、置顶上限、明细两档、入口开关、外部页面那张卡片与它的两道闸、节名是配置起的还是兜底的、部门那一格只念部门名 |
components/oa/mobile/MobileFormSummary.spec.ts(26 条) |
屏幕上真是那样:分组切成两节时两行标题各带自己的条数、每一段自己折自己不带走别的段、没起那一格时还是从前一坨、勾了「严格只出一节」只剩一行标题、不折叠、—、缩略图、卡片带对 job/activity/slotKey、开关没开时还是从前那版、节名没配就不摆那一行标题、电脑上「默认隐藏」那格点过名的摆出来而没点名的不出现、条件格在办单屏跟着条件露与划、回看屏按存过的值把「默认隐藏 + 条件」那组摆回来而普通条件格照旧摊开,外加明细这一档:点了就地逐条摊开(摊的是那张子表的全部行、列按 mobileRowCells)、「点了摊开」与「配成逐条展开」两档摊出来逐字同一份、换一张单子不把上一张摊到第几条带过来 |
components/oa/mobile/MobileFormReader.spec.ts |
「完整单据」跟摘要同一句判据:清单点了名的默认隐藏格也摆、勾掉的两屏都不摆、配过的短名两屏念同一个名字、条件不成立的那几格只在办单那一屏消失(回看那一屏只放行不收) |
components/oa/design/MobileLayoutPanel.spec.ts |
清单对得上现在这张表、「分组标题」不进清单、有分组才摆那颗「严格只出一节」(写 singleSection,没分组不出现也不留多余的键)、改动当场 emit、上不上屏写的是 mobileHidden(外部页面那一行写配置的 hidden,电脑上默认隐藏那一行写配置的 show,配了显示条件那一行两笔都不写、角标写「按显示条件」)、底部那句统计与清单同一句判据、搜与筛、筛着时排序停用 |
components/oa/mobile/MobileFlow.spec.ts |
审批记录整条不折叠:十二环的单子摆十三行、没有「展开更早」那颗钮、发起那一行在最前 |
views/oa/design/FormDesignerView.mobile.spec.ts |
配完存得出去(content.layout.mobile)、重开读得回来、进撤销栈与未保存、删掉的格子不留死配置 |
后端那一头只验一件事:这份配置存出去还在。clean_option_source(clean_formats(content))
原样交回 layout.mobile(api/design.py 一行没动,跑一次内存里的函数就够,不建数据)。
6. 没做的
- 手机端没有自己那一份「分组」清单。段就是表单上那几枚「分组标题」,不另设第二套分段; 真想要一整节滚到底就勾那颗「严格只出一节」。给手机上单独配一层分组,等于让同一张单 在两处各有各的段,早晚会漂。
- 段不能单独起手机端名字、也不能单独排序。段名就是那一格写的名字(两屏共用), 段的先后由清单里第一次出现的位置决定。要"段"和"段名"都能配,就得把排版件拉进清单, 那一档要解决的却正好是"它没有值"。
- 发起页与桌面不变。这一档只管手机上那一屏只读的摆法,填单的那一屏仍是桌面那套网格。
- 不给"手机端必填""手机端可见范围"这类新语义。那些是权限与校验,不是版式; 一旦在这一层掺进去,同一件事就有了两处判据。
- 手机上不内嵌外部页面。那一整页在清单上是一格、在手机上是一张「打开」卡片—— 卡片能配、能排序、能勾掉,iframe 不给。别人的系统在 390px 里嵌进来就是没法看, 桌面那一版也一样是给卡片。