unis-oa/docs/mobile-form-layout-config.md

37 KiB
Raw Permalink Blame History

手机端表单版式:手机上摆哪几格、怎么摆能配,段跟着表单上的分组走

原话是这一句:「手机端的流程详情里面表单内容里面分:费用报销基本信息、系统取数、完整单据。 我不希望这样,我就希望只有费用报销基本信息。但是费用报销基本信息里面展示哪些字段、怎么排放 我需要有地方可以配置。」

这一档刚上线时手机上真的只出一节。后来又挨了一句:「手机端展示是否可以将我在表单中配置的 分组那个组件也展示出来,这样我在手机端也可以看出来表单字段是哪个分组,这样手机端看着也比较舒服。」 ——「分组标题」那一格在电脑上有抬头、有色标、有线,手机上整块丢了,配表的人等于白起那些名字。 于是「只出一节」这一条改成了**「一节还是几节由表单上摆的『分组标题』决定」**:没摆就还是一节, 摆了几枚就切几段(见 §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,摘要、完整单据、设计器面板、底部那句"上屏几格" 读的都是它(从前是四地各写一遍,才会出现"面板写着展示、手机上没有那一格"):

  1. 这份清单本身:逐格那颗「手机上不展示」(field.mobileHidden,与属性面板那颗同一个键; 外部页面那一格记配置的 hidden)——记在 plan.hiddenMobile;
  2. 本环节字段权限说「隐藏」(perms[field.key] === 'hidden')——记在 plan.dropped。 权限问的是"这个人此刻能不能看",配表的人说了不算,所以它压在配置之上。
  3. 这一格配的「显示条件」此刻不成立——记在 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 里嵌进来就是没法看, 桌面那一版也一样是给卡片。