@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/reference.md
CHANGED
|
@@ -2,11 +2,11 @@
|
|
|
2
2
|
|
|
3
3
|
# @moheng-design/ui 完整参考
|
|
4
4
|
|
|
5
|
-
适用版本:v3.
|
|
5
|
+
适用版本:v3.1.1 —— 本文件随包分发,永远与所安装的 `@moheng-design/ui` 版本配套。
|
|
6
6
|
|
|
7
7
|
共 94 个组件。每个组件含:契约 JSDoc 原文、完整 props 表、
|
|
8
8
|
关联类型,以及手写的组合约定(何时使用 / 何时改用其他组件 / 组合约定 / 禁止与使用边界)。
|
|
9
|
-
文末另有两份全表:165 条 lint 规则,以及
|
|
9
|
+
文末另有两份全表:165 条 lint 规则,以及 396 条 design token 的名值对照。
|
|
10
10
|
|
|
11
11
|
## 目录
|
|
12
12
|
|
|
@@ -108,7 +108,8 @@ Mock 数据用已登记的占位符,`模块1 / 模块2` 被明令禁止。
|
|
|
108
108
|
UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`,不写 `你没有权限`。
|
|
109
109
|
表单与说明文案(02 §8):校验错误写字段名与不满足的条件(`任务名称不能为空`);
|
|
110
110
|
确认说明写后果(`删除后 3 条记录不可恢复`),不写请求;占位文字写示例或范围
|
|
111
|
-
|
|
111
|
+
(`例如:季度巡检记录`),不写指令 —— 唯一的例外是组件内置的 `ListTablePagination` 跳页框,
|
|
112
|
+
它照 GAP Design kit 写「请输入」,调用方不得仿照;无权限的出路点明找谁(`联系本模块管理员开通`)。
|
|
112
113
|
|
|
113
114
|
## 五层 Canvas 模型
|
|
114
115
|
|
|
@@ -253,6 +254,18 @@ Shell 契约禁止在导航带内增加未登记元素:搜索框、面包屑
|
|
|
253
254
|
| L4 数据控制 | `dataControl` | search / filters / sort / pagination / appliedFilterTags |
|
|
254
255
|
| L5 数据呈现 | `dataPresentation` | `DataTable` / `RecordList` / `CardList` / `KanbanBoard` / `Calendar` / `Chart` / `Timeline` |
|
|
255
256
|
|
|
257
|
+
结果集页面里有两种层的内容「只有一种」的情形,写法固定,不算缺层:
|
|
258
|
+
|
|
259
|
+
- **单视角**:结果集没有多个稳定工作视角时(需求写明「无页签」),`businessView` 这一层的取值是
|
|
260
|
+
「单视角」。不传 `businessViews` / `businessView` / `onBusinessViewChange`,工具栏第一行不渲染;
|
|
261
|
+
不得为凑出一行虚构一个只有「全部」的标签。这一层没有可写的 prop,是五层里唯一只在页面的
|
|
262
|
+
五层声明注释里记下取值(`businessView: 单视角`)的情形。
|
|
263
|
+
- **只有分页**:结果集没有搜索、筛选、排序时,`dataControl` 只含 pagination。不渲染
|
|
264
|
+
`ApplicationQueryToolbar`(它的第二行恒有搜索框,不得为凑工具栏放一个用不上的搜索),
|
|
265
|
+
`ApplicationPageLayoutContainer` 不传 `dataControl`,`ListTablePagination` 照常进
|
|
266
|
+
`ApplicationDataDisplay` 的 `pagination`;`dataPresentation` 只落在 `ApplicationDataDisplay` 的
|
|
267
|
+
`presentation`。这种页面通常也是单视角。
|
|
268
|
+
|
|
256
269
|
`DETAIL` 与 `COMPOSITE` **不是**页面模式,是特殊物理结构资产。
|
|
257
270
|
`Embedded` 是 `integrationMode`,不是页面模式。
|
|
258
271
|
|
|
@@ -300,7 +313,8 @@ WORKBENCH ApplicationPageLayoutContainer pageType="WORKBENCH"
|
|
|
300
313
|
└─ children 分区导航 GlobalSidebar + 面板网格(指标区、待办、动态、应用入口)
|
|
301
314
|
|
|
302
315
|
DETAIL ApplicationPageLayoutContainer pageType="DETAIL"
|
|
303
|
-
├─ header ApplicationPageHeader(
|
|
316
|
+
├─ header ApplicationPageHeader(onBack 回到来源列表;只有要展示多级路径时才改用 breadcrumb,
|
|
317
|
+
│ 两者不得同时传;对象级动作放 actions)
|
|
304
318
|
└─ children ApplicationRecordDetailBody(分节;分节级动作放分节标题行)
|
|
305
319
|
|
|
306
320
|
编辑器 ApplicationPageLayoutContainer pageType 随所属业务
|
|
@@ -383,6 +397,15 @@ DETAIL ApplicationPageLayoutContainer pageType="DETAIL"
|
|
|
383
397
|
业务记录的占位符(07 · C-8):`成员 A` / `成员 B` / `成员 C`(人名)· `对象 A` / `对象 B` / `对象 C`(业务对象名)·
|
|
384
398
|
`编号 0001` / `编号 0002`(记录编号,四位补零递增)。同类条目按字母或序号顺延,不得换用真实人名。
|
|
385
399
|
|
|
400
|
+
未登记的类型按两条规则生成,同样逐字复用、按字母顺延:
|
|
401
|
+
|
|
402
|
+
- **名称类**写「类型名 + 空格 + 字母」:`部门 A` / `部门 B`(组织部门)· `城市 A`(地区)· `规格 A`(规格型号)·
|
|
403
|
+
`项目 A`(项目)。不得借用 `对象 A` 充当部门或城市 —— 读者分不清那一列是什么。
|
|
404
|
+
- **定长编码类**按真实位数写,用 0 补齐、末位按序号顺延,让列宽与真实数据一致:
|
|
405
|
+
`913100000000000001` / `913100000000000002`(统一社会信用代码 / 纳税人识别号,18 位)·
|
|
406
|
+
`6222000000000001`(银行卡号,16 位)。
|
|
407
|
+
不得用随手敲的数字串,也不得用真实存在的编码。
|
|
408
|
+
|
|
386
409
|
`模块1` / `模块2` 作为标签文案被明令禁止。
|
|
387
410
|
|
|
388
411
|
|
|
@@ -465,7 +488,7 @@ Foundation 按钮 —— 按钮排版、几何、圆角与基础交互的唯一
|
|
|
465
488
|
|
|
466
489
|
| prop | 类型 | 必填 | 说明 |
|
|
467
490
|
|---|---|:---:|---|
|
|
468
|
-
| `variant` | `'primary' \| 'secondary' \| 'outline' \| 'ghost' \| 'destructive' \| 'destructive-outline' \| 'link'` | 否 |
|
|
491
|
+
| `variant` | `'primary' \| 'secondary' \| 'outline' \| 'ghost' \| 'ghost-accent' \| 'destructive' \| 'destructive-outline' \| 'link'` | 否 | 视觉语义。有 GAP Design kit 对应类型的五档逐态对齐按钮组件集 24:2110: `primary` 用于页面主操作,每个动作组内至多一个;主色实心底,移入变浅、按下变深, 禁用为浅主色底白字(kit「类型=主要」,三态从换肤主色派生); `secondary` 用于次要操作,是默认值;白底、线条色描边,移入只把文字变为主色, 按下为主色 15% 底 + 主色描边 + 主色字,禁用为文字3(kit「类型=二级」); `ghost` 透明底、文字1,移入中性 6% 底、按下中性 25% 底,禁用为文字3(kit「类型=幽灵」, `iconOnly` 即 kit「类型=图标」); `ghost-accent` 透明底、主色字,移入主色 6% 底、按下主色 15% 底(kit「类型=幽灵主要」), 用于表格与记录列表的行内动作; `destructive` 用于不可逆的删除类操作(实心危险色); `destructive-outline` 白底、线条色描边、危险色文字;移入时描边变为危险色,按下时再加危险色 10% 底(GAP Design kit「按钮 / 类型=危险」三态), 用于与次要按钮并排的删除类动作; `link` 用于行内跳转,无内边距、带下划线。 `outline`、`destructive`、`link` 在 kit 里没有对应类型。 |
|
|
469
492
|
| `size` | `'xs' \| 'sm' \| 'default' \| 'lg'` | 否 | 尺寸,映射高度 24 / 28 / 32 / 40px。 `default` 读取 `--application-button-height`; `sm` 用于表格行内等紧凑布局;`xs` 用于标签内嵌。 |
|
|
470
493
|
| `iconOnly` | `boolean` | 否 | 等宽图标按钮。宽度收敛为与高度相等,行内内边距归零。 为 true 时**必须**提供 `aria-label`,因为按钮没有可见文字。 |
|
|
471
494
|
| `disabled` | `boolean` | 否 | 禁用。禁用时不触发 onClick 并移出 tab 顺序。 禁用作用于整个交互单元 —— 不得只禁用文字而保留图标可点。 传 `aria-disabled="true"` 得到同一套禁用外观但保持可聚焦(`SystemButton` 的 loading 即此写法);本组件不拦截事件,阻断动作由设置它的一方负责。 |
|
|
@@ -486,7 +509,7 @@ Foundation 按钮 —— 按钮排版、几何、圆角与基础交互的唯一
|
|
|
486
509
|
- 页面区域内的内容分节切换改用 `Tabs`,不得用一排 ghost 按钮模拟。
|
|
487
510
|
- 原生 `<button>` 一律改用本组件(`mappings.json` · `no-native-button`)。
|
|
488
511
|
|
|
489
|
-
**组合约定。** `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`
|
|
512
|
+
**组合约定。** `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` 属性。
|
|
490
513
|
|
|
491
514
|
**禁止 / 使用边界。**
|
|
492
515
|
|
|
@@ -532,7 +555,7 @@ Page Mode Switch 是页面级控件,位于上下文区右侧,属于 `Applica
|
|
|
532
555
|
- 翻页控件改用 `Pagination`,列表与表格的翻页改用 `ListTablePagination`。
|
|
533
556
|
- 单个动作不成组,直接用 `SystemButton`。
|
|
534
557
|
|
|
535
|
-
**组合约定。** `children` 是 slot 而非数据 prop,这与 `ToggleGroup` 的 `items` 形态相反,分工是实质性的(04 · A4):本组只做拼接、不管状态,因此接受任意子节点,包括 Fragment、数组与条件渲染,子组件也不必接受或转发 `style`。拼接态的圆角压平与 1px 边框重叠由 CSS 结构伪类完成,不做属性注入,子组件的 `className` 优先级不受影响。组内按钮的 `size` 必须一致,否则拼接边缘对不齐。拼接态要求子项都有可见边框才对得上,因此不得在拼接态里混入 `intent="quiet"` 与 `intent="link"`(库内为 `variant="ghost"` 与 `variant="link"`)。组渲染 `role="group"`,若该组表达的是互斥选择,说明组件选错了。组自身不带外边距,与相邻元素的距离由容器负责。子项中至多一个 primary。
|
|
558
|
+
**组合约定。** `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。
|
|
536
559
|
|
|
537
560
|
**禁止 / 使用边界。**
|
|
538
561
|
|
|
@@ -812,7 +835,7 @@ Combobox 的单个选项
|
|
|
812
835
|
`import { DateInput } from '@moheng-design/ui'` · 契约 `contracts/foundation/input-selection/date-input.ts`
|
|
813
836
|
|
|
814
837
|
单个日期的录入控件:与 `Input` 同高同壳(32px、12px 圆角、1px 描边),右侧带 16px
|
|
815
|
-
|
|
838
|
+
日历图标(文字1,与值间隔 4,GAP Design kit「表单/选择」),点击弹出 `Calendar` 月格,选中即回填并收起。
|
|
816
839
|
|
|
817
840
|
值一律是本地时区的 ISO 日期串 `yyyy-mm-dd`(不是 `Date`,也不是带时区的时间戳)——
|
|
818
841
|
表单提交与接口对接都按字符串走,组件内部用本地时区换算,不经 `toISOString()`。
|
|
@@ -1068,7 +1091,7 @@ Combobox 的单个选项
|
|
|
1068
1091
|
|
|
1069
1092
|
`import { Label } from '@moheng-design/ui'` · 契约 `contracts/foundation/input-selection/label.ts`
|
|
1070
1093
|
|
|
1071
|
-
独立控件标签,14/20
|
|
1094
|
+
独立控件标签,14/20 字号,文字2(`--ds-color-text-secondary`,GAP Design kit「字段名称」)。
|
|
1072
1095
|
|
|
1073
1096
|
用于 `Field` **之外**的场景 —— 行内筛选器、工具栏控件、表格单元格编辑器。
|
|
1074
1097
|
标准表单行请用 `Field`,它自带标签。
|
|
@@ -2629,7 +2652,8 @@ Chart 的单条数据系列
|
|
|
2629
2652
|
|
|
2630
2653
|
DataTable 承载面 —— LIST 页面模式、LEDGER 台账页、SPLIT 右栏。
|
|
2631
2654
|
|
|
2632
|
-
表头位于 `--application-table-header`,高 44;表体行最小高 56(两行内容 72)。
|
|
2655
|
+
表头位于 `--application-table-header`,高 44,文字 14/20 medium 文字2;表体行最小高 56(两行内容 72)。
|
|
2656
|
+
单元格里放了按钮(行内「编辑 / 删除」)时上下内边距收为 12,32 高的按钮不撑高行。
|
|
2633
2657
|
行与行之间、表头列与列之间是 0.5px 分隔线(`--application-hairline`),**不是投影**。
|
|
2634
2658
|
|
|
2635
2659
|
⚠ 当本组件是当前的 Data Presentation 时,
|
|
@@ -2666,7 +2690,7 @@ Table 的单列定义
|
|
|
2666
2690
|
|---|---|:---:|---|
|
|
2667
2691
|
| `key` | `string` | 是 | 列键。未提供 `render` 时用作取值字段名 |
|
|
2668
2692
|
| `title` | `ReactNode` | 是 | 表头内容 |
|
|
2669
|
-
| `width` | `number \| string` | 否 | 列宽。数字按 px
|
|
2693
|
+
| `width` | `number \| string` | 否 | 列宽。数字按 px,字符串原样透传。不写的列是弹性列:表格用固定布局,弹性列均分 「表格宽 − 固定列」的剩余宽度(GAP Design kit「列表」),最窄 88px,不够分时表格横向滚动 |
|
|
2670
2694
|
| `align` | `'left' \| 'right' \| 'center'` | 否 | 对齐方式。`right` 自动启用等宽数字 |
|
|
2671
2695
|
| `sortable` | `boolean` | 否 | 该列可排序。表头显示排序指示器并可点击 |
|
|
2672
2696
|
| `priority` | `'primary' \| 'default' \| 'low'` | 否 | 列优先级,决定窄视口下**先压缩谁、先隐藏谁**。 对应 02 §9 规则 8「先压间距,再压列数,再压优先级」。 **每一列都应显式设置**,否则窄视口下的降级顺序不可预期。 |
|
|
@@ -2679,8 +2703,8 @@ Table 的单列定义
|
|
|
2679
2703
|
|
|
2680
2704
|
| prop | 类型 | 必填 | 说明 |
|
|
2681
2705
|
|---|---|:---:|---|
|
|
2682
|
-
| `content` | `ReactNode` | 是 |
|
|
2683
|
-
| `busy` | `boolean` | 否 |
|
|
2706
|
+
| `content` | `ReactNode` | 是 | 行内容,横跨全部列居中显示,行高与表体行同为最小 56。例如「识别中…」「正在加载更多」 |
|
|
2707
|
+
| `busy` | `boolean` | 否 | 进行中。文字取强调色并叠加一层扫光动效;系统开启减少动效时不播放扫光 |
|
|
2684
2708
|
|
|
2685
2709
|
**`TableSort`**
|
|
2686
2710
|
|
|
@@ -2702,7 +2726,7 @@ Table 的单列定义
|
|
|
2702
2726
|
- 只是一组同构的目录行,无列对齐需求 —— 改用 `Item`。
|
|
2703
2727
|
- 需要手写 `<table>` / `<tr>` / `<td>` —— 一律改用本组件,手写表格拿不到已登记的表头底色、行分隔线与列宽约定。
|
|
2704
2728
|
|
|
2705
|
-
**组合约定。** 本组件不持有外边距,与相邻区块的间隙由 `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
|
|
2729
|
+
**组合约定。** 本组件不持有外边距,与相邻区块的间隙由 `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` 为空时它不渲染。
|
|
2706
2730
|
|
|
2707
2731
|
**禁止 / 使用边界。**
|
|
2708
2732
|
- 禁止手写 `<tr>` / `<td>` 作为子元素传入 —— 本组件不接受复合子组件,列与行只能来自 `columns` 与 `rows`。
|
|
@@ -3198,7 +3222,7 @@ Sonner 的单条提示
|
|
|
3198
3222
|
|
|
3199
3223
|
**用途。** 转瞬即逝的提示堆栈,用于确认某件事已经发生 —— 已保存、已导出、3 条已办结。
|
|
3200
3224
|
|
|
3201
|
-
**何时使用。** 当结果是已完成的事实、用户无需据此采取任何行动时,该组件是默认选择。判据是单一的:如果用户错过了这条提示会有损失,它就不该是 toast。`title` 应是已完成事实的陈述。未指定 `duration` 时单条停留 5000ms
|
|
3225
|
+
**何时使用。** 当结果是已完成的事实、用户无需据此采取任何行动时,该组件是默认选择。判据是单一的:如果用户错过了这条提示会有损失,它就不该是 toast。`title` 应是已完成事实的陈述。未指定 `duration` 时单条停留 5000ms,指针停在堆栈上或键盘焦点在提示内时暂停;两者都离开后按剩余时间继续计时。
|
|
3202
3226
|
|
|
3203
3227
|
**何时改用其他组件。**
|
|
3204
3228
|
- 用户必须读到并处理的失败改用 `Alert`,就地呈现在受影响区域顶部。
|
|
@@ -3347,7 +3371,8 @@ Sonner 的单条提示
|
|
|
3347
3371
|
查询工具栏主控制行中的**日期区间**快捷筛选,与 `ApplicationFilterMenu` 同为一个
|
|
3348
3372
|
常驻维度,放进 `ApplicationQueryToolbar` 的 `commonFilters`。
|
|
3349
3373
|
|
|
3350
|
-
触发器与 `ApplicationFilterMenu`
|
|
3374
|
+
触发器与 `ApplicationFilterMenu` 同高同壳、同一套 GAP Design kit「筛选/选择」五态:生效时维度名变为主色、
|
|
3375
|
+
不回显区间,区间经可访问名读出(「接收时间:2026-07-01 – 2026-07-28」),视觉上只在已筛选标签里。
|
|
3351
3376
|
面板里是起止两张 `Calendar` 月格,由「应用」提交、「清空」撤销 —— 选到一半不生效。
|
|
3352
3377
|
|
|
3353
3378
|
⚠ **已生效的区间必须回写到工具栏第三行的筛选标签行**(`appliedTags`),且标签可移除。
|
|
@@ -3358,7 +3383,7 @@ Sonner 的单条提示
|
|
|
3358
3383
|
| prop | 类型 | 必填 | 说明 |
|
|
3359
3384
|
|---|---|:---:|---|
|
|
3360
3385
|
| `label` | `ReactNode` | 是 | 维度名称,显示在触发器上,如「接收时间」 |
|
|
3361
|
-
| `labelText` | `string` | 否 |
|
|
3386
|
+
| `labelText` | `string` | 否 | 维度名称的纯文本,用于触发器的可访问名「维度名:起 – 止」与面板的组名。 `label` 为非字符串时**必须**提供,否则可访问名缺维度名。 |
|
|
3362
3387
|
| `value` | `DateRangeValue` | 否 | 受控值。两端都缺省即未生效 |
|
|
3363
3388
|
| `onValueChange` | `(value: DateRangeValue) => void` | 否 | 「应用」提交时的回调。「清空」提交 `{}` |
|
|
3364
3389
|
| `disabled` | `boolean` | 否 | 禁用 |
|
|
@@ -3377,7 +3402,7 @@ Sonner 的单条提示
|
|
|
3377
3402
|
|
|
3378
3403
|
**用途。** 查询工具栏主控制行中的日期区间快捷筛选,承载**一个**日期维度(接收时间、开票日期)的起止区间。
|
|
3379
3404
|
|
|
3380
|
-
**何时使用。** 结果集需要按某个日期维度的区间筛选、且该维度高频使用时,必须使用本组件。触发器与 `ApplicationFilterMenu`
|
|
3405
|
+
**何时使用。** 结果集需要按某个日期维度的区间筛选、且该维度高频使用时,必须使用本组件。触发器与 `ApplicationFilterMenu` 同高同壳、同一套五态,生效时只把维度名变为主色、不回显区间(区间读屏经可访问名读出,视觉上只在已筛选标签里);面板里起止各一张 `Calendar`,选择是草稿,「应用」提交、「清空」撤销。值为 `{ start?, end? }`,两端都是本地时区 ISO `yyyy-mm-dd`,缺省一端表示该端不限。
|
|
3381
3406
|
|
|
3382
3407
|
**何时改用其他组件。**
|
|
3383
3408
|
- 取值为有限枚举的维度:改用 `ApplicationFilterMenu`。
|
|
@@ -3385,7 +3410,7 @@ Sonner 的单条提示
|
|
|
3385
3410
|
- 低频的日期维度:收进 `moreFilters` 的 `ApplicationFilterList` 面板,不常驻工具栏。
|
|
3386
3411
|
- 整页按日期浏览:改用 `pageMode` 为 `CALENDAR` 的日历承载面。
|
|
3387
3412
|
|
|
3388
|
-
**组合约定。** 该组件必须作为 `ApplicationQueryToolbar` 的 `commonFilters` 内容出现,与 `ApplicationFilterMenu` 合计常驻不超过 3 个。生效区间必须由调用方回写到 `appliedTags`(标签文案如「接收时间:2026-07-01 – 2026-07-28」),并在 `onRemoveTag` 里把区间清回 `{}`。`label` 为非字符串时必须提供 `labelText
|
|
3413
|
+
**组合约定。** 该组件必须作为 `ApplicationQueryToolbar` 的 `commonFilters` 内容出现,与 `ApplicationFilterMenu` 合计常驻不超过 3 个。生效区间必须由调用方回写到 `appliedTags`(标签文案如「接收时间:2026-07-01 – 2026-07-28」),并在 `onRemoveTag` 里把区间清回 `{}`。`label` 为非字符串时必须提供 `labelText`,它是触发器可访问名「维度名:起 – 止」的来源。结束日期早于开始日期时「应用」禁用,组件不替调用方交换两端。区间两端都是闭区间(含当天),调用方换算成接口参数时自行补足时分。
|
|
3389
3414
|
|
|
3390
3415
|
**禁止 / 使用边界。**
|
|
3391
3416
|
- 不得让已生效的区间只停留在触发器上而不回写筛选标签行。
|
|
@@ -3409,12 +3434,12 @@ Sonner 的单条提示
|
|
|
3409
3434
|
|
|
3410
3435
|
| prop | 类型 | 必填 | 说明 |
|
|
3411
3436
|
|---|---|:---:|---|
|
|
3412
|
-
| `label` | `ReactNode` | 否 |
|
|
3437
|
+
| `label` | `ReactNode` | 否 | 维度名称,显示在触发器上。生效时维度名与字形变为主色,**不回显取值** —— GAP Design kit「筛选/选择 · 已选择」(39:2349)只显示标签,取值在工具栏第三行的已筛选标签里。 读屏经视觉隐藏文本读到「:当前值」 |
|
|
3413
3438
|
| `options` | `ApplicationFilterOption[]` | 是 | 该维度的可选值 |
|
|
3414
3439
|
| `value` | `string \| string[]` | 否 | 受控值。`multiple` 为 true 时是 string[] |
|
|
3415
3440
|
| `defaultValue` | `string \| string[]` | 否 | 非受控初始值 |
|
|
3416
3441
|
| `onValueChange` | `(value: string \| string[]) => void` | 否 | 值变化回调。单选时再次点选当前值会清空该维度 |
|
|
3417
|
-
| `multiple` | `boolean` | 否 |
|
|
3442
|
+
| `multiple` | `boolean` | 否 | 多选。读屏读到的取值为「N 项」,且选中后菜单不自动关闭 |
|
|
3418
3443
|
| `disabled` | `boolean` | 否 | 禁用 |
|
|
3419
3444
|
|
|
3420
3445
|
继承 `HTMLAttributes<HTMLDivElement>` 的全部原生属性,其中 `defaultValue` 已被本组件重新定义或移除。
|
|
@@ -3428,11 +3453,11 @@ Sonner 的单条提示
|
|
|
3428
3453
|
| `value` | `string` | 是 | 选项值,在该维度内唯一 |
|
|
3429
3454
|
| `label` | `ReactNode` | 是 | 选项显示内容 |
|
|
3430
3455
|
| `count` | `number` | 否 | 该选项对应的结果数,右对齐等宽数字显示 |
|
|
3431
|
-
| `labelText` | `string` | 否 |
|
|
3456
|
+
| `labelText` | `string` | 否 | 取值的纯文本,触发器经视觉隐藏文本读给读屏(视觉上不回显取值,见 `label`)。 `label` 为非字符串时**必须**提供,否则读出 `[object Object]`。见 T11。 |
|
|
3432
3457
|
|
|
3433
3458
|
**用途。** 查询工具栏主控制行中的常驻快捷筛选触发器,承载**一个**高频筛选维度的取值。
|
|
3434
3459
|
|
|
3435
|
-
**何时使用。** 该维度在结果集上高频使用、取值为短词且数量有限时,必须选用本组件。面板已登记 180px 最小宽与 280px 最高,取值控制在 8 项以内方能一屏读完。工具栏内至多常驻 2–3 个,其余维度一律下沉到「更多筛选」。触发器高 32px、圆角 12px,与同排的 `SearchField`
|
|
3460
|
+
**何时使用。** 该维度在结果集上高频使用、取值为短词且数量有限时,必须选用本组件。面板已登记 180px 最小宽与 280px 最高,取值控制在 8 项以内方能一屏读完。工具栏内至多常驻 2–3 个,其余维度一律下沉到「更多筛选」。触发器高 32px、圆角 12px,与同排的 `SearchField` 读作一行。触发器按 GAP Design kit「筛选/选择」五态呈现:默认(白底、线条色描边)、已选择(维度名与字形变主色,**只显示维度名、不回显取值**)、移入(主色描边)、点击(导航背景底)、展开(主色 6% 底、主色描边与文字)。取值只出现在工具栏第三行的已筛选标签里,读屏经视觉隐藏文本读到「维度名:取值」。
|
|
3436
3461
|
|
|
3437
3462
|
**何时改用其他组件。**
|
|
3438
3463
|
- 低频维度、或需要一次性提交多个维度:改用 `ApplicationFilterList`,它是「更多筛选」的面板主体,持有草稿并由「应用」提交。
|
|
@@ -3443,14 +3468,14 @@ Sonner 的单条提示
|
|
|
3443
3468
|
- 键盘优先的全局搜索与执行:改用 `Command` 的 `dialog` 形态。
|
|
3444
3469
|
- 日期区间维度:改用 `ApplicationDateRangeFilter`,同样放进 `commonFilters`。
|
|
3445
3470
|
|
|
3446
|
-
**组合约定。** 该组件必须作为 `ApplicationQueryToolbar` 的 `commonFilters` 内容出现,传 2–3 个;不得独立散落在页面其他位置。该组件只持有本维度的取值,已生效条件必须由调用方回写到 `ApplicationQueryToolbar` 的 `appliedTags`,并实现 `onRemoveTag` 与 `onResetTags`;筛选状态只存在于菜单内部是不合规的。`ApplicationFilterOption.label` 传入非字符串时,必须同时提供 `labelText
|
|
3471
|
+
**组合约定。** 该组件必须作为 `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` 负责。
|
|
3447
3472
|
|
|
3448
3473
|
**禁止 / 使用边界。**
|
|
3449
3474
|
- 不得在一个查询工具栏内常驻超过 3 个筛选菜单。
|
|
3450
3475
|
- 禁止让已生效的筛选条件停留在菜单内部而不回写筛选标签行。
|
|
3451
3476
|
- 不得放进 `ApplicationPageHeader` —— 上下文区禁止出现搜索、筛选、排序。
|
|
3452
3477
|
- 不得用它切换 `pageMode` 或 `dataPresentation`,这两者各有专属控件。
|
|
3453
|
-
-
|
|
3478
|
+
- 不得覆盖触发器的高度、圆角与五种状态的外观,也不得把取值拼进 `label` 让触发器回显 —— 取值的视觉位置是已筛选标签行。
|
|
3454
3479
|
|
|
3455
3480
|
### ListSelectionCheckbox
|
|
3456
3481
|
|
|
@@ -3530,7 +3555,7 @@ Foundation `Pagination`(首页 · 上一页 · 页码窗口 · 下一页 ·
|
|
|
3530
3555
|
|
|
3531
3556
|
**用途。** 数据展示区的标准页脚 —— 摘要、每页条数、页码窗口与跳页。
|
|
3532
3557
|
|
|
3533
|
-
**何时使用。** 结果集同时具备总数与每页条数需求时必须使用本组件,它是 LIST 页面模式的默认配置。形态按 GAP Design kit「分页行」固定为:左侧「每页 N 条,共 Z 条数据」摘要(12/20 三级文字色),右侧依次为每页条数选择器、`Pagination`(首页 · 上一页 · 页码窗口 · 下一页 · 末页)与「第 [ ] 页」跳页框,控件一律 32 高、圆角 12、间隔 4
|
|
3558
|
+
**何时使用。** 结果集同时具备总数与每页条数需求时必须使用本组件,它是 LIST 页面模式的默认配置。形态按 GAP Design kit「分页行」固定为:左侧「每页 N 条,共 Z 条数据」摘要(12/20 三级文字色),右侧依次为每页条数选择器、`Pagination`(首页 · 上一页 · 页码窗口 · 下一页 · 末页)与「第 [ ] 页」跳页框,控件一律 32 高、圆角 12、间隔 4。跳页框 68×32,占位「请输入」是 kit 原文、也是通则「占位写示例或范围」唯一的登记例外(总页数由可访问名「跳转到第几页,共 N 页」读出),回车提交,输入越界时夹到 1 与总页数之间,提交后清空;总页数很少时可传 `showJumper={false}` 隐去。每页条数默认档为 20 / 50 / 100,业务确有别的档位时通过 `pageSizeOptions` 覆盖。
|
|
3534
3559
|
|
|
3535
3560
|
**何时改用其他组件。**
|
|
3536
3561
|
- 既无总数也无每页条数需求:改用 `Pagination`,它是本组件内部的页码区,可以单独使用。
|
|
@@ -3696,7 +3721,7 @@ Foundation `Pagination`(首页 · 上一页 · 页码窗口 · 下一页 ·
|
|
|
3696
3721
|
|
|
3697
3722
|
| prop | 类型 | 必填 | 说明 |
|
|
3698
3723
|
|---|---|:---:|---|
|
|
3699
|
-
| `intent` | `'primary' \| 'secondary' \| 'quiet' \| 'link' \| 'destructive' \| 'destructive-outline'` | 否 | 应用意图。映射到 Foundation Button 的 variant:`quiet` → ghost
|
|
3724
|
+
| `intent` | `'primary' \| 'secondary' \| 'quiet' \| 'quiet-accent' \| 'link' \| 'destructive' \| 'destructive-outline'` | 否 | 应用意图。映射到 Foundation Button 的 variant:`quiet` → ghost,`quiet-accent` → ghost-accent, 其余同名。 记录级的行内动作(`Table` 操作列、`ApplicationRecordList` 行尾的「编辑 / 删除」)用 `quiet-accent`:透明底、主色字,移入主色 6% 底、按下主色 15% 底(GAP Design kit 「按钮 / 类型=幽灵主要」,列表操作单元 123:5796)。行内删除同样用它,危险提示交给删除前的 `AlertDialog`(kit 行内没有红色删除)。`link` 只留给句中或卡片页脚那种行内链接式动作。 删除类动作两档:`destructive-outline`(白底、线条色描边、危险色文字;移入时描边变为危险色,按下时再加危险色 10% 底(GAP Design kit「按钮 / 类型=危险」三态))用于与次要按钮 并排出现的删除,例如表单里「删除此附件」;`destructive`(实心危险色)只用于 确认弹窗里那个不可逆的最终动作。同一动作组内不得同时出现两档。 |
|
|
3700
3725
|
| `size` | `'default' \| 'compact' \| 'sm'` | 否 | 尺寸。见 T2 —— `compact` 目前与 `default` 无视觉差异。 `sm` 映射 Foundation Button 的 28px 档,只用于嵌进 32px 控件内部的动作 (`InputGroup` 的尾部按钮),不得用来压缩页面上的独立按钮。 |
|
|
3701
3726
|
| `iconOnly` | `boolean` | 否 | 等宽图标按钮:宽度收敛为与高度相等,行内内边距归零。直接映射到 Foundation `Button` 的 `iconOnly`,与 `intent` / `size` 正交。为 true 时**必须**提供 `aria-label`。 |
|
|
3702
3727
|
| `loading` | `boolean` | 否 | 加载中。阻断交互并设置 `aria-busy`,同时渲染一个行内转圈;`iconOnly` 时转圈 替换原图标的位置,按钮尺寸不变。与 `disabled` 都会阻断动作,但语义不同:loading 是暂时的。 实现不用原生 `disabled`:渲染 `aria-disabled="true"` 并在 `onClick` 中 `preventDefault`(同时挡住 `type="submit"` 的表单提交),按钮保持可聚焦, 焦点不会在点击后掉到 `<body>`。 |
|
|
@@ -3706,7 +3731,7 @@ Foundation `Pagination`(首页 · 上一页 · 页码窗口 · 下一页 ·
|
|
|
3706
3731
|
|
|
3707
3732
|
**用途。** 整个产品的默认动作按钮,是 Foundation `Button` 之上只承载应用意图、loading 与产品状态的薄适配层。
|
|
3708
3733
|
|
|
3709
|
-
**何时使用。** 业务页面中的每一个按钮都必须使用本组件,没有例外;Foundation `Button` 只供库内组件使用。改一次应用强调色,全部 `SystemButton` 同时换肤,这个性质正是它存在的理由。该组件绝不重新实现按钮的排版与几何:14/20 字号、32px 高度、12px 圆角全部来自 Foundation `Button`。删除类动作分两档:`intent="destructive-outline"
|
|
3734
|
+
**何时使用。** 业务页面中的每一个按钮都必须使用本组件,没有例外;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` 的三态从换肤主色派生。
|
|
3710
3735
|
|
|
3711
3736
|
**何时改用其他组件。**
|
|
3712
3737
|
- 一组相关按钮需要拼接为分段控件或间隔簇:外层用 `ButtonGroup`,组内仍是 `SystemButton`。
|
|
@@ -3968,7 +3993,8 @@ Page Mode、Business View、搜索、筛选、对象动作、页面级主操作
|
|
|
3968
3993
|
|
|
3969
3994
|
⚠ **这是一个工作台面组件,位于 Content Canvas 内部,
|
|
3970
3995
|
不是应用外层 Shell 的一部分。**
|
|
3971
|
-
应用外层 Shell
|
|
3996
|
+
应用外层 Shell 是刻意设计的**无侧栏、全宽导航带堆叠**:基础版两带(应用一级 + 应用二级),
|
|
3997
|
+
集团版三带(再加集团顶部导航),见 GAP Design kit「框架结构」——
|
|
3972
3998
|
不要因为有了这个组件就往 Shell 上加一条全局左栏。
|
|
3973
3999
|
|
|
3974
4000
|
Content Canvas 内的通用垂直导航请用 Foundation `Sidebar`;
|
|
@@ -4321,7 +4347,7 @@ primary-secondary 语义中的单个次级数字
|
|
|
4321
4347
|
- 行内或表格单元中的状态标签:改用 `Badge`。
|
|
4322
4348
|
- 承载业务内容而非数字的卡片:改用 `Card`。
|
|
4323
4349
|
|
|
4324
|
-
**组合约定。** 本组件必须放进 `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
|
|
4350
|
+
**组合约定。** 本组件必须放进 `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` 都不渲染;读屏经组件内置的状态播报获知「指标加载中」/「指标加载失败」。
|
|
4325
4351
|
|
|
4326
4352
|
**禁止 / 使用边界。**
|
|
4327
4353
|
- 不得用 `state="loading"` 长期占位来顶替「无真实指标」—— 无指标时整个区域不渲染。
|
|
@@ -4587,8 +4613,8 @@ Canvas 的**上下文区**(源仓库名 `application-page-header`)。
|
|
|
4587
4613
|
| `onRefresh` | `() => void` | 否 | 刷新回调。提供时更新时间与刷新字形合成一枚按钮,`refreshing` 状态下不可点、字形转圈。 **未提供时不渲染刷新字形,时间按纯文字显示** —— 没有刷新能力的页面(草稿、向导、 一次性结果)不得出现一个点了没反应的按钮。状态文案(时间 / 刷新中 / 刷新失败)不受影响。 |
|
|
4588
4614
|
| `onBack` | `() => void` | 否 | 返回回调。提供时标题前渲染「返回」幽灵按钮(kit「数据更新-二级页面」)。 组件不做路由跳转,回到哪里、还原哪些上下文由调用方决定。 与 `breadcrumb` 不得同时传 —— 二级页面用返回,需要展示多级路径时才用面包屑 |
|
|
4589
4615
|
| `backLabel` | `string` | 否 | 返回按钮文案,默认「返回」。只在 `onBack` 提供时生效 |
|
|
4590
|
-
| `taskStatus` | `ApplicationPageHeaderTaskStatus` | 否 | 页面级进行中任务的状态胶囊,居中显示在页头中部。例如批量识别的「正在识别 14/100」。 `busy` 为 true
|
|
4591
|
-
| `actions` | `ReactNode` | 否 | 页面级动作组。**至多一个 primary
|
|
4616
|
+
| `taskStatus` | `ApplicationPageHeaderTaskStatus` | 否 | 页面级进行中任务的状态胶囊,居中显示在页头中部。例如批量识别的「正在识别 14/100」。 `busy` 为 true 时胶囊前带 16px 强调色转圈。胶囊 32 高、内边距 6/10、圆角 20、主色 6% 底, 文字 14/20 文字1。 只表达**本页正在进行的一项任务**的进度;**不得**用它显示数据刷新状态(那是 `dataStatus`)、页面说明(那是 `subtitle`)或筛选摘要(那属于 `ApplicationQueryToolbar`)。 |
|
|
4617
|
+
| `actions` | `ReactNode` | 否 | 页面级动作组。**至多一个 primary**。动作之间由组件统一给出 4 的间隔 (GAP Design kit「数据更新、操作」的页面操作插槽),调用方不得包一层 `ButtonGroup` 或自带外边距 |
|
|
4592
4618
|
| `pageModes` | `PageMode[]` | 否 | 本页**真正开放**的页面模式。少于 2 个则开关完全不渲染 |
|
|
4593
4619
|
| `pageMode` | `PageMode` | 否 | 当前页面模式 |
|
|
4594
4620
|
| `onPageModeChange` | `(mode: PageMode) => void` | 否 | 页面模式变化回调 |
|
|
@@ -4617,7 +4643,7 @@ Canvas 的**上下文区**(源仓库名 `application-page-header`)。
|
|
|
4617
4643
|
- 面包屑本体用 `Breadcrumb`,经 `breadcrumb` 槽位传入;单纯回到上一层(二级页面)不用面包屑,改传 `onBack`。
|
|
4618
4644
|
|
|
4619
4645
|
**组合约定。**
|
|
4620
|
-
- `actions` 承载页面级动作组,元素应为 `SystemButton`,至多一个 primary
|
|
4646
|
+
- `actions` 承载页面级动作组,元素应为 `SystemButton`,至多一个 primary,直接并列传入、不包 `ButtonGroup`。动作之间的 4px 间隔由组件给出(GAP Design kit「数据更新、操作」的页面操作插槽)。中文标签为 2–4 字裸名词短语:`新建`、`导入`、`导出`、`更多`。
|
|
4621
4647
|
- Page Mode Switch 由 `pageModes`、`pageMode`、`onPageModeChange` 三者共同驱动,三者必须成组提供;只给 `pageModes` 会得到一个点不动的开关。它按 radiogroup 模式只占一个 Tab 停靠点,← / → 切换模式并首尾相接,Home / End 跳到首末项 —— 方向键同样触发 `onPageModeChange`。
|
|
4622
4648
|
- `pageModes` 只列该页面真正开放的模式。少于 2 个时开关完全不渲染且不占位。
|
|
4623
4649
|
- 左侧按 GAP Design kit「数据更新」排布:可选的「返回」→ 标题 → 12px 竖线 → 更新时间。传 `onBack` 时标题前渲染「返回」幽灵按钮(16px chevron + 文字,32 高、圆角 12),文案经 `backLabel` 可改,组件不跳转、回到哪里由调用方决定;二级页面用它回到来源页。`onBack` 与 `breadcrumb` 不得同时传。
|
|
@@ -4625,7 +4651,7 @@ Canvas 的**上下文区**(源仓库名 `application-page-header`)。
|
|
|
4625
4651
|
- 传了 `onRefresh` 时,更新时间与其后的 16px 刷新字形合成一枚幽灵按钮,点它即刷新,可访问名为「刷新,2026-07-28 10:00」;没有刷新能力的页面(草稿、向导、一次性结果)不传,时间按纯文字显示,不出现刷新字形。
|
|
4626
4652
|
- 三种数据状态各有各的措辞与可用性:`normal` 显示更新时间,`refreshing` 显示刷新中、字形转圈且按钮不可点,`failed` 显示刷新失败(危险色)且按钮读作 `重试`。
|
|
4627
4653
|
- `title` 为字符串时才会得到悬浮提示。需要悬浮提示又需要补充信息时,标题主体传 `title`,补充信息走 `subtitle`。
|
|
4628
|
-
- 页面级进行中任务(批量识别、批量导入)的进度经 `taskStatus` 渲染为页头正中的胶囊,`label` 写「正在识别 14/100」,`busy` 为 true
|
|
4654
|
+
- 页面级进行中任务(批量识别、批量导入)的进度经 `taskStatus` 渲染为页头正中的胶囊,`label` 写「正在识别 14/100」,`busy` 为 true 时带强调色转圈;胶囊 32 高、内边距 6/10、主色 6% 底,文字为文字1。任务结束后移除 `taskStatus`,结果写进 `Sonner` 或页面内容。进度不得写进 `subtitle`。
|
|
4629
4655
|
- 外观是 48px 通栏:落在页面底色上、只有一条 0.5px 下边线,不是卡片;放在 `ApplicationPageLayoutContainer` 的 `header` 槽位时自动吃掉顶部与两侧留白。
|
|
4630
4656
|
- 该组件自身不带外边距,与相邻区域的间距由 `ApplicationPageLayoutContainer` 的区域间隙负责。
|
|
4631
4657
|
- Page Mode Switch 的选中态与 `ToggleGroup` 同为分段控件表达(选中项抬升为表面色),不得改为淡色洗 —— 淡色洗属于独立开关 `Toggle`。
|
|
@@ -4752,7 +4778,8 @@ Calendar → 日历设置 · Chart → 图表设置 · Timeline → 时间轴设
|
|
|
4752
4778
|
| `businessViews` | `BusinessViewTab[]` | 否 | 业务视图标签集合。2–4 个 |
|
|
4753
4779
|
| `businessView` | `string` | 否 | 当前业务视图 |
|
|
4754
4780
|
| `onBusinessViewChange` | `(value: string) => void` | 否 | 业务视图变化回调 |
|
|
4755
|
-
| `resultSummary` | `ReactNode` | 否 | 结果摘要,渲染为一枚胶囊,如 `<>共 <strong>1,284</strong> 条</>`。 数字用 `<strong>`
|
|
4781
|
+
| `resultSummary` | `ReactNode` | 否 | 结果摘要,渲染为一枚胶囊,如 `<>共 <strong>1,284</strong> 条</>`。 数字用 `<strong>` 包裹即加粗为正文色。已选数不写在这里,传 `selectedSummary`。 |
|
|
4782
|
+
| `selectedSummary` | `ReactNode` | 否 | 已选数,如「已选 3 张」。渲染在结果摘要胶囊内、主文之后,间隔 8,12/16 三级文字色 (GAP Design kit「查询结果摘要」39:2304)。只在有勾选时传,没有勾选时不传、不写「已选 0」; 必须与 `resultSummary` 一起传,单独传不渲染。数字与 `resultSummary` 同一口径,计的是行勾选数 |
|
|
4756
4783
|
| `searchValue` | `string` | 否 | 搜索框受控值 |
|
|
4757
4784
|
| `onSearchChange` | `(event: ChangeEvent<HTMLInputElement> \| { target: { value: string } }) => void` | 否 | 搜索框值变化回调 |
|
|
4758
4785
|
| `onSearchSubmit` | `(value: string) => void` | 否 | 搜索提交回调。**仅 Enter 触发** |
|
|
@@ -4813,7 +4840,7 @@ L3 业务视图标签
|
|
|
4813
4840
|
- 第二行左组的顺序固定为「结果摘要 → 搜索 → 排序 → 常用筛选 → 更多」,右组只放 `viewModeSwitch` 与呈现设置(GAP Design kit「数据筛选搜索」:排序在搜索后面、筛选前面;业财平台 round-01 裁决)。
|
|
4814
4841
|
- 间隔按 kit「数据筛选搜索」:三行之间 8;第二行左组控件之间 4、右组之间 4、左右两组之间 12;摘要与搜索之间由组件画一条 1×20 的线条色竖线,只在传了 `resultSummary` 时出现。间隔与竖线都由组件给出,传入的排序与筛选控件不带外边距。
|
|
4815
4842
|
- `sort` 传 `Select`(无可见标签,用 `aria-label` 命名)。DataTable 呈现下表头排序是第二入口:`Table` 的 `sort` 与这里的 `Select` 读写同一份排序状态,任一处改动另一处同步回显(07 · C-2)。
|
|
4816
|
-
- `resultSummary` 渲染为一枚胶囊,数字用 `<strong>` 包裹即加粗为正文色,如 `<>共 <strong>46</strong>
|
|
4843
|
+
- `resultSummary` 渲染为一枚胶囊,数字用 `<strong>` 包裹即加粗为正文色,如 `<>共 <strong>46</strong> 张</>`。有勾选时已选数传 `selectedSummary`(「已选 3 张」),组件把它排在主文之后、间隔 8、12/16 三级文字色;不得把已选数拼进 `resultSummary`,没有勾选时不传、不写「已选 0 张」。
|
|
4817
4844
|
- 生效条件必须回写 `appliedTags`,并同时提供 `onRemoveTag` 与 `onResetTags`;清除全部的按钮文案为「清空」,与筛选标签同款胶囊。`AppliedFilterTag.label` 为非字符串时必须提供 `labelText`,否则移除按钮的无障碍名称为空。
|
|
4818
4845
|
- 呈现设置按钮按 kit 是 32×32 纯图标(16px `sliders-horizontal`,白底描边、圆角 12),名字落在可访问名与悬停提示上;`presentation` 决定这个名字,必须与 `ApplicationDataDisplay` 的同名 prop 取自同一处状态。
|
|
4819
4846
|
- `hasPresentationSettings` 缺省时按是否提供 `onPresentationSettings` 推断:给了回调即渲染设置按钮,不给即不渲染且不占位;显式传入优先。无真实可配置项时不传回调即可,或显式传 `hasPresentationSettings={false}`。
|
|
@@ -4851,9 +4878,9 @@ L3 业务视图标签
|
|
|
4851
4878
|
|
|
4852
4879
|
| prop | 类型 | 必填 | 说明 |
|
|
4853
4880
|
|---|---|:---:|---|
|
|
4854
|
-
| `summary` | `ReactNode` | 否 |
|
|
4881
|
+
| `summary` | `ReactNode` | 否 | 对象头:对象名、状态徽标、关键标识。渲染在白卡之外、落在载体灰底上,占满整行; 有 `aside` 时横跨两栏(GAP Design kit「抽屉 / 常规」151:1135)。对象名用 24/32 medium (`--application-font-size-display` / `--application-line-height-display`),与状态徽标间隔 8 |
|
|
4855
4882
|
| `sections` | `DetailSection[]` | 否 | 分节集合,按顺序渲染 |
|
|
4856
|
-
| `aside` | `DetailSection` | 否 | 侧栏分节。提供时主体变为两栏:左栏(`summary`
|
|
4883
|
+
| `aside` | `DetailSection` | 否 | 侧栏分节。提供时主体变为两栏:左栏(`sections`)弹性伸展,右栏固定 360px, 两栏各是一张内边距 12 的白卡,间距 12;`summary` 在两栏之上。侧栏内元素间距 12, 主栏分节间距 16(GAP Design kit「抽屉 / 流程类左右」151:1941)。用于「处理记录」 「审批流转」这类**伴随主内容、随它一起看**的内容。 只放一个分节;**不得**把主要字段分节挪进侧栏,也不得用它放对象级动作 (动作在载体的动作区)。可用宽度不足 960px 时侧栏落到主栏下方。 |
|
|
4857
4884
|
|
|
4858
4885
|
继承 `HTMLAttributes<HTMLDivElement>` 的全部原生属性。
|
|
4859
4886
|
|
|
@@ -4873,8 +4900,8 @@ L3 业务视图标签
|
|
|
4873
4900
|
|
|
4874
4901
|
| prop | 类型 | 必填 | 说明 |
|
|
4875
4902
|
|---|---|:---:|---|
|
|
4876
|
-
| `key` | `string` | 否 | React key。`title`
|
|
4877
|
-
| `title` | `ReactNode` |
|
|
4903
|
+
| `key` | `string` | 否 | React key。`title` 省略或为非字符串时**必须**提供。见 M8 |
|
|
4904
|
+
| `title` | `ReactNode` | 否 | 分节标题,16/20 medium 字重,左侧带 2×14 强调色竖条。 可省略:内容自带版式标题、再加分节标题会重复时(票面、单据影像这类整块呈现的内容), 不渲染标题行与竖条。只有第一个分节可以省略 —— 后续分节没有标题,读者分不清 分节边界。省略时 `action` 仍右对齐渲染。 |
|
|
4878
4905
|
| `fields` | `DetailField[]` | 否 | 字段列表,自适应多列网格排布 |
|
|
4879
4906
|
| `content` | `ReactNode` | 否 | 自定义内容,排在字段之后。用于时间轴、附件列表等 |
|
|
4880
4907
|
| `action` | `ReactNode` | 否 | 分节级动作,右对齐于标题行 |
|
|
@@ -4891,10 +4918,11 @@ L3 业务视图标签
|
|
|
4891
4918
|
- 单个名值对之外的静态面板改用 `Card`。
|
|
4892
4919
|
|
|
4893
4920
|
**组合约定。**
|
|
4894
|
-
- `summary`
|
|
4895
|
-
- `sections` 按数组顺序渲染。`DetailSection.title`
|
|
4896
|
-
- 字段以 `dl` / `dt` / `dd` 输出为横排名值对:字段名 160px 宽、14/20 三级文字色,值 14/20 medium。列数随可用宽度自适应,字段列最窄 360px
|
|
4897
|
-
-
|
|
4921
|
+
- `summary` 承载对象头:对象名、状态徽标(应为 `Badge`)、关键标识。它渲染在白卡之外、落在载体灰底上并占满整行,有 `aside` 时横跨两栏(GAP Design kit「抽屉 / 常规」)。对象名用 24/32 medium:`--application-font-size-display` 与 `--application-line-height-display`,字重 `--application-font-weight-medium`;与状态徽标间隔 8。
|
|
4922
|
+
- `sections` 按数组顺序渲染。`DetailSection.title` 省略或为非字符串时必须提供 `key`;契约同样为 `DetailField` 登记了 `key`,`label` 为非字符串时必须提供。
|
|
4923
|
+
- 字段以 `dl` / `dt` / `dd` 输出为横排名值对:字段名 160px 宽、14/20 三级文字色,值 14/20 medium。列数随可用宽度自适应,字段列最窄 360px,两个载体不需要各写一套。分节内容落在内边距 12 的白卡里,载体负责灰底;分节间距 16,分节标题带 2×14 强调色竖条。
|
|
4924
|
+
- `DetailSection.title` 可省略:内容自带版式、再加分节标题会重复时(票面、单据影像这类整块呈现的内容)不渲染标题行与竖条。只有第一个分节可以省略,后续分节一律写标题,否则读者分不清分节边界。
|
|
4925
|
+
- 伴随主内容一起看的一个分节(处理记录、审批流转)经 `aside` 传入,主体变为两栏:左栏弹性、右栏固定 360px,间距 12,侧栏内元素间距 12;可用宽度不足 960px 时侧栏落到主栏下方并拉满整行。主要字段分节不得挪进 `aside`。
|
|
4898
4926
|
- 分节级动作经 `DetailSection.action` 右对齐于标题行;对象级主动作属于载体:抽屉写在页头右侧的动作区,独立详情页写在 `ApplicationPageHeader` 的 `actions`。
|
|
4899
4927
|
- 时间轴、附件列表等非名值对内容走 `DetailSection.content`,排在字段之后。
|
|
4900
4928
|
- 该组件不带外边距也不自持滚动,留白与滚动一律由载体负责。
|
|
@@ -5042,7 +5070,7 @@ SPLIT 左栏的单个目录项
|
|
|
5042
5070
|
- 消息流与活动流的条目改用 `Message`,会话气泡改用 `Bubble`。
|
|
5043
5071
|
- 六种系统状态的承载、批量动作条与分页的挂载,由宿主 `ApplicationDataDisplay` 负责,不在本组件内解决。
|
|
5044
5072
|
|
|
5045
|
-
**组合约定。** 本组件必须放进 `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`
|
|
5073
|
+
**组合约定。** 本组件必须放进 `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`,不属于本组件。
|
|
5046
5074
|
|
|
5047
5075
|
**禁止 / 使用边界。**
|
|
5048
5076
|
- 不得在本组件内持有搜索、筛选、排序状态 —— 那些全部属于 `ApplicationQueryToolbar`,数据展示区绝不持有第二套查询状态。
|
|
@@ -5122,7 +5150,7 @@ DETAIL 的**抽屉载体** —— 打开一条记录的详情而不丢失身后
|
|
|
5122
5150
|
|---|---|:---:|---|
|
|
5123
5151
|
| `open` | `boolean` | 否 | 是否打开。为 false 时渲染 `null` |
|
|
5124
5152
|
| `title` | `ReactNode` | 否 | 对象标题 |
|
|
5125
|
-
| `subtitle` | `ReactNode` | 否 |
|
|
5153
|
+
| `subtitle` | `ReactNode` | 否 | 副标题,通常是对象编号。与标题同行,同为 14/20 medium 文字2,间隔 10(GAP Design kit「抽屉 / 常规」页头) |
|
|
5126
5154
|
| `status` | `ReactNode` | 否 | 对象状态徽标,紧邻标题 |
|
|
5127
5155
|
| `width` | `number` | 否 | 宽度,单位 px。推荐 680 |
|
|
5128
5156
|
| `side` | `'left' \| 'right'` | 否 | 从哪一侧滑出。默认 `right`。来源在右侧(右栏、周末日格)时传 `left`, 免得 680px 的抽屉正好盖住刚点的那一处(06 · P2-8) |
|
|
@@ -5141,7 +5169,7 @@ DETAIL 的**抽屉载体** —— 打开一条记录的详情而不丢失身后
|
|
|
5141
5169
|
- 非业务记录的侧边面板、或不需要已登记详情结构的裸抽屉,改用 Foundation `Drawer`。
|
|
5142
5170
|
- 帮助、附件预览这类辅助性内容改用 `Sheet` —— 业务对象详情不属于那里;全局设置是二级导航里的设置模块,也不进抽屉。
|
|
5143
5171
|
- 需要深链接的详情改用独立详情页,深链接永远只指向独立详情页。
|
|
5144
|
-
-
|
|
5172
|
+
- 默认 680px 宽的抽屉:分节超过 3 个、字段超过 15 个、动作流程有实质差异或性能要求不同时,改用独立详情页承载完整内容,抽屉侧只保留核心内容。1280px 宽变体不受分节数与字段数两条阈值约束 —— GAP Design kit「抽屉弹窗」的三个 1278 宽变体(常规、流程类左右、图文详情)本就承载对象头、统计、页签与侧栏,可以与独立详情页共用同一份完整的 `ApplicationRecordDetailBody`;动作流程与性能两条照常适用,深链接仍只指向独立详情页。
|
|
5145
5173
|
- 编辑与新建改用 `ApplicationFormDialog`;不可逆动作的确认改用 `AlertDialog`。
|
|
5146
5174
|
|
|
5147
5175
|
**组合约定。** `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 基座负责,调用方不得再实现一遍。
|
|
@@ -5184,7 +5212,7 @@ DETAIL 的**抽屉载体** —— 打开一条记录的详情而不丢失身后
|
|
|
5184
5212
|
| `open` | `boolean` | 否 | 是否打开。为 false 时渲染 `null` |
|
|
5185
5213
|
| `title` | `ReactNode` | 否 | 标题 |
|
|
5186
5214
|
| `description` | `ReactNode` | 否 | 补充说明,与标题同行、以 14/20 label 色跟在标题之后。只写一句短语 |
|
|
5187
|
-
| `size` | `'small' \| 'large' \| 'xlarge'` | 否 | 宽度档位。`small` 720px / `large` 960px / `xlarge` 1280px。 `xlarge` 是 GAP Design kit 弹窗宽度区间(680–1280
|
|
5215
|
+
| `size` | `'small' \| 'large' \| 'xlarge'` | 否 | 宽度档位。`small` 720px / `large` 960px / `xlarge` 1280px。 `xlarge` 是 GAP Design kit 弹窗宽度区间(680–1280)的上限,用于字段多、或字段之上带原件预览 (`preview`)的编辑场景(业财平台 round-01 · editor/dialog/width 裁决,2026-11-10) |
|
|
5188
5216
|
| `columns` | `number` | 否 | 字段网格列数。默认 2 |
|
|
5189
5217
|
| `submitText` | `string` | 否 | 提交按钮文案 |
|
|
5190
5218
|
| `cancelText` | `string` | 否 | 取消按钮文案 |
|
|
@@ -5194,13 +5222,14 @@ DETAIL 的**抽屉载体** —— 打开一条记录的详情而不丢失身后
|
|
|
5194
5222
|
| `onCancel` | `() => void` | 否 | 取消回调。页头关闭按钮、Esc 与遮罩点击同样触发它 |
|
|
5195
5223
|
| `secondaryActions` | `ReactNode` | 否 | 底部动作区的附加次要动作,排在「取消」与提交按钮之间,例如逐条编辑时的 「上一张」「下一张」。传 `SystemButton`(`intent="secondary"`)。 **不得**放第二个 primary,也不得放删除类动作 —— 删除不与提交并排出现在页脚。 |
|
|
5196
5224
|
| `footerNote` | `ReactNode` | 否 | 底部动作区左侧的一段说明,12/16 label 色,例如「共 100 条,当前第 6 条」。 只写与本次提交相关的上下文;校验错误与提交失败**不得**写在这里(前者在字段、后者是 `error`)。 |
|
|
5225
|
+
| `preview` | `ReactNode` | 否 | 原件 / 单据影像预览区,渲染在白卡内、字段网格之上,横跨全部列,与字段网格间隔 10。 用于对照原件录入的编辑场景(发票、合同影像)。只放预览与它的查看动作,不放字段; 原件**不得**作为非 `Field` 子元素塞进 `children` 再用外部 CSS 跨列(规则冲突 R8) |
|
|
5197
5226
|
| `children` | `ReactNode` | 否 | 表单字段,传 `Field` 子元素 |
|
|
5198
5227
|
|
|
5199
5228
|
继承 `HTMLAttributes<HTMLDivElement>` 的全部原生属性,其中 `title` 已被本组件重新定义或移除。
|
|
5200
5229
|
|
|
5201
5230
|
**用途。** 业务对象新建与编辑的模态表单载体,拥有已登记的字段网格与提交 / 取消语义。
|
|
5202
5231
|
|
|
5203
|
-
**何时使用。** 用户必须完成或放弃的表单任务一律用本组件。已登记宽度只有 `small` 720px、`large` 960px 与 `xlarge` 1280px 三档(1280 是 GAP Design kit 弹窗宽度区间 680–1280 的上限,业财平台 round-01 裁决),字段默认排布在两列网格上。`xlarge`
|
|
5232
|
+
**何时使用。** 用户必须完成或放弃的表单任务一律用本组件。已登记宽度只有 `small` 720px、`large` 960px 与 `xlarge` 1280px 三档(1280 是 GAP Design kit 弹窗宽度区间 680–1280 的上限,业财平台 round-01 裁决),字段默认排布在两列网格上。`xlarge` 只给字段多、或字段之上带原件预览的编辑场景。提交中由 `submitting` 表达,提交级失败由 `error` 表达。该组件建立在共享 Overlay 基座上,因此自带 Esc 关闭、焦点陷阱、关闭后焦点恢复与背景滚动锁定。
|
|
5204
5233
|
|
|
5205
5234
|
**何时改用其他组件。**
|
|
5206
5235
|
- 不含表单的聚焦任务(导入映射、确认预览)改用 Foundation `Dialog`。
|
|
@@ -5210,7 +5239,7 @@ DETAIL 的**抽屉载体** —— 打开一条记录的详情而不丢失身后
|
|
|
5210
5239
|
- 帮助、附件预览这类辅助性面板改用 `Sheet`;全局设置是二级导航里的设置模块。
|
|
5211
5240
|
- 字段规模超出三档宽度可承载的范围时,改用独立编辑页承载。
|
|
5212
5241
|
|
|
5213
|
-
**组合约定。** 字段一律以 `Field` 子元素传入 `children`,一个 `Field` 管辖一个控件。需要跨列的字段给 `Field` 传 `span="full"`,不得用内联 `style` 写 `gridColumn`;需要单列或三列时改 `columns`,不要用外部 CSS
|
|
5242
|
+
**组合约定。** 字段一律以 `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 基座负责,调用方不得再包一层定位容器。
|
|
5214
5243
|
|
|
5215
5244
|
**禁止 / 使用边界。**
|
|
5216
5245
|
- 不得把提交失败呈现为 `Sonner` —— 用户必须处理的失败绝不能放进转瞬即逝的提示里。
|
|
@@ -5219,6 +5248,7 @@ DETAIL 的**抽屉载体** —— 打开一条记录的详情而不丢失身后
|
|
|
5219
5248
|
- 禁止把宽度改到 720px / 960px / 1280px 三档之外,也禁止让对话框超出有效视口。
|
|
5220
5249
|
- 不得用 `className` 把面板圆角改回 16 或其他值 —— 四个模态弹窗同取 `--application-radius-dialog`。
|
|
5221
5250
|
- 不得用本组件承载只读详情,详情有它自己的两个载体。
|
|
5251
|
+
- 不得在 `preview` 里放字段或提交类动作 —— 它只承载原件与查看原件的动作。
|
|
5222
5252
|
- 不得在 `children` 内用内联 style 改写控件自身的边框、高度或圆角。
|
|
5223
5253
|
|
|
5224
5254
|
### ApplicationGlobalActionPanel
|
|
@@ -5844,10 +5874,10 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5844
5874
|
| `no-raw-px-value` | forbid-value | internal | error | 禁止硬编码尺寸。间距用 --ds-space-0 至 --ds-space-5(后缀是档位序号,六档依次为 0/4/8/12/16/24px),圆角用 --ds-radius-0/4/8/12/16/20(后缀即像素值),字号用 --ds-font-size-12/14/16/20/24、行高用 --ds-line-height-16/20/24/28/32(后缀同为像素值)。系统内没有 20 / 32 / 48 间距档,出现这类值说明取错了标尺 |
|
|
5845
5875
|
| `no-unregistered-font` | forbid-value | internal | error | 禁止直接书写字族。请改用 var(--ds-font-family),等宽场景用 var(--ds-font-family-mono)。系统只有单一字族,没有展示体,也没有搭配字体 |
|
|
5846
5876
|
| `props-whitelist-icon` | props-whitelist | both | warn | <Icon> 不接受该 prop。已声明的 props:name、size、strokeWidth、color、style。继承自 SVGProps<SVGSVGElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5847
|
-
| `prop-enum-icon-name` | prop-enum | both | warn | <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' 之一 |
|
|
5877
|
+
| `prop-enum-icon-name` | prop-enum | both | warn | <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' 之一 |
|
|
5848
5878
|
| `prop-enum-icon-size` | prop-enum | both | warn | <Icon> 的 size 取值须为 14 \| 16 \| 18 \| 20 \| 24 之一 |
|
|
5849
5879
|
| `props-whitelist-button` | props-whitelist | both | warn | <Button> 不接受该 prop。已声明的 props:variant、size、iconOnly、disabled、children。继承自 ButtonHTMLAttributes<HTMLButtonElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5850
|
-
| `prop-enum-button-variant` | prop-enum | both | warn | <Button> 的 variant 取值须为 'primary' \| 'secondary' \| 'outline' \| 'ghost' \| 'destructive' \| 'destructive-outline' \| 'link' 之一 |
|
|
5880
|
+
| `prop-enum-button-variant` | prop-enum | both | warn | <Button> 的 variant 取值须为 'primary' \| 'secondary' \| 'outline' \| 'ghost' \| 'ghost-accent' \| 'destructive' \| 'destructive-outline' \| 'link' 之一 |
|
|
5851
5881
|
| `prop-enum-button-size` | prop-enum | both | warn | <Button> 的 size 取值须为 'xs' \| 'sm' \| 'default' \| 'lg' 之一 |
|
|
5852
5882
|
| `props-whitelist-button-group` | props-whitelist | both | warn | <ButtonGroup> 不接受该 prop。已声明的 props:children、orientation、attached。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5853
5883
|
| `prop-enum-button-group-orientation` | prop-enum | both | warn | <ButtonGroup> 的 orientation 取值须为 'horizontal' \| 'vertical' 之一 |
|
|
@@ -5940,11 +5970,11 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5940
5970
|
| `props-whitelist-sidebar-app-link-button` | props-whitelist | both | warn | <SidebarAppLinkButton> 不接受该 prop。已声明的 props:name、glyph、description。继承自 ButtonHTMLAttributes<HTMLButtonElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5941
5971
|
| `props-whitelist-sidebar-rail-button` | props-whitelist | both | warn | <SidebarRailButton> 不接受该 prop。已声明的 props:icon、label、active、badge。继承自 ButtonHTMLAttributes<HTMLButtonElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5942
5972
|
| `props-whitelist-system-button` | props-whitelist | both | warn | <SystemButton> 不接受该 prop。已声明的 props:intent、size、iconOnly、loading、children。继承自 ButtonHTMLAttributes<HTMLButtonElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5943
|
-
| `prop-enum-system-button-intent` | prop-enum | both | warn | <SystemButton> 的 intent 取值须为 'primary' \| 'secondary' \| 'quiet' \| 'link' \| 'destructive' \| 'destructive-outline' 之一 |
|
|
5973
|
+
| `prop-enum-system-button-intent` | prop-enum | both | warn | <SystemButton> 的 intent 取值须为 'primary' \| 'secondary' \| 'quiet' \| 'quiet-accent' \| 'link' \| 'destructive' \| 'destructive-outline' 之一 |
|
|
5944
5974
|
| `prop-enum-system-button-size` | prop-enum | both | warn | <SystemButton> 的 size 取值须为 'default' \| 'compact' \| 'sm' 之一 |
|
|
5945
5975
|
| `props-whitelist-application-module-switcher` | props-whitelist | both | warn | <ApplicationModuleSwitcher> 不接受该 prop。已声明的 props:moduleName、modules、currentModule、open、onOpenChange、onSelect。继承自 ButtonHTMLAttributes<HTMLButtonElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5946
5976
|
| `props-whitelist-application-primary-navigation` | props-whitelist | both | warn | <ApplicationPrimaryNavigation> 不接受该 prop。已声明的 props:appName、appGlyph、activeAction、actionBadges、onAction、account。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5947
|
-
| `prop-enum-application-primary-navigation-app-glyph` | prop-enum | both | warn | <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' 之一 |
|
|
5977
|
+
| `prop-enum-application-primary-navigation-app-glyph` | prop-enum | both | warn | <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' 之一 |
|
|
5948
5978
|
| `prop-enum-application-primary-navigation-active-action` | prop-enum | both | warn | <ApplicationPrimaryNavigation> 的 activeAction 取值须为 'messages' \| 'todos' \| 'overview' \| 'risk' \| 'settings' 之一 |
|
|
5949
5979
|
| `props-whitelist-application-secondary-navigation` | props-whitelist | both | warn | <ApplicationSecondaryNavigation> 不接受该 prop。已声明的 props:moduleSwitcher、tabs、value、onValueChange、onNavigationSettings、navigationSettingsOpen、onCloseSettings。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5950
5980
|
| `props-whitelist-global-sidebar` | props-whitelist | both | warn | <GlobalSidebar> 不接受该 prop。已声明的 props:items、value、onValueChange、footer。继承自 HTMLAttributes<HTMLElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
@@ -5966,7 +5996,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5966
5996
|
| `prop-enum-application-page-header-page-mode` | prop-enum | both | warn | <ApplicationPageHeader> 的 pageMode 取值须为 'LIST' \| 'CARD' \| 'SPLIT' \| 'BOARD' \| 'CALENDAR' 之一 |
|
|
5967
5997
|
| `props-whitelist-application-page-layout-container` | props-whitelist | both | warn | <ApplicationPageLayoutContainer> 不接受该 prop。已声明的 props:pageType、header、metrics、dataControl、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5968
5998
|
| `prop-enum-application-page-layout-container-page-type` | prop-enum | both | warn | <ApplicationPageLayoutContainer> 的 pageType 取值须为 'WORKBENCH' \| 'MANAGEMENT' \| 'LEDGER' \| 'ANALYSIS' \| 'REPORT' \| 'DETAIL' 之一 |
|
|
5969
|
-
| `props-whitelist-application-query-toolbar` | props-whitelist | both | warn | <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-* 等)可直接传,会透传到底层元素 |
|
|
5999
|
+
| `props-whitelist-application-query-toolbar` | props-whitelist | both | warn | <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-* 等)可直接传,会透传到底层元素 |
|
|
5970
6000
|
| `prop-enum-application-query-toolbar-presentation` | prop-enum | both | warn | <ApplicationQueryToolbar> 的 presentation 取值须为 'DataTable' \| 'RecordList' \| 'CardList' \| 'KanbanBoard' \| 'Calendar' \| 'Chart' \| 'Timeline' 之一 |
|
|
5971
6001
|
| `props-whitelist-application-record-detail-body` | props-whitelist | both | warn | <ApplicationRecordDetailBody> 不接受该 prop。已声明的 props:summary、sections、aside。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5972
6002
|
| `props-whitelist-application-split-list-sidebar` | props-whitelist | both | warn | <ApplicationSplitListSidebar> 不接受该 prop。已声明的 props:search、items、value、onValueChange、onClear、settings、footer、width。继承自 HTMLAttributes<HTMLElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
@@ -5974,7 +6004,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5974
6004
|
| `props-whitelist-list-batch-action-bar` | props-whitelist | both | warn | <ListBatchActionBar> 不接受该 prop。已声明的 props:count、onClear、actions、hint。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5975
6005
|
| `props-whitelist-application-detail-drawer` | props-whitelist | both | warn | <ApplicationDetailDrawer> 不接受该 prop。已声明的 props:open、title、subtitle、status、width、side、primaryAction、secondaryActions、onClose、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5976
6006
|
| `prop-enum-application-detail-drawer-side` | prop-enum | both | warn | <ApplicationDetailDrawer> 的 side 取值须为 'left' \| 'right' 之一 |
|
|
5977
|
-
| `props-whitelist-application-form-dialog` | props-whitelist | both | warn | <ApplicationFormDialog> 不接受该 prop。已声明的 props:open、title、description、size、columns、submitText、cancelText、submitting、error、onSubmit、onCancel、secondaryActions、footerNote、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
6007
|
+
| `props-whitelist-application-form-dialog` | props-whitelist | both | warn | <ApplicationFormDialog> 不接受该 prop。已声明的 props:open、title、description、size、columns、submitText、cancelText、submitting、error、onSubmit、onCancel、secondaryActions、footerNote、preview、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5978
6008
|
| `prop-enum-application-form-dialog-size` | prop-enum | both | warn | <ApplicationFormDialog> 的 size 取值须为 'small' \| 'large' \| 'xlarge' 之一 |
|
|
5979
6009
|
| `props-whitelist-application-global-action-panel` | props-whitelist | both | warn | <ApplicationGlobalActionPanel> 不接受该 prop。已声明的 props:open、title、tabs、activeTab、onTabChange、footer、state、loading、emptyState、error、noPermission、onClose、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5980
6010
|
| `prop-enum-application-global-action-panel-state` | prop-enum | both | warn | <ApplicationGlobalActionPanel> 的 state 取值须为 'ready' \| 'loading' \| 'empty' \| 'error' \| 'no-permission' 之一 |
|
|
@@ -5989,7 +6019,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5989
6019
|
|
|
5990
6020
|
## 图标字形
|
|
5991
6021
|
|
|
5992
|
-
共
|
|
6022
|
+
共 38 个。`<Icon name>` 只接受下表的名字(类型 `IconName`,清单外的名字在 tsc 与 `prop-enum` 两处被拒),尺寸只取登记档 14 / 16 / 18 / 20 / 24;
|
|
5993
6023
|
绕过类型检查的未登记名字渲染为等尺寸占位盒。确需新字形须先登记进 `@moheng-design/ui` 的图标清单并随包发版,
|
|
5994
6024
|
不得改用内联 `<svg>`。表中用途是该字形在库内的登记用途,业务侧可复用同一字形表达同义动作。
|
|
5995
6025
|
|
|
@@ -6012,6 +6042,8 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
6012
6042
|
| `columns-2` | Page Mode Switch 的 SPLIT 档字形(16px 档) |
|
|
6013
6043
|
| `download` | 业务页「导出 / 下载」动作的前置字形(14 / 16px 档) |
|
|
6014
6044
|
| `ellipsis` | 行内「更多操作」菜单的触发器字形;Pagination 页码跳空处(16px 档) |
|
|
6045
|
+
| `eye` | 业务页「查看 / 查看原件」动作的字形,含附件与处理记录里的查看(14 / 16px 档;kit icon/查看 195:2194) |
|
|
6046
|
+
| `file-text` | 票据、单据、文档类业务对象的导航与标题字形(16 / 18px 档;业财平台 round-02 生成侧缺口) |
|
|
6015
6047
|
| `funnel` | 工具栏「筛选 / 更多筛选」触发器的字形(14 / 16px 档);lucide 已把 filter 更名为 funnel |
|
|
6016
6048
|
| `info` | Alert 的 info 状态图标 |
|
|
6017
6049
|
| `kanban` | Page Mode Switch 的 BOARD 档字形(16px 档) |
|
|
@@ -6019,6 +6051,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
6019
6051
|
| `list` | Page Mode Switch 的 LIST 档字形(16px 档) |
|
|
6020
6052
|
| `message-square` | 全局动作「消息」的字形(18px 档) |
|
|
6021
6053
|
| `minus` | ApplicationMetricTrend 的持平方向字形(14px 档) |
|
|
6054
|
+
| `paperclip` | 附件的标记字形:附件列表、处理记录里的附件条目(14 / 16px 档) |
|
|
6022
6055
|
| `pencil` | 业务页「编辑」动作的字形,含行内操作(14 / 16px 档) |
|
|
6023
6056
|
| `plus` | 业务页「新建」动作的前置字形(SystemButton 内 14 / 16px 档) |
|
|
6024
6057
|
| `refresh-cw` | ApplicationPageHeader 的数据刷新触发器,接在更新时间之后(16px 档) |
|
|
@@ -6033,7 +6066,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
6033
6066
|
|
|
6034
6067
|
## Token 全表
|
|
6035
6068
|
|
|
6036
|
-
共
|
|
6069
|
+
共 396 条:`--application-*` 103 条、`--ui-*` 145 条、`--ds-*` 148 条。源是 `packages/ui/src/tokens/*.css`(01 §4.1),
|
|
6037
6070
|
本表由其导出产物 `tokens.json` 展平而来 —— CSS 是源,方向不可反转。
|
|
6038
6071
|
|
|
6039
6072
|
值即 CSS 源里的字面量,可直接写进 `var()` 的回退位或用于比对;`var(--…)` 形式表示
|
|
@@ -6079,12 +6112,14 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
6079
6112
|
| `--application-font-size-title` | `var(--ds-font-size-16)` | `--application-*` |
|
|
6080
6113
|
| `--application-font-size-heading` | `var(--ds-font-size-20)` | `--application-*` |
|
|
6081
6114
|
| `--application-font-size-metric` | `var(--ds-font-size-32)` | `--application-*` |
|
|
6115
|
+
| `--application-font-size-display` | `var(--ds-font-size-24)` | `--application-*` |
|
|
6082
6116
|
| `--application-metric-trend-up` | `var(--ds-color-text-tertiary)` | `--application-*` |
|
|
6083
6117
|
| `--application-line-height-meta` | `var(--ds-line-height-16)` | `--application-*` |
|
|
6084
6118
|
| `--application-line-height-body` | `var(--ds-line-height-20)` | `--application-*` |
|
|
6085
6119
|
| `--application-line-height-title` | `var(--ds-line-height-24)` | `--application-*` |
|
|
6086
6120
|
| `--application-line-height-heading` | `var(--ds-line-height-28)` | `--application-*` |
|
|
6087
6121
|
| `--application-line-height-metric` | `var(--ds-line-height-32)` | `--application-*` |
|
|
6122
|
+
| `--application-line-height-display` | `var(--ds-line-height-32)` | `--application-*` |
|
|
6088
6123
|
| `--application-space-0` | `var(--ds-space-0)` | `--application-*` |
|
|
6089
6124
|
| `--application-space-1` | `var(--ds-space-1)` | `--application-*` |
|
|
6090
6125
|
| `--application-space-2` | `var(--ds-space-2)` | `--application-*` |
|
|
@@ -6393,6 +6428,11 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
6393
6428
|
| `--ds-color-active-neutral` | `color-mix(in srgb,var(--ds-color-text) 12%,transparent)` | `--ds-*` |
|
|
6394
6429
|
| `--ds-color-focus` | `var(--ds-color-theme-primary)` | `--ds-*` |
|
|
6395
6430
|
| `--ds-color-tint-accent` | `color-mix(in srgb,var(--ds-color-theme-primary) 6%,transparent)` | `--ds-*` |
|
|
6431
|
+
| `--ds-color-tint-accent-active` | `color-mix(in srgb,var(--ds-color-theme-primary) 15%,transparent)` | `--ds-*` |
|
|
6432
|
+
| `--ds-color-tint-neutral-active` | `color-mix(in srgb,var(--ds-color-text) 25%,transparent)` | `--ds-*` |
|
|
6433
|
+
| `--ds-color-theme-primary-hover` | `color-mix(in srgb,var(--ds-color-theme-primary) 90%,var(--ds-color-on-accent))` | `--ds-*` |
|
|
6434
|
+
| `--ds-color-theme-primary-active` | `color-mix(in srgb,var(--ds-color-theme-primary) 93%,var(--ds-color-text))` | `--ds-*` |
|
|
6435
|
+
| `--ds-color-theme-primary-disabled` | `color-mix(in srgb,var(--ds-color-theme-primary) 67%,var(--ds-color-on-accent))` | `--ds-*` |
|
|
6396
6436
|
| `--ds-space-0` | `0px` | `--ds-*` |
|
|
6397
6437
|
| `--ds-space-1` | `4px` | `--ds-*` |
|
|
6398
6438
|
| `--ds-space-2` | `8px` | `--ds-*` |
|