@moheng-design/ui-skill 3.0.0 → 3.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +6 -4
- package/bin/cli.js +62 -11
- package/bin/lib/upgrade.mjs +58 -0
- package/generated/SKILL.md +37 -14
- package/generated/contracts.json +52 -28
- package/generated/plugin-data.js +16 -6
- package/generated/reference.md +98 -58
- package/generated/rules.json +16 -6
- package/generated/skills/moheng-ui-audit/SKILL.md +1 -1
- package/generated/skills/moheng-ui-bootstrap/SKILL.md +1 -1
- package/generated/skills/moheng-ui-feedback/SKILL.md +5 -4
- package/generated/skills/moheng-ui-page/SKILL.md +5 -3
- package/generated/skills/moheng-ui-review/SKILL.md +1 -1
- package/generated/skills/moheng-ui-upgrade/SKILL.md +4 -2
- package/handwritten/canvas-model.md +23 -1
- package/handwritten/conventions.md +27 -24
- package/handwritten/skills/feedback.md +3 -2
- package/handwritten/skills/page.md +4 -2
- package/handwritten/skills/upgrade.md +3 -1
- package/package.json +2 -2
package/generated/rules.json
CHANGED
|
@@ -671,6 +671,8 @@
|
|
|
671
671
|
"columns-2",
|
|
672
672
|
"download",
|
|
673
673
|
"ellipsis",
|
|
674
|
+
"eye",
|
|
675
|
+
"file-text",
|
|
674
676
|
"funnel",
|
|
675
677
|
"info",
|
|
676
678
|
"kanban",
|
|
@@ -678,6 +680,7 @@
|
|
|
678
680
|
"list",
|
|
679
681
|
"message-square",
|
|
680
682
|
"minus",
|
|
683
|
+
"paperclip",
|
|
681
684
|
"pencil",
|
|
682
685
|
"plus",
|
|
683
686
|
"refresh-cw",
|
|
@@ -690,7 +693,7 @@
|
|
|
690
693
|
"upload",
|
|
691
694
|
"x"
|
|
692
695
|
],
|
|
693
|
-
"message": "<Icon> 的 name 取值须为 'activity' | 'arrow-down' | 'arrow-up' | 'calendar' | 'check' | 'chevron-down' | 'chevron-left' | 'chevron-right' | 'chevron-up' | 'chevrons-left' | 'chevrons-right' | 'circle-alert' | 'circle-check' | 'circle-check-big' | 'columns-2' | 'download' | 'ellipsis' | 'funnel' | 'info' | 'kanban' | 'layout-grid' | 'list' | 'message-square' | 'minus' | 'pencil' | 'plus' | 'refresh-cw' | 'search' | 'settings' | 'shield-check' | 'sliders-horizontal' | 'trash-2' | 'triangle-alert' | 'upload' | 'x' 之一",
|
|
696
|
+
"message": "<Icon> 的 name 取值须为 'activity' | 'arrow-down' | 'arrow-up' | 'calendar' | 'check' | 'chevron-down' | 'chevron-left' | 'chevron-right' | 'chevron-up' | 'chevrons-left' | 'chevrons-right' | 'circle-alert' | 'circle-check' | 'circle-check-big' | 'columns-2' | 'download' | 'ellipsis' | 'eye' | 'file-text' | 'funnel' | 'info' | 'kanban' | 'layout-grid' | 'list' | 'message-square' | 'minus' | 'paperclip' | 'pencil' | 'plus' | 'refresh-cw' | 'search' | 'settings' | 'shield-check' | 'sliders-horizontal' | 'trash-2' | 'triangle-alert' | 'upload' | 'x' 之一",
|
|
694
697
|
"rationale": "取值与顺序取自契约 contracts/foundation/icon/icon.ts,不得在别处另立一份。"
|
|
695
698
|
},
|
|
696
699
|
{
|
|
@@ -760,11 +763,12 @@
|
|
|
760
763
|
"secondary",
|
|
761
764
|
"outline",
|
|
762
765
|
"ghost",
|
|
766
|
+
"ghost-accent",
|
|
763
767
|
"destructive",
|
|
764
768
|
"destructive-outline",
|
|
765
769
|
"link"
|
|
766
770
|
],
|
|
767
|
-
"message": "<Button> 的 variant 取值须为 'primary' | 'secondary' | 'outline' | 'ghost' | 'destructive' | 'destructive-outline' | 'link' 之一",
|
|
771
|
+
"message": "<Button> 的 variant 取值须为 'primary' | 'secondary' | 'outline' | 'ghost' | 'ghost-accent' | 'destructive' | 'destructive-outline' | 'link' 之一",
|
|
768
772
|
"rationale": "取值与顺序取自契约 contracts/foundation/actions/button.ts,不得在别处另立一份。"
|
|
769
773
|
},
|
|
770
774
|
{
|
|
@@ -3078,11 +3082,12 @@
|
|
|
3078
3082
|
"primary",
|
|
3079
3083
|
"secondary",
|
|
3080
3084
|
"quiet",
|
|
3085
|
+
"quiet-accent",
|
|
3081
3086
|
"link",
|
|
3082
3087
|
"destructive",
|
|
3083
3088
|
"destructive-outline"
|
|
3084
3089
|
],
|
|
3085
|
-
"message": "<SystemButton> 的 intent 取值须为 'primary' | 'secondary' | 'quiet' | 'link' | 'destructive' | 'destructive-outline' 之一",
|
|
3090
|
+
"message": "<SystemButton> 的 intent 取值须为 'primary' | 'secondary' | 'quiet' | 'quiet-accent' | 'link' | 'destructive' | 'destructive-outline' 之一",
|
|
3086
3091
|
"rationale": "取值与顺序取自契约 contracts/application-atomic/system-button.ts,不得在别处另立一份。"
|
|
3087
3092
|
},
|
|
3088
3093
|
{
|
|
@@ -3193,6 +3198,8 @@
|
|
|
3193
3198
|
"columns-2",
|
|
3194
3199
|
"download",
|
|
3195
3200
|
"ellipsis",
|
|
3201
|
+
"eye",
|
|
3202
|
+
"file-text",
|
|
3196
3203
|
"funnel",
|
|
3197
3204
|
"info",
|
|
3198
3205
|
"kanban",
|
|
@@ -3200,6 +3207,7 @@
|
|
|
3200
3207
|
"list",
|
|
3201
3208
|
"message-square",
|
|
3202
3209
|
"minus",
|
|
3210
|
+
"paperclip",
|
|
3203
3211
|
"pencil",
|
|
3204
3212
|
"plus",
|
|
3205
3213
|
"refresh-cw",
|
|
@@ -3212,7 +3220,7 @@
|
|
|
3212
3220
|
"upload",
|
|
3213
3221
|
"x"
|
|
3214
3222
|
],
|
|
3215
|
-
"message": "<ApplicationPrimaryNavigation> 的 appGlyph 取值须为 'activity' | 'arrow-down' | 'arrow-up' | 'calendar' | 'check' | 'chevron-down' | 'chevron-left' | 'chevron-right' | 'chevron-up' | 'chevrons-left' | 'chevrons-right' | 'circle-alert' | 'circle-check' | 'circle-check-big' | 'columns-2' | 'download' | 'ellipsis' | 'funnel' | 'info' | 'kanban' | 'layout-grid' | 'list' | 'message-square' | 'minus' | 'pencil' | 'plus' | 'refresh-cw' | 'search' | 'settings' | 'shield-check' | 'sliders-horizontal' | 'trash-2' | 'triangle-alert' | 'upload' | 'x' 之一",
|
|
3223
|
+
"message": "<ApplicationPrimaryNavigation> 的 appGlyph 取值须为 'activity' | 'arrow-down' | 'arrow-up' | 'calendar' | 'check' | 'chevron-down' | 'chevron-left' | 'chevron-right' | 'chevron-up' | 'chevrons-left' | 'chevrons-right' | 'circle-alert' | 'circle-check' | 'circle-check-big' | 'columns-2' | 'download' | 'ellipsis' | 'eye' | 'file-text' | 'funnel' | 'info' | 'kanban' | 'layout-grid' | 'list' | 'message-square' | 'minus' | 'paperclip' | 'pencil' | 'plus' | 'refresh-cw' | 'search' | 'settings' | 'shield-check' | 'sliders-horizontal' | 'trash-2' | 'triangle-alert' | 'upload' | 'x' 之一",
|
|
3216
3224
|
"rationale": "取值与顺序取自契约 contracts/application-module/navigation/application-primary-navigation.ts,不得在别处另立一份。"
|
|
3217
3225
|
},
|
|
3218
3226
|
{
|
|
@@ -3777,6 +3785,7 @@
|
|
|
3777
3785
|
"businessView",
|
|
3778
3786
|
"onBusinessViewChange",
|
|
3779
3787
|
"resultSummary",
|
|
3788
|
+
"selectedSummary",
|
|
3780
3789
|
"searchValue",
|
|
3781
3790
|
"onSearchChange",
|
|
3782
3791
|
"onSearchSubmit",
|
|
@@ -3799,7 +3808,7 @@
|
|
|
3799
3808
|
"style",
|
|
3800
3809
|
"children"
|
|
3801
3810
|
],
|
|
3802
|
-
"message": "<ApplicationQueryToolbar> 不接受该 prop。已声明的 props:businessViews、businessView、onBusinessViewChange、resultSummary、searchValue、onSearchChange、onSearchSubmit、searchPlaceholder、searchAriaLabel、commonFilters、moreFilters、sort、appliedTags、onRemoveTag、onResetTags、presentation、hasPresentationSettings、onPresentationSettings、presentationSettingsOpen、viewModeSwitch。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
3811
|
+
"message": "<ApplicationQueryToolbar> 不接受该 prop。已声明的 props:businessViews、businessView、onBusinessViewChange、resultSummary、selectedSummary、searchValue、onSearchChange、onSearchSubmit、searchPlaceholder、searchAriaLabel、commonFilters、moreFilters、sort、appliedTags、onRemoveTag、onResetTags、presentation、hasPresentationSettings、onPresentationSettings、presentationSettingsOpen、viewModeSwitch。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
3803
3812
|
"rationale": "本条的 allowed 只列自有 props 与 React 保留项。继承自 HTMLAttributes<HTMLDivElement> 的属性由 plugin-data.js 的 nativeBases 表按基类共享放行,直接消费 rules.json 的工具须同时读那张表。契约:contracts/application-module/content/application-query-toolbar.ts"
|
|
3804
3813
|
},
|
|
3805
3814
|
{
|
|
@@ -4014,13 +4023,14 @@
|
|
|
4014
4023
|
"onCancel",
|
|
4015
4024
|
"secondaryActions",
|
|
4016
4025
|
"footerNote",
|
|
4026
|
+
"preview",
|
|
4017
4027
|
"children",
|
|
4018
4028
|
"key",
|
|
4019
4029
|
"ref",
|
|
4020
4030
|
"className",
|
|
4021
4031
|
"style"
|
|
4022
4032
|
],
|
|
4023
|
-
"message": "<ApplicationFormDialog> 不接受该 prop。已声明的 props:open、title、description、size、columns、submitText、cancelText、submitting、error、onSubmit、onCancel、secondaryActions、footerNote、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
4033
|
+
"message": "<ApplicationFormDialog> 不接受该 prop。已声明的 props:open、title、description、size、columns、submitText、cancelText、submitting、error、onSubmit、onCancel、secondaryActions、footerNote、preview、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素",
|
|
4024
4034
|
"rationale": "本条的 allowed 只列自有 props 与 React 保留项。继承自 HTMLAttributes<HTMLDivElement> 的属性由 plugin-data.js 的 nativeBases 表按基类共享放行,直接消费 rules.json 的工具须同时读那张表。契约:contracts/application-module/overlays/application-form-dialog.ts"
|
|
4025
4035
|
},
|
|
4026
4036
|
{
|
|
@@ -7,7 +7,7 @@ description: 用 @moheng-design/ui 搭系统的过程中撞到组件缺失、pro
|
|
|
7
7
|
|
|
8
8
|
# 问题收集与回流
|
|
9
9
|
|
|
10
|
-
适用版本:v3.
|
|
10
|
+
适用版本:v3.1.1
|
|
11
11
|
|
|
12
12
|
## 为什么要结构化
|
|
13
13
|
|
|
@@ -36,8 +36,9 @@ description: 用 @moheng-design/ui 搭系统的过程中撞到组件缺失、pro
|
|
|
36
36
|
|
|
37
37
|
```tsx
|
|
38
38
|
// TODO(moheng): missing-component 看板呈现没有对应组件
|
|
39
|
-
|
|
40
|
-
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
绕过而不记录,问题就永远留在项目里,组件库永远不知道。
|
|
41
42
|
|
|
42
43
|
## 收集
|
|
43
44
|
|
|
@@ -56,7 +57,7 @@ npx @moheng-design/ui-skill feedback
|
|
|
56
57
|
```markdown
|
|
57
58
|
### <反馈类型> · <组件或 token 名>
|
|
58
59
|
|
|
59
|
-
- 版本:@moheng-design/ui v3.
|
|
60
|
+
- 版本:@moheng-design/ui v3.1.1
|
|
60
61
|
- 位置:<文件:行>
|
|
61
62
|
- 复现:<最小代码>
|
|
62
63
|
- 期望:<一句话>
|
|
@@ -7,7 +7,7 @@ description: 用 @moheng-design/ui 的 Application Module 层搭一个完整页
|
|
|
7
7
|
|
|
8
8
|
# 页面骨架
|
|
9
9
|
|
|
10
|
-
适用版本:v3.
|
|
10
|
+
适用版本:v3.1.1
|
|
11
11
|
|
|
12
12
|
## 先定字段,再碰组件
|
|
13
13
|
|
|
@@ -16,7 +16,9 @@ Application Module 层的组件不能脱离五层 Canvas 模型使用。写第
|
|
|
16
16
|
`ApplicationDataDisplay` 展示的记录集合:
|
|
17
17
|
|
|
18
18
|
- **有结果集**(列表、台账、报表、以查询结果为主体的分析页):下面五个字段必须逐个定下来
|
|
19
|
-
|
|
19
|
+
并写进代码,不得含糊、不得留空。只有一个工作视角时 `businessView` 定为「单视角」、工具栏第一行不渲染;
|
|
20
|
+
只有分页、没有搜索筛选排序时 `dataControl` 只含 pagination、不渲染工具栏 —— 这两种都是有效取值,
|
|
21
|
+
写法见 SKILL.md「五层 Canvas 模型」。
|
|
20
22
|
- **没有结果集**(工作台、详情页、配置页、协作工作台、编辑器):只声明 `pageType`,其余
|
|
21
23
|
四个字段不写,也不得为凑字段塞一个数据展示区或空工具栏。结构按 SKILL.md「无结果集页面
|
|
22
24
|
的结构」一节搭。
|
|
@@ -68,7 +70,7 @@ Application Module 层的组件不能脱离五层 Canvas 模型使用。写第
|
|
|
68
70
|
|
|
69
71
|
骨架的硬要求:
|
|
70
72
|
|
|
71
|
-
- 该写的字段显式写进组件 props
|
|
73
|
+
- 该写的字段显式写进组件 props,不写在注释里(唯一例外:单视角的 `businessView` 没有 prop 可写,记在五层声明注释里)。落点是:
|
|
72
74
|
`pageType` → `ApplicationPageLayoutContainer`(必填);
|
|
73
75
|
`pageMode` → `ApplicationPageHeader`;
|
|
74
76
|
`businessView` → `ApplicationQueryToolbar`;
|
|
@@ -7,7 +7,7 @@ description: 升级项目里的 @moheng-design/ui 版本时加载。先看契约
|
|
|
7
7
|
|
|
8
8
|
# 版本升级
|
|
9
9
|
|
|
10
|
-
适用版本:v3.
|
|
10
|
+
适用版本:v3.1.1
|
|
11
11
|
|
|
12
12
|
## 差异由契约算
|
|
13
13
|
|
|
@@ -22,7 +22,9 @@ npx @moheng-design/ui-skill upgrade --from <旧版 contracts.json 的路径>
|
|
|
22
22
|
|
|
23
23
|
旧版 `contracts.json` 在升级前的 `node_modules/@moheng-design/ui-skill/generated/` 里,
|
|
24
24
|
升级前先拷一份出来。命令比对新旧两份,产出 `moheng-upgrade.md`:
|
|
25
|
-
组件的增删、prop 的增删与必填变化、枚举值的增删、类型的收窄与变化、新标为弃用的 prop
|
|
25
|
+
组件的增删、prop 的增删与必填变化、枚举值的增删、类型的收窄与变化、新标为弃用的 prop,
|
|
26
|
+
以及子类型(`TableColumn`、`Metric`、`DetailSection` 这类列定义、指标项、分节接口)的字段增删、
|
|
27
|
+
必填翻转与类型变化 —— 子类型条目带「(某组件的子类型)」后缀,去该组件的 reference.md 章节查。
|
|
26
28
|
|
|
27
29
|
3. 按报告改代码,从破坏性的几节改起(报告按此排序,「新增」两节排在最后)。删掉的 prop
|
|
28
30
|
与枚举值、收窄为固定取值的 prop 对应的是 `props-whitelist` / `prop-enum` 会报的那些
|
|
@@ -139,6 +139,18 @@ Shell 契约禁止在导航带内增加未登记元素:搜索框、面包屑
|
|
|
139
139
|
| L4 数据控制 | `dataControl` | search / filters / sort / pagination / appliedFilterTags |
|
|
140
140
|
| L5 数据呈现 | `dataPresentation` | `DataTable` / `RecordList` / `CardList` / `KanbanBoard` / `Calendar` / `Chart` / `Timeline` |
|
|
141
141
|
|
|
142
|
+
结果集页面里有两种层的内容「只有一种」的情形,写法固定,不算缺层:
|
|
143
|
+
|
|
144
|
+
- **单视角**:结果集没有多个稳定工作视角时(需求写明「无页签」),`businessView` 这一层的取值是
|
|
145
|
+
「单视角」。不传 `businessViews` / `businessView` / `onBusinessViewChange`,工具栏第一行不渲染;
|
|
146
|
+
不得为凑出一行虚构一个只有「全部」的标签。这一层没有可写的 prop,是五层里唯一只在页面的
|
|
147
|
+
五层声明注释里记下取值(`businessView: 单视角`)的情形。
|
|
148
|
+
- **只有分页**:结果集没有搜索、筛选、排序时,`dataControl` 只含 pagination。不渲染
|
|
149
|
+
`ApplicationQueryToolbar`(它的第二行恒有搜索框,不得为凑工具栏放一个用不上的搜索),
|
|
150
|
+
`ApplicationPageLayoutContainer` 不传 `dataControl`,`ListTablePagination` 照常进
|
|
151
|
+
`ApplicationDataDisplay` 的 `pagination`;`dataPresentation` 只落在 `ApplicationDataDisplay` 的
|
|
152
|
+
`presentation`。这种页面通常也是单视角。
|
|
153
|
+
|
|
142
154
|
`DETAIL` 与 `COMPOSITE` **不是**页面模式,是特殊物理结构资产。
|
|
143
155
|
`Embedded` 是 `integrationMode`,不是页面模式。
|
|
144
156
|
|
|
@@ -186,7 +198,8 @@ WORKBENCH ApplicationPageLayoutContainer pageType="WORKBENCH"
|
|
|
186
198
|
└─ children 分区导航 GlobalSidebar + 面板网格(指标区、待办、动态、应用入口)
|
|
187
199
|
|
|
188
200
|
DETAIL ApplicationPageLayoutContainer pageType="DETAIL"
|
|
189
|
-
├─ header ApplicationPageHeader(
|
|
201
|
+
├─ header ApplicationPageHeader(onBack 回到来源列表;只有要展示多级路径时才改用 breadcrumb,
|
|
202
|
+
│ 两者不得同时传;对象级动作放 actions)
|
|
190
203
|
└─ children ApplicationRecordDetailBody(分节;分节级动作放分节标题行)
|
|
191
204
|
|
|
192
205
|
编辑器 ApplicationPageLayoutContainer pageType 随所属业务
|
|
@@ -269,4 +282,13 @@ DETAIL ApplicationPageLayoutContainer pageType="DETAIL"
|
|
|
269
282
|
业务记录的占位符(07 · C-8):`成员 A` / `成员 B` / `成员 C`(人名)· `对象 A` / `对象 B` / `对象 C`(业务对象名)·
|
|
270
283
|
`编号 0001` / `编号 0002`(记录编号,四位补零递增)。同类条目按字母或序号顺延,不得换用真实人名。
|
|
271
284
|
|
|
285
|
+
未登记的类型按两条规则生成,同样逐字复用、按字母顺延:
|
|
286
|
+
|
|
287
|
+
- **名称类**写「类型名 + 空格 + 字母」:`部门 A` / `部门 B`(组织部门)· `城市 A`(地区)· `规格 A`(规格型号)·
|
|
288
|
+
`项目 A`(项目)。不得借用 `对象 A` 充当部门或城市 —— 读者分不清那一列是什么。
|
|
289
|
+
- **定长编码类**按真实位数写,用 0 补齐、末位按序号顺延,让列宽与真实数据一致:
|
|
290
|
+
`913100000000000001` / `913100000000000002`(统一社会信用代码 / 纳税人识别号,18 位)·
|
|
291
|
+
`6222000000000001`(银行卡号,16 位)。
|
|
292
|
+
不得用随手敲的数字串,也不得用真实存在的编码。
|
|
293
|
+
|
|
272
294
|
`模块1` / `模块2` 作为标签文案被明令禁止。
|
|
@@ -97,7 +97,8 @@ Mock 数据用已登记的占位符,`模块1 / 模块2` 被明令禁止。
|
|
|
97
97
|
UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`,不写 `你没有权限`。
|
|
98
98
|
表单与说明文案(02 §8):校验错误写字段名与不满足的条件(`任务名称不能为空`);
|
|
99
99
|
确认说明写后果(`删除后 3 条记录不可恢复`),不写请求;占位文字写示例或范围
|
|
100
|
-
|
|
100
|
+
(`例如:季度巡检记录`),不写指令 —— 唯一的例外是组件内置的 `ListTablePagination` 跳页框,
|
|
101
|
+
它照 GAP Design kit 写「请输入」,调用方不得仿照;无权限的出路点明找谁(`联系本模块管理员开通`)。
|
|
101
102
|
|
|
102
103
|
## Icon
|
|
103
104
|
|
|
@@ -137,7 +138,7 @@ UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`
|
|
|
137
138
|
- 页面区域内的内容分节切换改用 `Tabs`,不得用一排 ghost 按钮模拟。
|
|
138
139
|
- 原生 `<button>` 一律改用本组件(`mappings.json` · `no-native-button`)。
|
|
139
140
|
|
|
140
|
-
**组合约定。** `size` 与 `iconOnly` 是两根正交的轴(04 · A1):`size` 映射高度 24 / 28 / 32 / 40px,`iconOnly` 把宽度收敛为与高度相等并把行内内边距归零,两者可任意组合。`iconOnly` 为 true 时必须提供 `aria-label`,因为按钮没有可见文字。`children` 是必填的 —— 等宽图标按钮的 `children` 就是那个 `Icon` 元素。一个动作组内至多一个 `variant="primary"`;上下文区的页面动作组由 `ApplicationPageHeader` 的 `actions` 承载,同样至多一个。外边距一律由容器负责:动作对交给 `ButtonGroup`(未拼接态以 8px 分隔),页面动作组交给 `ApplicationPageHeader`,批量动作交给 `ListBatchActionBar` 的 `actions`,按钮自身不得带 margin。图标与文字的 4px 间隙由按钮的 gap 提供,不得再包一层带间距的容器。破坏性动作用 `variant="destructive"`,且必须经 `AlertDialog`
|
|
141
|
+
**组合约定。** `size` 与 `iconOnly` 是两根正交的轴(04 · A1):`size` 映射高度 24 / 28 / 32 / 40px,`iconOnly` 把宽度收敛为与高度相等并把行内内边距归零,两者可任意组合。`iconOnly` 为 true 时必须提供 `aria-label`,因为按钮没有可见文字。`children` 是必填的 —— 等宽图标按钮的 `children` 就是那个 `Icon` 元素。一个动作组内至多一个 `variant="primary"`;上下文区的页面动作组由 `ApplicationPageHeader` 的 `actions` 承载,同样至多一个。外边距一律由容器负责:动作对交给 `ButtonGroup`(未拼接态以 8px 分隔),页面动作组交给 `ApplicationPageHeader`,批量动作交给 `ListBatchActionBar` 的 `actions`,按钮自身不得带 margin。图标与文字的 4px 间隙由按钮的 gap 提供,不得再包一层带间距的容器。破坏性动作用 `variant="destructive"`,且必须经 `AlertDialog` 确认,批量场景的标题中写明受影响对象的数量。各变体的默认、移入、按下、禁用四态逐个对齐 GAP Design kit 按钮组件集 24:2110:`primary` 移入变浅、按下变深、禁用为浅主色底白字,三档从换肤主色 `--ds-color-theme-primary` 派生,换肤时随之变化;`secondary` 移入只把文字变为主色,按下为主色 15% 底、主色描边与主色字,禁用只把文字退为文字3;`ghost` 移入中性 6% 底、按下中性 25% 底;`ghost-accent` 透明底、主色字,移入主色 6% 底、按下主色 15% 底,用于行内动作(kit「类型=幽灵主要」)。`outline`、`destructive`、`link` 在 kit 里没有对应类型。本组件不持有任何状态,无 `"use client"`,可直接作为 server component 使用。`aria-disabled="true"` 与原生 `disabled` 同一套禁用外观但保持可聚焦,本组件不拦截事件,阻断动作由设置它的一方负责。`size` 已从 `ButtonHTMLAttributes` 中 `Omit`,契约的四档尺寸取代原生 `size` 属性。
|
|
141
142
|
|
|
142
143
|
**禁止 / 使用边界。**
|
|
143
144
|
|
|
@@ -163,7 +164,7 @@ UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`
|
|
|
163
164
|
- 翻页控件改用 `Pagination`,列表与表格的翻页改用 `ListTablePagination`。
|
|
164
165
|
- 单个动作不成组,直接用 `SystemButton`。
|
|
165
166
|
|
|
166
|
-
**组合约定。** `children` 是 slot 而非数据 prop,这与 `ToggleGroup` 的 `items` 形态相反,分工是实质性的(04 · A4):本组只做拼接、不管状态,因此接受任意子节点,包括 Fragment、数组与条件渲染,子组件也不必接受或转发 `style`。拼接态的圆角压平与 1px 边框重叠由 CSS 结构伪类完成,不做属性注入,子组件的 `className` 优先级不受影响。组内按钮的 `size` 必须一致,否则拼接边缘对不齐。拼接态要求子项都有可见边框才对得上,因此不得在拼接态里混入 `intent="quiet"` 与 `intent="link"`(库内为 `variant="ghost"` 与 `variant="link"`)。组渲染 `role="group"`,若该组表达的是互斥选择,说明组件选错了。组自身不带外边距,与相邻元素的距离由容器负责。子项中至多一个 primary。
|
|
167
|
+
**组合约定。** `children` 是 slot 而非数据 prop,这与 `ToggleGroup` 的 `items` 形态相反,分工是实质性的(04 · A4):本组只做拼接、不管状态,因此接受任意子节点,包括 Fragment、数组与条件渲染,子组件也不必接受或转发 `style`。拼接态的圆角压平与 1px 边框重叠由 CSS 结构伪类完成,不做属性注入,子组件的 `className` 优先级不受影响。组内按钮的 `size` 必须一致,否则拼接边缘对不齐。拼接态要求子项都有可见边框才对得上,因此不得在拼接态里混入 `intent="quiet"`、`intent="quiet-accent"` 与 `intent="link"`(库内为 `variant="ghost"`、`variant="ghost-accent"` 与 `variant="link"`)。组渲染 `role="group"`,若该组表达的是互斥选择,说明组件选错了。组自身不带外边距,与相邻元素的距离由容器负责。子项中至多一个 primary。
|
|
167
168
|
|
|
168
169
|
**禁止 / 使用边界。**
|
|
169
170
|
|
|
@@ -921,7 +922,7 @@ UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`
|
|
|
921
922
|
- 只是一组同构的目录行,无列对齐需求 —— 改用 `Item`。
|
|
922
923
|
- 需要手写 `<table>` / `<tr>` / `<td>` —— 一律改用本组件,手写表格拿不到已登记的表头底色、行分隔线与列宽约定。
|
|
923
924
|
|
|
924
|
-
**组合约定。** 本组件不持有外边距,与相邻区块的间隙由 `ApplicationDataDisplay` 与 `ApplicationPageLayoutContainer` 负责;横向溢出在组件内部消化,外部不得再套横向滚动容器。`selectable` 为 true 时必须同时提供 `selected` 与 `onSelectedChange`,否则勾选框点了没有任何反应;选择框由 `ListSelectionCheckbox` 承担,勾选不会顺带触发 `onRowClick`;它的可访问名是「选择」加标题列(首个 `priority: 'primary'` 的列,未声明取首列)单元格的内容。给了 `onRowClick` 的行可聚焦,Enter / 空格触发同一回调,行保留表格行语义、不改作按钮。行点击与按键忽略来自行内可交互元素(按钮、链接、勾选框、菜单等)的事件,`render` 里放这类控件时调用方不必再手动阻止冒泡。任一列设了 `sortable` 时必须同时提供 `sort` 与 `onSortChange`,同列再次点击在 `asc` 与 `desc` 间切换。放进 `ApplicationDataDisplay` 时,表头排序是工具栏 `sort` 槽位(`Select`)的第二入口,`sort` 必须与工具栏取自同一份排序状态(07 · C-2)。`rowKey` 必须指向 `rows` 中真实存在且唯一的字段,缺省值是 `id`。每一列都应显式设置 `priority`:`low` 列在 1180px 宽或 720px 高以下整列隐藏,单元格内边距在 1439px 以下先行压缩,顺序即「先压间距,再压列数,再压优先级」。单独使用时 `rows` 为空必须提供 `empty`,且应当传 `<Empty />`;放进 `ApplicationDataDisplay` 时不另设 `empty`,空结果由数据展示区的 `state="empty"` 与 `empty` 槽位承担(07 · C-6)。批量动作条与分页不属于本组件,分别走 `ApplicationDataDisplay` 的 `batchBar` 与 `pagination` 槽位,前者传 `ListBatchActionBar`,后者传 `ListTablePagination`。有设计稿时,每一列的 `width` 取设计稿的列宽:固定宽的列写数字,弹性列不写 `width
|
|
925
|
+
**组合约定。** 本组件不持有外边距,与相邻区块的间隙由 `ApplicationDataDisplay` 与 `ApplicationPageLayoutContainer` 负责;横向溢出在组件内部消化,外部不得再套横向滚动容器。`selectable` 为 true 时必须同时提供 `selected` 与 `onSelectedChange`,否则勾选框点了没有任何反应;选择框由 `ListSelectionCheckbox` 承担,勾选不会顺带触发 `onRowClick`;它的可访问名是「选择」加标题列(首个 `priority: 'primary'` 的列,未声明取首列)单元格的内容。给了 `onRowClick` 的行可聚焦,Enter / 空格触发同一回调,行保留表格行语义、不改作按钮。行点击与按键忽略来自行内可交互元素(按钮、链接、勾选框、菜单等)的事件,`render` 里放这类控件时调用方不必再手动阻止冒泡。任一列设了 `sortable` 时必须同时提供 `sort` 与 `onSortChange`,同列再次点击在 `asc` 与 `desc` 间切换。放进 `ApplicationDataDisplay` 时,表头排序是工具栏 `sort` 槽位(`Select`)的第二入口,`sort` 必须与工具栏取自同一份排序状态(07 · C-2)。`rowKey` 必须指向 `rows` 中真实存在且唯一的字段,缺省值是 `id`。每一列都应显式设置 `priority`:`low` 列在 1180px 宽或 720px 高以下整列隐藏,单元格内边距在 1439px 以下先行压缩,顺序即「先压间距,再压列数,再压优先级」。单独使用时 `rows` 为空必须提供 `empty`,且应当传 `<Empty />`;放进 `ApplicationDataDisplay` 时不另设 `empty`,空结果由数据展示区的 `state="empty"` 与 `empty` 槽位承担(07 · C-6)。批量动作条与分页不属于本组件,分别走 `ApplicationDataDisplay` 的 `batchBar` 与 `pagination` 槽位,前者传 `ListBatchActionBar`,后者传 `ListTablePagination`。有设计稿时,每一列的 `width` 取设计稿的列宽:固定宽的列写数字,弹性列不写 `width`,由表格均分剩余宽度(固定表格布局,GAP Design kit「列表」的弹性列等分)—— 不得全部留空交给浏览器按内容分配。弹性列最窄 88px,容器不够分时表格转为在自身内部横向滚动。表头文字 14/20 medium 文字2。行内动作(「编辑 / 删除」)用 `SystemButton intent="quiet-accent"`(kit「类型=幽灵主要」,列表操作单元 123:5796)。单元格里放了按钮时,该单元格上下内边距自动收为 12,32 高的按钮落进 56 的行,不撑高行(kit「列表」类型=操作);调用方不得为此改用 `size="sm"` 或自写单元格样式。列数多、需要横向滚动时,末列「操作」写 `fixed: 'right'` 贴住右缘,首列标题列可写 `fixed: 'left'`;只允许首列声明 `left`、末列声明 `right`,每侧至多一列。附着在列表末尾的进行中状态(「识别中…」「正在加载更多」)经 `trailingRow` 渲染为一条横跨全部列的通栏行,与表体行同为最小高 56;`busy` 为 true 时文字取强调色并带扫光动效;`rows` 为空时它不渲染。
|
|
925
926
|
|
|
926
927
|
**禁止 / 使用边界。**
|
|
927
928
|
- 禁止手写 `<tr>` / `<td>` 作为子元素传入 —— 本组件不接受复合子组件,列与行只能来自 `columns` 与 `rows`。
|
|
@@ -1323,7 +1324,7 @@ UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`
|
|
|
1323
1324
|
|
|
1324
1325
|
**用途。** 转瞬即逝的提示堆栈,用于确认某件事已经发生 —— 已保存、已导出、3 条已办结。
|
|
1325
1326
|
|
|
1326
|
-
**何时使用。** 当结果是已完成的事实、用户无需据此采取任何行动时,该组件是默认选择。判据是单一的:如果用户错过了这条提示会有损失,它就不该是 toast。`title` 应是已完成事实的陈述。未指定 `duration` 时单条停留 5000ms
|
|
1327
|
+
**何时使用。** 当结果是已完成的事实、用户无需据此采取任何行动时,该组件是默认选择。判据是单一的:如果用户错过了这条提示会有损失,它就不该是 toast。`title` 应是已完成事实的陈述。未指定 `duration` 时单条停留 5000ms,指针停在堆栈上或键盘焦点在提示内时暂停;两者都离开后按剩余时间继续计时。
|
|
1327
1328
|
|
|
1328
1329
|
**何时改用其他组件。**
|
|
1329
1330
|
- 用户必须读到并处理的失败改用 `Alert`,就地呈现在受影响区域顶部。
|
|
@@ -1401,7 +1402,7 @@ UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`
|
|
|
1401
1402
|
|
|
1402
1403
|
**用途。** 查询工具栏主控制行中的常驻快捷筛选触发器,承载**一个**高频筛选维度的取值。
|
|
1403
1404
|
|
|
1404
|
-
**何时使用。** 该维度在结果集上高频使用、取值为短词且数量有限时,必须选用本组件。面板已登记 180px 最小宽与 280px 最高,取值控制在 8 项以内方能一屏读完。工具栏内至多常驻 2–3 个,其余维度一律下沉到「更多筛选」。触发器高 32px、圆角 12px,与同排的 `SearchField`
|
|
1405
|
+
**何时使用。** 该维度在结果集上高频使用、取值为短词且数量有限时,必须选用本组件。面板已登记 180px 最小宽与 280px 最高,取值控制在 8 项以内方能一屏读完。工具栏内至多常驻 2–3 个,其余维度一律下沉到「更多筛选」。触发器高 32px、圆角 12px,与同排的 `SearchField` 读作一行。触发器按 GAP Design kit「筛选/选择」五态呈现:默认(白底、线条色描边)、已选择(维度名与字形变主色,**只显示维度名、不回显取值**)、移入(主色描边)、点击(导航背景底)、展开(主色 6% 底、主色描边与文字)。取值只出现在工具栏第三行的已筛选标签里,读屏经视觉隐藏文本读到「维度名:取值」。
|
|
1405
1406
|
|
|
1406
1407
|
**何时改用其他组件。**
|
|
1407
1408
|
- 低频维度、或需要一次性提交多个维度:改用 `ApplicationFilterList`,它是「更多筛选」的面板主体,持有草稿并由「应用」提交。
|
|
@@ -1412,20 +1413,20 @@ UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`
|
|
|
1412
1413
|
- 键盘优先的全局搜索与执行:改用 `Command` 的 `dialog` 形态。
|
|
1413
1414
|
- 日期区间维度:改用 `ApplicationDateRangeFilter`,同样放进 `commonFilters`。
|
|
1414
1415
|
|
|
1415
|
-
**组合约定。** 该组件必须作为 `ApplicationQueryToolbar` 的 `commonFilters` 内容出现,传 2–3 个;不得独立散落在页面其他位置。该组件只持有本维度的取值,已生效条件必须由调用方回写到 `ApplicationQueryToolbar` 的 `appliedTags`,并实现 `onRemoveTag` 与 `onResetTags`;筛选状态只存在于菜单内部是不合规的。`ApplicationFilterOption.label` 传入非字符串时,必须同时提供 `labelText
|
|
1416
|
+
**组合约定。** 该组件必须作为 `ApplicationQueryToolbar` 的 `commonFilters` 内容出现,传 2–3 个;不得独立散落在页面其他位置。该组件只持有本维度的取值,已生效条件必须由调用方回写到 `ApplicationQueryToolbar` 的 `appliedTags`,并实现 `onRemoveTag` 与 `onResetTags`;筛选状态只存在于菜单内部是不合规的。`ApplicationFilterOption.label` 传入非字符串时,必须同时提供 `labelText`,否则读屏读到的取值退化为 `[object Object]`。`multiple` 为 true 时 `value` 与 `defaultValue` 必须是数组,为 false 时必须是字符串;单选状态下再次点选当前值会清空该维度,`onValueChange` 必须能接收空字符串。面板自带定位、碰撞翻转与外点击关闭,调用方不得再包一层 `Popover` 或 `DropdownMenu`。`count` 必须与数据展示区当前口径下的结果数一致。该组件不自带外边距,横向间距由工具栏的 `--ui-control-gap` 负责。
|
|
1416
1417
|
|
|
1417
1418
|
**禁止 / 使用边界。**
|
|
1418
1419
|
- 不得在一个查询工具栏内常驻超过 3 个筛选菜单。
|
|
1419
1420
|
- 禁止让已生效的筛选条件停留在菜单内部而不回写筛选标签行。
|
|
1420
1421
|
- 不得放进 `ApplicationPageHeader` —— 上下文区禁止出现搜索、筛选、排序。
|
|
1421
1422
|
- 不得用它切换 `pageMode` 或 `dataPresentation`,这两者各有专属控件。
|
|
1422
|
-
-
|
|
1423
|
+
- 不得覆盖触发器的高度、圆角与五种状态的外观,也不得把取值拼进 `label` 让触发器回显 —— 取值的视觉位置是已筛选标签行。
|
|
1423
1424
|
|
|
1424
1425
|
## ApplicationDateRangeFilter
|
|
1425
1426
|
|
|
1426
1427
|
**用途。** 查询工具栏主控制行中的日期区间快捷筛选,承载**一个**日期维度(接收时间、开票日期)的起止区间。
|
|
1427
1428
|
|
|
1428
|
-
**何时使用。** 结果集需要按某个日期维度的区间筛选、且该维度高频使用时,必须使用本组件。触发器与 `ApplicationFilterMenu`
|
|
1429
|
+
**何时使用。** 结果集需要按某个日期维度的区间筛选、且该维度高频使用时,必须使用本组件。触发器与 `ApplicationFilterMenu` 同高同壳、同一套五态,生效时只把维度名变为主色、不回显区间(区间读屏经可访问名读出,视觉上只在已筛选标签里);面板里起止各一张 `Calendar`,选择是草稿,「应用」提交、「清空」撤销。值为 `{ start?, end? }`,两端都是本地时区 ISO `yyyy-mm-dd`,缺省一端表示该端不限。
|
|
1429
1430
|
|
|
1430
1431
|
**何时改用其他组件。**
|
|
1431
1432
|
- 取值为有限枚举的维度:改用 `ApplicationFilterMenu`。
|
|
@@ -1433,7 +1434,7 @@ UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`
|
|
|
1433
1434
|
- 低频的日期维度:收进 `moreFilters` 的 `ApplicationFilterList` 面板,不常驻工具栏。
|
|
1434
1435
|
- 整页按日期浏览:改用 `pageMode` 为 `CALENDAR` 的日历承载面。
|
|
1435
1436
|
|
|
1436
|
-
**组合约定。** 该组件必须作为 `ApplicationQueryToolbar` 的 `commonFilters` 内容出现,与 `ApplicationFilterMenu` 合计常驻不超过 3 个。生效区间必须由调用方回写到 `appliedTags`(标签文案如「接收时间:2026-07-01 – 2026-07-28」),并在 `onRemoveTag` 里把区间清回 `{}`。`label` 为非字符串时必须提供 `labelText
|
|
1437
|
+
**组合约定。** 该组件必须作为 `ApplicationQueryToolbar` 的 `commonFilters` 内容出现,与 `ApplicationFilterMenu` 合计常驻不超过 3 个。生效区间必须由调用方回写到 `appliedTags`(标签文案如「接收时间:2026-07-01 – 2026-07-28」),并在 `onRemoveTag` 里把区间清回 `{}`。`label` 为非字符串时必须提供 `labelText`,它是触发器可访问名「维度名:起 – 止」的来源。结束日期早于开始日期时「应用」禁用,组件不替调用方交换两端。区间两端都是闭区间(含当天),调用方换算成接口参数时自行补足时分。
|
|
1437
1438
|
|
|
1438
1439
|
**禁止 / 使用边界。**
|
|
1439
1440
|
- 不得让已生效的区间只停留在触发器上而不回写筛选标签行。
|
|
@@ -1464,7 +1465,7 @@ UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`
|
|
|
1464
1465
|
|
|
1465
1466
|
**用途。** 数据展示区的标准页脚 —— 摘要、每页条数、页码窗口与跳页。
|
|
1466
1467
|
|
|
1467
|
-
**何时使用。** 结果集同时具备总数与每页条数需求时必须使用本组件,它是 LIST 页面模式的默认配置。形态按 GAP Design kit「分页行」固定为:左侧「每页 N 条,共 Z 条数据」摘要(12/20 三级文字色),右侧依次为每页条数选择器、`Pagination`(首页 · 上一页 · 页码窗口 · 下一页 · 末页)与「第 [ ] 页」跳页框,控件一律 32 高、圆角 12、间隔 4
|
|
1468
|
+
**何时使用。** 结果集同时具备总数与每页条数需求时必须使用本组件,它是 LIST 页面模式的默认配置。形态按 GAP Design kit「分页行」固定为:左侧「每页 N 条,共 Z 条数据」摘要(12/20 三级文字色),右侧依次为每页条数选择器、`Pagination`(首页 · 上一页 · 页码窗口 · 下一页 · 末页)与「第 [ ] 页」跳页框,控件一律 32 高、圆角 12、间隔 4。跳页框 68×32,占位「请输入」是 kit 原文、也是通则「占位写示例或范围」唯一的登记例外(总页数由可访问名「跳转到第几页,共 N 页」读出),回车提交,输入越界时夹到 1 与总页数之间,提交后清空;总页数很少时可传 `showJumper={false}` 隐去。每页条数默认档为 20 / 50 / 100,业务确有别的档位时通过 `pageSizeOptions` 覆盖。
|
|
1468
1469
|
|
|
1469
1470
|
**何时改用其他组件。**
|
|
1470
1471
|
- 既无总数也无每页条数需求:改用 `Pagination`,它是本组件内部的页码区,可以单独使用。
|
|
@@ -1544,7 +1545,7 @@ UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`
|
|
|
1544
1545
|
|
|
1545
1546
|
**用途。** 整个产品的默认动作按钮,是 Foundation `Button` 之上只承载应用意图、loading 与产品状态的薄适配层。
|
|
1546
1547
|
|
|
1547
|
-
**何时使用。** 业务页面中的每一个按钮都必须使用本组件,没有例外;Foundation `Button` 只供库内组件使用。改一次应用强调色,全部 `SystemButton` 同时换肤,这个性质正是它存在的理由。该组件绝不重新实现按钮的排版与几何:14/20 字号、32px 高度、12px 圆角全部来自 Foundation `Button`。删除类动作分两档:`intent="destructive-outline"
|
|
1548
|
+
**何时使用。** 业务页面中的每一个按钮都必须使用本组件,没有例外;Foundation `Button` 只供库内组件使用。改一次应用强调色,全部 `SystemButton` 同时换肤,这个性质正是它存在的理由。该组件绝不重新实现按钮的排版与几何:14/20 字号、32px 高度、12px 圆角全部来自 Foundation `Button`。删除类动作分两档:`intent="destructive-outline"`(白底、线条色描边、危险色文字;移入时描边变为危险色,按下时再加危险色 10% 底(GAP Design kit「按钮 / 类型=危险」三态))用于与次要按钮并排的删除,如表单里「删除此附件」;`intent="destructive"`(实心危险色)只用于 `AlertDialog` 里那个不可逆的最终确认,同一动作组内不得同时出现两档。记录级的行内动作(`Table` 操作列、`ApplicationRecordList` 行尾的「编辑 / 删除」)用 `intent="quiet-accent"`:透明底、主色字,移入主色 6% 底、按下主色 15% 底(GAP Design kit「按钮 / 类型=幽灵主要」,列表操作单元 123:5796);行内删除同样用它,危险提示交给删除前的 `AlertDialog`,kit 的行内没有红色删除。`intent="link"`(无内边距、带下划线)只留给句中或卡片页脚那种链接式动作。各意图的移入、按下、禁用态随 Foundation `Button` 对齐 kit 按钮组件集 24:2110,`primary` 的三态从换肤主色派生。
|
|
1548
1549
|
|
|
1549
1550
|
**何时改用其他组件。**
|
|
1550
1551
|
- 一组相关按钮需要拼接为分段控件或间隔簇:外层用 `ButtonGroup`,组内仍是 `SystemButton`。
|
|
@@ -1688,7 +1689,7 @@ UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`
|
|
|
1688
1689
|
- 行内或表格单元中的状态标签:改用 `Badge`。
|
|
1689
1690
|
- 承载业务内容而非数字的卡片:改用 `Card`。
|
|
1690
1691
|
|
|
1691
|
-
**组合约定。** 本组件必须放进 `ApplicationPageLayoutContainer` 的 `metrics` 槽位,区域之间的间隙由该容器的 `--ui-section-gap` 负责;卡片之间的间隙由本组件的 `--ui-card-gap` 负责(Standard 12px / Condensed 10px / Compact 8px)。单张指标卡不得自带外边距。`trend` / `status` / `chart` / `primary-secondary` 四种语义的卡片必须作为 `children` 写在本组件内部,与 `metrics` 生成的基础卡共用同一个 grid,等高才能成立;把它们平级另起一行会破坏等高。每区 4–6 张,`columns` 缺省取卡片总数(`metrics` 条目数加 `children` 中的卡片数,条件渲染为 `null` / `false` 的不计入)、上限 6。`Metric.key` 应显式提供 —— `label` 是 ReactNode,用它作 React key 在传入 JSX 时无效。`Metric.icon` 走 `Icon`,提供后该卡语义从 `numeric` 变为 `icon`。`Metric.description` 是数值下方一行 12/16 的口径说明(「2026 年 · 不含已冲红」),只写统计口径,不写趋势或操作提示;有设计稿时照稿给出,同一区内要么都写要么都不写,否则等高的卡片里文字基线不齐。指标壳不是卡片:无边框、无底色、无内边距,直接落在页面底色上,高 76px
|
|
1692
|
+
**组合约定。** 本组件必须放进 `ApplicationPageLayoutContainer` 的 `metrics` 槽位,区域之间的间隙由该容器的 `--ui-section-gap` 负责;卡片之间的间隙由本组件的 `--ui-card-gap` 负责(Standard 12px / Condensed 10px / Compact 8px)。单张指标卡不得自带外边距。`trend` / `status` / `chart` / `primary-secondary` 四种语义的卡片必须作为 `children` 写在本组件内部,与 `metrics` 生成的基础卡共用同一个 grid,等高才能成立;把它们平级另起一行会破坏等高。每区 4–6 张,`columns` 缺省取卡片总数(`metrics` 条目数加 `children` 中的卡片数,条件渲染为 `null` / `false` 的不计入)、上限 6。`Metric.key` 应显式提供 —— `label` 是 ReactNode,用它作 React key 在传入 JSX 时无效。`Metric.icon` 走 `Icon`,提供后该卡语义从 `numeric` 变为 `icon`。`Metric.description` 是数值下方一行 12/16 的口径说明(「2026 年 · 不含已冲红」),只写统计口径,不写趋势或操作提示;有设计稿时照稿给出,同一区内要么都写要么都不写,否则等高的卡片里文字基线不齐。指标壳不是卡片:无边框、无底色、无内边距,直接落在页面底色上,高 76px;标签 12/16、数值 32/32 semibold、说明 12/16 三行之间各 6(GAP Design kit「字段/竖/统计」)。指标数据在途或失败时用 `state` 表达,取值只有 `ready` / `loading` / `error` 三种:`loading` 由组件渲染与指标卡同壳同高的骨架(张数同 `columns` 的缺省算法,无卡片时为 4),调用方不得自拼骨架卡;`error` 渲染一张横跨整行的失败卡,内容经 `error` 传入,应说明失败原因并提供「重试」,不传时显示内置的「指标加载失败」。两种状态下 `metrics` 与 `children` 都不渲染;读屏经组件内置的状态播报获知「指标加载中」/「指标加载失败」。
|
|
1692
1693
|
|
|
1693
1694
|
**禁止 / 使用边界。**
|
|
1694
1695
|
- 不得用 `state="loading"` 长期占位来顶替「无真实指标」—— 无指标时整个区域不渲染。
|
|
@@ -1822,7 +1823,7 @@ UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`
|
|
|
1822
1823
|
- 面包屑本体用 `Breadcrumb`,经 `breadcrumb` 槽位传入;单纯回到上一层(二级页面)不用面包屑,改传 `onBack`。
|
|
1823
1824
|
|
|
1824
1825
|
**组合约定。**
|
|
1825
|
-
- `actions` 承载页面级动作组,元素应为 `SystemButton`,至多一个 primary
|
|
1826
|
+
- `actions` 承载页面级动作组,元素应为 `SystemButton`,至多一个 primary,直接并列传入、不包 `ButtonGroup`。动作之间的 4px 间隔由组件给出(GAP Design kit「数据更新、操作」的页面操作插槽)。中文标签为 2–4 字裸名词短语:`新建`、`导入`、`导出`、`更多`。
|
|
1826
1827
|
- Page Mode Switch 由 `pageModes`、`pageMode`、`onPageModeChange` 三者共同驱动,三者必须成组提供;只给 `pageModes` 会得到一个点不动的开关。它按 radiogroup 模式只占一个 Tab 停靠点,← / → 切换模式并首尾相接,Home / End 跳到首末项 —— 方向键同样触发 `onPageModeChange`。
|
|
1827
1828
|
- `pageModes` 只列该页面真正开放的模式。少于 2 个时开关完全不渲染且不占位。
|
|
1828
1829
|
- 左侧按 GAP Design kit「数据更新」排布:可选的「返回」→ 标题 → 12px 竖线 → 更新时间。传 `onBack` 时标题前渲染「返回」幽灵按钮(16px chevron + 文字,32 高、圆角 12),文案经 `backLabel` 可改,组件不跳转、回到哪里由调用方决定;二级页面用它回到来源页。`onBack` 与 `breadcrumb` 不得同时传。
|
|
@@ -1830,7 +1831,7 @@ UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`
|
|
|
1830
1831
|
- 传了 `onRefresh` 时,更新时间与其后的 16px 刷新字形合成一枚幽灵按钮,点它即刷新,可访问名为「刷新,2026-07-28 10:00」;没有刷新能力的页面(草稿、向导、一次性结果)不传,时间按纯文字显示,不出现刷新字形。
|
|
1831
1832
|
- 三种数据状态各有各的措辞与可用性:`normal` 显示更新时间,`refreshing` 显示刷新中、字形转圈且按钮不可点,`failed` 显示刷新失败(危险色)且按钮读作 `重试`。
|
|
1832
1833
|
- `title` 为字符串时才会得到悬浮提示。需要悬浮提示又需要补充信息时,标题主体传 `title`,补充信息走 `subtitle`。
|
|
1833
|
-
- 页面级进行中任务(批量识别、批量导入)的进度经 `taskStatus` 渲染为页头正中的胶囊,`label` 写「正在识别 14/100」,`busy` 为 true
|
|
1834
|
+
- 页面级进行中任务(批量识别、批量导入)的进度经 `taskStatus` 渲染为页头正中的胶囊,`label` 写「正在识别 14/100」,`busy` 为 true 时带强调色转圈;胶囊 32 高、内边距 6/10、主色 6% 底,文字为文字1。任务结束后移除 `taskStatus`,结果写进 `Sonner` 或页面内容。进度不得写进 `subtitle`。
|
|
1834
1835
|
- 外观是 48px 通栏:落在页面底色上、只有一条 0.5px 下边线,不是卡片;放在 `ApplicationPageLayoutContainer` 的 `header` 槽位时自动吃掉顶部与两侧留白。
|
|
1835
1836
|
- 该组件自身不带外边距,与相邻区域的间距由 `ApplicationPageLayoutContainer` 的区域间隙负责。
|
|
1836
1837
|
- Page Mode Switch 的选中态与 `ToggleGroup` 同为分段控件表达(选中项抬升为表面色),不得改为淡色洗 —— 淡色洗属于独立开关 `Toggle`。
|
|
@@ -1868,7 +1869,7 @@ UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`
|
|
|
1868
1869
|
- 第二行左组的顺序固定为「结果摘要 → 搜索 → 排序 → 常用筛选 → 更多」,右组只放 `viewModeSwitch` 与呈现设置(GAP Design kit「数据筛选搜索」:排序在搜索后面、筛选前面;业财平台 round-01 裁决)。
|
|
1869
1870
|
- 间隔按 kit「数据筛选搜索」:三行之间 8;第二行左组控件之间 4、右组之间 4、左右两组之间 12;摘要与搜索之间由组件画一条 1×20 的线条色竖线,只在传了 `resultSummary` 时出现。间隔与竖线都由组件给出,传入的排序与筛选控件不带外边距。
|
|
1870
1871
|
- `sort` 传 `Select`(无可见标签,用 `aria-label` 命名)。DataTable 呈现下表头排序是第二入口:`Table` 的 `sort` 与这里的 `Select` 读写同一份排序状态,任一处改动另一处同步回显(07 · C-2)。
|
|
1871
|
-
- `resultSummary` 渲染为一枚胶囊,数字用 `<strong>` 包裹即加粗为正文色,如 `<>共 <strong>46</strong>
|
|
1872
|
+
- `resultSummary` 渲染为一枚胶囊,数字用 `<strong>` 包裹即加粗为正文色,如 `<>共 <strong>46</strong> 张</>`。有勾选时已选数传 `selectedSummary`(「已选 3 张」),组件把它排在主文之后、间隔 8、12/16 三级文字色;不得把已选数拼进 `resultSummary`,没有勾选时不传、不写「已选 0 张」。
|
|
1872
1873
|
- 生效条件必须回写 `appliedTags`,并同时提供 `onRemoveTag` 与 `onResetTags`;清除全部的按钮文案为「清空」,与筛选标签同款胶囊。`AppliedFilterTag.label` 为非字符串时必须提供 `labelText`,否则移除按钮的无障碍名称为空。
|
|
1873
1874
|
- 呈现设置按钮按 kit 是 32×32 纯图标(16px `sliders-horizontal`,白底描边、圆角 12),名字落在可访问名与悬停提示上;`presentation` 决定这个名字,必须与 `ApplicationDataDisplay` 的同名 prop 取自同一处状态。
|
|
1874
1875
|
- `hasPresentationSettings` 缺省时按是否提供 `onPresentationSettings` 推断:给了回调即渲染设置按钮,不给即不渲染且不占位;显式传入优先。无真实可配置项时不传回调即可,或显式传 `hasPresentationSettings={false}`。
|
|
@@ -2001,10 +2002,11 @@ UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`
|
|
|
2001
2002
|
- 单个名值对之外的静态面板改用 `Card`。
|
|
2002
2003
|
|
|
2003
2004
|
**组合约定。**
|
|
2004
|
-
- `summary`
|
|
2005
|
-
- `sections` 按数组顺序渲染。`DetailSection.title`
|
|
2006
|
-
- 字段以 `dl` / `dt` / `dd` 输出为横排名值对:字段名 160px 宽、14/20 三级文字色,值 14/20 medium。列数随可用宽度自适应,字段列最窄 360px
|
|
2007
|
-
-
|
|
2005
|
+
- `summary` 承载对象头:对象名、状态徽标(应为 `Badge`)、关键标识。它渲染在白卡之外、落在载体灰底上并占满整行,有 `aside` 时横跨两栏(GAP Design kit「抽屉 / 常规」)。对象名用 24/32 medium:`--application-font-size-display` 与 `--application-line-height-display`,字重 `--application-font-weight-medium`;与状态徽标间隔 8。
|
|
2006
|
+
- `sections` 按数组顺序渲染。`DetailSection.title` 省略或为非字符串时必须提供 `key`;契约同样为 `DetailField` 登记了 `key`,`label` 为非字符串时必须提供。
|
|
2007
|
+
- 字段以 `dl` / `dt` / `dd` 输出为横排名值对:字段名 160px 宽、14/20 三级文字色,值 14/20 medium。列数随可用宽度自适应,字段列最窄 360px,两个载体不需要各写一套。分节内容落在内边距 12 的白卡里,载体负责灰底;分节间距 16,分节标题带 2×14 强调色竖条。
|
|
2008
|
+
- `DetailSection.title` 可省略:内容自带版式、再加分节标题会重复时(票面、单据影像这类整块呈现的内容)不渲染标题行与竖条。只有第一个分节可以省略,后续分节一律写标题,否则读者分不清分节边界。
|
|
2009
|
+
- 伴随主内容一起看的一个分节(处理记录、审批流转)经 `aside` 传入,主体变为两栏:左栏弹性、右栏固定 360px,间距 12,侧栏内元素间距 12;可用宽度不足 960px 时侧栏落到主栏下方并拉满整行。主要字段分节不得挪进 `aside`。
|
|
2008
2010
|
- 分节级动作经 `DetailSection.action` 右对齐于标题行;对象级主动作属于载体:抽屉写在页头右侧的动作区,独立详情页写在 `ApplicationPageHeader` 的 `actions`。
|
|
2009
2011
|
- 时间轴、附件列表等非名值对内容走 `DetailSection.content`,排在字段之后。
|
|
2010
2012
|
- 该组件不带外边距也不自持滚动,留白与滚动一律由载体负责。
|
|
@@ -2032,7 +2034,7 @@ UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`
|
|
|
2032
2034
|
- 消息流与活动流的条目改用 `Message`,会话气泡改用 `Bubble`。
|
|
2033
2035
|
- 六种系统状态的承载、批量动作条与分页的挂载,由宿主 `ApplicationDataDisplay` 负责,不在本组件内解决。
|
|
2034
2036
|
|
|
2035
|
-
**组合约定。** 本组件必须放进 `ApplicationDataDisplay` 的 `children`,仅在 `state="ready"` 时渲染。外边距由 `ApplicationPageLayoutContainer` 持有(`--ui-page-gutter` 与 `--ui-section-gap`),本组件与其行一律不自带 margin。`selectable` 为 true 时行首由组件自动渲染 `ListSelectionCheckbox`,列表顶部另有一行吸顶的全选框(`scope="all"`,半选态按本次 `records` 里已选的条数派生),调用方不得再自行插一个行勾选框或全选行;全选 / 全不选只增删本次 `records` 的 id,`selected` 里其他页的选择原样保留,因此 `onSelectedChange` 的结果可以直接写回,不必再与别页的选择合并。可选时根节点是 `role="group"`、条目在内层的 list 里,`aria-label` 照旧传给本组件,即为该组与列表的名字。`selected` 与 `onSelectedChange` 必须成对提供,本组件的选择是受控的。选择集合非空时,调用方必须把 `ListBatchActionBar` 交给 `ApplicationDataDisplay` 的 `batchBar`。`activeId` 与选择集合是两回事:前者是 SPLIT 右栏或抽屉流程中的当前对象,只有一个,视觉上是选中底色;后者是勾选集合,视觉上是 4% 淡洗。行点击与 Enter / 空格忽略来自行内可交互元素的事件 —— 按钮、链接、表单控件、勾选框、菜单与菜单项(含经 portal 渲染的菜单面板)都不会顺带触发 `onOpen`;`RecordListItem.actions`
|
|
2037
|
+
**组合约定。** 本组件必须放进 `ApplicationDataDisplay` 的 `children`,仅在 `state="ready"` 时渲染。外边距由 `ApplicationPageLayoutContainer` 持有(`--ui-page-gutter` 与 `--ui-section-gap`),本组件与其行一律不自带 margin。`selectable` 为 true 时行首由组件自动渲染 `ListSelectionCheckbox`,列表顶部另有一行吸顶的全选框(`scope="all"`,半选态按本次 `records` 里已选的条数派生),调用方不得再自行插一个行勾选框或全选行;全选 / 全不选只增删本次 `records` 的 id,`selected` 里其他页的选择原样保留,因此 `onSelectedChange` 的结果可以直接写回,不必再与别页的选择合并。可选时根节点是 `role="group"`、条目在内层的 list 里,`aria-label` 照旧传给本组件,即为该组与列表的名字。`selected` 与 `onSelectedChange` 必须成对提供,本组件的选择是受控的。选择集合非空时,调用方必须把 `ListBatchActionBar` 交给 `ApplicationDataDisplay` 的 `batchBar`。`activeId` 与选择集合是两回事:前者是 SPLIT 右栏或抽屉流程中的当前对象,只有一个,视觉上是选中底色;后者是勾选集合,视觉上是 4% 淡洗。行点击与 Enter / 空格忽略来自行内可交互元素的事件 —— 按钮、链接、表单控件、勾选框、菜单与菜单项(含经 portal 渲染的菜单面板)都不会顺带触发 `onOpen`;`RecordListItem.actions` 另由组件包一层阻止冒泡,连同动作区的留白一起不开行;放进去的动作用 `SystemButton intent="quiet-accent"`,与 `Table` 操作列一致。改用 `renderRow` 接管行主体时同样成立,调用方不必再手动阻止冒泡。给了 `onOpen` 的行可聚焦、Enter / 空格打开,行保留列表项语义;`activeId` 那一行输出 `aria-current="true"`。行首勾选框的可访问名为「选择」加记录标题(`renderRow` 接管且 `title` 不是纯文本时回落为「选择此行」)。行高 56px,容得下标题与元信息两行。`presentation` 取 `RecordList`,不得谎报为 `DataTable`;呈现设置按钮读作「列表设置」,且它属于 `ApplicationQueryToolbar`,不属于本组件。
|
|
2036
2038
|
|
|
2037
2039
|
**禁止 / 使用边界。**
|
|
2038
2040
|
- 不得在本组件内持有搜索、筛选、排序状态 —— 那些全部属于 `ApplicationQueryToolbar`,数据展示区绝不持有第二套查询状态。
|
|
@@ -2065,7 +2067,7 @@ UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`
|
|
|
2065
2067
|
|
|
2066
2068
|
**用途。** 业务对象新建与编辑的模态表单载体,拥有已登记的字段网格与提交 / 取消语义。
|
|
2067
2069
|
|
|
2068
|
-
**何时使用。** 用户必须完成或放弃的表单任务一律用本组件。已登记宽度只有 `small` 720px、`large` 960px 与 `xlarge` 1280px 三档(1280 是 GAP Design kit 弹窗宽度区间 680–1280 的上限,业财平台 round-01 裁决),字段默认排布在两列网格上。`xlarge`
|
|
2070
|
+
**何时使用。** 用户必须完成或放弃的表单任务一律用本组件。已登记宽度只有 `small` 720px、`large` 960px 与 `xlarge` 1280px 三档(1280 是 GAP Design kit 弹窗宽度区间 680–1280 的上限,业财平台 round-01 裁决),字段默认排布在两列网格上。`xlarge` 只给字段多、或字段之上带原件预览的编辑场景。提交中由 `submitting` 表达,提交级失败由 `error` 表达。该组件建立在共享 Overlay 基座上,因此自带 Esc 关闭、焦点陷阱、关闭后焦点恢复与背景滚动锁定。
|
|
2069
2071
|
|
|
2070
2072
|
**何时改用其他组件。**
|
|
2071
2073
|
- 不含表单的聚焦任务(导入映射、确认预览)改用 Foundation `Dialog`。
|
|
@@ -2075,7 +2077,7 @@ UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`
|
|
|
2075
2077
|
- 帮助、附件预览这类辅助性面板改用 `Sheet`;全局设置是二级导航里的设置模块。
|
|
2076
2078
|
- 字段规模超出三档宽度可承载的范围时,改用独立编辑页承载。
|
|
2077
2079
|
|
|
2078
|
-
**组合约定。** 字段一律以 `Field` 子元素传入 `children`,一个 `Field` 管辖一个控件。需要跨列的字段给 `Field` 传 `span="full"`,不得用内联 `style` 写 `gridColumn`;需要单列或三列时改 `columns`,不要用外部 CSS
|
|
2080
|
+
**组合约定。** 字段一律以 `Field` 子元素传入 `children`,一个 `Field` 管辖一个控件。需要跨列的字段给 `Field` 传 `span="full"`,不得用内联 `style` 写 `gridColumn`;需要单列或三列时改 `columns`,不要用外部 CSS 重排网格。对照原件录入时,原件 / 单据影像传 `preview`,组件把它排在白卡内、字段网格之上并横跨全部列(间隔 10);不得把原件当作非 `Field` 子元素塞进 `children` 再用外部 CSS 跨列。字段级错误交给 `Field` 的 `error`,并且控件自身的 `invalid` 需另行设置 —— 两者不联动。提交级失败传 `error`,内容应是 `<Alert tone="danger">`,由组件渲染在主体顶部、字段网格之前。主体与底部动作区包在一个 `<form>` 里,主按钮是提交按钮,字段内按 Enter 即提交并调用 `onSubmit`;浏览器自带校验已关闭,字段校验一律走 `Field`。`submitting` 为 true 时组件禁用主按钮并置忙态,同时屏蔽 Esc 与遮罩点击两条关闭路径,取消按钮仍可用;调用方仍须在自己的提交回调里防止重复请求。底部动作区由组件持有,取消在左、主操作在右,文案经 `submitText` / `cancelText` 覆盖;逐条编辑这类需要「上一张」「下一张」的场景经 `secondaryActions` 传入 `SystemButton`(`intent="secondary"`),排在取消与提交之间;与本次提交相关的上下文(「共 100 条,当前第 6 条」)经 `footerNote` 渲染在动作区左侧。页头右侧恒有纯图标的关闭按钮,行为等同取消,提交中禁用。外观按 GAP Design kit「抽屉弹窗 / 弹窗」:面板圆角 20;48px 灰底页头,标题与关闭键间隔 10;主体灰底内含一张白卡承载字段网格,字段间距 10;底部动作区同为灰底,内边距 12、动作间隔 4、顶部 0.5px 分隔线。`onCancel` 同时被取消按钮、Esc 与遮罩点击触发(提交中只剩取消按钮),因此它必须是幂等的。视口边距由 Overlay 基座负责,调用方不得再包一层定位容器。
|
|
2079
2081
|
|
|
2080
2082
|
**禁止 / 使用边界。**
|
|
2081
2083
|
- 不得把提交失败呈现为 `Sonner` —— 用户必须处理的失败绝不能放进转瞬即逝的提示里。
|
|
@@ -2084,6 +2086,7 @@ UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`
|
|
|
2084
2086
|
- 禁止把宽度改到 720px / 960px / 1280px 三档之外,也禁止让对话框超出有效视口。
|
|
2085
2087
|
- 不得用 `className` 把面板圆角改回 16 或其他值 —— 四个模态弹窗同取 `--application-radius-dialog`。
|
|
2086
2088
|
- 不得用本组件承载只读详情,详情有它自己的两个载体。
|
|
2089
|
+
- 不得在 `preview` 里放字段或提交类动作 —— 它只承载原件与查看原件的动作。
|
|
2087
2090
|
- 不得在 `children` 内用内联 style 改写控件自身的边框、高度或圆角。
|
|
2088
2091
|
|
|
2089
2092
|
## ApplicationDetailDrawer
|
|
@@ -2096,7 +2099,7 @@ UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`
|
|
|
2096
2099
|
- 非业务记录的侧边面板、或不需要已登记详情结构的裸抽屉,改用 Foundation `Drawer`。
|
|
2097
2100
|
- 帮助、附件预览这类辅助性内容改用 `Sheet` —— 业务对象详情不属于那里;全局设置是二级导航里的设置模块,也不进抽屉。
|
|
2098
2101
|
- 需要深链接的详情改用独立详情页,深链接永远只指向独立详情页。
|
|
2099
|
-
-
|
|
2102
|
+
- 默认 680px 宽的抽屉:分节超过 3 个、字段超过 15 个、动作流程有实质差异或性能要求不同时,改用独立详情页承载完整内容,抽屉侧只保留核心内容。1280px 宽变体不受分节数与字段数两条阈值约束 —— GAP Design kit「抽屉弹窗」的三个 1278 宽变体(常规、流程类左右、图文详情)本就承载对象头、统计、页签与侧栏,可以与独立详情页共用同一份完整的 `ApplicationRecordDetailBody`;动作流程与性能两条照常适用,深链接仍只指向独立详情页。
|
|
2100
2103
|
- 编辑与新建改用 `ApplicationFormDialog`;不可逆动作的确认改用 `AlertDialog`。
|
|
2101
2104
|
|
|
2102
2105
|
**组合约定。** `children` 必须传 `ApplicationRecordDetailBody`,不得为抽屉另写一份详情主体。`width` 默认 680px;`--application-drawer-width` 的 1280px 是宽 / 全屏变体,需要时经 `width` 显式传入。`side` 默认 `right`;来源在页面右侧(SPLIT 右栏的条目、月格的周末日格)时传 `left`,不得让抽屉盖住刚打开它的那一处。`status` 紧邻抽屉标题,只在**抽屉标题就是对象名**时使用;抽屉标题是页面类型名(「进项发票详情」)、对象名写在 `ApplicationRecordDetailBody` 的 `summary` 里时,状态徽标随对象名放进 `summary`,不传 `status` —— 状态描述的是对象,必须紧邻对象名。抽屉为灰底、无投影,标题与副标题同行、均为 14/20。页头按 GAP Design kit「抽屉 / 常规」:右侧依次为 `primaryAction`、`secondaryActions` 与 32×32 纯图标关闭键,间隔 4,没有底部动作区(业财平台 round-01 裁决)。`primaryAction` 是唯一的主对象动作,其余一律进 `secondaryActions`,超过两三个时收进「更多」。关闭键由组件渲染,可访问名为「关闭」;独立详情页的退出是写着「返回」的按钮(`ApplicationPageHeader` 的 `onBack`)—— 这是结构区分,不是文案偏好。`onClose` 里调用方必须还原来源页面的八项上下文:业务视图、搜索、筛选、排序、分页、页面模式、当前对象、滚动位置,少还原任何一项都算缺陷。与列表配合时,来源侧用 `ApplicationRecordList` 的 `activeId` 或 `Table` 的 `onRowClick` 标记当前对象。视口边距、Esc、焦点陷阱、焦点恢复与滚动锁定由 Overlay 基座负责,调用方不得再实现一遍。
|
|
@@ -14,7 +14,9 @@ Application Module 层的组件不能脱离五层 Canvas 模型使用。写第
|
|
|
14
14
|
`ApplicationDataDisplay` 展示的记录集合:
|
|
15
15
|
|
|
16
16
|
- **有结果集**(列表、台账、报表、以查询结果为主体的分析页):下面五个字段必须逐个定下来
|
|
17
|
-
|
|
17
|
+
并写进代码,不得含糊、不得留空。只有一个工作视角时 `businessView` 定为「单视角」、工具栏第一行不渲染;
|
|
18
|
+
只有分页、没有搜索筛选排序时 `dataControl` 只含 pagination、不渲染工具栏 —— 这两种都是有效取值,
|
|
19
|
+
写法见 SKILL.md「五层 Canvas 模型」。
|
|
18
20
|
- **没有结果集**(工作台、详情页、配置页、协作工作台、编辑器):只声明 `pageType`,其余
|
|
19
21
|
四个字段不写,也不得为凑字段塞一个数据展示区或空工具栏。结构按 SKILL.md「无结果集页面
|
|
20
22
|
的结构」一节搭。
|
|
@@ -37,7 +39,7 @@ Application Module 层的组件不能脱离五层 Canvas 模型使用。写第
|
|
|
37
39
|
|
|
38
40
|
骨架的硬要求:
|
|
39
41
|
|
|
40
|
-
- 该写的字段显式写进组件 props
|
|
42
|
+
- 该写的字段显式写进组件 props,不写在注释里(唯一例外:单视角的 `businessView` 没有 prop 可写,记在五层声明注释里)。落点是:
|
|
41
43
|
`pageType` → `ApplicationPageLayoutContainer`(必填);
|
|
42
44
|
`pageMode` → `ApplicationPageHeader`;
|
|
43
45
|
`businessView` → `ApplicationQueryToolbar`;
|
|
@@ -20,7 +20,9 @@ npx @moheng-design/ui-skill upgrade --from <旧版 contracts.json 的路径>
|
|
|
20
20
|
|
|
21
21
|
旧版 `contracts.json` 在升级前的 `node_modules/@moheng-design/ui-skill/generated/` 里,
|
|
22
22
|
升级前先拷一份出来。命令比对新旧两份,产出 `moheng-upgrade.md`:
|
|
23
|
-
组件的增删、prop 的增删与必填变化、枚举值的增删、类型的收窄与变化、新标为弃用的 prop
|
|
23
|
+
组件的增删、prop 的增删与必填变化、枚举值的增删、类型的收窄与变化、新标为弃用的 prop,
|
|
24
|
+
以及子类型(`TableColumn`、`Metric`、`DetailSection` 这类列定义、指标项、分节接口)的字段增删、
|
|
25
|
+
必填翻转与类型变化 —— 子类型条目带「(某组件的子类型)」后缀,去该组件的 reference.md 章节查。
|
|
24
26
|
|
|
25
27
|
3. 按报告改代码,从破坏性的几节改起(报告按此排序,「新增」两节排在最后)。删掉的 prop
|
|
26
28
|
与枚举值、收窄为固定取值的 prop 对应的是 `props-whitelist` / `prop-enum` 会报的那些
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@moheng-design/ui-skill",
|
|
3
|
-
"version": "3.
|
|
3
|
+
"version": "3.1.1",
|
|
4
4
|
"description": "@moheng-design/ui 的 AI agent 支持包 —— SKILL.md 引导 + ESLint / stylelint 强制规则",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"agent",
|
|
@@ -54,7 +54,7 @@
|
|
|
54
54
|
"eslint": "^9.39.0",
|
|
55
55
|
"stylelint": "^16.26.0",
|
|
56
56
|
"typescript": "^5.9.3",
|
|
57
|
-
"@moheng-design/ui": "3.
|
|
57
|
+
"@moheng-design/ui": "3.1.1"
|
|
58
58
|
},
|
|
59
59
|
"scripts": {
|
|
60
60
|
"generate": "node scripts/generate.mjs",
|