@moheng-design/ui-skill 2.0.0 → 3.0.0
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 +1 -1
- package/bin/cli.js +0 -0
- package/bin/lib/upgrade.mjs +27 -6
- package/generated/SKILL.md +49 -36
- package/generated/contracts.json +1504 -620
- package/generated/plugin-data.js +113 -19
- package/generated/reference.md +570 -258
- package/generated/rules.json +93 -19
- package/generated/skills/moheng-ui-bootstrap/SKILL.md +1 -1
- package/generated/skills/moheng-ui-page/SKILL.md +7 -4
- package/generated/skills/moheng-ui-review/SKILL.md +1 -1
- package/generated/skills/moheng-ui-upgrade/SKILL.md +5 -3
- package/handwritten/anti-patterns.md +7 -5
- package/handwritten/canvas-model.md +18 -9
- package/handwritten/conventions.md +156 -82
- package/handwritten/skills/page.md +4 -1
- package/handwritten/skills/upgrade.md +5 -3
- package/package.json +11 -11
package/generated/reference.md
CHANGED
|
@@ -4,19 +4,19 @@
|
|
|
4
4
|
|
|
5
5
|
适用版本:v3.0.0 —— 本文件随包分发,永远与所安装的 `@moheng-design/ui` 版本配套。
|
|
6
6
|
|
|
7
|
-
共
|
|
7
|
+
共 94 个组件。每个组件含:契约 JSDoc 原文、完整 props 表、
|
|
8
8
|
关联类型,以及手写的组合约定(何时使用 / 何时改用其他组件 / 组合约定 / 禁止与使用边界)。
|
|
9
|
-
文末另有两份全表:
|
|
9
|
+
文末另有两份全表:165 条 lint 规则,以及 389 条 design token 的名值对照。
|
|
10
10
|
|
|
11
11
|
## 目录
|
|
12
12
|
|
|
13
13
|
- **Foundation · icon** —— [Icon](#icon)
|
|
14
14
|
- **Foundation · actions** —— [Button](#button)、[ButtonGroup](#buttongroup)、[Toggle](#toggle)、[ToggleGroup](#togglegroup)
|
|
15
|
-
- **Foundation · input-selection** —— [Calendar](#calendar)、[Checkbox](#checkbox)、[Combobox](#combobox)、[Field](#field)、[Input](#input)、[InputGroup](#inputgroup)、[InputOTP](#inputotp)、[Label](#label)、[NativeSelect](#nativeselect)、[RadioGroup](#radiogroup)、[Select](#select)、[Slider](#slider)、[Switch](#switch)、[Textarea](#textarea)
|
|
15
|
+
- **Foundation · input-selection** —— [Calendar](#calendar)、[Checkbox](#checkbox)、[Combobox](#combobox)、[DateInput](#dateinput)、[Field](#field)、[Input](#input)、[InputGroup](#inputgroup)、[InputOTP](#inputotp)、[Label](#label)、[NativeSelect](#nativeselect)、[RadioGroup](#radiogroup)、[Select](#select)、[Slider](#slider)、[Switch](#switch)、[Textarea](#textarea)
|
|
16
16
|
- **Foundation · navigation-command** —— [Accordion](#accordion)、[Breadcrumb](#breadcrumb)、[Command](#command)、[ContextMenu](#contextmenu)、[Menubar](#menubar)、[NavigationMenu](#navigationmenu)、[Pagination](#pagination)、[Sidebar](#sidebar)、[Tabs](#tabs)
|
|
17
17
|
- **Foundation · data-content-layout** —— [AspectRatio](#aspectratio)、[Avatar](#avatar)、[Badge](#badge)、[Bubble](#bubble)、[Card](#card)、[Carousel](#carousel)、[Chart](#chart)、[Empty](#empty)、[Item](#item)、[Kbd](#kbd)、[Message](#message)、[MessageScroller](#messagescroller)、[Progress](#progress)、[Resizable](#resizable)、[ScrollArea](#scrollarea)、[Separator](#separator)、[Skeleton](#skeleton)、[Table](#table)
|
|
18
18
|
- **Foundation · feedback-overlay** —— [Alert](#alert)、[AlertDialog](#alertdialog)、[Collapsible](#collapsible)、[Dialog](#dialog)、[Drawer](#drawer)、[DropdownMenu](#dropdownmenu)、[HoverCard](#hovercard)、[Popover](#popover)、[Sheet](#sheet)、[Sonner](#sonner)、[SonnerProvider](#sonnerprovider)、[Spinner](#spinner)、[Tooltip](#tooltip)
|
|
19
|
-
- **Application Atomic** —— [ApplicationFilterMenu](#applicationfiltermenu)、[ListSelectionCheckbox](#listselectioncheckbox)、[ListTablePagination](#listtablepagination)、[SearchField](#searchfield)、[SidebarAppLinkButton](#sidebarapplinkbutton)、[SidebarRailButton](#sidebarrailbutton)、[SystemButton](#systembutton)
|
|
19
|
+
- **Application Atomic** —— [ApplicationDateRangeFilter](#applicationdaterangefilter)、[ApplicationFilterMenu](#applicationfiltermenu)、[ListSelectionCheckbox](#listselectioncheckbox)、[ListTablePagination](#listtablepagination)、[SearchField](#searchfield)、[SidebarAppLinkButton](#sidebarapplinkbutton)、[SidebarRailButton](#sidebarrailbutton)、[SystemButton](#systembutton)
|
|
20
20
|
- **Application Module · navigation** —— [ApplicationModuleSwitcher](#applicationmoduleswitcher)、[ApplicationPrimaryNavigation](#applicationprimarynavigation)、[ApplicationSecondaryNavigation](#applicationsecondarynavigation)、[GlobalSidebar](#globalsidebar)、[TopNavigationPrimaryBar](#topnavigationprimarybar)
|
|
21
21
|
- **Application Module · statistics** —— [ApplicationMetricChart](#applicationmetricchart)、[ApplicationMetricPrimarySecondary](#applicationmetricprimarysecondary)、[ApplicationMetricStatus](#applicationmetricstatus)、[ApplicationMetricStrip](#applicationmetricstrip)、[ApplicationMetricTrend](#applicationmetrictrend)
|
|
22
22
|
- **Application Module · content** —— [ApplicationDataDisplay](#applicationdatadisplay)、[ApplicationFilterList](#applicationfilterlist)、[ApplicationPageHeader](#applicationpageheader)、[ApplicationPageLayoutContainer](#applicationpagelayoutcontainer)、[ApplicationQueryToolbar](#applicationquerytoolbar)、[ApplicationRecordDetailBody](#applicationrecorddetailbody)、[ApplicationSplitListSidebar](#applicationsplitlistsidebar)
|
|
@@ -127,25 +127,34 @@ Application
|
|
|
127
127
|
└─ Overlay Dialog / Drawer / Popover / Menu / Toast
|
|
128
128
|
```
|
|
129
129
|
|
|
130
|
-
### Shell
|
|
130
|
+
### Shell 导航带
|
|
131
131
|
|
|
132
|
-
|
|
132
|
+
固定骨架,**没有左侧全局栏**。导航带永不滚动。几何以 GAP Design kit「框架结构」为准,外壳有两种形态:
|
|
133
|
+
|
|
134
|
+
| 形态 | 带(自上而下) | Standard 总高 | Compact 总高 |
|
|
135
|
+
|---|---|---:|---:|
|
|
136
|
+
| 基础版 | 应用一级 + 应用二级 | 96px | 80px |
|
|
137
|
+
| 集团版 | 集团顶部 + 应用一级 + 应用二级 | 144px | 120px |
|
|
133
138
|
|
|
134
139
|
| 带 | 组件 | Standard | Compact |
|
|
135
140
|
|---|---|---:|---:|
|
|
136
|
-
|
|
|
137
|
-
| 应用一级导航 `APPLICATION.PRIMARY_NAV` | `ApplicationPrimaryNavigation` |
|
|
141
|
+
| 集团顶部导航 `PLATFORM.TOP_USER_BAR`(仅集团版) | `TopNavigationPrimaryBar` | 48px | 40px |
|
|
142
|
+
| 应用一级导航 `APPLICATION.PRIMARY_NAV` | `ApplicationPrimaryNavigation` | 48px | 40px |
|
|
138
143
|
| 应用二级导航 `APPLICATION.SECONDARY_NAV` | `ApplicationSecondaryNavigation` | 48px | 40px |
|
|
139
144
|
| Content Canvas | `ApplicationPageLayoutContainer` | 剩余视口 | 剩余视口 |
|
|
140
145
|
|
|
146
|
+
账户头像在基础版里是 `ApplicationPrimaryNavigation` 的 `account`,在集团版里在 `TopNavigationPrimaryBar`,
|
|
147
|
+
一个外壳只有一处。外壳总高读 `--ui-shell-application-total-height`:渲染了 `TopNavigationPrimaryBar` 时它自动计入
|
|
148
|
+
集团顶栏,宿主不必区分两种形态。
|
|
149
|
+
|
|
141
150
|
Compact 档在视口宽 ≤1180px 或高 ≤720px 时生效(`--ui-viewport-compact-max-width` / `-height`),
|
|
142
|
-
|
|
151
|
+
各带高度由同一组 `@media` 一并切换,宿主不得自行复刻断点。
|
|
143
152
|
|
|
144
153
|
宿主 padding 为零 —— padding 属于页面内容根。
|
|
145
154
|
|
|
146
155
|
### 宿主布局
|
|
147
156
|
|
|
148
|
-
本库不提供宿主组件(07 · C-5
|
|
157
|
+
本库不提供宿主组件(07 · C-5:组件留到第二个真实项目再抽),导航带 + Canvas 的宿主由应用
|
|
149
158
|
自己写,标准写法如下(类名由宿主自定,只读 `--application-*` 与 `--ui-*`):
|
|
150
159
|
|
|
151
160
|
```css
|
|
@@ -155,14 +164,14 @@ body {
|
|
|
155
164
|
margin: 0;
|
|
156
165
|
}
|
|
157
166
|
|
|
158
|
-
.app-shell { /*
|
|
167
|
+
.app-shell { /* 导航带 + Canvas,整体占满视口 */
|
|
159
168
|
display: flex;
|
|
160
169
|
flex-direction: column;
|
|
161
170
|
block-size: 100dvh;
|
|
162
171
|
background: var(--application-canvas);
|
|
163
172
|
}
|
|
164
173
|
|
|
165
|
-
.app-shell__bands { /*
|
|
174
|
+
.app-shell__bands { /* 包住全部导航带;不进滚动容器,即永不滚动 */
|
|
166
175
|
flex: none;
|
|
167
176
|
z-index: var(--ui-z-shell);
|
|
168
177
|
}
|
|
@@ -358,7 +367,7 @@ DETAIL ApplicationPageLayoutContainer pageType="DETAIL"
|
|
|
358
367
|
### 关键尺寸
|
|
359
368
|
|
|
360
369
|
抽屉宽 680px(`--application-drawer-width: 1280px` 是宽/全屏变体);
|
|
361
|
-
表单对话框 720px / 960px;`SPLIT` 左栏 360px(Compact 300px);
|
|
370
|
+
表单对话框 720px / 960px / 1280px;`SPLIT` 左栏 360px(Compact 300px);
|
|
362
371
|
卡片网格默认 ≥1440 五列、Condensed 四列、Compact 三列,卡片最小宽 220px。
|
|
363
372
|
列数读 `--ui-card-columns-default`,三档由 `viewport.css` 的 `@media` 在 `:root` 上改写(5 / 4 / 3),
|
|
364
373
|
最小宽读 `--ui-card-min-width`,卡间距读 `--ui-card-gap`;系统内没有卡片网格组件,
|
|
@@ -442,8 +451,8 @@ DETAIL ApplicationPageLayoutContainer pageType="DETAIL"
|
|
|
442
451
|
|
|
443
452
|
Foundation 按钮 —— 按钮排版、几何、圆角与基础交互的唯一 Foundation Owner。
|
|
444
453
|
|
|
445
|
-
已登记契约:14/20 字号、12px 行内内边距、4px 图标间隙、
|
|
446
|
-
|
|
454
|
+
已登记契约:14/20 字号、12px 行内内边距、4px 图标间隙、12px 圆角、32px 默认高度。
|
|
455
|
+
圆角取控件角色 `--ds-radius-control`(GAP Design kit「圆角12」);等宽图标按钮为 12 圆角方形。
|
|
447
456
|
|
|
448
457
|
**业务页面一律用 `SystemButton`**,本组件只供库内组件使用(实践报告 P1-1 裁决)。
|
|
449
458
|
业务页面不得再造第二套基础按钮视觉。
|
|
@@ -456,7 +465,7 @@ Foundation 按钮 —— 按钮排版、几何、圆角与基础交互的唯一
|
|
|
456
465
|
|
|
457
466
|
| prop | 类型 | 必填 | 说明 |
|
|
458
467
|
|---|---|:---:|---|
|
|
459
|
-
| `variant` | `'primary' \| 'secondary' \| 'outline' \| 'ghost' \| 'destructive' \| 'link'` | 否 | 视觉语义。 `primary` 用于页面主操作,每个动作组内至多一个; `secondary` 用于次要操作,是默认值; `destructive`
|
|
468
|
+
| `variant` | `'primary' \| 'secondary' \| 'outline' \| 'ghost' \| 'destructive' \| 'destructive-outline' \| 'link'` | 否 | 视觉语义。 `primary` 用于页面主操作,每个动作组内至多一个; `secondary` 用于次要操作,是默认值; `destructive` 用于不可逆的删除类操作(实心危险色); `destructive-outline` 白底、危险色描边与文字,用于与次要按钮并排的删除类动作; `link` 用于行内跳转,无内边距、带下划线。 |
|
|
460
469
|
| `size` | `'xs' \| 'sm' \| 'default' \| 'lg'` | 否 | 尺寸,映射高度 24 / 28 / 32 / 40px。 `default` 读取 `--application-button-height`; `sm` 用于表格行内等紧凑布局;`xs` 用于标签内嵌。 |
|
|
461
470
|
| `iconOnly` | `boolean` | 否 | 等宽图标按钮。宽度收敛为与高度相等,行内内边距归零。 为 true 时**必须**提供 `aria-label`,因为按钮没有可见文字。 |
|
|
462
471
|
| `disabled` | `boolean` | 否 | 禁用。禁用时不触发 onClick 并移出 tab 顺序。 禁用作用于整个交互单元 —— 不得只禁用文字而保留图标可点。 传 `aria-disabled="true"` 得到同一套禁用外观但保持可聚焦(`SystemButton` 的 loading 即此写法);本组件不拦截事件,阻断动作由设置它的一方负责。 |
|
|
@@ -466,7 +475,7 @@ Foundation 按钮 —— 按钮排版、几何、圆角与基础交互的唯一
|
|
|
466
475
|
|
|
467
476
|
**用途。** Foundation 按钮,是按钮排版、几何、圆角与基础交互的唯一 Foundation Owner。
|
|
468
477
|
|
|
469
|
-
**何时使用。** 本组件只供库内组件使用。业务页面的按钮一律用 `SystemButton`,不存在降级到本组件的情形。已登记契约为 14/20 字号、12px 行内内边距、4px 图标间隙、
|
|
478
|
+
**何时使用。** 本组件只供库内组件使用。业务页面的按钮一律用 `SystemButton`,不存在降级到本组件的情形。已登记契约为 14/20 字号、12px 行内内边距、4px 图标间隙、12px 圆角、32px 默认高度;等宽图标按钮为 12 圆角方形,系统内没有独立的 pill 或 circle token。
|
|
470
479
|
|
|
471
480
|
**何时改用其他组件。**
|
|
472
481
|
|
|
@@ -670,13 +679,14 @@ ToggleGroup 的单个选项
|
|
|
670
679
|
|
|
671
680
|
**用途。** 月格日期选择器控件,周一为一周起始(一…日),固定 252px 宽;今日为淡强调色洗,选中为强调色实心填充。
|
|
672
681
|
|
|
673
|
-
**何时使用。**
|
|
682
|
+
**何时使用。** 作为日期取值面板使用。表单里的单个日期直接用已封装好的 `DateInput`,工具栏的日期区间筛选用 `ApplicationDateRangeFilter`,两者内部都是本组件;只有这两者都不适用的自定义面板才直接把本组件放进 `Popover`。**该组件是控件,不是承载面** —— `CALENDAR` 页面模式与它同名但不同层,不得混用。
|
|
674
683
|
|
|
675
684
|
**何时改用其他组件。**
|
|
676
685
|
- 整页的日历承载面(`pageMode` 为 `CALENDAR`):`ApplicationDataDisplay` 的 `presentation="Calendar"`,月格按 SKILL.md「呈现配方」的月历写法拼装。
|
|
677
686
|
- 粒度切换加月格加当日议程栏的工作台面:`ScheduleCollaborationWorkspace`。
|
|
678
687
|
- 查询工具栏中作为 `dataPresentation` 的日历呈现方式:由数据呈现区承担,不是本控件。
|
|
679
|
-
-
|
|
688
|
+
- 表单里的单个日期字段:`DateInput`。
|
|
689
|
+
- 查询工具栏里的日期区间筛选:`ApplicationDateRangeFilter`。
|
|
680
690
|
|
|
681
691
|
**组合约定。** `onSelect` 收到的是本地零点的 `Date`;落库、比较与按日期匹配一律使用本地时区的 ISO 日期串。翻月游标由组件内部持有;`month` 的年月变化时视图跟随,年月不变的重渲染不重置用户已翻到的月份。网格只占一个 Tab 停顿,方向键逐日 / 逐周、Home / End 到周首 / 周末、PageUp / PageDown 跨月(加 Shift 跨年),Enter / 空格选中;日格的无障碍名称为完整日期加星期。`selected` 为单值,该组件不表达区间高亮。「今天」默认取当前本地日期;以服务端时间为准、服务端渲染或测试需要固定日期时传 `today`(`Date`,只取本地年月日),它同时决定今日高亮、未传 `month` 时的初始月份与无选中日时的 Tab 停顿。置于 `Popover` 内时面板宽度不得小于 252px,`Popover` 的默认 320px 已足够容纳。星期名、上一月与下一月的无障碍名称、以及「年」「月」标题为中文常量,本库单语言。
|
|
682
692
|
|
|
@@ -797,6 +807,52 @@ Combobox 的单个选项
|
|
|
797
807
|
- 不得把 `emptyText` 复用为加载中或加载失败的文案 —— 它只表达筛选无结果,六种状态各有各的措辞。
|
|
798
808
|
- 不得在 `ComboboxOption.label` 中放入可交互元素。
|
|
799
809
|
|
|
810
|
+
### DateInput
|
|
811
|
+
|
|
812
|
+
`import { DateInput } from '@moheng-design/ui'` · 契约 `contracts/foundation/input-selection/date-input.ts`
|
|
813
|
+
|
|
814
|
+
单个日期的录入控件:与 `Input` 同高同壳(32px、12px 圆角、1px 描边),右侧带 16px
|
|
815
|
+
日历图标,点击弹出 `Calendar` 月格,选中即回填并收起。
|
|
816
|
+
|
|
817
|
+
值一律是本地时区的 ISO 日期串 `yyyy-mm-dd`(不是 `Date`,也不是带时区的时间戳)——
|
|
818
|
+
表单提交与接口对接都按字符串走,组件内部用本地时区换算,不经 `toISOString()`。
|
|
819
|
+
|
|
820
|
+
只选一个日期。日期区间筛选用 `ApplicationDateRangeFilter`;带时分的时刻本库暂无组件。
|
|
821
|
+
|
|
822
|
+
在 `Field` 里使用时,`Field` 的 `htmlFor` 指向本组件的 `id`(落在触发按钮上)。
|
|
823
|
+
|
|
824
|
+
**Props**
|
|
825
|
+
|
|
826
|
+
| prop | 类型 | 必填 | 说明 |
|
|
827
|
+
|---|---|:---:|---|
|
|
828
|
+
| `value` | `string` | 否 | 受控值,ISO `yyyy-mm-dd`。空串或不传表示未选 |
|
|
829
|
+
| `defaultValue` | `string` | 否 | 非受控初始值,ISO `yyyy-mm-dd` |
|
|
830
|
+
| `onValueChange` | `(value: string) => void` | 否 | 值变化回调,给出 ISO `yyyy-mm-dd`;清空时给出空串 |
|
|
831
|
+
| `placeholder` | `string` | 否 | 未选时的占位文字。写明格式或含义,如「选择开票日期」 |
|
|
832
|
+
| `disabled` | `boolean` | 否 | 禁用 |
|
|
833
|
+
| `invalid` | `boolean` | 否 | 校验失败态。边框转为 danger 色并设置 `aria-invalid`。 置于 `Field` 内时须与 `Field.error` 同时设置 —— 两者不联动,与 `Input` 相同。 |
|
|
834
|
+
| `today` | `Date` | 否 | 「今天」,透传给 `Calendar`。以服务端时间为准、服务端渲染或测试时传入 |
|
|
835
|
+
|
|
836
|
+
继承 `HTMLAttributes<HTMLDivElement>` 的全部原生属性,其中 `defaultValue`、`onChange` 已被本组件重新定义或移除。
|
|
837
|
+
|
|
838
|
+
**用途。** 单个日期的录入控件:与 `Input` 同高同壳(32px、12px 圆角、1px 描边),右侧带 16px 日历图标,点击弹出 `Calendar` 月格,选中即回填并收起。
|
|
839
|
+
|
|
840
|
+
**何时使用。** 表单里需要录入一个日期(开票日期、到期日、生效日)时,必须使用本组件。值一律是本地时区的 ISO 日期串 `yyyy-mm-dd`,经 `value` / `onValueChange` 受控,或经 `defaultValue` 非受控;清空时回调给出空串。外壳是按钮而不是可键入的输入框,日期只能从月格里选。
|
|
841
|
+
|
|
842
|
+
**何时改用其他组件。**
|
|
843
|
+
- 查询工具栏里的日期区间筛选:改用 `ApplicationDateRangeFilter`。
|
|
844
|
+
- 自由文本或数字:改用 `Input`。
|
|
845
|
+
- 需要月格常驻展开、不收起的面板:直接用 `Calendar`。
|
|
846
|
+
- 整页的日历承载面:`ApplicationDataDisplay` 的 `presentation="Calendar"`。
|
|
847
|
+
|
|
848
|
+
**组合约定。** 置于 `Field` 内时,`Field.htmlFor` 与本组件的 `id` 成对设置,`id` 落在触发按钮上。`Field.error` 与本组件的 `invalid` 必须同时设置,两者不联动,与 `Input` 相同。`placeholder` 写明字段含义,如「选择开票日期」。以服务端时间为准、服务端渲染或测试需要固定日期时传 `today`,它透传给 `Calendar`。该组件不自带外边距,宽度撑满父容器,列宽由字段网格负责。
|
|
849
|
+
|
|
850
|
+
**禁止 / 使用边界。**
|
|
851
|
+
- 不得用 `Input` 加占位示例(「2026-07-28」)代替本组件录入日期。
|
|
852
|
+
- 不得用 `toISOString()` 生成或换算 `value` —— 在 UTC+8 下会错一天,一律用本地时区的 `yyyy-mm-dd`。
|
|
853
|
+
- 不得用两个本组件拼装工具栏里的日期区间筛选,那是 `ApplicationDateRangeFilter` 的职责,且它带「应用」提交与筛选标签回写。
|
|
854
|
+
- 禁止覆盖触发器的高度、圆角与描边,`className` 只用于布局定位。
|
|
855
|
+
|
|
800
856
|
### Field
|
|
801
857
|
|
|
802
858
|
`import { Field } from '@moheng-design/ui'` · 契约 `contracts/foundation/input-selection/field.ts`
|
|
@@ -858,10 +914,10 @@ Combobox 的单个选项
|
|
|
858
914
|
|
|
859
915
|
单行文本控件。
|
|
860
916
|
|
|
861
|
-
用于 `Field`
|
|
917
|
+
用于 `Field` 内的自由文本与数字录入。单个日期用 `DateInput`。
|
|
862
918
|
搜索请用 `SearchField` —— 它拥有紧凑工具栏外壳,不要用 Input 自行拼装。
|
|
863
919
|
|
|
864
|
-
最小高度 32px,
|
|
920
|
+
最小高度 32px,12px 圆角(GAP Design kit)。
|
|
865
921
|
**焦点只在外层壳表达一次,内部不得再套第二圈焦点环。**
|
|
866
922
|
|
|
867
923
|
**替换原生元素:** `<input>`
|
|
@@ -874,13 +930,14 @@ Combobox 的单个选项
|
|
|
874
930
|
|
|
875
931
|
继承 `InputHTMLAttributes<HTMLInputElement>` 的全部原生属性。
|
|
876
932
|
|
|
877
|
-
**用途。**
|
|
933
|
+
**用途。** 单行文本控件,承担表单行与筛选行内的自由文本与数字录入。
|
|
878
934
|
|
|
879
|
-
**何时使用。** 值由用户自由键入、不来自固定选项集合时,该控件是默认选择。最小高度 32px、圆角
|
|
935
|
+
**何时使用。** 值由用户自由键入、不来自固定选项集合时,该控件是默认选择。最小高度 32px、圆角 12px、字号 14/20px,宽度撑满父容器。置于 `Field` 内构成标准表单行;置于 `InputGroup` 内构成带前后附加物的单一焦点单元。
|
|
880
936
|
|
|
881
937
|
**何时改用其他组件。**
|
|
882
938
|
|
|
883
939
|
- 纯文本搜索 → `SearchField`。产品内每一处搜索共用该入口,不得用该控件自行拼装工具栏搜索框。
|
|
940
|
+
- 单个日期 → `DateInput`;工具栏里的日期区间筛选 → `ApplicationDateRangeFilter`。
|
|
884
941
|
- 多行备注、说明与事由 → `Textarea`。
|
|
885
942
|
- 定长验证码 → `InputOTP`。
|
|
886
943
|
- 值来自固定集合 → `Select`;选项极多或密集的行内编辑器 → `NativeSelect`;需要输入筛选 → `Combobox`;2–5 个选项且需全部可见 → `RadioGroup`。
|
|
@@ -1446,7 +1503,7 @@ Breadcrumb 的单个层级
|
|
|
1446
1503
|
**组合约定。** 该组件只能作为 `ApplicationPageHeader` 的 `breadcrumb` 内容传入,间距与位置由上下文区负责,组件自身无外边距。中间层级按三态渲染:提供 `href` 渲染链接,仅提供 `onClick` 渲染按钮,两者都不提供渲染静态文本 —— 不可点击的层级必须走第三态,不得以空字符串或占位地址伪造链接。使用前端路由时必须同时提供 `href` 与 `onClick`,并在 `onClick` 内自行阻止默认跳转,组件不代为调用 `preventDefault`。末项无论是否提供 `href` 或 `onClick` 都渲染为当前页文本,两者在末项上均无效果。组件输出 `nav > ol > li` 结构,分隔字形在 `li` 内且对读屏隐藏。
|
|
1447
1504
|
|
|
1448
1505
|
**禁止 / 使用边界。**
|
|
1449
|
-
- 不得放进 Shell
|
|
1506
|
+
- 不得放进 Shell 的导航带 —— `TopNavigationPrimaryBar` 契约已明令禁止在其中添加面包屑。
|
|
1450
1507
|
- 不得在页面并无真实层级时把面包屑作为装饰渲染。
|
|
1451
1508
|
- 不得把末项写成链接,当前页不是可跳转目标。
|
|
1452
1509
|
- 禁止用面包屑承担模块导航或页面动作。
|
|
@@ -1692,13 +1749,17 @@ NavigationMenu 的单个导航项
|
|
|
1692
1749
|
|
|
1693
1750
|
`import { Pagination } from '@moheng-design/ui'` · 契约 `contracts/foundation/navigation-command/pagination.ts`
|
|
1694
1751
|
|
|
1695
|
-
|
|
1752
|
+
裸分页步进器:首页 · 上一页 · 页码窗口 · 下一页 · 末页。
|
|
1696
1753
|
|
|
1697
1754
|
**数据展示区的列表/表格分页请用 `ListTablePagination`** ——
|
|
1698
|
-
那是 Application Atomic
|
|
1699
|
-
|
|
1755
|
+
那是 Application Atomic 适配器,内部渲染本组件,另承载结果总数、每页条数与跳页。
|
|
1756
|
+
本组件只在没有那些附加信息时单独使用。
|
|
1757
|
+
|
|
1758
|
+
外观按 GAP Design kit「分页元素」:每一格 32×32、1px 线条描边、圆角 12、白底,间隔 4;
|
|
1759
|
+
页码 14/20 medium;四个步进键是 16px 纯图标,可访问名为「首页 / 上一页 / 下一页 / 末页」;
|
|
1760
|
+
跳空处是同款方块里的省略号字形。
|
|
1700
1761
|
|
|
1701
|
-
当前页带 `aria-current="page"
|
|
1762
|
+
当前页带 `aria-current="page"`、强调色描边与主色 6% 底,**不只靠颜色**表达。
|
|
1702
1763
|
|
|
1703
1764
|
**Props**
|
|
1704
1765
|
|
|
@@ -1710,20 +1771,21 @@ NavigationMenu 的单个导航项
|
|
|
1710
1771
|
|
|
1711
1772
|
继承 `HTMLAttributes<HTMLElement>` 的全部原生属性。
|
|
1712
1773
|
|
|
1713
|
-
**用途。**
|
|
1774
|
+
**用途。** 裸分页步进器,承担「首页 · 上一页 · 页码窗口 · 下一页 · 末页」。
|
|
1714
1775
|
|
|
1715
|
-
**何时使用。**
|
|
1776
|
+
**何时使用。** 仅在确实不需要结果总数与每页条数时单独使用该组件。页码窗口固定为「首页 + 当前页前后各 1 页 + 末页」,跳空处插省略号,最多 7 个槽位,不可配置。外观按 GAP Design kit「分页元素」:每一格 32×32、1px 线条描边、圆角 12、白底,间隔 4;四个步进键是 16px 纯图标,可访问名为「首页」「上一页」「下一页」「末页」。当前页带 `aria-current="page"`、强调色描边与主色 6% 底,不只靠颜色表达。页码按钮视觉上只显示数字(14/20 medium),可访问名为「第 N 页」;页码使用等宽数字,翻页时按钮不左右跳动。
|
|
1716
1777
|
|
|
1717
|
-
**何时改用其他组件。** 数据展示区的列表与表格页脚一律改用 `ListTablePagination
|
|
1778
|
+
**何时改用其他组件。** 数据展示区的列表与表格页脚一律改用 `ListTablePagination`。两者是包含关系:`ListTablePagination` 内部渲染本组件作为页码区,另外承载摘要、每页条数选择器与跳页框(业财平台 round-01 起,兑现 04 · T6 的原裁决)。系统内无限滚动不作为分页的替代方案。
|
|
1718
1779
|
|
|
1719
|
-
**组合约定。** 调用方必须保证 `1 ≤ page ≤ pageCount`,组件不对越界值做钳制。`pageCount` 为 1
|
|
1780
|
+
**组合约定。** 调用方必须保证 `1 ≤ page ≤ pageCount`,组件不对越界值做钳制。`pageCount` 为 1 时组件仍渲染四枚禁用的步进键与单个页码,只有一页时调用方应自行不渲染整个组件。分页状态在数据展示区内的规则与 `ListTablePagination` 相同(按业务视图各记一份,搜索、筛选、排序变化时复位到第 1 页,07 · C-13),该状态由调用方 Module 持有 —— 组件不持有任何页码状态。组件自身无外边距,与数据展示区的间距由容器负责。
|
|
1720
1781
|
|
|
1721
1782
|
**禁止 / 使用边界。**
|
|
1722
1783
|
- 不得在列表或表格的标准页脚使用该组件。
|
|
1723
1784
|
- 不得把该组件用作步骤指示器、轮播指示器或进度表达。
|
|
1724
1785
|
- 禁止传入越界的 `page`。
|
|
1725
1786
|
- 不得依赖该组件表达结果总数或每页条数,它不承载这两项。
|
|
1726
|
-
- 不得在同一数据展示区内同时渲染 Pagination 与 `ListTablePagination
|
|
1787
|
+
- 不得在同一数据展示区内同时渲染 Pagination 与 `ListTablePagination` —— 后者已经包含前者。
|
|
1788
|
+
- 不得把四个步进键改回文字按钮,也不得去掉首页与末页。
|
|
1727
1789
|
|
|
1728
1790
|
### Sidebar
|
|
1729
1791
|
|
|
@@ -1774,7 +1836,7 @@ Sidebar 的导航分组
|
|
|
1774
1836
|
|
|
1775
1837
|
**何时改用其他组件。** 工作台左侧 72px 图标栏改用 `GlobalSidebar`,它由 `SidebarRailButton` 构成,是另一个组件,两者不可互相替代。SPLIT 页面模式的左栏改用 `ApplicationSplitListSidebar`,它已登记目录搜索、结果数与目录设置三件事。水平方向的导航改用 `NavigationMenu` 或 `Tabs`。
|
|
1776
1838
|
|
|
1777
|
-
**组合约定。** 该组件不是 Shell —— 应用外层 Shell
|
|
1839
|
+
**组合约定。** 该组件不是 Shell —— 应用外层 Shell 是刻意设计的无侧栏导航带堆叠(基础版两带、集团版三带),不得因为存在本组件就往 Shell 上加一条全局左栏。组件是 `flex: 0 0 auto` 且高度 100% 的 flex 项,必须置于一个高度确定的横向 flex 容器内。该组件只有受控模式:`value` 与 `onValueChange` 必须成对提供,缺少 `onValueChange` 时点击不产生任何变化。`collapsed` 为 true 时图标是唯一可见内容,因此可能折叠的侧栏中每个 `SidebarItem` 都必须提供 `icon`;`label` 为非字符串时还必须提供 `labelText`,否则折叠态条目既无可访问名也无提示。折叠态条目以 `aria-label` 命名,并由内置 `Tooltip` 在悬停与聚焦时向右提示同一名称,调用方不得再包一层 `Tooltip`。有标题的分组输出以标题命名的 `role="group"`。折叠态不渲染分组标题与 `badge`,唯一的状态提示不得只放在 `badge` 上。`width` 只作用于展开态,折叠宽固定 56px 不随其变化。`SidebarGroup.label` 用作 React key,应在侧栏内唯一。
|
|
1778
1840
|
|
|
1779
1841
|
**禁止 / 使用边界。**
|
|
1780
1842
|
- 不得把该组件当作应用外层 Shell 的全局左栏。
|
|
@@ -1827,7 +1889,7 @@ Tabs 的单个标签
|
|
|
1827
1889
|
|
|
1828
1890
|
**何时使用。** 同一块区域内需要在 2 个及以上互斥内容之间切换时使用该组件。标签高 32px、内边距 6/12、文字 14/20,激活态是 2px 强调色下划线加 medium 字重,明确不是 pill 背景。标签行下方有 1px 分隔线,`count` 徽标为 12px 等宽数字。标签行只占一个 Tab 停靠点,左右方向键在可用标签之间移动焦点、首尾相接,Home / End 跳到首末项,选中须再按回车或空格;焦点离开后停靠点回到选中标签。
|
|
1829
1891
|
|
|
1830
|
-
**何时改用其他组件。** Shell
|
|
1892
|
+
**何时改用其他组件。** Shell 应用二级导航带的业务标签改用 `ApplicationSecondaryNavigation`,那里的图标是必填。L3 业务视图标签由 `ApplicationQueryToolbar` 承担,其第一行内部已组合本组件,不得在工具栏之外另起一行 Tabs 表达业务视图。Page Mode Switch 属于 `ApplicationPageHeader`,不得用 Tabs 或 `ToggleGroup` 搭建。密度、对齐这类局部显示选择改用 `ToggleGroup`。带浮层面板的水平导航改用 `NavigationMenu`。
|
|
1831
1893
|
|
|
1832
1894
|
**组合约定。** `children` 原样渲染,组件不做面板切换 —— 调用方必须自行依据当前 `value` 渲染对应内容。面板的 12px 上边距由组件负责,调用方不得再补上边距。根与面板都是列向 flex,面板吃掉根的剩余高度:要让面板内的 `ApplicationDataDisplay` 拿到有界高度、自己滚动,调用方只需让 Tabs 根在定高父级里拿到高度(给根加 `flex: 1; min-block-size: 0` 的类名),不得再在面板外另造一个 `role="tabpanel"` 容器;面板的直接子节点各成一个 flex 项,行内混排的文字须包一层块级元素。可访问名称以 `aria-label` 或 `aria-labelledby` 传入,组件把它落在 `role="tablist"` 上;渲染面板时激活标签与面板以 `aria-controls` / `aria-labelledby` 互相关联,调用方不必补。`items` 为空数组时整个组件渲染 `null`,不渲染空标签行、不画分隔线、不保留高度,因此调用方不得为「暂无标签」另行渲染占位。未提供 `defaultValue` 时组件默认选中 `items[0].value` 且不检查其禁用状态,`items[0]` 为 `disabled` 时必须显式提供 `defaultValue`。受控使用时 `value` 与 `onValueChange` 必须成对提供。`count` 只接受数字。
|
|
1833
1895
|
|
|
@@ -1920,7 +1982,8 @@ Tabs 的单个标签
|
|
|
1920
1982
|
|
|
1921
1983
|
紧凑的状态或分类标签 —— 行、卡片、指标、详情头。
|
|
1922
1984
|
|
|
1923
|
-
|
|
1985
|
+
24px 高,20px 圆角(胶囊),左右 10 上下 4,12/16 字号(GAP Design kit「标签」)。
|
|
1986
|
+
soft 档底色为 tone 语义色 10% 透明(neutral 为文字色 6%),前景取 tone 语义色。
|
|
1924
1987
|
|
|
1925
1988
|
⚠ **状态色只来自功能状态色板。** 图表分类色(20 色)绝不能用来表达状态。
|
|
1926
1989
|
|
|
@@ -1938,18 +2001,18 @@ Tabs 的单个标签
|
|
|
1938
2001
|
|
|
1939
2002
|
继承 `HTMLAttributes<HTMLSpanElement>` 的全部原生属性。
|
|
1940
2003
|
|
|
1941
|
-
**用途。** 紧凑的状态或分类标签,
|
|
2004
|
+
**用途。** 紧凑的状态或分类标签,24px 高、20px 圆角(胶囊)、左右 10 上下 4 内边距、12/16 字号。
|
|
1942
2005
|
|
|
1943
2006
|
**何时使用。** 列表行、卡片、指标、详情头需要一个短状态词或分类词时,必须使用该组件。`RecordListItem` 与 `WorkspacePerson` 的 `status` 槽位、`Card` 的 `extra` 槽位、`Item` 的 `trailing` 槽位登记的默认内容即为本组件。`tone` 的六档全部来自功能状态色板,一个 tone 在同一维度内只能有一个含义。
|
|
1944
2007
|
|
|
1945
2008
|
**何时改用其他组件。**
|
|
1946
2009
|
- 指标区里的「功能状态 + 计数」改用 `ApplicationMetricStatus`,该卡由圆点、文字、颜色三者共同承载状态。
|
|
1947
|
-
- 已生效的筛选条件改用 `ApplicationQueryToolbar` 的 `appliedTags
|
|
2010
|
+
- 已生效的筛选条件改用 `ApplicationQueryToolbar` 的 `appliedTags`,它自带逐项移除与「清空」。
|
|
1948
2011
|
- 需要说明成因并给出重试出路的整段提示改用 `Alert`。
|
|
1949
2012
|
- 一级导航上的未读提示改用 `ApplicationPrimaryNavigation` 的 `actionBadges` 圆点;消息条目的未读态改用 `Message` 的 `unread`。
|
|
1950
|
-
- 键盘按键提示改用 `Kbd
|
|
2013
|
+
- 键盘按键提示改用 `Kbd`,二者语义不同,不得互换。
|
|
1951
2014
|
|
|
1952
|
-
**组合约定。** `tone` 与业务状态的对应关系必须在应用侧集中定义一次,禁止逐页面各写一份。tone 只在同一维度内含义唯一:同屏出现两个状态维度(如处理状态与风险等级)时,用 `variant` 区分维度 —— 一个维度用 `soft`(淡色实底),另一个用 `outline`(描边),两个维度可以各用到同一个 tone(07 · C-9);同一维度内的不同取值不得共用 tone。外边距由宿主槽位负责,本组件自身不带 margin 且不换行,内容超长时由宿主决定截断。`
|
|
2015
|
+
**组合约定。** `tone` 与业务状态的对应关系必须在应用侧集中定义一次,禁止逐页面各写一份。tone 只在同一维度内含义唯一:同屏出现两个状态维度(如处理状态与风险等级)时,用 `variant` 区分维度 —— 一个维度用 `soft`(淡色实底),另一个用 `outline`(描边),两个维度可以各用到同一个 tone(07 · C-9);同一维度内的不同取值不得共用 tone。外边距由宿主槽位负责,本组件自身不带 margin 且不换行,内容超长时由宿主决定截断。`soft` 档的底色一律是 tone 语义色的 10% 透明(`neutral` 为文字色 6%),前景与描边取 tone 的语义色,`warning` 也不例外(GAP Design kit;此前 `warning` 前景取中性灰,已随警示色调深为 #ff7b00 改回同色系)。`children` 必须是 2–4 字裸名词短语。
|
|
1953
2016
|
|
|
1954
2017
|
**禁止 / 使用边界。**
|
|
1955
2018
|
- 不得用图表分类色表达状态 —— 分类色只编码分类。
|
|
@@ -2004,7 +2067,7 @@ Tabs 的单个标签
|
|
|
2004
2067
|
|
|
2005
2068
|
已登记契约:**只有两档密度** —— `default`(16px 节奏)与 `sm`(12px),
|
|
2006
2069
|
`default` 的节奏随视口密度档收为 16 / 12 / 10(07 · C-17),`sm` 在 Compact 档同取 10;
|
|
2007
|
-
|
|
2070
|
+
20px 圆角(GAP Design kit「圆角20」),1px 边框,**默认无装饰阴影**。不要给它加阴影。
|
|
2008
2071
|
|
|
2009
2072
|
**Props**
|
|
2010
2073
|
|
|
@@ -2033,7 +2096,7 @@ Tabs 的单个标签
|
|
|
2033
2096
|
**组合约定。** 本组件不持有外边距,卡片之间的间距(Standard 12px、Condensed 10px、Compact 8px)由父级栅格或 `ApplicationPageLayoutContainer` 负责。`title` 与 `extra` 同处标题行,`extra` 只放一个状态 `Badge` 或一个安静的动作。内边距与内部间隙随视口密度档自动收紧:`default` 为 Standard 16px、Condensed 12px、Compact 10px,`sm` 为 12px、Compact 10px,由 token 层的 `@media` 驱动,调用方不得另写断点改卡片内边距。`footer` 自带上边框与一段上内边距,不需要再在它上面放 `Separator`。`interactive` 只是把光标与边框反馈打开,跳转行为仍由调用方自己挂在卡片上 —— 因此 `interactive` 为 true 时必须同时给出真实的跳转处理(`onClick`),只设 `interactive` 而不跳转会得到一个骗人的指针。`interactive` 且给了 `onClick` 时组件自带键盘入口:标题读作按钮、进 Tab 序列,Enter / 空格触发同一个 `onClick`,焦点环画在整张卡上;无标题时整卡可聚焦。调用方不得再自行补 `tabIndex` / `role` / `onKeyDown` —— 显式传入 `tabIndex` 或 `role` 即视为接管,组件不再加自己那一份。标题行最小高度 32px,有无 `extra` 都一样高。`interactive` 为 true 时卡内不得再放独立的可点控件,除非该控件自行阻止事件冒泡。
|
|
2034
2097
|
|
|
2035
2098
|
**禁止 / 使用边界。**
|
|
2036
|
-
- 不得给卡片添加阴影 —— 已登记契约为
|
|
2099
|
+
- 不得给卡片添加阴影 —— 已登记契约为 20px 圆角、1px 边框、无默认装饰阴影,边框负责分隔。
|
|
2037
2100
|
- 禁止发明第三档密度:只有 `default`(16px 节奏)与 `sm`(12px)两档,随视口收紧的是这两档的取值,不是新的档。
|
|
2038
2101
|
- 不得在只读的指标卡语义上设置 `interactive` —— 指标卡必须保持 `cursor: default`,整卡绝不成为导航入口。
|
|
2039
2102
|
- 不得在 Card 外面再包一层自带 padding 的容器,那会与页面内容根的内边距叠成双重外边距。
|
|
@@ -2298,7 +2361,7 @@ Chart 的单条数据系列
|
|
|
2298
2361
|
- 业务记录行改用 `ApplicationRecordList`;表格行改用 `Table`。
|
|
2299
2362
|
- 需要说明成因并提供重试出路的整段提示改用 `Alert`。
|
|
2300
2363
|
|
|
2301
|
-
**组合约定。** `avatar` 槽位应传 `Avatar`。一组本组件作为 `ApplicationGlobalActionPanel` 的 `children`
|
|
2364
|
+
**组合约定。** `avatar` 槽位应传 `Avatar`。一组本组件作为 `ApplicationGlobalActionPanel` 的 `children` 传入,该面板是消息、待办、总览、风险预警四个全局动作共享的同一个面板,绝不为每个动作单独造一个弹层。行内边距由本组件自身承担,条目之间不得再加外边距,间距由容器的排列负责。`unread` 为 true 时淡色底与圆点必须同时出现,不得只保留其一。`author` 为 14/20,`time` 为 12/16,二者按基线对齐,因此传入内容应是短文本,不得塞入块级结构。整条可点开时直接给 `onClick`:组件随之给出指针与 hover 反馈,读作按钮、进 Tab 序列,Enter / 空格触发同一回调,调用方不得再自行补键盘处理。无条目时的空态由 `ApplicationGlobalActionPanel` 的 `emptyState` 承担,应传 `Empty`,其文案须区别于无权限与加载失败。
|
|
2302
2365
|
|
|
2303
2366
|
**禁止 / 使用边界。**
|
|
2304
2367
|
- 不得把本组件当作会话气泡使用。
|
|
@@ -2566,7 +2629,8 @@ Chart 的单条数据系列
|
|
|
2566
2629
|
|
|
2567
2630
|
DataTable 承载面 —— LIST 页面模式、LEDGER 台账页、SPLIT 右栏。
|
|
2568
2631
|
|
|
2569
|
-
表头位于 `--application-table-header
|
|
2632
|
+
表头位于 `--application-table-header`,高 44;表体行最小高 56(两行内容 72)。
|
|
2633
|
+
行与行之间、表头列与列之间是 0.5px 分隔线(`--application-hairline`),**不是投影**。
|
|
2570
2634
|
|
|
2571
2635
|
⚠ 当本组件是当前的 Data Presentation 时,
|
|
2572
2636
|
其上方的设置按钮**必须**写作「列设置」,不得写成通用的「视图设置」。
|
|
@@ -2590,6 +2654,7 @@ DataTable 承载面 —— LIST 页面模式、LEDGER 台账页、SPLIT 右栏
|
|
|
2590
2654
|
| `onSortChange` | `(sort: TableSort) => void` | 否 | 排序变化回调。同列再次点击在 asc / desc 间切换 |
|
|
2591
2655
|
| `empty` | `ReactNode` | 否 | `rows` 为空时替代行区域渲染的内容。 **应当传入 `<Empty />`** —— 空态文案不得与无权限、未找到、加载失败共用。 |
|
|
2592
2656
|
| `density` | `'default' \| 'sm'` | 否 | 密度。影响单元格内边距 |
|
|
2657
|
+
| `trailingRow` | `TableTrailingRow` | 否 | 数据行之后追加的一条通栏行,横跨全部列。用于「识别中…」「正在加载更多」这类 附着在列表末尾的进行中状态。`rows` 为空时不渲染(此时显示 `empty`)。 **不得**用它承载数据行、合计行或分组标题 —— 那些有各自的列语义。 |
|
|
2593
2658
|
|
|
2594
2659
|
继承 `HTMLAttributes<HTMLDivElement>` 的全部原生属性。
|
|
2595
2660
|
|
|
@@ -2606,6 +2671,16 @@ Table 的单列定义
|
|
|
2606
2671
|
| `sortable` | `boolean` | 否 | 该列可排序。表头显示排序指示器并可点击 |
|
|
2607
2672
|
| `priority` | `'primary' \| 'default' \| 'low'` | 否 | 列优先级,决定窄视口下**先压缩谁、先隐藏谁**。 对应 02 §9 规则 8「先压间距,再压列数,再压优先级」。 **每一列都应显式设置**,否则窄视口下的降级顺序不可预期。 |
|
|
2608
2673
|
| `render` | `(row: R) => ReactNode` | 否 | 单元格渲染函数。提供时取代按 `key` 取值 |
|
|
2674
|
+
| `fixed` | `'left' \| 'right'` | 否 | 固定列。横向滚动时该列贴住表格左缘或右缘,朝滚动内容一侧带 16px 渐隐阴影。 **只允许首列声明 `'left'`、末列声明 `'right'`,每侧至多一列** —— 不计算多列叠加偏移。声明在中间列上不报错,但滚动时会与相邻列重叠。 典型用法:末列「操作」固定在右侧。有选择列时,首列固定会连同选择列一起固定。 |
|
|
2675
|
+
|
|
2676
|
+
**`TableTrailingRow`**
|
|
2677
|
+
|
|
2678
|
+
数据行之后的通栏行
|
|
2679
|
+
|
|
2680
|
+
| prop | 类型 | 必填 | 说明 |
|
|
2681
|
+
|---|---|:---:|---|
|
|
2682
|
+
| `content` | `ReactNode` | 是 | 行内容,横跨全部列居中显示。例如「识别中…」「正在加载更多」 |
|
|
2683
|
+
| `busy` | `boolean` | 否 | 进行中。叠加一层扫光动效;系统开启减少动效时不播放 |
|
|
2609
2684
|
|
|
2610
2685
|
**`TableSort`**
|
|
2611
2686
|
|
|
@@ -2618,7 +2693,7 @@ Table 的单列定义
|
|
|
2618
2693
|
|
|
2619
2694
|
**用途。** DataTable 呈现方式的承载面 —— LIST 页面模式、LEDGER 台账页、SPLIT 右栏共用同一份表。
|
|
2620
2695
|
|
|
2621
|
-
**何时使用。** 数据需要按列对齐、逐列比较、按列排序时,必须使用本组件。它是数据驱动的:列写在 `columns`,行数据写在 `rows`。表头位于 `--application-table-header
|
|
2696
|
+
**何时使用。** 数据需要按列对齐、逐列比较、按列排序时,必须使用本组件。它是数据驱动的:列写在 `columns`,行数据写在 `rows`。表头位于 `--application-table-header`,高 44px;表体单元格四边 16px 内边距,行最小高 56px(两行内容 72px);选择列 48px;行与行之间、表头列与列之间是 0.5px 分隔线而非阴影。密度分 `default` 与 `sm` 两档,只影响单元格内边距与行高下限。
|
|
2622
2697
|
|
|
2623
2698
|
**何时改用其他组件。**
|
|
2624
2699
|
- 列数过剩、但行仍需扫视 —— 改用 `ApplicationRecordList`,它是非表格形态的结构化列表。
|
|
@@ -2627,7 +2702,7 @@ Table 的单列定义
|
|
|
2627
2702
|
- 只是一组同构的目录行,无列对齐需求 —— 改用 `Item`。
|
|
2628
2703
|
- 需要手写 `<table>` / `<tr>` / `<td>` —— 一律改用本组件,手写表格拿不到已登记的表头底色、行分隔线与列宽约定。
|
|
2629
2704
|
|
|
2630
|
-
**组合约定。** 本组件不持有外边距,与相邻区块的间隙由 `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
|
|
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`,由表格均分剩余宽度 —— 不得全部留空交给浏览器按内容分配。列数多、需要横向滚动时,末列「操作」写 `fixed: 'right'` 贴住右缘,首列标题列可写 `fixed: 'left'`;只允许首列声明 `left`、末列声明 `right`,每侧至多一列。附着在列表末尾的进行中状态(「识别中…」「正在加载更多」)经 `trailingRow` 渲染为一条横跨全部列的通栏行,`busy` 为 true 时带扫光动效;`rows` 为空时它不渲染。
|
|
2631
2706
|
|
|
2632
2707
|
**禁止 / 使用边界。**
|
|
2633
2708
|
- 禁止手写 `<tr>` / `<td>` 作为子元素传入 —— 本组件不接受复合子组件,列与行只能来自 `columns` 与 `rows`。
|
|
@@ -2635,6 +2710,8 @@ Table 的单列定义
|
|
|
2635
2710
|
- 不得为 LIST 页面模式与 SPLIT 右栏各写一份近乎相同的表,同一份业务数据只允许一份实现。
|
|
2636
2711
|
- 不得在单元格内嵌套第二个 `Table`。
|
|
2637
2712
|
- 不得省略 `priority`,缺省会让窄视口下的降级顺序不可预期。
|
|
2713
|
+
- 不得用 `trailingRow` 承载数据行、合计行或分组标题,它只表达列表末尾的进行中状态。
|
|
2714
|
+
- 不得给中间列声明 `fixed`,也不得在同一侧固定两列 —— 组件不计算多列叠加偏移,滚动时会重叠。
|
|
2638
2715
|
|
|
2639
2716
|
## Foundation · feedback-overlay
|
|
2640
2717
|
|
|
@@ -2695,19 +2772,24 @@ Table 的单列定义
|
|
|
2695
2772
|
|
|
2696
2773
|
需要用户填写内容的一律用 `Dialog`。
|
|
2697
2774
|
|
|
2775
|
+
版式照 GAP Design kit「弹窗 / 提示」(188:687):宽 680、最小高 240,不接受尺寸调整;
|
|
2776
|
+
面板圆角 20,与其余模态弹窗同取 `--ds-radius-dialog`。页头、主体、页脚与 `Dialog` 同一套三段结构,
|
|
2777
|
+
页头在标题前多一个 20px 的提示图标(`circle-alert`,警示色),图标、标题、关闭键间隔 8;
|
|
2778
|
+
说明在主体内居中,16/20。
|
|
2779
|
+
|
|
2698
2780
|
**Props**
|
|
2699
2781
|
|
|
2700
2782
|
| prop | 类型 | 必填 | 说明 |
|
|
2701
2783
|
|---|---|:---:|---|
|
|
2702
2784
|
| `open` | `boolean` | 否 | 是否打开。为 false 时组件渲染 `null` |
|
|
2703
2785
|
| `title` | `ReactNode` | 否 | 标题。须写明后果与受影响数量 |
|
|
2704
|
-
| `description` | `ReactNode` | 否 |
|
|
2786
|
+
| `description` | `ReactNode` | 否 | 说明文字,主体内居中,16/20 文字1。用于补充不可恢复性等关键信息 |
|
|
2705
2787
|
| `confirmText` | `string` | 否 | 确认按钮文案。应是具体动词(「删除」)而非泛化的「确定」 |
|
|
2706
2788
|
| `cancelText` | `string` | 否 | 取消按钮文案 |
|
|
2707
|
-
| `destructive` | `boolean` | 否 | 破坏性动作。确认按钮转为 danger
|
|
2789
|
+
| `destructive` | `boolean` | 否 | 破坏性动作。确认按钮转为 danger 色;页头的提示图标不随之变化,仍取警示色 |
|
|
2708
2790
|
| `onConfirm` | `() => void` | 否 | 确认回调 |
|
|
2709
2791
|
| `onCancel` | `() => void` | 否 | 取消回调。关闭按钮亦触发 |
|
|
2710
|
-
| `children` | `ReactNode` | 否 |
|
|
2792
|
+
| `children` | `ReactNode` | 否 | 额外内容,在主体内排在说明之后。用于列出受影响对象等 |
|
|
2711
2793
|
|
|
2712
2794
|
继承 `HTMLAttributes<HTMLDivElement>` 的全部原生属性,其中 `title` 已被本组件重新定义或移除。
|
|
2713
2795
|
|
|
@@ -2720,13 +2802,14 @@ Table 的单列定义
|
|
|
2720
2802
|
- 可撤销的已完成事实改用 `Sonner`,并把撤销放进它的 `action`。
|
|
2721
2803
|
- 不阻断主任务的失败提示改用 `Alert`。
|
|
2722
2804
|
|
|
2723
|
-
**组合约定。** 该组件宽度固定为
|
|
2805
|
+
**组合约定。** 该组件宽度固定为 680px、最小高 240px,不接受尺寸调整;面板圆角 20(GAP Design kit「弹窗 / 提示」),与其余模态弹窗同一角色。页头、主体、页脚与 `Dialog` 同一套三段结构:页头在标题前固定显示 20px 的 `circle-alert` 提示图标(警示色,`destructive` 与否都不变 —— 破坏性只由确认按钮的 danger 色表达),`description` 在主体内上下居中、16/20 居中排版。点击遮罩不关闭 —— 破坏性确认必须是显式选择;Esc 仍然可用,等同于取消,不会误触发确认。`onCancel` 同时承担取消按钮、右上角关闭按钮与 Esc 三条路径,缺省它会使该组件无法关闭。右上角关闭按钮的无障碍名称固定为「关闭」,与取消按钮可区分;打开时初始焦点落在取消按钮,误按 Enter 不会触发确认。`cancelText` 必须是 2–4 字裸名词短语,不得写成句子。面板以 `role="alertdialog"` 输出,`title` 与 `description` 分别作为它的可访问名与描述。确认与取消按钮由该组件内部渲染,调用方不得再在 `children` 中放置一组按钮;`children` 只用于列出受影响对象。
|
|
2724
2806
|
|
|
2725
2807
|
**禁止 / 使用边界。**
|
|
2726
2808
|
- 不得在 `children` 中放置输入控件或表单字段。
|
|
2727
2809
|
- 禁止把标题写成不含数量与后果的泛化问句。
|
|
2728
2810
|
- 不得在本组件之上再叠加任何模态浮层 —— 它本身就是「模态之上放行的那一层」,再往上即超过一层(06 · D-3)。
|
|
2729
2811
|
- 不得依赖点击遮罩关闭,该路径已按契约关闭。
|
|
2812
|
+
- 不得在 `title` 或 `children` 里再放一个警示图标 —— 页头已固定显示,重复出现即为两枚。
|
|
2730
2813
|
|
|
2731
2814
|
### Collapsible
|
|
2732
2815
|
|
|
@@ -2779,7 +2862,13 @@ Table 的单列定义
|
|
|
2779
2862
|
|
|
2780
2863
|
模态容器,用于用户必须完成或放弃的聚焦任务 —— 新建、编辑、导入映射。
|
|
2781
2864
|
|
|
2782
|
-
已登记宽度:`small` 720px、`large` 960px
|
|
2865
|
+
已登记宽度:`small` 720px、`large` 960px。面板圆角 20(GAP Design kit「抽屉弹窗 / 弹窗」,
|
|
2866
|
+
模态弹窗角色 `--ds-radius-dialog`,与 `AlertDialog`、`ApplicationFormDialog`、`PeoplePickerDialog` 一致)。
|
|
2867
|
+
|
|
2868
|
+
三段结构照 kit「弹窗」类型=默认(188:685):页头最小高 48、内边距 8/12、标题与关闭键间隔 10,
|
|
2869
|
+
底边 0.5px 分隔线;主体内边距 12;页脚内边距 12、动作间隔 4,顶边 0.5px 分隔线。
|
|
2870
|
+
三段同为导航背景色(`--ds-color-canvas`),关闭键 32×32、圆角 12。面板最小高 240,
|
|
2871
|
+
视口更矮时让位于「绝不超出有效视口」。
|
|
2783
2872
|
|
|
2784
2873
|
⚠ **Overlay 只是物理容器。** 它绝不创造新的 Page Type 或 Page Mode,
|
|
2785
2874
|
也**绝不超出有效视口**。
|
|
@@ -2794,10 +2883,11 @@ Table 的单列定义
|
|
|
2794
2883
|
| prop | 类型 | 必填 | 说明 |
|
|
2795
2884
|
|---|---|:---:|---|
|
|
2796
2885
|
| `open` | `boolean` | 否 | 是否打开。为 false 时组件渲染 `null` |
|
|
2797
|
-
| `title` | `ReactNode` | 否 | 标题,16/
|
|
2886
|
+
| `title` | `ReactNode` | 否 | 标题,16/20 medium 字重 |
|
|
2798
2887
|
| `description` | `ReactNode` | 否 | 标题下的补充说明,12/16 label 色 |
|
|
2799
2888
|
| `size` | `'small' \| 'large' \| number` | 否 | 宽度。`small` 720px、`large` 960px,也接受任意数字。 无论取值如何都受 `max-width: 100%` 与视口边距约束 |
|
|
2800
2889
|
| `footer` | `ReactNode` | 否 | 底部动作区,右对齐。取消在左、主操作在右 |
|
|
2890
|
+
| `footerNote` | `ReactNode` | 否 | 页脚左侧的说明,12/16 label 色,占满动作左侧的剩余宽度(kit「弹窗」操作插槽 188:662)。 只传它不传 `footer` 时页脚照样渲染 |
|
|
2801
2891
|
| `onClose` | `() => void` | 否 | 关闭回调。点击遮罩与关闭按钮都会触发 |
|
|
2802
2892
|
| `initialFocus` | `RefObject<HTMLElement \| null>` | 否 | 打开时的初始焦点(06 · P3-1)。缺省时落在面板内首个可聚焦元素 —— 标题栏的 关闭按钮。键盘优先的内容(首个输入框、搜索框)应把它的 ref 传进来。 目标须在本组件内;关闭后焦点照常回到打开前的元素 |
|
|
2803
2893
|
| `children` | `ReactNode` | 否 | 主体内容。超长时本区域内部滚动,标题与页脚保持固定 |
|
|
@@ -2806,17 +2896,17 @@ Table 的单列定义
|
|
|
2806
2896
|
|
|
2807
2897
|
**用途。** 模态容器,用于用户必须完成或放弃的聚焦任务 —— 新建、编辑、导入映射。
|
|
2808
2898
|
|
|
2809
|
-
**何时使用。** 当任务需要用户在离开前完成或明确放弃、且不适合占用整页时,该组件是默认的物理容器。已登记宽度为 `small` 720px、`large` 960px;`size` 也接受任意数字,但无论取值如何都受 `max-width: 100%`
|
|
2899
|
+
**何时使用。** 当任务需要用户在离开前完成或明确放弃、且不适合占用整页时,该组件是默认的物理容器。已登记宽度为 `small` 720px、`large` 960px;`size` 也接受任意数字,但无论取值如何都受 `max-width: 100%` 与视口边距约束。面板圆角 20(GAP Design kit「抽屉弹窗 / 弹窗」),取模态弹窗角色 `--ds-radius-dialog`,与 `AlertDialog`、`ApplicationFormDialog`、`PeoplePickerDialog` 一致。版式照 kit 类型=默认:页头、主体、页脚三段同为导航背景色,页头最小高 48、标题 16/20 medium、右侧 32×32 关闭键,页脚动作间隔 4,两处分隔线均为 0.5px;面板最小高 240。
|
|
2810
2900
|
|
|
2811
2901
|
**何时改用其他组件。**
|
|
2812
2902
|
- 完整业务表单改用 `ApplicationFormDialog`,它拥有已登记的字段网格与提交语义。
|
|
2813
2903
|
- 不可逆动作的确认改用 `AlertDialog`。
|
|
2814
2904
|
- 业务对象详情改用 `Drawer` 或独立详情页。
|
|
2815
|
-
-
|
|
2905
|
+
- 辅助性内容(帮助、附件预览)改用 `Sheet`;全局设置是 `ApplicationSecondaryNavigation` 里的设置模块,不进任何浮层。
|
|
2816
2906
|
- 无需阻断背景的锚定面板改用 `Popover`。
|
|
2817
2907
|
- 全局命令面板改用 `Command` 的 `dialog` 形态,不要把 `Command` 放进本组件。
|
|
2818
2908
|
|
|
2819
|
-
**组合约定。** 该组件与 `AlertDialog`、`Drawer`、`Sheet` 共用同一个模态基座,因此自带遮罩、Esc 关闭、焦点陷阱、关闭后焦点恢复与背景滚动锁定,调用方不得再自行实现这五件事,也不得自行设置 `z-index`。`onClose` 同时承担遮罩点击与关闭按钮两条路径。打开时焦点默认落在面板内首个可聚焦元素,即标题栏的关闭按钮;主体以输入为主(新建、编辑)时应以 `initialFocus` 传入首个字段的 ref,焦点一次落定,不先经过关闭按钮。`footer` 右对齐,取消在左、主操作在右,其中至多一个 `SystemButton` 用 `intent="primary"
|
|
2909
|
+
**组合约定。** 该组件与 `AlertDialog`、`Drawer`、`Sheet` 共用同一个模态基座,因此自带遮罩、Esc 关闭、焦点陷阱、关闭后焦点恢复与背景滚动锁定,调用方不得再自行实现这五件事,也不得自行设置 `z-index`。`onClose` 同时承担遮罩点击与关闭按钮两条路径。打开时焦点默认落在面板内首个可聚焦元素,即标题栏的关闭按钮;主体以输入为主(新建、编辑)时应以 `initialFocus` 传入首个字段的 ref,焦点一次落定,不先经过关闭按钮。`footer` 右对齐,取消在左、主操作在右,其中至多一个 `SystemButton` 用 `intent="primary"`。页脚左侧的补充信息(条数、当前位置、保存状态)传 `footerNote`,由该组件排成 12/16 label 色并把动作挤到右侧,调用方不得在 `footer` 里自行拼一段说明文字。主体区域内部滚动而标题与页脚固定,调用方不得在 `children` 外层再套一个滚动容器。`open` 为 false 时该组件渲染 null,内部状态随之丢失 —— 需要保留草稿的调用方必须自行持有该状态。
|
|
2820
2910
|
|
|
2821
2911
|
**禁止 / 使用边界。**
|
|
2822
2912
|
- 不得在本组件内改变 `pageType` 或 `pageMode` —— 浮层只是物理容器,绝不创造新的页面类型或页面模式。
|
|
@@ -2860,7 +2950,8 @@ Table 的单列定义
|
|
|
2860
2950
|
|
|
2861
2951
|
**何时改用其他组件。**
|
|
2862
2952
|
- 已登记的业务详情结构改用 `ApplicationDetailDrawer`,其主体须传 `ApplicationRecordDetailBody`。
|
|
2863
|
-
- 辅助性内容(帮助、附件预览)改用 `Sheet
|
|
2953
|
+
- 辅助性内容(帮助、附件预览)改用 `Sheet`,它在结构上更轻,不承载业务记录。
|
|
2954
|
+
- 全局设置改用 `ApplicationSecondaryNavigation` 的设置模块 —— `ApplicationPrimaryNavigation` 的设置动作给出的 `kind` 是 `'module'`,不打开抽屉(GAP Design kit「框架结构 / 结构=设置」)。
|
|
2864
2955
|
- 需要用户完成或放弃的聚焦任务改用 `Dialog`。
|
|
2865
2956
|
- 需要深链接指向的详情改用独立详情页,不得用抽屉承接。
|
|
2866
2957
|
|
|
@@ -2870,7 +2961,7 @@ Table 的单列定义
|
|
|
2870
2961
|
- 不得把深链接指向抽屉状态。
|
|
2871
2962
|
- 禁止把关闭动作的文案写成「返回」。
|
|
2872
2963
|
- 不得在抽屉内再打开第二个抽屉、对话框或侧板。模态之上至多再叠一层确认框(`AlertDialog`)或选择器(`PeoplePickerDialog`),更深的嵌套一律禁止(06 · D-3):抽屉里的删除必须经 `AlertDialog` 确认,确认框直接叠在抽屉之上,不得为此先关抽屉。
|
|
2873
|
-
- 不得承载帮助、附件预览一类辅助性面板 —— 那些走 `Sheet
|
|
2964
|
+
- 不得承载帮助、附件预览一类辅助性面板 —— 那些走 `Sheet`;也不得承载全局设置 —— 它是二级导航里的设置模块。
|
|
2874
2965
|
|
|
2875
2966
|
### DropdownMenu
|
|
2876
2967
|
|
|
@@ -3014,7 +3105,7 @@ DropdownMenu 的单个条目。
|
|
|
3014
3105
|
- 条目清单式的低频动作改用 `DropdownMenu`。
|
|
3015
3106
|
- 表单与筛选行中的取值改用 `Select`,需要输入筛选改用 `Combobox`。
|
|
3016
3107
|
- 查询工具栏的筛选维度改用 `ApplicationFilterMenu`。
|
|
3017
|
-
- 消息 / 待办 /
|
|
3108
|
+
- 消息 / 待办 / 总览 / 风险预警四个全局动作共享的弹层改用 `ApplicationGlobalActionPanel`,其 720px 宽、20px 圆角、680px 最高的几何已登记。
|
|
3018
3109
|
- 用户必须完成或放弃的任务改用 `Dialog`。
|
|
3019
3110
|
|
|
3020
3111
|
**组合约定。** 该组件是非模态浮层:不锁背景滚动、不陷阱焦点,Esc、外部点击与焦点离开(焦点从 `trigger` 或面板移到两者之外,如 Tab 出去)都会关闭并触发 `onOpenChange`;焦点离开引起的关闭不归还焦点。关闭时焦点若在面板内(Esc,或面板内的控件经 `onOpenChange(false)` 收起),焦点回到 `trigger`,因此在 `Dialog` 内使用时焦点不会逃出对话框。受控模式下 `open` 与 `onOpenChange` 必须成对出现。组件向 `trigger` 注入 `aria-expanded`,因此 `trigger` 必须是单个能接收该属性的 React 元素,调用方不得在 `trigger` 上再写一个;传入纯字符串时属性不会注入。触发器由别的组件渲染、只经回调交出元素时(`TopNavigationPrimaryBar` 的 `onAppSwitch` / `onAccount`),把该元素传给 `anchor` 并受控使用:面板贴它定位,点它不算外部点击,收起时焦点还给它,Tab 从它直接进入面板、从面板末项接着走它之后的元素;此时不渲染 `trigger`、组件根不占布局,`aria-expanded` 由渲染触发器的那个组件输出。`radius` 应传 token 而非字面值。作为「更多筛选」入口时,生效条件必须回写到 `ApplicationQueryToolbar` 第三行的筛选标签行。层级由已登记的浮层 z-index 承担,调用方不得自行设置。
|
|
@@ -3029,8 +3120,10 @@ DropdownMenu 的单个条目。
|
|
|
3029
3120
|
|
|
3030
3121
|
`import { Sheet } from '@moheng-design/ui'` · 契约 `contracts/foundation/feedback-overlay/sheet.ts`
|
|
3031
3122
|
|
|
3032
|
-
从任意边缘滑出的面板,用于**辅助性内容** ——
|
|
3033
|
-
|
|
3123
|
+
从任意边缘滑出的面板,用于**辅助性内容** —— 帮助面板、附件预览。
|
|
3124
|
+
|
|
3125
|
+
⚠ **全局设置也不属于这里。** 一级导航的「设置」让 `ApplicationSecondaryNavigation`
|
|
3126
|
+
换成设置模块(GAP Design kit「框架结构 / 结构=设置」),不打开任何侧板。
|
|
3034
3127
|
|
|
3035
3128
|
⚠ **业务对象详情不属于这里。** 详情用 `Drawer`(680px)
|
|
3036
3129
|
或独立详情页 —— Sheet 在结构上比 Drawer 更轻,不承载业务记录。
|
|
@@ -3048,23 +3141,24 @@ DropdownMenu 的单个条目。
|
|
|
3048
3141
|
|
|
3049
3142
|
继承 `HTMLAttributes<HTMLDivElement>` 的全部原生属性,其中 `title` 已被本组件重新定义或移除。
|
|
3050
3143
|
|
|
3051
|
-
**用途。** 从任意边缘滑出的面板,用于辅助性内容 ——
|
|
3144
|
+
**用途。** 从任意边缘滑出的面板,用于辅助性内容 —— 帮助面板、附件预览。
|
|
3052
3145
|
|
|
3053
|
-
**何时使用。**
|
|
3146
|
+
**何时使用。** 当内容是辅助性的参考信息、不属于任何一条业务记录时,该组件是默认选择。四个 `side` 方向均实际生效:左右向时 `size` 为宽度,上下向时为高度,正交方向一律铺满。默认尺寸 420px。
|
|
3054
3147
|
|
|
3055
3148
|
**何时改用其他组件。**
|
|
3056
3149
|
- 业务对象详情改用 `Drawer`(680px)或独立详情页 —— 本组件在结构上比抽屉更轻,不承载业务记录。
|
|
3057
3150
|
- 已登记的业务详情结构改用 `ApplicationDetailDrawer`。
|
|
3058
3151
|
- 需要用户完成或放弃的聚焦任务改用 `Dialog`。
|
|
3059
|
-
- 消息 / 待办 /
|
|
3060
|
-
-
|
|
3152
|
+
- 消息 / 待办 / 总览 / 风险预警四个全局动作改用 `ApplicationGlobalActionPanel`。
|
|
3153
|
+
- 全局设置改用 `ApplicationSecondaryNavigation` 的设置模块 —— 一级导航的设置动作让二级导航整带换成设置模块,不打开本组件(GAP Design kit「框架结构 / 结构=设置」)。
|
|
3154
|
+
- 工具栏的呈现设置面板(列设置、看板设置等)改用 `Popover`,与更多筛选同一承载(07 · C-7)。
|
|
3061
3155
|
|
|
3062
|
-
**组合约定。** 该组件与 `Dialog`、`AlertDialog`、`Drawer` 共用同一个模态基座,因此自带 Esc 关闭、焦点陷阱、焦点恢复与背景滚动锁定。该组件没有固定底部动作区 —— 需要提交按钮常驻底部的载体改用 `Drawer
|
|
3156
|
+
**组合约定。** 该组件与 `Dialog`、`AlertDialog`、`Drawer` 共用同一个模态基座,因此自带 Esc 关闭、焦点陷阱、焦点恢复与背景滚动锁定。该组件没有固定底部动作区 —— 需要提交按钮常驻底部的载体改用 `Drawer`。主体区域内部滚动,标题栏高度对齐内容区标题栏。全局设置在整个产品中只有一个入口(一级导航的设置动作),它打开的是二级导航里的设置模块,不经本组件承载。
|
|
3063
3157
|
|
|
3064
3158
|
**禁止 / 使用边界。**
|
|
3065
3159
|
- 不得用本组件承载业务对象详情。
|
|
3066
3160
|
- 禁止在本组件内放置需要固定在底部的提交动作。
|
|
3067
|
-
-
|
|
3161
|
+
- 不得用本组件承载全局设置,也不得为「设置」建立第二个入口。
|
|
3068
3162
|
- 不得在本组件之上再叠加抽屉或对话框。
|
|
3069
3163
|
|
|
3070
3164
|
### Sonner
|
|
@@ -3246,6 +3340,59 @@ Sonner 的单条提示
|
|
|
3246
3340
|
|
|
3247
3341
|
## Application Atomic
|
|
3248
3342
|
|
|
3343
|
+
### ApplicationDateRangeFilter
|
|
3344
|
+
|
|
3345
|
+
`import { ApplicationDateRangeFilter } from '@moheng-design/ui'` · 契约 `contracts/application-atomic/application-date-range-filter.ts`
|
|
3346
|
+
|
|
3347
|
+
查询工具栏主控制行中的**日期区间**快捷筛选,与 `ApplicationFilterMenu` 同为一个
|
|
3348
|
+
常驻维度,放进 `ApplicationQueryToolbar` 的 `commonFilters`。
|
|
3349
|
+
|
|
3350
|
+
触发器与 `ApplicationFilterMenu` 同高同壳,生效时回显「接收时间:2026-07-01 – 2026-07-28」。
|
|
3351
|
+
面板里是起止两张 `Calendar` 月格,由「应用」提交、「清空」撤销 —— 选到一半不生效。
|
|
3352
|
+
|
|
3353
|
+
⚠ **已生效的区间必须回写到工具栏第三行的筛选标签行**(`appliedTags`),且标签可移除。
|
|
3354
|
+
与 `ApplicationFilterMenu` 同一条规矩:筛选状态只存在于触发器上是不合规的。
|
|
3355
|
+
|
|
3356
|
+
**Props**
|
|
3357
|
+
|
|
3358
|
+
| prop | 类型 | 必填 | 说明 |
|
|
3359
|
+
|---|---|:---:|---|
|
|
3360
|
+
| `label` | `ReactNode` | 是 | 维度名称,显示在触发器上,如「接收时间」 |
|
|
3361
|
+
| `labelText` | `string` | 否 | 维度名称的纯文本,用于触发器回显与可访问名。 `label` 为非字符串时**必须**提供,否则回显为 `[object Object]`。 |
|
|
3362
|
+
| `value` | `DateRangeValue` | 否 | 受控值。两端都缺省即未生效 |
|
|
3363
|
+
| `onValueChange` | `(value: DateRangeValue) => void` | 否 | 「应用」提交时的回调。「清空」提交 `{}` |
|
|
3364
|
+
| `disabled` | `boolean` | 否 | 禁用 |
|
|
3365
|
+
| `today` | `Date` | 否 | 「今天」,透传给两张 `Calendar` |
|
|
3366
|
+
|
|
3367
|
+
继承 `HTMLAttributes<HTMLDivElement>` 的全部原生属性,其中 `defaultValue`、`onChange` 已被本组件重新定义或移除。
|
|
3368
|
+
|
|
3369
|
+
**`DateRangeValue`**
|
|
3370
|
+
|
|
3371
|
+
日期区间。两端均为本地时区 ISO `yyyy-mm-dd`,缺省一端表示该端不限
|
|
3372
|
+
|
|
3373
|
+
| prop | 类型 | 必填 | 说明 |
|
|
3374
|
+
|---|---|:---:|---|
|
|
3375
|
+
| `start` | `string` | 否 | 起始日期(含) |
|
|
3376
|
+
| `end` | `string` | 否 | 结束日期(含) |
|
|
3377
|
+
|
|
3378
|
+
**用途。** 查询工具栏主控制行中的日期区间快捷筛选,承载**一个**日期维度(接收时间、开票日期)的起止区间。
|
|
3379
|
+
|
|
3380
|
+
**何时使用。** 结果集需要按某个日期维度的区间筛选、且该维度高频使用时,必须使用本组件。触发器与 `ApplicationFilterMenu` 同高同壳,生效时回显「维度名:起 – 止」;面板里起止各一张 `Calendar`,选择是草稿,「应用」提交、「清空」撤销。值为 `{ start?, end? }`,两端都是本地时区 ISO `yyyy-mm-dd`,缺省一端表示该端不限。
|
|
3381
|
+
|
|
3382
|
+
**何时改用其他组件。**
|
|
3383
|
+
- 取值为有限枚举的维度:改用 `ApplicationFilterMenu`。
|
|
3384
|
+
- 表单里的单个日期字段:改用 `DateInput`。
|
|
3385
|
+
- 低频的日期维度:收进 `moreFilters` 的 `ApplicationFilterList` 面板,不常驻工具栏。
|
|
3386
|
+
- 整页按日期浏览:改用 `pageMode` 为 `CALENDAR` 的日历承载面。
|
|
3387
|
+
|
|
3388
|
+
**组合约定。** 该组件必须作为 `ApplicationQueryToolbar` 的 `commonFilters` 内容出现,与 `ApplicationFilterMenu` 合计常驻不超过 3 个。生效区间必须由调用方回写到 `appliedTags`(标签文案如「接收时间:2026-07-01 – 2026-07-28」),并在 `onRemoveTag` 里把区间清回 `{}`。`label` 为非字符串时必须提供 `labelText`,它同时是触发器回显与可访问名的来源。结束日期早于开始日期时「应用」禁用,组件不替调用方交换两端。区间两端都是闭区间(含当天),调用方换算成接口参数时自行补足时分。
|
|
3389
|
+
|
|
3390
|
+
**禁止 / 使用边界。**
|
|
3391
|
+
- 不得让已生效的区间只停留在触发器上而不回写筛选标签行。
|
|
3392
|
+
- 不得在面板外再包一层 `Popover` 或 `DropdownMenu`,面板自带定位与外点击关闭。
|
|
3393
|
+
- 不得放进 `ApplicationPageHeader` —— 上下文区禁止出现筛选。
|
|
3394
|
+
- 禁止在选到一半时发起查询,区间只经「应用」提交。
|
|
3395
|
+
|
|
3249
3396
|
### ApplicationFilterMenu
|
|
3250
3397
|
|
|
3251
3398
|
`import { ApplicationFilterMenu } from '@moheng-design/ui'` · 契约 `contracts/application-atomic/application-filter-menu.ts`
|
|
@@ -3285,7 +3432,7 @@ Sonner 的单条提示
|
|
|
3285
3432
|
|
|
3286
3433
|
**用途。** 查询工具栏主控制行中的常驻快捷筛选触发器,承载**一个**高频筛选维度的取值。
|
|
3287
3434
|
|
|
3288
|
-
**何时使用。** 该维度在结果集上高频使用、取值为短词且数量有限时,必须选用本组件。面板已登记 180px 最小宽与 280px 最高,取值控制在 8 项以内方能一屏读完。工具栏内至多常驻 2–3 个,其余维度一律下沉到「更多筛选」。触发器高 32px、圆角
|
|
3435
|
+
**何时使用。** 该维度在结果集上高频使用、取值为短词且数量有限时,必须选用本组件。面板已登记 180px 最小宽与 280px 最高,取值控制在 8 项以内方能一屏读完。工具栏内至多常驻 2–3 个,其余维度一律下沉到「更多筛选」。触发器高 32px、圆角 12px,与同排的 `SearchField` 读作一行。
|
|
3289
3436
|
|
|
3290
3437
|
**何时改用其他组件。**
|
|
3291
3438
|
- 低频维度、或需要一次性提交多个维度:改用 `ApplicationFilterList`,它是「更多筛选」的面板主体,持有草稿并由「应用」提交。
|
|
@@ -3294,6 +3441,7 @@ Sonner 的单条提示
|
|
|
3294
3441
|
- 需要输入即筛选:改用 `Combobox`。
|
|
3295
3442
|
- 局部显示选择(密度、对齐方式、局部视图标记):改用 `ToggleGroup`。
|
|
3296
3443
|
- 键盘优先的全局搜索与执行:改用 `Command` 的 `dialog` 形态。
|
|
3444
|
+
- 日期区间维度:改用 `ApplicationDateRangeFilter`,同样放进 `commonFilters`。
|
|
3297
3445
|
|
|
3298
3446
|
**组合约定。** 该组件必须作为 `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` 负责。
|
|
3299
3447
|
|
|
@@ -3352,14 +3500,19 @@ Sonner 的单条提示
|
|
|
3352
3500
|
|
|
3353
3501
|
`import { ListTablePagination } from '@moheng-design/ui'` · 契约 `contracts/application-atomic/list-table-pagination.ts`
|
|
3354
3502
|
|
|
3355
|
-
列表 / 表格分页 ——
|
|
3503
|
+
列表 / 表格分页 —— 摘要、每页条数、页码窗口与跳页。
|
|
3356
3504
|
数据展示区的标准页脚,LIST 页面模式的默认配置。
|
|
3357
3505
|
|
|
3506
|
+
形态按 GAP Design kit「分页行」(业财平台 round-01 · pagination/structure 裁决,2026-11-10):
|
|
3507
|
+
左侧摘要「每页 N 条,共 Z 条数据」12/20 三级文字色,右侧依次为每页条数选择器、
|
|
3508
|
+
Foundation `Pagination`(首页 · 上一页 · 页码窗口 · 下一页 · 末页)与「第 [ ] 页」跳页框,
|
|
3509
|
+
控件一律 32 高、圆角 12、间隔 4。**本组件包含 `Pagination`**,两者不再是替代关系。
|
|
3510
|
+
|
|
3358
3511
|
⚠ **分页状态按业务视图各记一份**:切换 Business View 时回到该视图上次所在的页,
|
|
3359
3512
|
切换 Page Mode 与从详情返回时保持当前页 —— 规范要求恢复来源上下文。
|
|
3360
3513
|
搜索、筛选、排序变化时复位到第 1 页(07 · C-13)。
|
|
3361
3514
|
|
|
3362
|
-
|
|
3515
|
+
没有总数与每页条数需求时,直接用 Foundation `Pagination`。
|
|
3363
3516
|
|
|
3364
3517
|
**Props**
|
|
3365
3518
|
|
|
@@ -3369,20 +3522,21 @@ Sonner 的单条提示
|
|
|
3369
3522
|
| `pageSize` | `number` | 否 | 每页条数 |
|
|
3370
3523
|
| `total` | `number` | 否 | 结果总数。用于计算区间与总页数 |
|
|
3371
3524
|
| `pageSizeOptions` | `number[]` | 否 | 每页条数的可选值 |
|
|
3525
|
+
| `showJumper` | `boolean` | 否 | 是否显示「第 [ ] 页」跳页框,默认 `true`(kit 分页行恒有)。回车提交,越界时夹到 1 与总页数之间,提交后清空。总页数很少、跳页没有意义时可传 `false` |
|
|
3372
3526
|
| `onPageChange` | `(page: number) => void` | 否 | 页码变化回调 |
|
|
3373
3527
|
| `onPageSizeChange` | `(pageSize: number) => void` | 否 | 每页条数变化回调。变更后通常应重置到第 1 页,由调用方决定 |
|
|
3374
3528
|
|
|
3375
3529
|
继承 `HTMLAttributes<HTMLDivElement>` 的全部原生属性。
|
|
3376
3530
|
|
|
3377
|
-
**用途。** 数据展示区的标准页脚 ——
|
|
3531
|
+
**用途。** 数据展示区的标准页脚 —— 摘要、每页条数、页码窗口与跳页。
|
|
3378
3532
|
|
|
3379
|
-
**何时使用。** 结果集同时具备总数与每页条数需求时必须使用本组件,它是 LIST
|
|
3533
|
+
**何时使用。** 结果集同时具备总数与每页条数需求时必须使用本组件,它是 LIST 页面模式的默认配置。形态按 GAP Design kit「分页行」固定为:左侧「每页 N 条,共 Z 条数据」摘要(12/20 三级文字色),右侧依次为每页条数选择器、`Pagination`(首页 · 上一页 · 页码窗口 · 下一页 · 末页)与「第 [ ] 页」跳页框,控件一律 32 高、圆角 12、间隔 4。跳页框回车提交,输入越界时夹到 1 与总页数之间,提交后清空;总页数很少时可传 `showJumper={false}` 隐去。每页条数默认档为 20 / 50 / 100,业务确有别的档位时通过 `pageSizeOptions` 覆盖。
|
|
3380
3534
|
|
|
3381
3535
|
**何时改用其他组件。**
|
|
3382
|
-
- 既无总数也无每页条数需求:改用 `Pagination
|
|
3383
|
-
-
|
|
3536
|
+
- 既无总数也无每页条数需求:改用 `Pagination`,它是本组件内部的页码区,可以单独使用。
|
|
3537
|
+
- 两者是包含关系:本组件已经渲染了 `Pagination`,同一个数据展示区内不得再另放一个。
|
|
3384
3538
|
|
|
3385
|
-
**组合约定。** 该组件必须放进 `ApplicationDataDisplay` 的 `pagination` 槽位,固定在区域底部;该槽位不随 `state` 隐藏,因此 `state` 不为 `ready` 时调用方不得传入分页。分页状态按业务视图各记一份:切换 `businessView` 时回到该视图上次所在的页,切换 `pageMode` 与从详情返回时保持当前页;搜索、筛选、排序变化时复位到第 1 页(07 · C-13)。该组件是全受控的,这份状态由调用方持有。`onPageSizeChange` 之后通常应重置到第 1 页,调用方必须显式再调一次 `onPageChange`,组件不代劳。`total` 与 `ApplicationQueryToolbar` 的 `resultSummary` 必须取自同一口径的同一个数,否则页脚与摘要会互相打脸。每页条数选择器内部已复用 `NativeSelect`,调用方不得在旁边再挂一个 `Select
|
|
3539
|
+
**组合约定。** 该组件必须放进 `ApplicationDataDisplay` 的 `pagination` 槽位,固定在区域底部;该槽位不随 `state` 隐藏,因此 `state` 不为 `ready` 时调用方不得传入分页。分页状态按业务视图各记一份:切换 `businessView` 时回到该视图上次所在的页,切换 `pageMode` 与从详情返回时保持当前页;搜索、筛选、排序变化时复位到第 1 页(07 · C-13)。该组件是全受控的,这份状态由调用方持有。`onPageSizeChange` 之后通常应重置到第 1 页,调用方必须显式再调一次 `onPageChange`,组件不代劳。`total` 与 `ApplicationQueryToolbar` 的 `resultSummary` 必须取自同一口径的同一个数,否则页脚与摘要会互相打脸。每页条数选择器内部已复用 `NativeSelect`、页码区已复用 `Pagination`、跳页框已复用 `Input`,调用方不得在旁边再挂一个 `Select`、页码条或跳页输入。该组件不自带外边距,与上方结果集的间距由数据展示区负责。
|
|
3386
3540
|
|
|
3387
3541
|
**禁止 / 使用边界。**
|
|
3388
3542
|
- 不得在同一数据展示区内出现两处分页控件。
|
|
@@ -3397,7 +3551,7 @@ Sonner 的单条提示
|
|
|
3397
3551
|
共享的紧凑搜索入口 —— **产品内每一处纯文本搜索**:
|
|
3398
3552
|
查询工具栏、目录搜索、人员与文件选择器。
|
|
3399
3553
|
|
|
3400
|
-
32px 最小高度,
|
|
3554
|
+
32px 最小高度,12px 圆角,白底 1px 描边(GAP Design kit「表单/输入」),焦点只在外壳表达一次。
|
|
3401
3555
|
|
|
3402
3556
|
⚠ **只在 Enter 时提交。** 规范禁止逐字实时搜索作为默认行为。
|
|
3403
3557
|
|
|
@@ -3511,7 +3665,7 @@ Sonner 的单条提示
|
|
|
3511
3665
|
- 该栏整体由 `GlobalSidebar` 渲染:改为向 `GlobalSidebar` 的 `items` 传数据(`icon` / `label` / `badge` / `separator`),本组件由它在内部渲染。栏底入口例外:`GlobalSidebar` 的 `footer` 直接放本组件(07 · C-15)。
|
|
3512
3666
|
- 跨应用的快捷入口:改用 `SidebarAppLinkButton`。
|
|
3513
3667
|
- Content Canvas 内部的通用垂直导航:改用 `Sidebar`,其折叠态即是 56px 图标栏。
|
|
3514
|
-
- Shell
|
|
3668
|
+
- Shell 的导航带:改用 `TopNavigationPrimaryBar`、`ApplicationPrimaryNavigation`、`ApplicationSecondaryNavigation`、`ApplicationModuleSwitcher`。
|
|
3515
3669
|
|
|
3516
3670
|
**组合约定。** `label` 不可省略 —— 规范禁止纯图标导航项。图标与标签是一个交互单元,禁用或淡化必须作用于整个条目。同一栏内至多一个条目设 `active`。`badge` 只承载未读计数或极短文本,长文案会溢出 14px 高的药丸;数字或文本徽标的视觉部分对读屏隐藏,条目名读作「标签,N 条」,调用方不得再把计数拼进 `label`。标签必须是 2–4 字裸名词短语,超出即被截断。分隔线通过 `GlobalSidebarEntry.separator` 表达,调用方不得在 `items` 之间手工插入 `Separator`。直接使用本组件时(即不经 `GlobalSidebar`),必须放进 56px 宽的列容器,条目之间的纵向间距由该容器负责,该组件不自带外边距。
|
|
3517
3671
|
|
|
@@ -3519,7 +3673,7 @@ Sonner 的单条提示
|
|
|
3519
3673
|
- 不得省略 `label`,纯图标导航项被规范禁止。
|
|
3520
3674
|
- 不得只禁用图标或只淡化标签,二者必须整体一致。
|
|
3521
3675
|
- 禁止在 `GlobalSidebar` 的 `items` 与 `footer` 之外再向该栏手工插入条目。
|
|
3522
|
-
- 不得把它挪进应用外层 Shell —— Shell
|
|
3676
|
+
- 不得把它挪进应用外层 Shell —— Shell 是刻意设计的无侧栏、全宽导航带堆叠。
|
|
3523
3677
|
|
|
3524
3678
|
### SystemButton
|
|
3525
3679
|
|
|
@@ -3542,7 +3696,7 @@ Sonner 的单条提示
|
|
|
3542
3696
|
|
|
3543
3697
|
| prop | 类型 | 必填 | 说明 |
|
|
3544
3698
|
|---|---|:---:|---|
|
|
3545
|
-
| `intent` | `'primary' \| 'secondary' \| 'quiet' \| 'link' \| 'destructive'` | 否 | 应用意图。映射到 Foundation Button 的 variant:`quiet` → ghost,其余同名。 |
|
|
3699
|
+
| `intent` | `'primary' \| 'secondary' \| 'quiet' \| 'link' \| 'destructive' \| 'destructive-outline'` | 否 | 应用意图。映射到 Foundation Button 的 variant:`quiet` → ghost,其余同名。 删除类动作两档:`destructive-outline`(白底、危险色描边与文字)用于与次要按钮 并排出现的删除,例如表单里「删除此附件」;`destructive`(实心危险色)只用于 确认弹窗里那个不可逆的最终动作。同一动作组内不得同时出现两档。 |
|
|
3546
3700
|
| `size` | `'default' \| 'compact' \| 'sm'` | 否 | 尺寸。见 T2 —— `compact` 目前与 `default` 无视觉差异。 `sm` 映射 Foundation Button 的 28px 档,只用于嵌进 32px 控件内部的动作 (`InputGroup` 的尾部按钮),不得用来压缩页面上的独立按钮。 |
|
|
3547
3701
|
| `iconOnly` | `boolean` | 否 | 等宽图标按钮:宽度收敛为与高度相等,行内内边距归零。直接映射到 Foundation `Button` 的 `iconOnly`,与 `intent` / `size` 正交。为 true 时**必须**提供 `aria-label`。 |
|
|
3548
3702
|
| `loading` | `boolean` | 否 | 加载中。阻断交互并设置 `aria-busy`,同时渲染一个行内转圈;`iconOnly` 时转圈 替换原图标的位置,按钮尺寸不变。与 `disabled` 都会阻断动作,但语义不同:loading 是暂时的。 实现不用原生 `disabled`:渲染 `aria-disabled="true"` 并在 `onClick` 中 `preventDefault`(同时挡住 `type="submit"` 的表单提交),按钮保持可聚焦, 焦点不会在点击后掉到 `<body>`。 |
|
|
@@ -3552,7 +3706,7 @@ Sonner 的单条提示
|
|
|
3552
3706
|
|
|
3553
3707
|
**用途。** 整个产品的默认动作按钮,是 Foundation `Button` 之上只承载应用意图、loading 与产品状态的薄适配层。
|
|
3554
3708
|
|
|
3555
|
-
**何时使用。** 业务页面中的每一个按钮都必须使用本组件,没有例外;Foundation `Button` 只供库内组件使用。改一次应用强调色,全部 `SystemButton` 同时换肤,这个性质正是它存在的理由。该组件绝不重新实现按钮的排版与几何:14/20 字号、32px 高度、
|
|
3709
|
+
**何时使用。** 业务页面中的每一个按钮都必须使用本组件,没有例外;Foundation `Button` 只供库内组件使用。改一次应用强调色,全部 `SystemButton` 同时换肤,这个性质正是它存在的理由。该组件绝不重新实现按钮的排版与几何:14/20 字号、32px 高度、12px 圆角全部来自 Foundation `Button`。删除类动作分两档:`intent="destructive-outline"`(白底、危险色描边与文字)用于与次要按钮并排的删除,如表单里「删除此附件」;`intent="destructive"`(实心危险色)只用于 `AlertDialog` 里那个不可逆的最终确认,同一动作组内不得同时出现两档。
|
|
3556
3710
|
|
|
3557
3711
|
**何时改用其他组件。**
|
|
3558
3712
|
- 一组相关按钮需要拼接为分段控件或间隔簇:外层用 `ButtonGroup`,组内仍是 `SystemButton`。
|
|
@@ -3578,18 +3732,18 @@ Sonner 的单条提示
|
|
|
3578
3732
|
|
|
3579
3733
|
应用二级导航的**左半部分** —— 你在哪个模块,以及如何切换。
|
|
3580
3734
|
|
|
3581
|
-
####
|
|
3582
|
-
Standard
|
|
3583
|
-
|
|
3584
|
-
名称 16/20 **700**,14px chevron 右对齐。
|
|
3735
|
+
#### 触发器(GAP Design kit「应用二级模块切换」)
|
|
3736
|
+
Standard 168×48,Compact 148×40;内边距 4/12,**没有图标块**;
|
|
3737
|
+
名称 16/20 **medium**,20px chevron 右对齐;右侧 0.5px 分隔线;悬停与展开时 6% 淡底。
|
|
3585
3738
|
|
|
3586
3739
|
⚠ **绝不能简化成一个小图标,也绝不能移除。**
|
|
3587
3740
|
|
|
3588
3741
|
#### 面板
|
|
3589
|
-
|
|
3590
|
-
|
|
3591
|
-
**1px
|
|
3592
|
-
条目最小高 40,内边距 8/12,圆角 12,文字 14/22
|
|
3742
|
+
挂在触发器正下方(`position: absolute`),与触发器同宽 168、最窄 128,
|
|
3743
|
+
底色为导航背景与表面色各半,内边距 4,条目间隔 2,
|
|
3744
|
+
**1px 右边线,无圆角,无阴影**,限高到视口底、自带垂直滚动。
|
|
3745
|
+
条目最小高 40,内边距 8/12,圆角 12,文字 14/22;悬停取导航背景;
|
|
3746
|
+
当前模块为强调色 semibold,右侧 14px 对勾。
|
|
3593
3747
|
|
|
3594
3748
|
⚠ **点击当前模块不发生跳转。** 路由计算由调用方负责。
|
|
3595
3749
|
|
|
@@ -3605,7 +3759,6 @@ Standard 最小宽 168 / 高 40,Compact 148 / 32;
|
|
|
3605
3759
|
| `moduleName` | `string` | 否 | 触发器上显示的当前模块名 |
|
|
3606
3760
|
| `modules` | `ModuleItem[]` | 否 | 可切换的模块集合 |
|
|
3607
3761
|
| `currentModule` | `string` | 否 | 当前模块值。点击它不触发 `onSelect` |
|
|
3608
|
-
| `glyph` | `ReactNode` | 否 | 触发器图标块内的字形,18px |
|
|
3609
3762
|
| `open` | `boolean` | 否 | 受控面板开合 |
|
|
3610
3763
|
| `onOpenChange` | `(open: boolean) => void` | 否 | 面板开合变化回调 |
|
|
3611
3764
|
| `onSelect` | `(value: string) => void` | 否 | 模块选中回调。点击当前模块不触发 |
|
|
@@ -3633,11 +3786,12 @@ Standard 最小宽 168 / 高 40,Compact 148 / 32;
|
|
|
3633
3786
|
- 跨应用(而非跨模块)跳转:改用 `TopNavigationPrimaryBar` 的 `onAppSwitch`,条目用 `SidebarAppLinkButton`。
|
|
3634
3787
|
- 工作台的图标菜单栏:改用 `GlobalSidebar`;Content Canvas 内的通用垂直导航:改用 `Sidebar`。
|
|
3635
3788
|
|
|
3636
|
-
**组合约定。** `open` 与 `onOpenChange` 必须成对提供 —— 触发器点击只调用 `onOpenChange`,不提供该回调时面板永远无法打开。`currentModule` 必须命中 `modules` 中的一项。点击当前模块既不触发 `onSelect` 也不关闭面板;路由计算由调用方在 `onSelect`
|
|
3789
|
+
**组合约定。** `open` 与 `onOpenChange` 必须成对提供 —— 触发器点击只调用 `onOpenChange`,不提供该回调时面板永远无法打开。`currentModule` 必须命中 `modules` 中的一项。点击当前模块既不触发 `onSelect` 也不关闭面板;路由计算由调用方在 `onSelect` 中完成,组件不做任何跳转。几何按 GAP Design kit「应用二级模块切换」:触发器 168×48(Compact 148×40)、内边距 4/12、没有图标块,模块名 16/20 medium,20px chevron 右对齐,右侧 0.5px 分隔线,悬停与展开时 6% 淡底;面板挂在触发器正下方,与触发器同宽 168(最窄 128),内边距 4、条目间隔 2,限高到视口底、自身滚动;条目 40 高、内边距 8/12、圆角 12,悬停取导航背景,当前模块为强调色 semibold 加 14px 对勾。几何由 Shell token 决定,调用方不得改写。`ModuleItem.icon` 可选,kit 的模块条目不带图标,需要时走 `Icon`。键盘按 menu button 模式:打开即聚焦首个可用模块(触发器上按 ↑ 打开则聚焦末项),↑ / ↓ / Home / End 在模块间移动;Esc、外部点击与 Tab 都经 `onOpenChange(false)` 收起,Esc 后焦点回到触发器 —— 调用方不得再自行监听 Esc 或外部点击。
|
|
3637
3790
|
|
|
3638
3791
|
**禁止 / 使用边界。**
|
|
3639
3792
|
- 不得把触发器简化成一个小图标,也不得在窄屏下移除它。
|
|
3640
|
-
- 禁止给面板加圆角、阴影或遮罩 —— 它只有 1px
|
|
3793
|
+
- 禁止给面板加圆角、阴影或遮罩 —— 它只有 1px 右边线,是从触发器垂下的一截而非浮起的卡片。
|
|
3794
|
+
- 不得给触发器加回图标块,也不得把面板做成贴视口的整高侧板。
|
|
3641
3795
|
- 不得把本组件放到 `ApplicationSecondaryNavigation` 之外的位置。
|
|
3642
3796
|
- 不得由本组件承担路由跳转,`onSelect` 只是通知。
|
|
3643
3797
|
- 不得用它切换应用、切换页面模式或切换业务视图。
|
|
@@ -3646,75 +3800,111 @@ Standard 最小宽 168 / 高 40,Compact 148 / 32;
|
|
|
3646
3800
|
|
|
3647
3801
|
`import { ApplicationPrimaryNavigation } from '@moheng-design/ui'` · 契约 `contracts/application-module/navigation/application-primary-navigation.ts`
|
|
3648
3802
|
|
|
3649
|
-
`APPLICATION.PRIMARY_NAV` ——
|
|
3650
|
-
Standard
|
|
3803
|
+
`APPLICATION.PRIMARY_NAV` —— GAP Design kit「通用导航 / 应用一级导航」。
|
|
3804
|
+
Standard 48px / Compact 40px,内边距 8/12。
|
|
3651
3805
|
|
|
3652
|
-
|
|
3653
|
-
名称 16/24 **700**,说明 12/16 400(Compact 档隐藏)。
|
|
3806
|
+
外壳有两种形态(kit「导航组合」):
|
|
3654
3807
|
|
|
3655
|
-
|
|
3656
|
-
|
|
3808
|
+
| 形态 | 带 | 总高 |
|
|
3809
|
+
|---|---|---:|
|
|
3810
|
+
| 基础版 | 本带 + `ApplicationSecondaryNavigation` | 96 |
|
|
3811
|
+
| 集团版 | `TopNavigationPrimaryBar` + 本带 + `ApplicationSecondaryNavigation` | 144 |
|
|
3812
|
+
|
|
3813
|
+
**左侧**:应用身份 —— 32×32 logo 瓦片(8px 圆角,8% 强调色混入表面色)+ 4px 间隙 +
|
|
3814
|
+
应用名 14/20 regular 文字1。kit 里没有应用说明行。
|
|
3657
3815
|
|
|
3658
3816
|
**右侧**:**恰好这五个已登记全局动作,且顺序固定**:
|
|
3659
3817
|
|
|
3660
|
-
消息 → 待办 →
|
|
3818
|
+
消息 → 待办 → 总览 → 风险预警 → 设置
|
|
3661
3819
|
|
|
3662
|
-
32
|
|
3663
|
-
|
|
3820
|
+
每个动作是「18px 字形 + 文字」:32 高,左右 10,字形与文字间隔 4,圆角 12,文字 14/20 文字2;
|
|
3821
|
+
动作之间 4px。前四个打开共享 Popover;**设置不弹浮层**,而是让 `ApplicationSecondaryNavigation`
|
|
3822
|
+
整带换成设置模块(kit「框架结构 / 结构=设置」:模块切换器显示设置模块名,标签换成设置项,
|
|
3823
|
+
最右的「导航设置」按钮换成关闭叉号)。
|
|
3824
|
+
基础版传 `account` 时,头像(24×24 圆形)在动作组之后,间隔 8px。
|
|
3664
3825
|
|
|
3665
3826
|
#### ⚠ 硬性约束
|
|
3666
3827
|
- **绝不渲染第二个设置入口**
|
|
3667
3828
|
- logo 瓦片是 8% 强调色混入表面色,**绝不是饱和强调色块**
|
|
3668
|
-
- Compact
|
|
3829
|
+
- Compact 档必须保留 logo、名称与全部五个动作入口
|
|
3669
3830
|
|
|
3670
3831
|
**Props**
|
|
3671
3832
|
|
|
3672
3833
|
| prop | 类型 | 必填 | 说明 |
|
|
3673
3834
|
|---|---|:---:|---|
|
|
3674
|
-
| `appName` | `string` | 否 | 应用名称,
|
|
3675
|
-
| `
|
|
3676
|
-
| `appGlyph` | `IconName` | 否 | 应用 logo mock 字形的图标名(24px),默认 `'shield-check'`。 与 `<Icon name>` 同为已登记字形名(05 · P1-6),清单外的名字在类型层被拒 |
|
|
3835
|
+
| `appName` | `string` | 否 | 应用名称,14/20 regular。mock 文案登记为「示例应用」 |
|
|
3836
|
+
| `appGlyph` | `IconName` | 否 | 应用 logo mock 字形的图标名(20px),默认 `'shield-check'`。 与 `<Icon name>` 同为已登记字形名(05 · P1-6),清单外的名字在类型层被拒 |
|
|
3677
3837
|
| `activeAction` | `GlobalActionKey` | 否 | 当前激活的全局动作面板 |
|
|
3678
3838
|
| `actionBadges` | `Partial<Record<GlobalActionKey, boolean>>` | 否 | 各动作的未读圆点 |
|
|
3679
|
-
| `onAction` | `(key: GlobalActionKey, kind:
|
|
3680
|
-
| `
|
|
3839
|
+
| `onAction` | `(key: GlobalActionKey, kind: GlobalActionKind) => void` | 否 | 动作点击回调。`kind` 指明该动作的承载:`'popover'` 打开共享的 `ApplicationGlobalActionPanel`, `'module'`(只有设置)把 `ApplicationSecondaryNavigation` 换成设置模块 |
|
|
3840
|
+
| `account` | `ApplicationPrimaryNavigationAccount` | 否 | 基础版外壳的账户入口。传入即在动作组之后渲染头像;集团版外壳(渲染了 `TopNavigationPrimaryBar`)不得传,否则一个外壳里会有两个账户入口 |
|
|
3681
3841
|
|
|
3682
3842
|
继承 `HTMLAttributes<HTMLDivElement>` 的全部原生属性。
|
|
3683
3843
|
|
|
3684
|
-
|
|
3844
|
+
**`ApplicationPrimaryNavigationAccount`**
|
|
3845
|
+
|
|
3846
|
+
基础版外壳里本带承载的账户入口(GAP Design kit「导航组合 / 基础版本」:用户头像在应用一级
|
|
3847
|
+
导航的最右端)。集团版外壳的账户入口在 `TopNavigationPrimaryBar`,此时不传本项。
|
|
3848
|
+
|
|
3849
|
+
| prop | 类型 | 必填 | 说明 |
|
|
3850
|
+
|---|---|:---:|---|
|
|
3851
|
+
| `name` | `string` | 否 | 账户名。同时是头像按钮的可访问名与缩写来源,缩写规则与 `Avatar` 相同 —— 中文取末字(「成员 A」→「A」),拉丁名取首字母(07 · C-8)。缺省时头像显示「账」 |
|
|
3852
|
+
| `open` | `boolean` | 否 | 账户面板是否展开。传入(含 `false`)即输出 `aria-haspopup="dialog"` 与 `aria-expanded`; 缺省时两者都不输出。面板内容根应声明 `role="dialog"` 与可访问名 |
|
|
3853
|
+
| `onToggle` | `(trigger: HTMLButtonElement) => void` | 否 | 头像点击回调。参数是被点的触发器,传给 `Popover` 的 `anchor` 锚定; 回调里切换开合并回写 `open`(与 `TopNavigationPrimaryBar.onAccount` 同一接法) |
|
|
3685
3854
|
|
|
3686
|
-
|
|
3855
|
+
**用途。** Shell 的应用一级导航带 `APPLICATION.PRIMARY_NAV`(GAP Design kit「应用一级导航」),左侧是当前应用的身份,右侧是五个已登记全局动作的入口;基础版外壳里账户头像也在这一带的最右端。
|
|
3856
|
+
|
|
3857
|
+
**何时使用。** 应用外壳必须渲染一条本组件:基础版里它是第一带,集团版里它在 `TopNavigationPrimaryBar` 之下。它是全局动作(消息、待办、总览、风险预警、设置)在整个产品中的唯一入口位置。应用级、跨页面、与当前业务页面无关的动作放在这里;只与当前页面有关的动作一律不放。
|
|
3687
3858
|
|
|
3688
3859
|
**何时改用其他组件。**
|
|
3689
3860
|
- 页面级动作组(新建 / 导入 / 导出 / 更多、刷新):改用 `ApplicationPageHeader` 的动作槽位,按钮用 `SystemButton`。
|
|
3690
3861
|
- 搜索、常用筛选、排序、列设置:改用 `ApplicationQueryToolbar`。
|
|
3691
3862
|
- 模块切换与业务标签:改用 `ApplicationSecondaryNavigation`。
|
|
3692
|
-
- 前四个动作打开的浮层内容:改用 `ApplicationGlobalActionPanel
|
|
3863
|
+
- 前四个动作打开的浮层内容:改用 `ApplicationGlobalActionPanel`;设置打开的设置模块:改用 `ApplicationSecondaryNavigation`(传 `onCloseSettings`)。
|
|
3693
3864
|
|
|
3694
|
-
**组合约定。** 五个动作及其顺序(消息 → 待办 →
|
|
3865
|
+
**组合约定。** 五个动作及其顺序(消息 → 待办 → 总览 → 风险预警 → 设置)固化在实现内部,不接受外部传入,「已登记」即指此。`onAction` 的第二个参数 `kind`(`GlobalActionKind`)指明该动作的承载:四个 `popover` 动作必须共用同一个 `ApplicationGlobalActionPanel` 实例,一个面板四套内容;设置是唯一的 `module` 动作,调用方据此把 `ApplicationSecondaryNavigation` 换成设置模块并传 `onCloseSettings`(GAP Design kit「框架结构 / 结构=设置」),不打开任何浮层。`activeAction` 与 `onAction` 必须成对使用:设置模块开着时 `activeAction` 为 `'settings'`,设置动作随之带激活态;`activeAction` 只对 popover 动作产生 `aria-expanded`。`actionBadges` 的键只能取五个已登记动作键,且它只表达「有未读」而不表达数量。`appGlyph` 取图标 `registry.json` 中已登记的字形名(20px),类型与 `<Icon name>` 同为 `IconName`。几何按 kit:48 高(Compact 40)、内边距 8/12;logo 瓦片 32×32、圆角 8,应用名 14/20 regular,没有应用说明行;每个动作是「18px 字形 + 文字」,32 高、左右 10、圆角 12,文字 14/20 二级文字色,动作之间 4px。动作文字常显,不内置 `Tooltip`,调用方也不得再为它们包一层。基础版外壳传 `account`(`name` / `open` / `onToggle`),头像 24×24 圆形接在动作组之后 8px,面板接法与 `TopNavigationPrimaryBar.onAccount` 相同:`onToggle` 的参数是触发器,传给 `Popover` 的 `anchor`;集团版不得传 `account`。本带自持内边距与 0.5px 底部分隔线,宿主不得再加外边距。
|
|
3695
3866
|
|
|
3696
3867
|
**禁止 / 使用边界。**
|
|
3697
3868
|
- 禁止渲染第二个设置入口,无论它出现在本带、账户菜单还是页面内。
|
|
3698
3869
|
- 不得增加、删除或重排五个全局动作,也不得把其中任意一个折叠进「更多」。
|
|
3699
3870
|
- 不得把 logo 瓦片画成饱和强调色块 —— 它是 8% 强调色混入表面色的淡底。
|
|
3871
|
+
- 不得把五个动作改回纯图标,也不得在 Compact 档隐去它们的文字。
|
|
3700
3872
|
- 不得为每个全局动作各造一个浮层,四个 popover 动作共用同一个面板。
|
|
3873
|
+
- 不得把设置接到 `Drawer`、`Sheet` 或 `ApplicationGlobalActionPanel` —— 它是二级导航里的设置模块。
|
|
3701
3874
|
- 不得在本带承载页面标题、页面动作或数据控制。
|
|
3702
3875
|
|
|
3703
3876
|
### ApplicationSecondaryNavigation
|
|
3704
3877
|
|
|
3705
3878
|
`import { ApplicationSecondaryNavigation } from '@moheng-design/ui'` · 契约 `contracts/application-module/navigation/application-secondary-navigation.ts`
|
|
3706
3879
|
|
|
3707
|
-
`APPLICATION.SECONDARY_NAV` ——
|
|
3708
|
-
Standard 48px / Compact 40px。
|
|
3880
|
+
`APPLICATION.SECONDARY_NAV` —— GAP Design kit「应用二级导航」,外壳的最后一带
|
|
3881
|
+
(基础版第二带、集团版第三带)。Standard 48px / Compact 40px,右侧内边距 12。
|
|
3882
|
+
|
|
3883
|
+
**左侧**:完整的模块切换器,贴左缘。**中间**:当前模块的业务标签,间隔 8。
|
|
3884
|
+
**最右**:一枚已登记的 32×32 纯图标按钮 —— 平时是「导航设置」,设置模块打开时是「关闭设置」。
|
|
3885
|
+
|
|
3886
|
+
#### 尾部按钮(kit「二级导航设置」24:134 与「结构=设置」230:1104)
|
|
3887
|
+
32×32、圆角 12、透明底,悬停是 6% 文字色淡底。两种形态互斥,同一时刻至多一枚:
|
|
3888
|
+
|
|
3889
|
+
| 形态 | 何时渲染 | 字形 | 可访问名 |
|
|
3890
|
+
|---|---|---|---|
|
|
3891
|
+
| 导航设置 | 传了 `onNavigationSettings`,且未传 `onCloseSettings` | 16px `sliders-horizontal`,文字2 | 「导航设置」 |
|
|
3892
|
+
| 关闭设置 | 传了 `onCloseSettings` | 16px 叉号,文字1 | 「关闭设置」 |
|
|
3893
|
+
|
|
3894
|
+
两个回调都不传时不渲染,也不占位。
|
|
3709
3895
|
|
|
3710
|
-
|
|
3896
|
+
#### 设置模块
|
|
3897
|
+
全局动作「设置」不弹抽屉:它让本带整体换成设置模块 —— `moduleSwitcher` 显示设置模块名,
|
|
3898
|
+
`tabs` 换成设置项,同时传 `onCloseSettings`,尾部按钮随之变为关闭叉号,根元素输出
|
|
3899
|
+
`data-mode="settings"`。关闭时由调用方把模块切换器、标签与 `value` 换回进入设置前的那一组。
|
|
3711
3900
|
|
|
3712
3901
|
#### ⚠ 每个标签都是「图标 + 文字」
|
|
3713
3902
|
图标在左、可见文字在右。**纯文字标签被禁止**,
|
|
3714
3903
|
**为适应窄屏而丢弃全部图标同样被禁止** —— 标签保持单行并横向滚动,绝不换行。
|
|
3715
3904
|
|
|
3716
|
-
标签几何:32px 高,内边距 6/12,文字 14/20。
|
|
3717
|
-
激活态是已登记的 **2px
|
|
3905
|
+
标签几何:32px 高,内边距 6/12,文字 14/20 文字2。
|
|
3906
|
+
激活态是已登记的 **2px 下划线**(两端各缩进 12,贴标签底边)加强调色 medium 文字,
|
|
3907
|
+
绝不是 pill 背景;悬停是 6% 文字色淡底、圆角 12,文字不变色。
|
|
3718
3908
|
图标容器宽度固定,使字重变化不会横向推移文字。
|
|
3719
3909
|
|
|
3720
3910
|
#### ⚠ 本带不得承载
|
|
@@ -3730,6 +3920,9 @@ Page Mode、Business View、搜索、筛选、对象动作、页面级主操作
|
|
|
3730
3920
|
| `tabs` | `SecondaryNavTab[]` | 否 | 业务标签集合 |
|
|
3731
3921
|
| `value` | `string` | 否 | 当前标签 |
|
|
3732
3922
|
| `onValueChange` | `(value: string) => void` | 否 | 标签变化回调 |
|
|
3923
|
+
| `onNavigationSettings` | `(event: MouseEvent<HTMLButtonElement>) => void` | 否 | 「导航设置」按钮的点击回调(kit「二级导航设置」)。传入即在本带最右端渲染该按钮; 不传即不渲染、不占位。参数是点击事件,`event.currentTarget` 即按钮元素,可传给 `Popover` 的 `anchor` 锚定面板,也是面板关闭后焦点的归还目标。 设置模块打开时(传了 `onCloseSettings`)本按钮不渲染 —— 那个位置换成关闭叉号 |
|
|
3924
|
+
| `navigationSettingsOpen` | `boolean` | 否 | 导航设置面板是否展开。传入(含 `false`)即在按钮上输出 `aria-haspopup="dialog"` 与 `aria-expanded`;缺省时两者都不输出。应与 `onNavigationSettings` 成对提供, 面板内容根相应声明 `role="dialog"` 与可访问名 |
|
|
3925
|
+
| `onCloseSettings` | `(event: MouseEvent<HTMLButtonElement>) => void` | 否 | 设置模块的关闭回调(kit「框架结构 / 结构=设置」)。传入即声明本带当前承载的是设置模块: 最右端渲染关闭叉号(可访问名「关闭设置」)取代「导航设置」按钮,根元素输出 `data-mode="settings"`。回调里由调用方换回进入设置前的模块切换器、`tabs` 与 `value` |
|
|
3733
3926
|
|
|
3734
3927
|
继承 `HTMLAttributes<HTMLDivElement>` 的全部原生属性。
|
|
3735
3928
|
|
|
@@ -3744,9 +3937,9 @@ Page Mode、Business View、搜索、筛选、对象动作、页面级主操作
|
|
|
3744
3937
|
| `icon` | `ReactNode` | 是 | 前置图标,**契约要求必填** —— 每个业务标签都是「图标 + 文字」。 必须来自已登记字形集:绝不用 Emoji、绝不用系统字体符号。 图标的业务含义必须稳定 —— 不得在 hover 或 active 时换成另一含义的字形。 |
|
|
3745
3938
|
| `disabled` | `boolean` | 否 | 禁用。禁用作用于整个标签,不得只禁文字而留图标可点 |
|
|
3746
3939
|
|
|
3747
|
-
**用途。** Shell
|
|
3940
|
+
**用途。** Shell 的应用二级导航带 `APPLICATION.SECONDARY_NAV`(GAP Design kit「应用二级导航」),左侧是完整的模块切换器,中间是当前模块的业务标签,最右是一枚已登记的尾部按钮 —— 平时是「导航设置」,设置模块里是「关闭设置」。
|
|
3748
3941
|
|
|
3749
|
-
**何时使用。**
|
|
3942
|
+
**何时使用。** 应用外壳必须在 `ApplicationPrimaryNavigation` 之下渲染一条本组件,它是外壳的最后一带。标签表达的是「当前模块内的功能分区」,其集合随模块切换而整体更换。标签数量与内容由模块决定,不由页面决定。全局动作「设置」打开时,本带整体换成设置模块(GAP Design kit「框架结构 / 结构=设置」):模块切换器显示设置模块名,标签换成设置项,尾部按钮变为关闭叉号 —— 设置不进任何抽屉、侧板或弹窗。
|
|
3750
3943
|
|
|
3751
3944
|
**何时改用其他组件。**
|
|
3752
3945
|
- 页面区域内的局部标签页(详情分节、SPLIT 右栏内容标签):改用 `Tabs`,那里图标是可选的。
|
|
@@ -3754,11 +3947,14 @@ Page Mode、Business View、搜索、筛选、对象动作、页面级主操作
|
|
|
3754
3947
|
- Page Mode Switch:改用 `ApplicationPageHeader`。
|
|
3755
3948
|
- 不强制图标的水平导航基元:改用 `NavigationMenu`。
|
|
3756
3949
|
- Content Canvas 内的垂直导航:改用 `Sidebar`。
|
|
3950
|
+
- 导航设置打开的面板:改用 `Popover`,以 `onNavigationSettings` 交出的按钮为锚点。
|
|
3757
3951
|
|
|
3758
|
-
**组合约定。** `moduleSwitcher` 槽位只接 `ApplicationModuleSwitcher`,不得传入 `Select`、`DropdownMenu` 或自制触发器。`SecondaryNavTab.icon` 在契约中是必填字段,图标必须来自已登记字形并通过 `Icon` 渲染,且其业务含义在 hover 与 active 下保持不变。`value` 与 `onValueChange` 必须成对使用;`tabs` 非空时 `value` 必须命中其中一项。切换模块时必须同时更换 `tabs` 与 `value
|
|
3952
|
+
**组合约定。** `moduleSwitcher` 槽位只接 `ApplicationModuleSwitcher`,不得传入 `Select`、`DropdownMenu` 或自制触发器。`SecondaryNavTab.icon` 在契约中是必填字段,图标必须来自已登记字形并通过 `Icon` 渲染,且其业务含义在 hover 与 active 下保持不变。`value` 与 `onValueChange` 必须成对使用;`tabs` 非空时 `value` 必须命中其中一项。切换模块时必须同时更换 `tabs` 与 `value`,不得让上一个模块的标签残留。标签行保持单行并横向滚动,滚动条已隐藏,调用方不得在外层再包一层滚动容器。标签图标取 16px 档。几何按 kit:48 高(Compact 40),模块切换器贴左缘、右侧内边距 12,标签间隔 8;标签 32 高、内边距 6/12、文字 14/20 二级文字色;激活态为强调色 medium 文字加 2px 下划线(两端各缩进 12,贴标签底边);悬停为 6% 文字色淡底、圆角 12,文字不变色。激活态的下划线由组件绘制,调用方不得通过 `className` 叠加背景或边框。本带自持内边距与 0.5px 底部分隔线,宿主不得再加外边距。尾部按钮只有两种已登记形态,由回调决定,同一时刻至多一枚:传 `onNavigationSettings` 渲染「导航设置」(kit「二级导航设置」:32×32、圆角 12、透明底、16px `sliders-horizontal` 取二级文字色、悬停 6% 淡底,可访问名与提示「导航设置」),回调参数是点击事件,`event.currentTarget` 即 `Popover` 的锚点,面板开合回写 `navigationSettingsOpen`,按钮据此输出 `aria-haspopup="dialog"` 与 `aria-expanded`;传 `onCloseSettings` 即声明本带承载的是设置模块,尾部换成同一几何的关闭叉号(主要文字色,可访问名与提示「关闭设置」),根元素带 `data-mode="settings"`,此时不渲染导航设置。两个回调都不传时不渲染、不占位。设置模块由调用方组装:`ApplicationPrimaryNavigation` 的 `onAction` 收到 `kind='module'` 时,`moduleSwitcher` 照旧传 `ApplicationModuleSwitcher`(`moduleName` 为设置模块名、`modules` 为设置模块清单),`tabs` 换成设置项(同样必须带图标),`activeAction` 置为 `'settings'`,Content Canvas 渲染当前设置项的页面;`onCloseSettings` 里把模块切换器、`tabs` 与 `value` 换回进入设置前的那一组,并清掉 `activeAction`。
|
|
3759
3953
|
|
|
3760
3954
|
**禁止 / 使用边界。**
|
|
3761
3955
|
- 不得在本带承载 Page Mode、Business View、搜索、筛选、对象动作或页面级主操作。
|
|
3956
|
+
- 不得往尾部按钮的位置放其他元素 —— 它只有「导航设置」与「关闭设置」两种已登记形态。
|
|
3957
|
+
- 禁止把设置做成 `Drawer`、`Sheet` 或弹窗,也禁止在设置模块里省掉关闭叉号。
|
|
3762
3958
|
- 禁止纯文字标签,也禁止为适应窄屏而丢弃全部图标。
|
|
3763
3959
|
- 不得让标签换行 —— 单行横向滚动是已登记行为。
|
|
3764
3960
|
- 不得把激活态改成 pill 背景,激活态是已登记的 2px 下划线。
|
|
@@ -3815,7 +4011,7 @@ Content Canvas 内的通用垂直导航请用 Foundation `Sidebar`;
|
|
|
3815
4011
|
**组合约定。** `items` 是数据而非元素 —— 组件内部渲染 `SidebarRailButton` 并自行控制 `active` 与点击,调用方不得先构造好按钮元素再传入。`GlobalSidebarEntry.label` 在类型上可选,在规范上必填:规范禁止纯图标导航项,只给 `icon` 不给 `label` 能通过类型检查但不合规。`icon` 的登记尺寸是 20px,走 `Icon`。`separator` 为 true 时其余字段被忽略,但该条目的 `key` 仍必须在栏内唯一。`value` 与 `onValueChange` 成对使用。`footer` 被推到栏底,与条目之间不需要额外间隔元素;栏底的入口(如「设置」)直接放 `SidebarRailButton`(07 · C-15)。本组件自持内边距与右侧 1px 边线,宿主用 flex 把它与内容区并排即可(写法见 SKILL.md「五层 Canvas 模型 · 宿主布局」),不得再加外边距。
|
|
3816
4012
|
|
|
3817
4013
|
**禁止 / 使用边界。**
|
|
3818
|
-
- 不得把本组件当作应用外壳的全局左栏 —— Shell
|
|
4014
|
+
- 不得把本组件当作应用外壳的全局左栏 —— Shell 是刻意设计的无侧栏、全宽导航带堆叠。
|
|
3819
4015
|
- 不得给本组件设置 `position: fixed` 或让它跨出 Content Canvas。
|
|
3820
4016
|
- 禁止渲染只有图标而没有标签的条目。
|
|
3821
4017
|
- 不得用它替代 `Sidebar` 承载带分组标题的多层导航。
|
|
@@ -3824,15 +4020,21 @@ Content Canvas 内的通用垂直导航请用 Foundation `Sidebar`;
|
|
|
3824
4020
|
|
|
3825
4021
|
`import { TopNavigationPrimaryBar } from '@moheng-design/ui'` · 契约 `contracts/application-module/navigation/top-navigation-primary-bar.ts`
|
|
3826
4022
|
|
|
3827
|
-
`PLATFORM.TOP_USER_BAR` ——
|
|
3828
|
-
|
|
4023
|
+
`PLATFORM.TOP_USER_BAR` —— GAP Design kit「集团顶部导航」,**只在集团版外壳出现**
|
|
4024
|
+
(本带 + 应用一级 + 应用二级,共 144)。基础版外壳不渲染本组件,账户入口由
|
|
4025
|
+
`ApplicationPrimaryNavigation` 的 `account` 承载。
|
|
4026
|
+
Standard 48px / Compact 40px,**没有第三种高度**;内边距 8/12,底部 0.5px 分隔线。
|
|
3829
4027
|
|
|
3830
|
-
|
|
3831
|
-
|
|
4028
|
+
渲染本组件时,其 CSS 在 `:root` 上把 `--ui-shell-top-bar-offset` 抬到本带高度,
|
|
4029
|
+
`--ui-shell-application-total-height` 随之计入本带 —— 宿主不必区分两种外壳。
|
|
4030
|
+
|
|
4031
|
+
栅格 `auto minmax(0,1fr) auto`;应用切换触发器 32×32、圆角 12,账户头像 24×24 圆形
|
|
4032
|
+
(32×32 命中区),动作簇间距 10px,右边距 12px。
|
|
3832
4033
|
|
|
3833
4034
|
#### ⚠ 品牌标识必须始终可见
|
|
3834
|
-
|
|
3835
|
-
**
|
|
4035
|
+
品牌区按 GAP Design kit「集团顶部导航」(24:249):
|
|
4036
|
+
**36×36 图形 + 8px 间隙 + 企业名称(20/30 semibold)**,宽度按内容。
|
|
4037
|
+
名称恒为可见文字;图形位放 `brandLogoSrc`,缺省时渲染已登记的 mock 纯色块。
|
|
3836
4038
|
色块内部**不得**再绘制伪 Logo。
|
|
3837
4039
|
|
|
3838
4040
|
#### ⚠ Shell 契约禁止添加未登记元素
|
|
@@ -3850,7 +4052,7 @@ Standard 52px / Compact 44px,**没有第三种高度**。
|
|
|
3850
4052
|
| prop | 类型 | 必填 | 说明 |
|
|
3851
4053
|
|---|---|:---:|---|
|
|
3852
4054
|
| `brandName` | `string` | 否 | 企业名称。mock 兜底文案登记为「企业名称」 |
|
|
3853
|
-
| `brandLogoSrc` | `string` | 否 |
|
|
4055
|
+
| `brandLogoSrc` | `string` | 否 | 品牌图形地址,按 36×36 渲染(`object-fit: contain`),与 `brandName` 并排; 图形是装饰,可访问名由旁边的名称文字承担。缺省时图形位回退到已登记 mock 色块。 传的是图形标(kit 里的 36px 图形),不是含企业名的横版字标 —— 名称由组件以文字渲染, 再传字标会让名字出现两遍 |
|
|
3854
4056
|
| `center` | `ReactNode` | 否 | 中间区域内容。默认为空 —— 加东西前请确认它是已登记元素 |
|
|
3855
4057
|
| `accountName` | `string` | 否 | 账户名。同时是账户按钮的可访问名与头像缩写的来源;缩写规则与 `Avatar` 相同 —— 中文取末字(「成员 A」→「A」),拉丁名取首字母(07 · C-8)。缺省时头像显示「账」 |
|
|
3856
4058
|
| `onAppSwitch` | `(trigger: HTMLButtonElement) => void` | 否 | 应用切换回调。参数是被点的触发器,供 `Popover` 的 `anchor` 锚定; 不需要锚定的调用方照旧写无参函数 |
|
|
@@ -3860,9 +4062,9 @@ Standard 52px / Compact 44px,**没有第三种高度**。
|
|
|
3860
4062
|
|
|
3861
4063
|
继承 `HTMLAttributes<HTMLDivElement>` 的全部原生属性。
|
|
3862
4064
|
|
|
3863
|
-
**用途。**
|
|
4065
|
+
**用途。** 集团版外壳的最上一带 `PLATFORM.TOP_USER_BAR`(GAP Design kit「集团顶部导航」),承载集团级身份(品牌)、应用切换与账户入口,跨全部应用与全部页面不变。
|
|
3864
4066
|
|
|
3865
|
-
**何时使用。**
|
|
4067
|
+
**何时使用。** 外壳有两种形态:基础版是「应用一级导航 + 应用二级导航」两带共 96px,不渲染本组件;集团版在两带之上再加本组件,三带共 144px。产品需要跨应用切换与集团品牌时用集团版,此时一个外壳必须且只能渲染一条本组件。它表达的是「用户在哪个集团、以什么身份」,与当前打开的是哪个应用、哪个模块、哪个页面全部无关。凡是随应用切换而变化的内容,均不属于本带。
|
|
3866
4068
|
|
|
3867
4069
|
**何时改用其他组件。**
|
|
3868
4070
|
- 应用身份(logo、应用名、应用说明)与五个全局动作:改用 `ApplicationPrimaryNavigation`。
|
|
@@ -3871,13 +4073,14 @@ Standard 52px / Compact 44px,**没有第三种高度**。
|
|
|
3871
4073
|
- 层级回溯路径:改用 `Breadcrumb`,且只能出现在上下文区。
|
|
3872
4074
|
- 跨应用跳转的条目:改用 `SidebarAppLinkButton` 渲染在 `onAppSwitch` 打开的面板内。
|
|
3873
4075
|
|
|
3874
|
-
**组合约定。** 本带高度由 `--ui-shell-primary-height` 决定(Standard
|
|
4076
|
+
**组合约定。** 本带高度由 `--ui-shell-primary-height` 决定(Standard 48px / Compact 40px),只有这两档;调用方不得用 `className` 或行内样式改高。导航带的固定与层级由宿主布局承担(标准宿主 CSS 见 SKILL.md「五层 Canvas 模型 · 宿主布局」),组件本身按普通流元素渲染并输出 `data-shell-slot="top-navigation"` 供布局定位;堆叠总高读 `--ui-shell-application-total-height`,Content Canvas 据此让位 —— 本组件在场时它的 CSS 把 `--ui-shell-top-bar-offset` 计入总高(96 → 144),宿主不必区分两种外壳。集团版的账户入口只在本带,`ApplicationPrimaryNavigation` 不得再传 `account`。本带自持左右内边距与 0.5px 底部分隔线,宿主不得再加外边距。品牌区按 GAP Design kit「集团顶部导航」:36×36 图形 + 8px 间隙 + `brandName`(20/30 semibold),宽度按内容;名称恒以文字渲染,图形位放 `brandLogoSrc`(图形标,按 36×36 `contain` 渲染,是装饰,`alt` 为空),缺省时自动回退到已登记 mock 纯色块 —— 不得传含企业名的横版字标,那会让名字出现两遍;提供 `onAccount` 时应一并提供 `accountName`,账户按钮的可访问名与头像缩写均取自它,缩写规则与 `Avatar` 相同(中文取末字,「成员 A」→「A」;拉丁名取首字母)。`center` 默认为空,写入内容前必须确认该元素在 Shell 契约中已登记。 应用切换与账户两个面板用 `Popover` 承载:`onAppSwitch` / `onAccount` 的参数是被点的触发器,必须传给 `Popover` 的 `anchor` 锚定,不得另放空锚点凑位置;开合由调用方受控,回调里切换开合(再点触发器即收起),并把同一份状态回写到 `appSwitchOpen` / `accountOpen`,触发器据此输出 `aria-haspopup="dialog"` 与 `aria-expanded`,面板内容根相应声明 `role="dialog"` 与可访问名。
|
|
3875
4077
|
|
|
3876
4078
|
**禁止 / 使用边界。**
|
|
3877
4079
|
- 不得在本带内加入搜索框、面包屑、通知铃铛、页面标题、卡片或阴影 —— Shell 契约禁止添加未登记元素。
|
|
3878
|
-
- 禁止在
|
|
4080
|
+
- 禁止在 36×36 纯色块内部再绘制伪 Logo,该色块是占位而非标识。
|
|
3879
4081
|
- 不得出现第三种高度,也不得随 Condensed 档改变高度。
|
|
3880
4082
|
- 不得在一个页面内渲染第二条本组件,也不得把它嵌进 Content Canvas。
|
|
4083
|
+
- 不得在基础版外壳里渲染本组件来承载账户入口 —— 基础版的账户入口是 `ApplicationPrimaryNavigation` 的 `account`。
|
|
3881
4084
|
|
|
3882
4085
|
## Application Module · statistics
|
|
3883
4086
|
|
|
@@ -3907,7 +4110,8 @@ MetricStrip 内置的基础指标条目(numeric / icon 语义)
|
|
|
3907
4110
|
|---|---|:---:|---|
|
|
3908
4111
|
| `key` | `string` | 否 | React key。**应显式提供** —— 见 M2 |
|
|
3909
4112
|
| `label` | `ReactNode` | 是 | 指标名,12/16 label 色 |
|
|
3910
|
-
| `value` | `ReactNode` | 是 | 指标值,
|
|
4113
|
+
| `value` | `ReactNode` | 是 | 指标值,32/32 semibold,等宽数字 |
|
|
4114
|
+
| `description` | `ReactNode` | 否 | 口径说明,渲染在数值下方一行,12/16 次要文字色。例如「2026 年 · 不含已冲红」。 只写统计口径(时间范围、包含与排除),**不得**写趋势、环比或操作提示 —— 变化量用 `ApplicationMetricTrend`,操作入口不属于只读的指标卡。 |
|
|
3911
4115
|
| `unit` | `string` | 否 | 单位,紧随数值以 12px regular 显示 |
|
|
3912
4116
|
| `icon` | `ReactNode` | 否 | 图标。提供时语义从 `numeric` 变为 `icon`,渲染 32px 淡强调色方块 |
|
|
3913
4117
|
|
|
@@ -3965,7 +4169,8 @@ MetricStrip 内置的基础指标条目(numeric / icon 语义)
|
|
|
3965
4169
|
|---|---|:---:|---|
|
|
3966
4170
|
| `key` | `string` | 否 | React key。**应显式提供** —— 见 M2 |
|
|
3967
4171
|
| `label` | `ReactNode` | 是 | 指标名,12/16 label 色 |
|
|
3968
|
-
| `value` | `ReactNode` | 是 | 指标值,
|
|
4172
|
+
| `value` | `ReactNode` | 是 | 指标值,32/32 semibold,等宽数字 |
|
|
4173
|
+
| `description` | `ReactNode` | 否 | 口径说明,渲染在数值下方一行,12/16 次要文字色。例如「2026 年 · 不含已冲红」。 只写统计口径(时间范围、包含与排除),**不得**写趋势、环比或操作提示 —— 变化量用 `ApplicationMetricTrend`,操作入口不属于只读的指标卡。 |
|
|
3969
4174
|
| `unit` | `string` | 否 | 单位,紧随数值以 12px regular 显示 |
|
|
3970
4175
|
| `icon` | `ReactNode` | 否 | 图标。提供时语义从 `numeric` 变为 `icon`,渲染 32px 淡强调色方块 |
|
|
3971
4176
|
|
|
@@ -4027,7 +4232,8 @@ MetricStrip 内置的基础指标条目(numeric / icon 语义)
|
|
|
4027
4232
|
|---|---|:---:|---|
|
|
4028
4233
|
| `key` | `string` | 否 | React key。**应显式提供** —— 见 M2 |
|
|
4029
4234
|
| `label` | `ReactNode` | 是 | 指标名,12/16 label 色 |
|
|
4030
|
-
| `value` | `ReactNode` | 是 | 指标值,
|
|
4235
|
+
| `value` | `ReactNode` | 是 | 指标值,32/32 semibold,等宽数字 |
|
|
4236
|
+
| `description` | `ReactNode` | 否 | 口径说明,渲染在数值下方一行,12/16 次要文字色。例如「2026 年 · 不含已冲红」。 只写统计口径(时间范围、包含与排除),**不得**写趋势、环比或操作提示 —— 变化量用 `ApplicationMetricTrend`,操作入口不属于只读的指标卡。 |
|
|
4031
4237
|
| `unit` | `string` | 否 | 单位,紧随数值以 12px regular 显示 |
|
|
4032
4238
|
| `icon` | `ReactNode` | 否 | 图标。提供时语义从 `numeric` 变为 `icon`,渲染 32px 淡强调色方块 |
|
|
4033
4239
|
|
|
@@ -4090,7 +4296,8 @@ MetricStrip 内置的基础指标条目(numeric / icon 语义)
|
|
|
4090
4296
|
|---|---|:---:|---|
|
|
4091
4297
|
| `key` | `string` | 否 | React key。**应显式提供** —— 见 M2 |
|
|
4092
4298
|
| `label` | `ReactNode` | 是 | 指标名,12/16 label 色 |
|
|
4093
|
-
| `value` | `ReactNode` | 是 | 指标值,
|
|
4299
|
+
| `value` | `ReactNode` | 是 | 指标值,32/32 semibold,等宽数字 |
|
|
4300
|
+
| `description` | `ReactNode` | 否 | 口径说明,渲染在数值下方一行,12/16 次要文字色。例如「2026 年 · 不含已冲红」。 只写统计口径(时间范围、包含与排除),**不得**写趋势、环比或操作提示 —— 变化量用 `ApplicationMetricTrend`,操作入口不属于只读的指标卡。 |
|
|
4094
4301
|
| `unit` | `string` | 否 | 单位,紧随数值以 12px regular 显示 |
|
|
4095
4302
|
| `icon` | `ReactNode` | 否 | 图标。提供时语义从 `numeric` 变为 `icon`,渲染 32px 淡强调色方块 |
|
|
4096
4303
|
|
|
@@ -4114,7 +4321,7 @@ primary-secondary 语义中的单个次级数字
|
|
|
4114
4321
|
- 行内或表格单元中的状态标签:改用 `Badge`。
|
|
4115
4322
|
- 承载业务内容而非数字的卡片:改用 `Card`。
|
|
4116
4323
|
|
|
4117
|
-
**组合约定。** 本组件必须放进 `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
|
|
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,数值 32/32 semibold。指标数据在途或失败时用 `state` 表达,取值只有 `ready` / `loading` / `error` 三种:`loading` 由组件渲染与指标卡同壳同高的骨架(张数同 `columns` 的缺省算法,无卡片时为 4),调用方不得自拼骨架卡;`error` 渲染一张横跨整行的失败卡,内容经 `error` 传入,应说明失败原因并提供「重试」,不传时显示内置的「指标加载失败」。两种状态下 `metrics` 与 `children` 都不渲染;读屏经组件内置的状态播报获知「指标加载中」/「指标加载失败」。
|
|
4118
4325
|
|
|
4119
4326
|
**禁止 / 使用边界。**
|
|
4120
4327
|
- 不得用 `state="loading"` 长期占位来顶替「无真实指标」—— 无指标时整个区域不渲染。
|
|
@@ -4122,7 +4329,7 @@ primary-secondary 语义中的单个次级数字
|
|
|
4122
4329
|
- 不得给指标卡挂点击跳转,整卡默认只读,`cursor: default` 是已登记行为。
|
|
4123
4330
|
- 不得一行超过 6 张,也不得让同一区内的卡片高度不一致。
|
|
4124
4331
|
- 不得在指标区放置页面动作按钮、搜索框或筛选控件。
|
|
4125
|
-
-
|
|
4332
|
+
- 禁止给指标卡加阴影、边框或白底 —— 指标直接落在页面底色上。
|
|
4126
4333
|
|
|
4127
4334
|
### ApplicationMetricTrend
|
|
4128
4335
|
|
|
@@ -4154,7 +4361,8 @@ MetricStrip 内置的基础指标条目(numeric / icon 语义)
|
|
|
4154
4361
|
|---|---|:---:|---|
|
|
4155
4362
|
| `key` | `string` | 否 | React key。**应显式提供** —— 见 M2 |
|
|
4156
4363
|
| `label` | `ReactNode` | 是 | 指标名,12/16 label 色 |
|
|
4157
|
-
| `value` | `ReactNode` | 是 | 指标值,
|
|
4364
|
+
| `value` | `ReactNode` | 是 | 指标值,32/32 semibold,等宽数字 |
|
|
4365
|
+
| `description` | `ReactNode` | 否 | 口径说明,渲染在数值下方一行,12/16 次要文字色。例如「2026 年 · 不含已冲红」。 只写统计口径(时间范围、包含与排除),**不得**写趋势、环比或操作提示 —— 变化量用 `ApplicationMetricTrend`,操作入口不属于只读的指标卡。 |
|
|
4158
4366
|
| `unit` | `string` | 否 | 单位,紧随数值以 12px regular 显示 |
|
|
4159
4367
|
| `icon` | `ReactNode` | 否 | 图标。提供时语义从 `numeric` 变为 `icon`,渲染 32px 淡强调色方块 |
|
|
4160
4368
|
|
|
@@ -4339,11 +4547,22 @@ Loading / Empty / Error / No Permission / Not Found 绝不共用文案 ——
|
|
|
4339
4547
|
|
|
4340
4548
|
Canvas 的**上下文区**(源仓库名 `application-page-header`)。
|
|
4341
4549
|
|
|
4342
|
-
|
|
4550
|
+
左侧:可选的「返回」· 16px 标题 · 竖线 · 更新时间与刷新。中部:可选的任务状态胶囊(`taskStatus`)。
|
|
4343
4551
|
右侧:页面动作组,再经分隔线之后是**页面级的 Page Mode Switch**。
|
|
4344
4552
|
|
|
4553
|
+
左侧按 GAP Design kit「数据更新」(业财平台 round-01 裁决,2026-11-10):
|
|
4554
|
+
- 二级页面以「返回」幽灵按钮(16px chevron + 文字,32 高、左右 12、圆角 12)开头,
|
|
4555
|
+
与标题间隔 8 —— 传 `onBack` 即渲染
|
|
4556
|
+
- 标题之后是一条 12px 高的竖线,再接更新时间:完整日期时间(`2026-07-28 10:00`)
|
|
4557
|
+
14/20 文字1,不加「更新于」前缀;传了 `onRefresh` 时时间与其后的 16px 刷新字形
|
|
4558
|
+
合成一枚幽灵按钮(32 高、左右 12、圆角 12),点它即刷新
|
|
4559
|
+
|
|
4560
|
+
外观(GAP Design kit,业财平台 round-01):48px 高的通栏,落在页面底色上、只有一条
|
|
4561
|
+
0.5px 下边线,不是卡片。放在 `ApplicationPageLayoutContainer` 的 `header` 槽位时
|
|
4562
|
+
向两侧与顶部吃掉页面留白,贴满内容区宽度。此前左侧的 3×16 强调色条已移除。
|
|
4563
|
+
|
|
4345
4564
|
#### 允许出现在这里
|
|
4346
|
-
新建 / 导入 / 导出 /
|
|
4565
|
+
新建 / 导入 / 导出 / 更多、刷新、返回、面包屑、Page Mode Switch。
|
|
4347
4566
|
|
|
4348
4567
|
#### ⚠ 禁止出现在这里
|
|
4349
4568
|
**搜索、常用筛选、排序、SPLIT 视图模式切换、列设置、行级或批量动作。**
|
|
@@ -4361,37 +4580,53 @@ Canvas 的**上下文区**(源仓库名 `application-page-header`)。
|
|
|
4361
4580
|
|
|
4362
4581
|
| prop | 类型 | 必填 | 说明 |
|
|
4363
4582
|
|---|---|:---:|---|
|
|
4364
|
-
| `title` | `ReactNode` | 否 | 页面标题,16/
|
|
4583
|
+
| `title` | `ReactNode` | 否 | 页面标题,16/32 regular 字重,超长省略 |
|
|
4365
4584
|
| `subtitle` | `ReactNode` | 否 | 副标题,紧随标题以 12px label 色显示 |
|
|
4366
4585
|
| `dataStatus` | `'normal' \| 'refreshing' \| 'failed'` | 否 | 数据状态。决定状态文案与刷新按钮的可用性 |
|
|
4367
|
-
| `updatedAt` | `string` | 否 |
|
|
4368
|
-
| `onRefresh` | `() => void` | 否 |
|
|
4586
|
+
| `updatedAt` | `string` | 否 | 数据更新时间,写完整日期时间 `YYYY-MM-DD HH:mm`(如 `2026-07-28 10:00`),原样显示、 不加前缀(GAP Design kit「数据更新」;推翻 07 · C-12 的「只写 HH:mm」)。 仅在 `normal` 状态显示;`refreshing` / `failed` 显示「刷新中」/「刷新失败」 |
|
|
4587
|
+
| `onRefresh` | `() => void` | 否 | 刷新回调。提供时更新时间与刷新字形合成一枚按钮,`refreshing` 状态下不可点、字形转圈。 **未提供时不渲染刷新字形,时间按纯文字显示** —— 没有刷新能力的页面(草稿、向导、 一次性结果)不得出现一个点了没反应的按钮。状态文案(时间 / 刷新中 / 刷新失败)不受影响。 |
|
|
4588
|
+
| `onBack` | `() => void` | 否 | 返回回调。提供时标题前渲染「返回」幽灵按钮(kit「数据更新-二级页面」)。 组件不做路由跳转,回到哪里、还原哪些上下文由调用方决定。 与 `breadcrumb` 不得同时传 —— 二级页面用返回,需要展示多级路径时才用面包屑 |
|
|
4589
|
+
| `backLabel` | `string` | 否 | 返回按钮文案,默认「返回」。只在 `onBack` 提供时生效 |
|
|
4590
|
+
| `taskStatus` | `ApplicationPageHeaderTaskStatus` | 否 | 页面级进行中任务的状态胶囊,居中显示在页头中部。例如批量识别的「正在识别 14/100」。 `busy` 为 true 时胶囊前带转圈。 只表达**本页正在进行的一项任务**的进度;**不得**用它显示数据刷新状态(那是 `dataStatus`)、页面说明(那是 `subtitle`)或筛选摘要(那属于 `ApplicationQueryToolbar`)。 |
|
|
4369
4591
|
| `actions` | `ReactNode` | 否 | 页面级动作组。**至多一个 primary** |
|
|
4370
4592
|
| `pageModes` | `PageMode[]` | 否 | 本页**真正开放**的页面模式。少于 2 个则开关完全不渲染 |
|
|
4371
4593
|
| `pageMode` | `PageMode` | 否 | 当前页面模式 |
|
|
4372
4594
|
| `onPageModeChange` | `(mode: PageMode) => void` | 否 | 页面模式变化回调 |
|
|
4373
|
-
| `breadcrumb` | `ReactNode` | 否 |
|
|
4595
|
+
| `breadcrumb` | `ReactNode` | 否 | 面包屑。仅当页面需要展示多级路径时提供;单纯「回到上一层」用 `onBack`,两者不得同时传。 面包屑在标题上方另占一行,页头因此高于 48 |
|
|
4374
4596
|
|
|
4375
4597
|
继承 `HTMLAttributes<HTMLDivElement>` 的全部原生属性,其中 `title` 已被本组件重新定义或移除。
|
|
4376
4598
|
|
|
4599
|
+
**`ApplicationPageHeaderTaskStatus`**
|
|
4600
|
+
|
|
4601
|
+
页头中部的任务状态胶囊
|
|
4602
|
+
|
|
4603
|
+
| prop | 类型 | 必填 | 说明 |
|
|
4604
|
+
|---|---|:---:|---|
|
|
4605
|
+
| `label` | `ReactNode` | 是 | 胶囊文案,如「正在识别 14/100」 |
|
|
4606
|
+
| `busy` | `boolean` | 否 | 任务进行中。为 true 时胶囊前带转圈,任务结束后改为 false 或移除整个 `taskStatus` |
|
|
4607
|
+
|
|
4377
4608
|
**用途。** Canvas 的上下文区,承载页面身份、数据新鲜度与页面级 Page Mode Switch。
|
|
4378
4609
|
|
|
4379
|
-
**何时使用。**
|
|
4610
|
+
**何时使用。** 每个业务页面的第一个区域必须是该组件。返回、页面标题、面包屑、数据状态与刷新、页面级动作组、Page Mode Switch 全部集中在这里,且只有这里。该组件回答的是「这是哪个页面、数据是什么时候的、用哪种模式看」。
|
|
4380
4611
|
|
|
4381
4612
|
**何时改用其他组件。**
|
|
4382
4613
|
- 跨页身份与应用、模块导航属于 Shell,改用 `TopNavigationPrimaryBar`、`ApplicationPrimaryNavigation`、`ApplicationSecondaryNavigation`。
|
|
4383
4614
|
- 搜索、常用筛选、排序、呈现设置、SPLIT 右栏的 View Mode Switch 一律改用 `ApplicationQueryToolbar`。
|
|
4384
4615
|
- 批量动作改用 `ListBatchActionBar`,它出现在结果集上方而非上下文区。
|
|
4385
4616
|
- 记录对象的头部改用 `ApplicationRecordDetailBody` 的 `summary` 与 `ApplicationDetailDrawer` 的标题区。
|
|
4386
|
-
- 面包屑本体用 `Breadcrumb`,经 `breadcrumb`
|
|
4617
|
+
- 面包屑本体用 `Breadcrumb`,经 `breadcrumb` 槽位传入;单纯回到上一层(二级页面)不用面包屑,改传 `onBack`。
|
|
4387
4618
|
|
|
4388
4619
|
**组合约定。**
|
|
4389
4620
|
- `actions` 承载页面级动作组,元素应为 `SystemButton`,至多一个 primary。中文标签为 2–4 字裸名词短语:`新建`、`导入`、`导出`、`更多`。
|
|
4390
4621
|
- Page Mode Switch 由 `pageModes`、`pageMode`、`onPageModeChange` 三者共同驱动,三者必须成组提供;只给 `pageModes` 会得到一个点不动的开关。它按 radiogroup 模式只占一个 Tab 停靠点,← / → 切换模式并首尾相接,Home / End 跳到首末项 —— 方向键同样触发 `onPageModeChange`。
|
|
4391
4622
|
- `pageModes` 只列该页面真正开放的模式。少于 2 个时开关完全不渲染且不占位。
|
|
4392
|
-
-
|
|
4393
|
-
-
|
|
4623
|
+
- 左侧按 GAP Design kit「数据更新」排布:可选的「返回」→ 标题 → 12px 竖线 → 更新时间。传 `onBack` 时标题前渲染「返回」幽灵按钮(16px chevron + 文字,32 高、圆角 12),文案经 `backLabel` 可改,组件不跳转、回到哪里由调用方决定;二级页面用它回到来源页。`onBack` 与 `breadcrumb` 不得同时传。
|
|
4624
|
+
- `dataStatus` 为 `normal` 时应同时提供 `updatedAt`,否则数据新鲜度无从判断。`updatedAt` 写完整日期时间 `YYYY-MM-DD HH:mm`(24 小时制、两位补零,如 `2026-07-28 10:00`),组件原样显示为 14/20 正文色,不加「更新于」前缀;不得传秒或「刚刚」「5 分钟前」一类相对时间。此条取代 07 · C-12 的「只写 HH:mm」(业财平台 round-01 按 kit 裁决)。
|
|
4625
|
+
- 传了 `onRefresh` 时,更新时间与其后的 16px 刷新字形合成一枚幽灵按钮,点它即刷新,可访问名为「刷新,2026-07-28 10:00」;没有刷新能力的页面(草稿、向导、一次性结果)不传,时间按纯文字显示,不出现刷新字形。
|
|
4626
|
+
- 三种数据状态各有各的措辞与可用性:`normal` 显示更新时间,`refreshing` 显示刷新中、字形转圈且按钮不可点,`failed` 显示刷新失败(危险色)且按钮读作 `重试`。
|
|
4394
4627
|
- `title` 为字符串时才会得到悬浮提示。需要悬浮提示又需要补充信息时,标题主体传 `title`,补充信息走 `subtitle`。
|
|
4628
|
+
- 页面级进行中任务(批量识别、批量导入)的进度经 `taskStatus` 渲染为页头正中的胶囊,`label` 写「正在识别 14/100」,`busy` 为 true 时带转圈;任务结束后移除 `taskStatus`,结果写进 `Sonner` 或页面内容。进度不得写进 `subtitle`。
|
|
4629
|
+
- 外观是 48px 通栏:落在页面底色上、只有一条 0.5px 下边线,不是卡片;放在 `ApplicationPageLayoutContainer` 的 `header` 槽位时自动吃掉顶部与两侧留白。
|
|
4395
4630
|
- 该组件自身不带外边距,与相邻区域的间距由 `ApplicationPageLayoutContainer` 的区域间隙负责。
|
|
4396
4631
|
- Page Mode Switch 的选中态与 `ToggleGroup` 同为分段控件表达(选中项抬升为表面色),不得改为淡色洗 —— 淡色洗属于独立开关 `Toggle`。
|
|
4397
4632
|
|
|
@@ -4401,6 +4636,9 @@ Canvas 的**上下文区**(源仓库名 `application-page-header`)。
|
|
|
4401
4636
|
- 不得让刷新重置业务视图、搜索、筛选、排序或页面模式 —— 刷新只更新数据。
|
|
4402
4637
|
- 不得在 `actions` 中放置行级动作或批量动作。
|
|
4403
4638
|
- 禁止渲染只有一种取值的 Page Mode Switch,也不得为它保留空位。
|
|
4639
|
+
- 不得用 `taskStatus` 显示数据刷新状态、页面说明或筛选摘要 —— 三者各有 `dataStatus`、`subtitle` 与工具栏。
|
|
4640
|
+
- 禁止同时传 `onBack` 与 `breadcrumb`,也不得用 `actions` 里的按钮充当返回。
|
|
4641
|
+
- 不得给 `updatedAt` 拼上「更新于」等前缀 —— 组件按 kit 原样显示时间。
|
|
4404
4642
|
|
|
4405
4643
|
### ApplicationPageLayoutContainer
|
|
4406
4644
|
|
|
@@ -4475,8 +4713,16 @@ Content Canvas 宿主自身内边距为零,因此不会产生双重外边距
|
|
|
4475
4713
|
| 行 | 内容 | 渲染条件 |
|
|
4476
4714
|
|---|---|---|
|
|
4477
4715
|
| 1 | 业务视图标签(2–4 个稳定工作视角) | 仅当确有视图 |
|
|
4478
|
-
| 2 | 结果摘要 │ 搜索 + 常用筛选 + 更多
|
|
4479
|
-
| 3 | 已生效筛选标签(可移除 +
|
|
4716
|
+
| 2 | 结果摘要 │ 搜索 + 排序 + 常用筛选 + 更多 ‖ 视图切换 + 呈现设置 | always |
|
|
4717
|
+
| 3 | 已生效筛选标签(可移除 + 「清空」全部) | 仅当有筛选生效 |
|
|
4718
|
+
|
|
4719
|
+
第 2 行左组的顺序固定为「结果摘要 → 搜索 → 排序 → 常用筛选 → 更多」—— 排序紧跟搜索、
|
|
4720
|
+
在筛选之前(GAP Design kit「数据筛选搜索」的标注;业财平台 round-01 裁决,2026-11-10)。
|
|
4721
|
+
右组只放 `viewModeSwitch` 与呈现设置。
|
|
4722
|
+
|
|
4723
|
+
几何按 kit「数据筛选搜索」(84:2803):三行之间 8;第 2 行左组控件之间 4,摘要与搜索之间
|
|
4724
|
+
由组件画一条 1×20 的线条色竖线(只在传了 `resultSummary` 时出现);右组之间 4;左右两组之间 12。
|
|
4725
|
+
调用方传入的排序与筛选控件不得自带外边距 —— 间隔由组件统一给出。
|
|
4480
4726
|
|
|
4481
4727
|
#### ⚠ 搜索
|
|
4482
4728
|
**通过 Enter 或明确的搜索动作提交,绝不逐字实时搜索。**
|
|
@@ -4486,9 +4732,11 @@ Content Canvas 宿主自身内边距为零,因此不会产生双重外边距
|
|
|
4486
4732
|
由「应用」提交,并**回写到第三行的标签**。
|
|
4487
4733
|
|
|
4488
4734
|
#### ⚠ 呈现设置按钮必须按当前呈现方式命名
|
|
4735
|
+
按钮是 32×32 纯图标(16px `sliders-horizontal`,白底描边、圆角 12,kit「列表工具」),
|
|
4736
|
+
名字落在可访问名与悬停提示上:
|
|
4489
4737
|
DataTable → 列设置 · RecordList → 列表设置 · CardList → 卡片设置 · KanbanBoard → 看板设置 ·
|
|
4490
4738
|
Calendar → 日历设置 · Chart → 图表设置 · Timeline → 时间轴设置。
|
|
4491
|
-
|
|
4739
|
+
**通用的「视图设置」被明令禁止**,「自定义」同理 —— 它不说明设的是什么。
|
|
4492
4740
|
无真实可配置项时(`hasPresentationSettings={false}`,或不传
|
|
4493
4741
|
`onPresentationSettings`)按钮不渲染且不占位。
|
|
4494
4742
|
每种呈现方式**各自独立存储**其设置。
|
|
@@ -4504,7 +4752,7 @@ Calendar → 日历设置 · Chart → 图表设置 · Timeline → 时间轴设
|
|
|
4504
4752
|
| `businessViews` | `BusinessViewTab[]` | 否 | 业务视图标签集合。2–4 个 |
|
|
4505
4753
|
| `businessView` | `string` | 否 | 当前业务视图 |
|
|
4506
4754
|
| `onBusinessViewChange` | `(value: string) => void` | 否 | 业务视图变化回调 |
|
|
4507
|
-
| `resultSummary` | `ReactNode` | 否 |
|
|
4755
|
+
| `resultSummary` | `ReactNode` | 否 | 结果摘要,渲染为一枚胶囊,如 `<>共 <strong>1,284</strong> 条</>`。 数字用 `<strong>` 包裹即加粗为正文色;有勾选时紧随写已选数(「已选 3 条」)。 |
|
|
4508
4756
|
| `searchValue` | `string` | 否 | 搜索框受控值 |
|
|
4509
4757
|
| `onSearchChange` | `(event: ChangeEvent<HTMLInputElement> \| { target: { value: string } }) => void` | 否 | 搜索框值变化回调 |
|
|
4510
4758
|
| `onSearchSubmit` | `(value: string) => void` | 否 | 搜索提交回调。**仅 Enter 触发** |
|
|
@@ -4512,10 +4760,10 @@ Calendar → 日历设置 · Chart → 图表设置 · Timeline → 时间轴设
|
|
|
4512
4760
|
| `searchAriaLabel` | `string` | 否 | 搜索框的可访问名,必须写明搜索范围。优先级:本 prop → `searchPlaceholder`。 占位文字写示例、可访问名写范围时分开传;二者同文时只传 `searchPlaceholder` 即可。两者都缺省时可访问名回落为「搜索当前结果」并在开发构建下告警一次 —— SearchField 的 `ariaLabel` 必填,不能留空,而写明范围只有调用方做得到(05 · P1-7) |
|
|
4513
4761
|
| `commonFilters` | `ReactNode` | 否 | 常用筛选,传 2–3 个 `ApplicationFilterMenu` |
|
|
4514
4762
|
| `moreFilters` | `ReactNode` | 否 | 「更多筛选」触发器,一律是 `Popover` 承载的 `ApplicationFilterList`;不得用 `Collapsible` 就地展开(06 · D-4) |
|
|
4515
|
-
| `sort` | `ReactNode` | 否 | 排序控件,传 `Select
|
|
4763
|
+
| `sort` | `ReactNode` | 否 | 排序控件,传 `Select`,渲染在搜索框之后、常用筛选之前。 DataTable 呈现下表头排序是第二入口,两处共享同一份排序状态(07 · C-2) |
|
|
4516
4764
|
| `appliedTags` | `AppliedFilterTag[]` | 否 | 已生效的筛选标签 |
|
|
4517
4765
|
| `onRemoveTag` | `(id: string) => void` | 否 | 移除单个标签回调 |
|
|
4518
|
-
| `onResetTags` | `() => void` | 否 |
|
|
4766
|
+
| `onResetTags` | `() => void` | 否 | 清空全部筛选回调。按钮文案为「清空」,与筛选标签同款胶囊 |
|
|
4519
4767
|
| `presentation` | `DataPresentation` | 否 | 当前呈现方式。**决定呈现设置按钮的文案** |
|
|
4520
4768
|
| `hasPresentationSettings` | `boolean` | 否 | 是否有可配置的呈现设置。false 时按钮不渲染且不占位。 缺省时按是否提供 `onPresentationSettings` 推断(05 · P1-7):此前缺省为 `true`,不传即渲染一个点了没反应的设置按钮,默认值站在了违规一边。 显式传入仍优先 |
|
|
4521
4769
|
| `onPresentationSettings` | `(event: MouseEvent<HTMLButtonElement>) => void` | 否 | 呈现设置点击回调。参数是按钮的点击事件,`event.currentTarget` 即设置按钮本身, 供调用方把面板锚定在它上面、或关闭后把焦点还给它(06 · P2-6)。 不读参数的无参回调照旧可用 |
|
|
@@ -4550,7 +4798,7 @@ L3 业务视图标签
|
|
|
4550
4798
|
|
|
4551
4799
|
**何时改用其他组件。**
|
|
4552
4800
|
- Page Mode Switch 属于 `ApplicationPageHeader`,不得在此重建。
|
|
4553
|
-
- 单个高频筛选维度的触发器改用 `ApplicationFilterMenu
|
|
4801
|
+
- 单个高频筛选维度的触发器改用 `ApplicationFilterMenu`,日期区间维度改用 `ApplicationDateRangeFilter`,都经 `commonFilters` 传入。
|
|
4554
4802
|
- 完整的筛选维度面板改用 `ApplicationFilterList`,装进 `Popover` 后经 `moreFilters` 传入;不得装进 `Collapsible` 就地展开(06 · D-4)。
|
|
4555
4803
|
- 纯文本搜索输入已由该组件内置的 `SearchField` 承担,不得在工具栏内另置搜索控件。
|
|
4556
4804
|
- 分页改用 `ListTablePagination`,它属于 `ApplicationDataDisplay` 的底部。
|
|
@@ -4561,23 +4809,28 @@ L3 业务视图标签
|
|
|
4561
4809
|
- `businessViews` 传 2–4 个稳定工作视角,`businessView` 与 `onBusinessViewChange` 必须成对提供。
|
|
4562
4810
|
- 搜索经 `searchValue` 与 `onSearchChange` 受控,提交只经 `onSearchSubmit`,由 Enter 触发。
|
|
4563
4811
|
- 搜索框的可访问名优先取 `searchAriaLabel`,其次取 `searchPlaceholder`,二者至少给一个且必须写明搜索范围;占位文字写示例、可访问名写范围时分开传,同文时只传 `searchPlaceholder`。`searchPlaceholder` 没有默认值,缺省时占位文字取 `searchAriaLabel`;二者都缺省时可访问名回落为「搜索当前结果」并在开发构建下告警一次。
|
|
4564
|
-
- `commonFilters` 常驻 2–3 个 `ApplicationFilterMenu`,其余维度一律收进 `moreFilters`;常用筛选里出现的维度不再进更多筛选(07 · C-11)。折叠只改变入口,不移除能力。
|
|
4812
|
+
- `commonFilters` 常驻 2–3 个 `ApplicationFilterMenu` 或 `ApplicationDateRangeFilter`,其余维度一律收进 `moreFilters`;常用筛选里出现的维度不再进更多筛选(07 · C-11)。折叠只改变入口,不移除能力。
|
|
4813
|
+
- 第二行左组的顺序固定为「结果摘要 → 搜索 → 排序 → 常用筛选 → 更多」,右组只放 `viewModeSwitch` 与呈现设置(GAP Design kit「数据筛选搜索」:排序在搜索后面、筛选前面;业财平台 round-01 裁决)。
|
|
4814
|
+
- 间隔按 kit「数据筛选搜索」:三行之间 8;第二行左组控件之间 4、右组之间 4、左右两组之间 12;摘要与搜索之间由组件画一条 1×20 的线条色竖线,只在传了 `resultSummary` 时出现。间隔与竖线都由组件给出,传入的排序与筛选控件不带外边距。
|
|
4565
4815
|
- `sort` 传 `Select`(无可见标签,用 `aria-label` 命名)。DataTable 呈现下表头排序是第二入口:`Table` 的 `sort` 与这里的 `Select` 读写同一份排序状态,任一处改动另一处同步回显(07 · C-2)。
|
|
4566
|
-
-
|
|
4567
|
-
- `
|
|
4816
|
+
- `resultSummary` 渲染为一枚胶囊,数字用 `<strong>` 包裹即加粗为正文色,如 `<>共 <strong>46</strong> 张</>`;有勾选时紧随写已选数。
|
|
4817
|
+
- 生效条件必须回写 `appliedTags`,并同时提供 `onRemoveTag` 与 `onResetTags`;清除全部的按钮文案为「清空」,与筛选标签同款胶囊。`AppliedFilterTag.label` 为非字符串时必须提供 `labelText`,否则移除按钮的无障碍名称为空。
|
|
4818
|
+
- 呈现设置按钮按 kit 是 32×32 纯图标(16px `sliders-horizontal`,白底描边、圆角 12),名字落在可访问名与悬停提示上;`presentation` 决定这个名字,必须与 `ApplicationDataDisplay` 的同名 prop 取自同一处状态。
|
|
4568
4819
|
- `hasPresentationSettings` 缺省时按是否提供 `onPresentationSettings` 推断:给了回调即渲染设置按钮,不给即不渲染且不占位;显式传入优先。无真实可配置项时不传回调即可,或显式传 `hasPresentationSettings={false}`。
|
|
4569
4820
|
- `onPresentationSettings` 收到设置按钮的点击事件,`event.currentTarget` 即按钮元素,可作面板锚点或关闭后的焦点归还目标;不读参数的无参回调照旧可用。面板由调用方持有,其开合状态经 `presentationSettingsOpen` 回传,按钮据此输出 `aria-expanded` —— 二者应当成对提供,不传则按钮不报开合。
|
|
4570
4821
|
- 呈现设置面板一律用 `Popover` 承载、锚定在呈现设置按钮上,与 `moreFilters` 同一承载;不得改用 `Sheet`、`Dialog` 或 `Drawer`(07 · C-7)。
|
|
4571
4822
|
- 每种呈现方式各自独立存储其设置,切换呈现方式不得沿用上一种的设置。
|
|
4572
4823
|
- `viewModeSwitch` 仅允许出现在服务 SPLIT 右栏的那一份工具栏上,且只改 `dataPresentation`。
|
|
4573
|
-
- 搜索框宽
|
|
4824
|
+
- 搜索框宽 240px,白底、1px 描边、圆角 12(GAP Design kit),占位文字写短的搜索范围;确需更宽时调用方覆盖 `--mh-query-toolbar-search-max-width`。放进 `ApplicationPageLayoutContainer` 时,该组件与数据展示区同处一张白卡(圆角 20、内边距 12),自身不再画卡片;单独使用时自身就是那张卡的上半。该组件不带外边距,与相邻区域的间距由 `ApplicationPageLayoutContainer` 负责。
|
|
4574
4825
|
- 数据展示区的 `state` 为 `no-permission` 或 `not-found` 时不渲染本组件;处于 `error` 时保留,条件改动后重新查询(07 · C-6)。
|
|
4575
4826
|
|
|
4576
4827
|
**禁止 / 使用边界。**
|
|
4577
4828
|
- 禁止逐字实时搜索,不得在 `onSearchChange` 中直接发起查询。
|
|
4578
4829
|
- 不得同时省略 `searchAriaLabel` 与 `searchPlaceholder`,也不得把任一写成不含范围的「搜索」。
|
|
4579
4830
|
- 不得显式传 `hasPresentationSettings` 为 true 而不给 `onPresentationSettings` —— 那是一个点了没反应的按钮。
|
|
4580
|
-
-
|
|
4831
|
+
- 禁止出现通用的「视图设置」或「自定义」按钮 —— 按钮必须按当前呈现方式命名:`列设置` / `列表设置` / `卡片设置` / `看板设置` / `日历设置` / `图表设置` / `时间轴设置`。
|
|
4832
|
+
- 不得把排序挪回右组,也不得把它排在常用筛选之后。
|
|
4833
|
+
- 不得在摘要与搜索之间自行再画分隔线,也不得给传入的排序与筛选控件加外边距来改间隔。
|
|
4581
4834
|
- 不得在该组件内渲染 Page Mode Switch,也不得用 `viewModeSwitch` 改动 `pageMode`。
|
|
4582
4835
|
- 不得让筛选状态只存在于菜单或面板内部而不回写 `appliedTags`。
|
|
4583
4836
|
- 禁止为同一个结果集放置两份工具栏,也不得把搜索、筛选、排序下沉进 `ApplicationDataDisplay`。表头排序不算下沉,但不得另持一份与工具栏 `sort` 分离的排序状态。
|
|
@@ -4600,6 +4853,7 @@ L3 业务视图标签
|
|
|
4600
4853
|
|---|---|:---:|---|
|
|
4601
4854
|
| `summary` | `ReactNode` | 否 | 对象头:标题、状态徽标、关键标识 |
|
|
4602
4855
|
| `sections` | `DetailSection[]` | 否 | 分节集合,按顺序渲染 |
|
|
4856
|
+
| `aside` | `DetailSection` | 否 | 侧栏分节。提供时主体变为两栏:左栏(`summary` + `sections`)弹性伸展, 右栏固定 360px,两栏各是一张白卡,间距 12。用于「处理记录」「审批流转」这类 **伴随主内容、随它一起看**的内容。 只放一个分节;**不得**把主要字段分节挪进侧栏,也不得用它放对象级动作 (动作在载体的动作区)。可用宽度不足 960px 时侧栏落到主栏下方。 |
|
|
4603
4857
|
|
|
4604
4858
|
继承 `HTMLAttributes<HTMLDivElement>` 的全部原生属性。
|
|
4605
4859
|
|
|
@@ -4609,8 +4863,8 @@ L3 业务视图标签
|
|
|
4609
4863
|
|
|
4610
4864
|
| prop | 类型 | 必填 | 说明 |
|
|
4611
4865
|
|---|---|:---:|---|
|
|
4612
|
-
| `label` | `ReactNode` | 是 | 字段名,
|
|
4613
|
-
| `value` | `ReactNode` | 是 | 字段值,14/20
|
|
4866
|
+
| `label` | `ReactNode` | 是 | 字段名,14/20 label 色,固定 160px 宽,与值横排 |
|
|
4867
|
+
| `value` | `ReactNode` | 是 | 字段值,14/20 medium 字重,长值自动断行 |
|
|
4614
4868
|
| `key` | `string` | 否 | React key。`label` 为非字符串时**必须**提供。见 M8 |
|
|
4615
4869
|
|
|
4616
4870
|
**`DetailSection`**
|
|
@@ -4620,7 +4874,7 @@ L3 业务视图标签
|
|
|
4620
4874
|
| prop | 类型 | 必填 | 说明 |
|
|
4621
4875
|
|---|---|:---:|---|
|
|
4622
4876
|
| `key` | `string` | 否 | React key。`title` 为非字符串时**必须**提供。见 M8 |
|
|
4623
|
-
| `title` | `ReactNode` | 是 | 分节标题,16/
|
|
4877
|
+
| `title` | `ReactNode` | 是 | 分节标题,16/20 medium 字重,左侧带 2×14 强调色竖条 |
|
|
4624
4878
|
| `fields` | `DetailField[]` | 否 | 字段列表,自适应多列网格排布 |
|
|
4625
4879
|
| `content` | `ReactNode` | 否 | 自定义内容,排在字段之后。用于时间轴、附件列表等 |
|
|
4626
4880
|
| `action` | `ReactNode` | 否 | 分节级动作,右对齐于标题行 |
|
|
@@ -4639,8 +4893,9 @@ L3 业务视图标签
|
|
|
4639
4893
|
**组合约定。**
|
|
4640
4894
|
- `summary` 承载对象头:标题、状态徽标(应为 `Badge`)、关键标识。
|
|
4641
4895
|
- `sections` 按数组顺序渲染。`DetailSection.title` 为非字符串时必须提供 `key`;契约同样为 `DetailField` 登记了 `key`,`label` 为非字符串时必须提供。
|
|
4642
|
-
- 字段以 `dl` / `dt` / `dd`
|
|
4643
|
-
-
|
|
4896
|
+
- 字段以 `dl` / `dt` / `dd` 输出为横排名值对:字段名 160px 宽、14/20 三级文字色,值 14/20 medium。列数随可用宽度自适应,字段列最窄 360px,两个载体不需要各写一套。主体内容落在白卡里,载体负责灰底;分节间距 16,分节标题带 2×14 强调色竖条。
|
|
4897
|
+
- 伴随主内容一起看的一个分节(处理记录、审批流转)经 `aside` 传入,主体变为两栏:左栏弹性、右栏 360px,间距 12;可用宽度不足 960px 时侧栏落到主栏下方。主要字段分节不得挪进 `aside`。
|
|
4898
|
+
- 分节级动作经 `DetailSection.action` 右对齐于标题行;对象级主动作属于载体:抽屉写在页头右侧的动作区,独立详情页写在 `ApplicationPageHeader` 的 `actions`。
|
|
4644
4899
|
- 时间轴、附件列表等非名值对内容走 `DetailSection.content`,排在字段之后。
|
|
4645
4900
|
- 该组件不带外边距也不自持滚动,留白与滚动一律由载体负责。
|
|
4646
4901
|
- 允许存在抽屉专用变体的条件是:超过 3 个分节、超过 15 个字段、动作流程有实质差异、性能要求不同,四者任一成立。即便成立,该变体只保留核心内容。
|
|
@@ -4652,6 +4907,7 @@ L3 业务视图标签
|
|
|
4652
4907
|
- 不得在分节顺序可变时省略 `key` —— 重排序会导致内部状态错位。
|
|
4653
4908
|
- 禁止在该组件内部再嵌套一个 `ApplicationRecordDetailBody`。
|
|
4654
4909
|
- 不得在该组件内承载搜索、筛选、排序或分页。
|
|
4910
|
+
- 不得向 `aside` 放对象级动作或第二组主要字段,侧栏只放一个伴随分节。
|
|
4655
4911
|
|
|
4656
4912
|
### ApplicationSplitListSidebar
|
|
4657
4913
|
|
|
@@ -4846,9 +5102,14 @@ SPLIT 左栏的单个目录项
|
|
|
4846
5102
|
|
|
4847
5103
|
DETAIL 的**抽屉载体** —— 打开一条记录的详情而不丢失身后的列表。
|
|
4848
5104
|
|
|
4849
|
-
推荐宽度 680px
|
|
5105
|
+
推荐宽度 680px。
|
|
4850
5106
|
|
|
4851
|
-
|
|
5107
|
+
页头(GAP Design kit「抽屉 / 常规」;业财平台 round-01 裁决,2026-11-10):48 高、左右 12、
|
|
5108
|
+
0.5px 下边线;左侧标题与副标题同行 14/20,右侧依次为主动作、次要动作组、32×32 纯图标
|
|
5109
|
+
关闭键,间隔 4。**没有底部动作区** —— 动作一律在页头。
|
|
5110
|
+
|
|
5111
|
+
⚠ **它的关闭键可访问名是「关闭」,独立详情页的退出是写着「返回」的按钮。**
|
|
5112
|
+
深链接只指向独立详情页。
|
|
4852
5113
|
|
|
4853
5114
|
⚠ **关闭时必须还原来源页面的**:业务视图、搜索、筛选、排序、分页、
|
|
4854
5115
|
页面模式、当前对象、滚动位置。少还原任何一项都算缺陷。
|
|
@@ -4865,8 +5126,8 @@ DETAIL 的**抽屉载体** —— 打开一条记录的详情而不丢失身后
|
|
|
4865
5126
|
| `status` | `ReactNode` | 否 | 对象状态徽标,紧邻标题 |
|
|
4866
5127
|
| `width` | `number` | 否 | 宽度,单位 px。推荐 680 |
|
|
4867
5128
|
| `side` | `'left' \| 'right'` | 否 | 从哪一侧滑出。默认 `right`。来源在右侧(右栏、周末日格)时传 `left`, 免得 680px 的抽屉正好盖住刚点的那一处(06 · P2-8) |
|
|
4868
|
-
| `primaryAction` | `ReactNode` | 否 |
|
|
4869
|
-
| `secondaryActions` | `ReactNode` | 否 |
|
|
5129
|
+
| `primaryAction` | `ReactNode` | 否 | **唯一**的主对象动作,渲染在页头右侧动作区的最左(kit:主按钮在前) |
|
|
5130
|
+
| `secondaryActions` | `ReactNode` | 否 | 次要动作组,渲染在主动作之后、关闭键之前。超过两三个时收进「更多」 |
|
|
4870
5131
|
| `onClose` | `() => void` | 否 | 关闭回调。**必须在此还原来源页面上下文** |
|
|
4871
5132
|
| `children` | `ReactNode` | 否 | 详情主体,应传 `ApplicationRecordDetailBody` |
|
|
4872
5133
|
|
|
@@ -4874,23 +5135,25 @@ DETAIL 的**抽屉载体** —— 打开一条记录的详情而不丢失身后
|
|
|
4874
5135
|
|
|
4875
5136
|
**用途。** DETAIL 的抽屉载体 —— 打开一条业务记录的详情,同时保持身后的列表上下文可见。
|
|
4876
5137
|
|
|
4877
|
-
**何时使用。** 从列表打开单条记录且不希望丢失来源上下文时,该页面必须用本组件。推荐宽度 680px
|
|
5138
|
+
**何时使用。** 从列表打开单条记录且不希望丢失来源上下文时,该页面必须用本组件。推荐宽度 680px,动作在页头右侧、没有底部动作区。它与独立详情页共用同一个 `ApplicationRecordDetailBody`,是「一份详情,两个载体」中的抽屉那一个。
|
|
4878
5139
|
|
|
4879
5140
|
**何时改用其他组件。**
|
|
4880
5141
|
- 非业务记录的侧边面板、或不需要已登记详情结构的裸抽屉,改用 Foundation `Drawer`。
|
|
4881
|
-
-
|
|
5142
|
+
- 帮助、附件预览这类辅助性内容改用 `Sheet` —— 业务对象详情不属于那里;全局设置是二级导航里的设置模块,也不进抽屉。
|
|
4882
5143
|
- 需要深链接的详情改用独立详情页,深链接永远只指向独立详情页。
|
|
4883
5144
|
- 分节超过 3 个、字段超过 15 个、动作流程有实质差异或性能要求不同时,改用独立详情页承载完整内容;抽屉侧只保留核心内容。
|
|
4884
5145
|
- 编辑与新建改用 `ApplicationFormDialog`;不可逆动作的确认改用 `AlertDialog`。
|
|
4885
5146
|
|
|
4886
|
-
**组合约定。** `children` 必须传 `ApplicationRecordDetailBody`,不得为抽屉另写一份详情主体。`width` 默认 680px;`--application-drawer-width` 的 1280px 是宽 / 全屏变体,需要时经 `width` 显式传入。`side` 默认 `right`;来源在页面右侧(SPLIT 右栏的条目、月格的周末日格)时传 `left`,不得让抽屉盖住刚打开它的那一处。`primaryAction`
|
|
5147
|
+
**组合约定。** `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 基座负责,调用方不得再实现一遍。
|
|
4887
5148
|
|
|
4888
5149
|
**禁止 / 使用边界。**
|
|
4889
5150
|
- 不得让深链接指向抽屉 —— 深链接只指向独立详情页。
|
|
4890
5151
|
- 不得为抽屉与独立详情页各写一份详情主体。
|
|
4891
5152
|
- 不得在 `onClose` 里做导航跳转 —— 抽屉是叠加层,关闭必须回到来源页面的原状态。
|
|
4892
|
-
-
|
|
5153
|
+
- 禁止把关闭键的可访问名写成「返回」,也禁止再加第二个退出入口。
|
|
5154
|
+
- 不得在抽屉底部另拼一条动作区 —— 动作一律在页头右侧。
|
|
4893
5155
|
- 不得渲染第二个 `primaryAction`,主对象动作唯一。
|
|
5156
|
+
- 不得在抽屉标题是页面类型名时把对象状态传进 `status`,状态必须紧邻对象名。
|
|
4894
5157
|
|
|
4895
5158
|
### ApplicationFormDialog
|
|
4896
5159
|
|
|
@@ -4898,12 +5161,19 @@ DETAIL 的**抽屉载体** —— 打开一条记录的详情而不丢失身后
|
|
|
4898
5161
|
|
|
4899
5162
|
业务对象的新建与编辑表单对话框。
|
|
4900
5163
|
|
|
4901
|
-
已登记宽度:`small` 720px、`large` 960px
|
|
4902
|
-
且**绝不超出有效视口**。
|
|
5164
|
+
已登记宽度:`small` 720px、`large` 960px、`xlarge` 1280px,**只有这三种**,
|
|
5165
|
+
且**绝不超出有效视口**。1280 是 GAP Design kit 弹窗宽度区间的上限(业财平台 round-01 裁决)。
|
|
4903
5166
|
|
|
4904
5167
|
字段以 `Field` 子元素传入,默认排布在两列网格上;
|
|
4905
5168
|
需要跨列的字段给 `Field` 传 `span="full"`。
|
|
4906
5169
|
|
|
5170
|
+
页头右侧恒有一个纯图标的关闭按钮(可访问名「关闭」),行为等同 `onCancel`,
|
|
5171
|
+
提交中禁用 —— 与 `Dialog` 一致。
|
|
5172
|
+
|
|
5173
|
+
外观(GAP Design kit「抽屉弹窗 / 弹窗」188:685,业财平台 round-01 起):面板圆角 20;
|
|
5174
|
+
48px 灰底页头,标题与关闭键间隔 10;主体灰底、内含一张白卡承载字段网格,字段间距 10;
|
|
5175
|
+
底部动作区同为灰底、内边距 12、动作间隔 4、顶部 0.5px 分隔线。
|
|
5176
|
+
|
|
4907
5177
|
⚠ **提交失败显示为主体顶部的 `Alert`,不是 toast** ——
|
|
4908
5178
|
用户必须处理的失败绝不能放进转瞬即逝的提示里。
|
|
4909
5179
|
|
|
@@ -4913,37 +5183,41 @@ DETAIL 的**抽屉载体** —— 打开一条记录的详情而不丢失身后
|
|
|
4913
5183
|
|---|---|:---:|---|
|
|
4914
5184
|
| `open` | `boolean` | 否 | 是否打开。为 false 时渲染 `null` |
|
|
4915
5185
|
| `title` | `ReactNode` | 否 | 标题 |
|
|
4916
|
-
| `description` | `ReactNode` | 否 |
|
|
4917
|
-
| `size` | `'small' \| 'large'` | 否 |
|
|
5186
|
+
| `description` | `ReactNode` | 否 | 补充说明,与标题同行、以 14/20 label 色跟在标题之后。只写一句短语 |
|
|
5187
|
+
| `size` | `'small' \| 'large' \| 'xlarge'` | 否 | 宽度档位。`small` 720px / `large` 960px / `xlarge` 1280px。 `xlarge` 是 GAP Design kit 弹窗宽度区间(680–1280)的上限,用于字段多、需要左右并排 原件与表单的编辑场景(业财平台 round-01 · editor/dialog/width 裁决,2026-11-10) |
|
|
4918
5188
|
| `columns` | `number` | 否 | 字段网格列数。默认 2 |
|
|
4919
5189
|
| `submitText` | `string` | 否 | 提交按钮文案 |
|
|
4920
5190
|
| `cancelText` | `string` | 否 | 取消按钮文案 |
|
|
4921
5191
|
| `submitting` | `boolean` | 否 | 提交中。阻断重复提交并给出忙态 |
|
|
4922
5192
|
| `error` | `ReactNode` | 否 | 提交级失败,通常传 `<Alert tone="danger">`,渲染在主体顶部 |
|
|
4923
5193
|
| `onSubmit` | `() => void` | 否 | 提交回调 |
|
|
4924
|
-
| `onCancel` | `() => void` | 否 |
|
|
5194
|
+
| `onCancel` | `() => void` | 否 | 取消回调。页头关闭按钮、Esc 与遮罩点击同样触发它 |
|
|
5195
|
+
| `secondaryActions` | `ReactNode` | 否 | 底部动作区的附加次要动作,排在「取消」与提交按钮之间,例如逐条编辑时的 「上一张」「下一张」。传 `SystemButton`(`intent="secondary"`)。 **不得**放第二个 primary,也不得放删除类动作 —— 删除不与提交并排出现在页脚。 |
|
|
5196
|
+
| `footerNote` | `ReactNode` | 否 | 底部动作区左侧的一段说明,12/16 label 色,例如「共 100 条,当前第 6 条」。 只写与本次提交相关的上下文;校验错误与提交失败**不得**写在这里(前者在字段、后者是 `error`)。 |
|
|
4925
5197
|
| `children` | `ReactNode` | 否 | 表单字段,传 `Field` 子元素 |
|
|
4926
5198
|
|
|
4927
5199
|
继承 `HTMLAttributes<HTMLDivElement>` 的全部原生属性,其中 `title` 已被本组件重新定义或移除。
|
|
4928
5200
|
|
|
4929
5201
|
**用途。** 业务对象新建与编辑的模态表单载体,拥有已登记的字段网格与提交 / 取消语义。
|
|
4930
5202
|
|
|
4931
|
-
**何时使用。** 用户必须完成或放弃的表单任务一律用本组件。已登记宽度只有 `small` 720px 与 `
|
|
5203
|
+
**何时使用。** 用户必须完成或放弃的表单任务一律用本组件。已登记宽度只有 `small` 720px、`large` 960px 与 `xlarge` 1280px 三档(1280 是 GAP Design kit 弹窗宽度区间 680–1280 的上限,业财平台 round-01 裁决),字段默认排布在两列网格上。`xlarge` 只给字段多、需要原件与表单左右并排的编辑场景。提交中由 `submitting` 表达,提交级失败由 `error` 表达。该组件建立在共享 Overlay 基座上,因此自带 Esc 关闭、焦点陷阱、关闭后焦点恢复与背景滚动锁定。
|
|
4932
5204
|
|
|
4933
5205
|
**何时改用其他组件。**
|
|
4934
5206
|
- 不含表单的聚焦任务(导入映射、确认预览)改用 Foundation `Dialog`。
|
|
4935
5207
|
- 不可逆动作的确认改用 `AlertDialog` —— 它的遮罩点击不关闭,破坏性确认必须是显式选择。
|
|
4936
5208
|
- 人员、组织、审核人、通知接收人的目录式选择改用 `PeoplePickerDialog`。
|
|
4937
5209
|
- 只读的业务对象详情改用 `ApplicationDetailDrawer` 或独立详情页。
|
|
4938
|
-
-
|
|
4939
|
-
-
|
|
5210
|
+
- 帮助、附件预览这类辅助性面板改用 `Sheet`;全局设置是二级导航里的设置模块。
|
|
5211
|
+
- 字段规模超出三档宽度可承载的范围时,改用独立编辑页承载。
|
|
4940
5212
|
|
|
4941
|
-
**组合约定。** 字段一律以 `Field` 子元素传入 `children`,一个 `Field` 管辖一个控件。需要跨列的字段给 `Field` 传 `span="full"`,不得用内联 `style` 写 `gridColumn`;需要单列或三列时改 `columns`,不要用外部 CSS 重排网格。字段级错误交给 `Field` 的 `error`,并且控件自身的 `invalid` 需另行设置 —— 两者不联动。提交级失败传 `error`,内容应是 `<Alert tone="danger">`,由组件渲染在主体顶部、字段网格之前。主体与底部动作区包在一个 `<form>` 里,主按钮是提交按钮,字段内按 Enter 即提交并调用 `onSubmit`;浏览器自带校验已关闭,字段校验一律走 `Field`。`submitting` 为 true 时组件禁用主按钮并置忙态,同时屏蔽 Esc 与遮罩点击两条关闭路径,取消按钮仍可用;调用方仍须在自己的提交回调里防止重复请求。底部动作区由组件持有,取消在左、主操作在右,文案经 `submitText` / `cancelText`
|
|
5213
|
+
**组合约定。** 字段一律以 `Field` 子元素传入 `children`,一个 `Field` 管辖一个控件。需要跨列的字段给 `Field` 传 `span="full"`,不得用内联 `style` 写 `gridColumn`;需要单列或三列时改 `columns`,不要用外部 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 基座负责,调用方不得再包一层定位容器。
|
|
4942
5214
|
|
|
4943
5215
|
**禁止 / 使用边界。**
|
|
4944
5216
|
- 不得把提交失败呈现为 `Sonner` —— 用户必须处理的失败绝不能放进转瞬即逝的提示里。
|
|
4945
5217
|
- 不得在 `children` 里自行渲染提交与取消按钮,底部动作区由组件持有。
|
|
4946
|
-
-
|
|
5218
|
+
- 不得经 `secondaryActions` 放第二个 primary 或删除类动作,也不得把校验错误写进 `footerNote`。
|
|
5219
|
+
- 禁止把宽度改到 720px / 960px / 1280px 三档之外,也禁止让对话框超出有效视口。
|
|
5220
|
+
- 不得用 `className` 把面板圆角改回 16 或其他值 —— 四个模态弹窗同取 `--application-radius-dialog`。
|
|
4947
5221
|
- 不得用本组件承载只读详情,详情有它自己的两个载体。
|
|
4948
5222
|
- 不得在 `children` 内用内联 style 改写控件自身的边框、高度或圆角。
|
|
4949
5223
|
|
|
@@ -4952,7 +5226,7 @@ DETAIL 的**抽屉载体** —— 打开一条记录的详情而不丢失身后
|
|
|
4952
5226
|
`import { ApplicationGlobalActionPanel } from '@moheng-design/ui'` · 契约 `contracts/application-module/overlays/application-global-action-panel.ts`
|
|
4953
5227
|
|
|
4954
5228
|
四个 popover 型全局动作**共享的同一个面板** ——
|
|
4955
|
-
消息 / 待办 /
|
|
5229
|
+
消息 / 待办 / 总览 / 风险预警。
|
|
4956
5230
|
|
|
4957
5231
|
⚠ **一个面板,四套内容。绝不为每个动作单独造一个弹层。**
|
|
4958
5232
|
|
|
@@ -4963,8 +5237,8 @@ DETAIL 的**抽屉载体** —— 打开一条记录的详情而不丢失身后
|
|
|
4963
5237
|
非模态:不锁滚动、不陷阱焦点。**Esc 关闭**由本组件承担(进库内的 Esc 层级栈,
|
|
4964
5238
|
上层浮层先响应),关闭后焦点归还给打开它的全局动作按钮。外点击关闭由调用方判定。
|
|
4965
5239
|
|
|
4966
|
-
⚠
|
|
4967
|
-
|
|
5240
|
+
⚠ **设置**不走本面板:它让 `ApplicationSecondaryNavigation` 换成设置模块
|
|
5241
|
+
(`onAction` 给它的 `kind` 是 `'module'`);且**绝不能存在第二个设置入口**。
|
|
4968
5242
|
|
|
4969
5243
|
**Props**
|
|
4970
5244
|
|
|
@@ -4996,12 +5270,12 @@ DETAIL 的**抽屉载体** —— 打开一条记录的详情而不丢失身后
|
|
|
4996
5270
|
| `label` | `ReactNode` | 是 | 标签文字 |
|
|
4997
5271
|
| `count` | `number` | 否 | 计数 |
|
|
4998
5272
|
|
|
4999
|
-
**用途。**
|
|
5273
|
+
**用途。** 消息、待办、总览、风险预警这四个 popover 型全局动作共享的同一个面板。
|
|
5000
5274
|
|
|
5001
5275
|
**何时使用。** 该面板由 `ApplicationPrimaryNavigation` 的右侧动作簇触发,`onAction` 回调的 `kind` 为 `'popover'` 时打开本组件。四个动作复用同一个实例,切换的只是 `title`、`tabs` 与 `children`。它不是模态:背景仍可交互,因此不锁滚动、不陷阱焦点;但打开时焦点移入面板的首个可聚焦元素,Esc 关闭由本组件承担,并与库内其他浮层共用同一个 Esc 层级栈(上层浮层先响应),关闭后焦点归还给打开它的全局动作按钮。由于不陷阱焦点,面板在 DOM 中的挂载位置决定从它 Tab 出去之后的顺序,建议紧跟触发它的全局动作挂载。
|
|
5002
5276
|
|
|
5003
5277
|
**何时改用其他组件。**
|
|
5004
|
-
- 设置改用 `
|
|
5278
|
+
- 设置改用 `ApplicationSecondaryNavigation` 的设置模块 —— `onAction` 对它给出的 `kind` 是 `'module'`,它不走本面板。
|
|
5005
5279
|
- 页面内的锚定浮层(常用筛选、更多筛选、呈现设置)改用 `Popover`,那是 Canvas 的事。
|
|
5006
5280
|
- 必须完成或放弃的聚焦任务改用 `Dialog` 或 `ApplicationFormDialog`。
|
|
5007
5281
|
- 业务页面内容一律留在 Canvas,不进入 Shell 层的任何浮层。
|
|
@@ -5440,15 +5714,17 @@ import '@moheng-design/ui/styles.css'
|
|
|
5440
5714
|
### 通用的「视图设置」按钮
|
|
5441
5715
|
|
|
5442
5716
|
```jsx
|
|
5443
|
-
// 不要这样写
|
|
5717
|
+
// 不要这样写 —— 自己拼一个设置按钮,名字还是通用的
|
|
5444
5718
|
<SystemButton>视图设置</SystemButton>
|
|
5719
|
+
<SystemButton>自定义</SystemButton>
|
|
5445
5720
|
|
|
5446
|
-
// 要这样写 ——
|
|
5447
|
-
<
|
|
5448
|
-
<
|
|
5721
|
+
// 要这样写 —— 交给工具栏,它按当前呈现方式命名
|
|
5722
|
+
<ApplicationQueryToolbar presentation="DataTable" onPresentationSettings={openColumns} /> {/* 列设置 */}
|
|
5723
|
+
<ApplicationQueryToolbar presentation="KanbanBoard" onPresentationSettings={openBoard} /> {/* 看板设置 */}
|
|
5449
5724
|
```
|
|
5450
5725
|
|
|
5451
|
-
|
|
5726
|
+
呈现设置是一个*概念*,不是一个按钮名。工具栏的设置按钮按 GAP Design kit 是 32×32 纯图标,
|
|
5727
|
+
名字落在可访问名与悬停提示上,必须按当前呈现方式命名:
|
|
5452
5728
|
`列设置` / `列表设置` / `卡片设置` / `看板设置` / `日历设置` / `图表设置` / `时间轴设置`。
|
|
5453
5729
|
|
|
5454
5730
|
### 六种数据状态共用一句话
|
|
@@ -5541,7 +5817,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5541
5817
|
|
|
5542
5818
|
## 规则清单
|
|
5543
5819
|
|
|
5544
|
-
共
|
|
5820
|
+
共 165 条。完整数据见 `generated/rules.json`。
|
|
5545
5821
|
|
|
5546
5822
|
| 规则 id | kind | scope | 级别 | 报错文案 |
|
|
5547
5823
|
|---|---|---|---|---|
|
|
@@ -5568,10 +5844,10 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5568
5844
|
| `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 间距档,出现这类值说明取错了标尺 |
|
|
5569
5845
|
| `no-unregistered-font` | forbid-value | internal | error | 禁止直接书写字族。请改用 var(--ds-font-family),等宽场景用 var(--ds-font-family-mono)。系统只有单一字族,没有展示体,也没有搭配字体 |
|
|
5570
5846
|
| `props-whitelist-icon` | props-whitelist | both | warn | <Icon> 不接受该 prop。已声明的 props:name、size、strokeWidth、color、style。继承自 SVGProps<SVGSVGElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5571
|
-
| `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' \| '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' 之一 |
|
|
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' 之一 |
|
|
5572
5848
|
| `prop-enum-icon-size` | prop-enum | both | warn | <Icon> 的 size 取值须为 14 \| 16 \| 18 \| 20 \| 24 之一 |
|
|
5573
5849
|
| `props-whitelist-button` | props-whitelist | both | warn | <Button> 不接受该 prop。已声明的 props:variant、size、iconOnly、disabled、children。继承自 ButtonHTMLAttributes<HTMLButtonElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5574
|
-
| `prop-enum-button-variant` | prop-enum | both | warn | <Button> 的 variant 取值须为 'primary' \| 'secondary' \| 'outline' \| 'ghost' \| 'destructive' \| 'link' 之一 |
|
|
5850
|
+
| `prop-enum-button-variant` | prop-enum | both | warn | <Button> 的 variant 取值须为 'primary' \| 'secondary' \| 'outline' \| 'ghost' \| 'destructive' \| 'destructive-outline' \| 'link' 之一 |
|
|
5575
5851
|
| `prop-enum-button-size` | prop-enum | both | warn | <Button> 的 size 取值须为 'xs' \| 'sm' \| 'default' \| 'lg' 之一 |
|
|
5576
5852
|
| `props-whitelist-button-group` | props-whitelist | both | warn | <ButtonGroup> 不接受该 prop。已声明的 props:children、orientation、attached。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5577
5853
|
| `prop-enum-button-group-orientation` | prop-enum | both | warn | <ButtonGroup> 的 orientation 取值须为 'horizontal' \| 'vertical' 之一 |
|
|
@@ -5583,6 +5859,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5583
5859
|
| `props-whitelist-calendar` | props-whitelist | both | warn | <Calendar> 不接受该 prop。已声明的 props:month、selected、onSelect、today。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5584
5860
|
| `props-whitelist-checkbox` | props-whitelist | both | warn | <Checkbox> 不接受该 prop。已声明的 props:checked、defaultChecked、indeterminate、onCheckedChange、label、invalid。继承自 InputHTMLAttributes<HTMLInputElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5585
5861
|
| `props-whitelist-combobox` | props-whitelist | both | warn | <Combobox> 不接受该 prop。已声明的 props:options、value、defaultValue、onValueChange、placeholder、emptyText、disabled、invalid。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5862
|
+
| `props-whitelist-date-input` | props-whitelist | both | warn | <DateInput> 不接受该 prop。已声明的 props:value、defaultValue、onValueChange、placeholder、disabled、invalid、today。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5586
5863
|
| `props-whitelist-field` | props-whitelist | both | warn | <Field> 不接受该 prop。已声明的 props:label、description、error、required、htmlFor、span、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5587
5864
|
| `props-whitelist-input` | props-whitelist | both | warn | <Input> 不接受该 prop。已声明的 props:invalid。继承自 InputHTMLAttributes<HTMLInputElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5588
5865
|
| `props-whitelist-input-group` | props-whitelist | both | warn | <InputGroup> 不接受该 prop。已声明的 props:leading、trailing、children、disabled、invalid。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
@@ -5631,13 +5908,13 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5631
5908
|
| `props-whitelist-separator` | props-whitelist | both | warn | <Separator> 不接受该 prop。已声明的 props:orientation、label、spacing。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5632
5909
|
| `prop-enum-separator-orientation` | prop-enum | both | warn | <Separator> 的 orientation 取值须为 'horizontal' \| 'vertical' 之一 |
|
|
5633
5910
|
| `props-whitelist-skeleton` | props-whitelist | both | warn | <Skeleton> 不接受该 prop。已声明的 props:width、height、radius、lines。继承自 HTMLAttributes<HTMLSpanElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5634
|
-
| `props-whitelist-table` | props-whitelist | both | warn | <Table> 不接受该 prop。已声明的 props:columns、rows、rowKey、selectable、selected、onSelectedChange、onRowClick、sort、onSortChange、empty、density。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5911
|
+
| `props-whitelist-table` | props-whitelist | both | warn | <Table> 不接受该 prop。已声明的 props:columns、rows、rowKey、selectable、selected、onSelectedChange、onRowClick、sort、onSortChange、empty、density、trailingRow。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5635
5912
|
| `prop-enum-table-density` | prop-enum | both | warn | <Table> 的 density 取值须为 'default' \| 'sm' 之一 |
|
|
5636
5913
|
| `props-whitelist-alert` | props-whitelist | both | warn | <Alert> 不接受该 prop。已声明的 props:tone、title、action、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5637
5914
|
| `prop-enum-alert-tone` | prop-enum | both | warn | <Alert> 的 tone 取值须为 'info' \| 'success' \| 'warning' \| 'danger' 之一 |
|
|
5638
5915
|
| `props-whitelist-alert-dialog` | props-whitelist | both | warn | <AlertDialog> 不接受该 prop。已声明的 props:open、title、description、confirmText、cancelText、destructive、onConfirm、onCancel、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5639
5916
|
| `props-whitelist-collapsible` | props-whitelist | both | warn | <Collapsible> 不接受该 prop。已声明的 props:label、defaultOpen、open、onOpenChange、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5640
|
-
| `props-whitelist-dialog` | props-whitelist | both | warn | <Dialog> 不接受该 prop。已声明的 props:open、title、description、size、footer、onClose、initialFocus、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5917
|
+
| `props-whitelist-dialog` | props-whitelist | both | warn | <Dialog> 不接受该 prop。已声明的 props:open、title、description、size、footer、footerNote、onClose、initialFocus、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5641
5918
|
| `props-whitelist-drawer` | props-whitelist | both | warn | <Drawer> 不接受该 prop。已声明的 props:open、title、width、side、footer、onClose、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5642
5919
|
| `prop-enum-drawer-side` | prop-enum | both | warn | <Drawer> 的 side 取值须为 'right' \| 'left' 之一 |
|
|
5643
5920
|
| `props-whitelist-dropdown-menu` | props-whitelist | both | warn | <DropdownMenu> 不接受该 prop。已声明的 props:trigger、items、onSelect、align。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
@@ -5654,21 +5931,22 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5654
5931
|
| `props-whitelist-spinner` | props-whitelist | both | warn | <Spinner> 不接受该 prop。已声明的 props:size、label。继承自 HTMLAttributes<HTMLSpanElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5655
5932
|
| `props-whitelist-tooltip` | props-whitelist | both | warn | <Tooltip> 不接受该 prop。已声明的 props:content、side、children。继承自 HTMLAttributes<HTMLSpanElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5656
5933
|
| `prop-enum-tooltip-side` | prop-enum | both | warn | <Tooltip> 的 side 取值须为 'top' \| 'bottom' \| 'left' \| 'right' 之一 |
|
|
5934
|
+
| `props-whitelist-application-date-range-filter` | props-whitelist | both | warn | <ApplicationDateRangeFilter> 不接受该 prop。已声明的 props:label、labelText、value、onValueChange、disabled、today。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5657
5935
|
| `props-whitelist-application-filter-menu` | props-whitelist | both | warn | <ApplicationFilterMenu> 不接受该 prop。已声明的 props:label、options、value、defaultValue、onValueChange、multiple、disabled。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5658
5936
|
| `props-whitelist-list-selection-checkbox` | props-whitelist | both | warn | <ListSelectionCheckbox> 不接受该 prop。已声明的 props:checked、indeterminate、onCheckedChange、scope、disabled。继承自 HTMLAttributes<HTMLSpanElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5659
5937
|
| `prop-enum-list-selection-checkbox-scope` | prop-enum | both | warn | <ListSelectionCheckbox> 的 scope 取值须为 'row' \| 'all' 之一 |
|
|
5660
|
-
| `props-whitelist-list-table-pagination` | props-whitelist | both | warn | <ListTablePagination> 不接受该 prop。已声明的 props:page、pageSize、total、pageSizeOptions、onPageChange、onPageSizeChange。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5938
|
+
| `props-whitelist-list-table-pagination` | props-whitelist | both | warn | <ListTablePagination> 不接受该 prop。已声明的 props:page、pageSize、total、pageSizeOptions、showJumper、onPageChange、onPageSizeChange。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5661
5939
|
| `props-whitelist-search-field` | props-whitelist | both | warn | <SearchField> 不接受该 prop。已声明的 props:value、defaultValue、onChange、onSubmit、placeholder、ariaLabel、disabled、inputProps。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5662
5940
|
| `props-whitelist-sidebar-app-link-button` | props-whitelist | both | warn | <SidebarAppLinkButton> 不接受该 prop。已声明的 props:name、glyph、description。继承自 ButtonHTMLAttributes<HTMLButtonElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5663
5941
|
| `props-whitelist-sidebar-rail-button` | props-whitelist | both | warn | <SidebarRailButton> 不接受该 prop。已声明的 props:icon、label、active、badge。继承自 ButtonHTMLAttributes<HTMLButtonElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5664
5942
|
| `props-whitelist-system-button` | props-whitelist | both | warn | <SystemButton> 不接受该 prop。已声明的 props:intent、size、iconOnly、loading、children。继承自 ButtonHTMLAttributes<HTMLButtonElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5665
|
-
| `prop-enum-system-button-intent` | prop-enum | both | warn | <SystemButton> 的 intent 取值须为 'primary' \| 'secondary' \| 'quiet' \| 'link' \| 'destructive' 之一 |
|
|
5943
|
+
| `prop-enum-system-button-intent` | prop-enum | both | warn | <SystemButton> 的 intent 取值须为 'primary' \| 'secondary' \| 'quiet' \| 'link' \| 'destructive' \| 'destructive-outline' 之一 |
|
|
5666
5944
|
| `prop-enum-system-button-size` | prop-enum | both | warn | <SystemButton> 的 size 取值须为 'default' \| 'compact' \| 'sm' 之一 |
|
|
5667
|
-
| `props-whitelist-application-module-switcher` | props-whitelist | both | warn | <ApplicationModuleSwitcher> 不接受该 prop。已声明的 props:moduleName、modules、currentModule、
|
|
5668
|
-
| `props-whitelist-application-primary-navigation` | props-whitelist | both | warn | <ApplicationPrimaryNavigation> 不接受该 prop。已声明的 props:appName、
|
|
5669
|
-
| `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' \| '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' 之一 |
|
|
5945
|
+
| `props-whitelist-application-module-switcher` | props-whitelist | both | warn | <ApplicationModuleSwitcher> 不接受该 prop。已声明的 props:moduleName、modules、currentModule、open、onOpenChange、onSelect。继承自 ButtonHTMLAttributes<HTMLButtonElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5946
|
+
| `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' 之一 |
|
|
5670
5948
|
| `prop-enum-application-primary-navigation-active-action` | prop-enum | both | warn | <ApplicationPrimaryNavigation> 的 activeAction 取值须为 'messages' \| 'todos' \| 'overview' \| 'risk' \| 'settings' 之一 |
|
|
5671
|
-
| `props-whitelist-application-secondary-navigation` | props-whitelist | both | warn | <ApplicationSecondaryNavigation> 不接受该 prop。已声明的 props:moduleSwitcher、tabs、value、onValueChange。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5949
|
+
| `props-whitelist-application-secondary-navigation` | props-whitelist | both | warn | <ApplicationSecondaryNavigation> 不接受该 prop。已声明的 props:moduleSwitcher、tabs、value、onValueChange、onNavigationSettings、navigationSettingsOpen、onCloseSettings。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5672
5950
|
| `props-whitelist-global-sidebar` | props-whitelist | both | warn | <GlobalSidebar> 不接受该 prop。已声明的 props:items、value、onValueChange、footer。继承自 HTMLAttributes<HTMLElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5673
5951
|
| `props-whitelist-top-navigation-primary-bar` | props-whitelist | both | warn | <TopNavigationPrimaryBar> 不接受该 prop。已声明的 props:brandName、brandLogoSrc、center、accountName、onAppSwitch、onAccount、appSwitchOpen、accountOpen。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5674
5952
|
| `props-whitelist-application-metric-chart` | props-whitelist | both | warn | <ApplicationMetricChart> 不接受该 prop。已声明的 props:label、value、unit、data、colorIndex。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
@@ -5683,21 +5961,21 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5683
5961
|
| `prop-enum-application-data-display-presentation` | prop-enum | both | warn | <ApplicationDataDisplay> 的 presentation 取值须为 'DataTable' \| 'RecordList' \| 'CardList' \| 'KanbanBoard' \| 'Calendar' \| 'Chart' \| 'Timeline' 之一 |
|
|
5684
5962
|
| `prop-enum-application-data-display-state` | prop-enum | both | warn | <ApplicationDataDisplay> 的 state 取值须为 'ready' \| 'loading' \| 'empty' \| 'error' \| 'no-permission' \| 'not-found' 之一 |
|
|
5685
5963
|
| `props-whitelist-application-filter-list` | props-whitelist | both | warn | <ApplicationFilterList> 不接受该 prop。已声明的 props:groups、values、onChange、onApply、onReset、search。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5686
|
-
| `props-whitelist-application-page-header` | props-whitelist | both | warn | <ApplicationPageHeader> 不接受该 prop。已声明的 props:title、subtitle、dataStatus、updatedAt、onRefresh、actions、pageModes、pageMode、onPageModeChange、breadcrumb。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5964
|
+
| `props-whitelist-application-page-header` | props-whitelist | both | warn | <ApplicationPageHeader> 不接受该 prop。已声明的 props:title、subtitle、dataStatus、updatedAt、onRefresh、onBack、backLabel、taskStatus、actions、pageModes、pageMode、onPageModeChange、breadcrumb。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5687
5965
|
| `prop-enum-application-page-header-data-status` | prop-enum | both | warn | <ApplicationPageHeader> 的 dataStatus 取值须为 'normal' \| 'refreshing' \| 'failed' 之一 |
|
|
5688
5966
|
| `prop-enum-application-page-header-page-mode` | prop-enum | both | warn | <ApplicationPageHeader> 的 pageMode 取值须为 'LIST' \| 'CARD' \| 'SPLIT' \| 'BOARD' \| 'CALENDAR' 之一 |
|
|
5689
5967
|
| `props-whitelist-application-page-layout-container` | props-whitelist | both | warn | <ApplicationPageLayoutContainer> 不接受该 prop。已声明的 props:pageType、header、metrics、dataControl、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5690
5968
|
| `prop-enum-application-page-layout-container-page-type` | prop-enum | both | warn | <ApplicationPageLayoutContainer> 的 pageType 取值须为 'WORKBENCH' \| 'MANAGEMENT' \| 'LEDGER' \| 'ANALYSIS' \| 'REPORT' \| 'DETAIL' 之一 |
|
|
5691
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-* 等)可直接传,会透传到底层元素 |
|
|
5692
5970
|
| `prop-enum-application-query-toolbar-presentation` | prop-enum | both | warn | <ApplicationQueryToolbar> 的 presentation 取值须为 'DataTable' \| 'RecordList' \| 'CardList' \| 'KanbanBoard' \| 'Calendar' \| 'Chart' \| 'Timeline' 之一 |
|
|
5693
|
-
| `props-whitelist-application-record-detail-body` | props-whitelist | both | warn | <ApplicationRecordDetailBody> 不接受该 prop。已声明的 props:summary、sections。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5971
|
+
| `props-whitelist-application-record-detail-body` | props-whitelist | both | warn | <ApplicationRecordDetailBody> 不接受该 prop。已声明的 props:summary、sections、aside。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5694
5972
|
| `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-* 等)可直接传,会透传到底层元素 |
|
|
5695
5973
|
| `props-whitelist-application-record-list` | props-whitelist | both | warn | <ApplicationRecordList> 不接受该 prop。已声明的 props:records、selectable、selected、onSelectedChange、activeId、onOpen、renderRow。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5696
5974
|
| `props-whitelist-list-batch-action-bar` | props-whitelist | both | warn | <ListBatchActionBar> 不接受该 prop。已声明的 props:count、onClear、actions、hint。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5697
5975
|
| `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-* 等)可直接传,会透传到底层元素 |
|
|
5698
5976
|
| `prop-enum-application-detail-drawer-side` | prop-enum | both | warn | <ApplicationDetailDrawer> 的 side 取值须为 'left' \| 'right' 之一 |
|
|
5699
|
-
| `props-whitelist-application-form-dialog` | props-whitelist | both | warn | <ApplicationFormDialog> 不接受该 prop。已声明的 props:open、title、description、size、columns、submitText、cancelText、submitting、error、onSubmit、onCancel、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5700
|
-
| `prop-enum-application-form-dialog-size` | prop-enum | both | warn | <ApplicationFormDialog> 的 size 取值须为 'small' \| 'large' 之一 |
|
|
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-* 等)可直接传,会透传到底层元素 |
|
|
5978
|
+
| `prop-enum-application-form-dialog-size` | prop-enum | both | warn | <ApplicationFormDialog> 的 size 取值须为 'small' \| 'large' \| 'xlarge' 之一 |
|
|
5701
5979
|
| `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-* 等)可直接传,会透传到底层元素 |
|
|
5702
5980
|
| `prop-enum-application-global-action-panel-state` | prop-enum | both | warn | <ApplicationGlobalActionPanel> 的 state 取值须为 'ready' \| 'loading' \| 'empty' \| 'error' \| 'no-permission' 之一 |
|
|
5703
5981
|
| `props-whitelist-people-picker-dialog` | props-whitelist | both | warn | <PeoplePickerDialog> 不接受该 prop。已声明的 props:open、title、people、selected、onSelectedChange、multiple、onConfirm、onCancel。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
@@ -5711,27 +5989,29 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5711
5989
|
|
|
5712
5990
|
## 图标字形
|
|
5713
5991
|
|
|
5714
|
-
共
|
|
5992
|
+
共 35 个。`<Icon name>` 只接受下表的名字(类型 `IconName`,清单外的名字在 tsc 与 `prop-enum` 两处被拒),尺寸只取登记档 14 / 16 / 18 / 20 / 24;
|
|
5715
5993
|
绕过类型检查的未登记名字渲染为等尺寸占位盒。确需新字形须先登记进 `@moheng-design/ui` 的图标清单并随包发版,
|
|
5716
5994
|
不得改用内联 `<svg>`。表中用途是该字形在库内的登记用途,业务侧可复用同一字形表达同义动作。
|
|
5717
5995
|
|
|
5718
5996
|
| 名字 | 登记用途 |
|
|
5719
5997
|
|---|---|
|
|
5720
|
-
| `activity` |
|
|
5998
|
+
| `activity` | 全局动作「总览」的字形(18px 档) |
|
|
5721
5999
|
| `arrow-down` | ApplicationMetricTrend 的下降方向字形(14px 档) |
|
|
5722
6000
|
| `arrow-up` | ApplicationMetricTrend 的上升方向字形(14px 档) |
|
|
5723
6001
|
| `calendar` | Page Mode Switch 的 CALENDAR 档字形(16px 档) |
|
|
5724
|
-
| `check` | Select / Combobox
|
|
6002
|
+
| `check` | Select / Combobox 浮层里的选中对勾;ApplicationModuleSwitcher 面板的当前模块(14px chevron 档) |
|
|
5725
6003
|
| `chevron-down` | Collapsible 触发器的展开指示;下拉类控件的通用指示符(14px 档) |
|
|
5726
|
-
| `chevron-left` | Calendar 的上一月导航(14px 档) |
|
|
5727
|
-
| `chevron-right` | Breadcrumb 的层级分隔符;向前展开的通用指示符(14px 档) |
|
|
6004
|
+
| `chevron-left` | Calendar 的上一月导航(14px 档);Pagination 上一页与 ApplicationPageHeader 返回按钮(16px 档) |
|
|
6005
|
+
| `chevron-right` | Breadcrumb 的层级分隔符;向前展开的通用指示符(14px 档);Pagination 下一页(16px 档) |
|
|
6006
|
+
| `chevrons-left` | Pagination 首页(16px 档) |
|
|
6007
|
+
| `chevrons-right` | Pagination 末页(16px 档) |
|
|
5728
6008
|
| `chevron-up` | Table 表头的升序指示符(14px 档) |
|
|
5729
|
-
| `circle-alert` | Alert 的 danger
|
|
6009
|
+
| `circle-alert` | Alert 的 danger 状态图标;AlertDialog 页头的提示图标(20px 档,警示色) |
|
|
5730
6010
|
| `circle-check` | Alert 的 success 状态图标 |
|
|
5731
6011
|
| `circle-check-big` | 全局动作「待办」的字形(18px 档) |
|
|
5732
6012
|
| `columns-2` | Page Mode Switch 的 SPLIT 档字形(16px 档) |
|
|
5733
6013
|
| `download` | 业务页「导出 / 下载」动作的前置字形(14 / 16px 档) |
|
|
5734
|
-
| `ellipsis` |
|
|
6014
|
+
| `ellipsis` | 行内「更多操作」菜单的触发器字形;Pagination 页码跳空处(16px 档) |
|
|
5735
6015
|
| `funnel` | 工具栏「筛选 / 更多筛选」触发器的字形(14 / 16px 档);lucide 已把 filter 更名为 funnel |
|
|
5736
6016
|
| `info` | Alert 的 info 状态图标 |
|
|
5737
6017
|
| `kanban` | Page Mode Switch 的 BOARD 档字形(16px 档) |
|
|
@@ -5741,11 +6021,11 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5741
6021
|
| `minus` | ApplicationMetricTrend 的持平方向字形(14px 档) |
|
|
5742
6022
|
| `pencil` | 业务页「编辑」动作的字形,含行内操作(14 / 16px 档) |
|
|
5743
6023
|
| `plus` | 业务页「新建」动作的前置字形(SystemButton 内 14 / 16px 档) |
|
|
5744
|
-
| `refresh-cw` | ApplicationPageHeader
|
|
6024
|
+
| `refresh-cw` | ApplicationPageHeader 的数据刷新触发器,接在更新时间之后(16px 档) |
|
|
5745
6025
|
| `search` | Command 面板的搜索框前置图标;SearchField 同款(16px 档) |
|
|
5746
6026
|
| `settings` | 全局动作「设置」的字形(18px 档) |
|
|
5747
|
-
| `shield-check` | ApplicationPrimaryNavigation 应用 logo 的 mock 字形默认值(
|
|
5748
|
-
| `sliders-horizontal` | ApplicationQueryToolbar
|
|
6027
|
+
| `shield-check` | ApplicationPrimaryNavigation 应用 logo 的 mock 字形默认值(20px 档) |
|
|
6028
|
+
| `sliders-horizontal` | ApplicationQueryToolbar 的呈现设置按钮与 ApplicationSecondaryNavigation 的导航设置按钮(16px 档,纯图标;kit「二级导航设置」字形逐点吻合) |
|
|
5749
6029
|
| `trash-2` | 业务页「删除」动作的字形,含行内与批量条(14 / 16px 档) |
|
|
5750
6030
|
| `triangle-alert` | Alert 的 warning 状态图标 |
|
|
5751
6031
|
| `upload` | 业务页「导入 / 上传」动作的前置字形(14 / 16px 档) |
|
|
@@ -5753,7 +6033,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5753
6033
|
|
|
5754
6034
|
## Token 全表
|
|
5755
6035
|
|
|
5756
|
-
共
|
|
6036
|
+
共 389 条:`--application-*` 101 条、`--ui-*` 145 条、`--ds-*` 143 条。源是 `packages/ui/src/tokens/*.css`(01 §4.1),
|
|
5757
6037
|
本表由其导出产物 `tokens.json` 展平而来 —— CSS 是源,方向不可反转。
|
|
5758
6038
|
|
|
5759
6039
|
值即 CSS 源里的字面量,可直接写进 `var()` 的回退位或用于比对;`var(--…)` 形式表示
|
|
@@ -5775,7 +6055,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5775
6055
|
| `--application-placeholder` | `var(--ds-color-text-placeholder)` | `--application-*` |
|
|
5776
6056
|
| `--application-border` | `var(--ds-color-border)` | `--application-*` |
|
|
5777
6057
|
| `--application-divider` | `var(--ds-color-divider)` | `--application-*` |
|
|
5778
|
-
| `--application-table-header` | `var(--ds-color-
|
|
6058
|
+
| `--application-table-header` | `var(--ds-color-canvas)` | `--application-*` |
|
|
5779
6059
|
| `--application-drawer-action-secondary-border` | `var(--ds-color-divider)` | `--application-*` |
|
|
5780
6060
|
| `--application-drawer-action-secondary-text` | `var(--ds-color-text)` | `--application-*` |
|
|
5781
6061
|
| `--application-accent` | `var(--ds-color-theme-primary)` | `--application-*` |
|
|
@@ -5798,7 +6078,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5798
6078
|
| `--application-font-size-body` | `var(--ds-font-size-14)` | `--application-*` |
|
|
5799
6079
|
| `--application-font-size-title` | `var(--ds-font-size-16)` | `--application-*` |
|
|
5800
6080
|
| `--application-font-size-heading` | `var(--ds-font-size-20)` | `--application-*` |
|
|
5801
|
-
| `--application-font-size-metric` | `var(--ds-font-size-
|
|
6081
|
+
| `--application-font-size-metric` | `var(--ds-font-size-32)` | `--application-*` |
|
|
5802
6082
|
| `--application-metric-trend-up` | `var(--ds-color-text-tertiary)` | `--application-*` |
|
|
5803
6083
|
| `--application-line-height-meta` | `var(--ds-line-height-16)` | `--application-*` |
|
|
5804
6084
|
| `--application-line-height-body` | `var(--ds-line-height-20)` | `--application-*` |
|
|
@@ -5813,8 +6093,9 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5813
6093
|
| `--application-space-5` | `var(--ds-space-5)` | `--application-*` |
|
|
5814
6094
|
| `--application-form-dialog-width-small` | `720px` | `--application-*` |
|
|
5815
6095
|
| `--application-form-dialog-width-large` | `960px` | `--application-*` |
|
|
6096
|
+
| `--application-form-dialog-width-xlarge` | `1280px` | `--application-*` |
|
|
5816
6097
|
| `--application-content-header-height` | `48px` | `--application-*` |
|
|
5817
|
-
| `--application-metric-strip-height` | `
|
|
6098
|
+
| `--application-metric-strip-height` | `76px` | `--application-*` |
|
|
5818
6099
|
| `--application-toolbar-height` | `32px` | `--application-*` |
|
|
5819
6100
|
| `--application-drawer-width` | `1280px` | `--application-*` |
|
|
5820
6101
|
| `--application-categorical-10` | `var(--ds-color-categorical-10)` | `--application-*` |
|
|
@@ -5843,6 +6124,10 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5843
6124
|
| `--application-radius-12` | `var(--ds-radius-12)` | `--application-*` |
|
|
5844
6125
|
| `--application-radius-16` | `var(--ds-radius-16)` | `--application-*` |
|
|
5845
6126
|
| `--application-radius-20` | `var(--ds-radius-20)` | `--application-*` |
|
|
6127
|
+
| `--application-radius-control` | `var(--ds-radius-control)` | `--application-*` |
|
|
6128
|
+
| `--application-radius-card` | `var(--ds-radius-card)` | `--application-*` |
|
|
6129
|
+
| `--application-radius-tag` | `var(--ds-radius-tag)` | `--application-*` |
|
|
6130
|
+
| `--application-radius-dialog` | `var(--ds-radius-dialog)` | `--application-*` |
|
|
5846
6131
|
| `--application-hover-neutral` | `var(--ds-color-hover-neutral)` | `--application-*` |
|
|
5847
6132
|
| `--application-metric-delta` | `var(--application-metric-trend-up)` | `--application-*` |
|
|
5848
6133
|
| `--application-active` | `var(--ds-color-active-accent)` | `--application-*` |
|
|
@@ -5857,14 +6142,20 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5857
6142
|
| `--application-font-weight-bold` | `var(--ds-font-weight-bold)` | `--application-*` |
|
|
5858
6143
|
| `--application-nav-item-height` | `var(--ds-nav-item-height)` | `--application-*` |
|
|
5859
6144
|
| `--application-avatar-fallback-surface` | `var(--ds-color-bg-4)` | `--application-*` |
|
|
5860
|
-
| `--
|
|
6145
|
+
| `--application-hairline` | `var(--ds-hairline)` | `--application-*` |
|
|
6146
|
+
| `--application-spacing-6` | `var(--ds-spacing-6)` | `--application-*` |
|
|
6147
|
+
| `--application-spacing-10` | `var(--ds-spacing-10)` | `--application-*` |
|
|
6148
|
+
| `--application-spacing-20` | `var(--ds-spacing-20)` | `--application-*` |
|
|
6149
|
+
| `--application-tint-accent` | `var(--ds-color-tint-accent)` | `--application-*` |
|
|
6150
|
+
| `--ui-shell-primary-height` | `48px` | `--ui-*` |
|
|
5861
6151
|
| `--ui-shell-secondary-height` | `44px` | `--ui-*` |
|
|
5862
|
-
| `--ui-shell-application-title-height` | `
|
|
6152
|
+
| `--ui-shell-application-title-height` | `48px` | `--ui-*` |
|
|
5863
6153
|
| `--ui-shell-application-subnav-height` | `48px` | `--ui-*` |
|
|
5864
|
-
| `--ui-shell-application-total-height` | `calc(var(--ui-shell-
|
|
6154
|
+
| `--ui-shell-application-total-height` | `calc(var(--ui-shell-top-bar-offset,0px) + var(--ui-shell-application-title-height) + var(--ui-shell-application-subnav-height))` | `--ui-*` |
|
|
6155
|
+
| `--ui-shell-band-divider` | `inset 0 calc(-1 * var(--ds-hairline)) 0 0 var(--ds-color-border)` | `--ui-*` |
|
|
5865
6156
|
| `--ui-shell-navigation-z` | `10` | `--ui-*` |
|
|
5866
6157
|
| `--ui-shell-topbar-gap` | `var(--ds-space-5)` | `--ui-*` |
|
|
5867
|
-
| `--ui-shell-topbar-padding-block` | `var(--ds-space-
|
|
6158
|
+
| `--ui-shell-topbar-padding-block` | `var(--ds-space-2)` | `--ui-*` |
|
|
5868
6159
|
| `--ui-shell-topbar-padding-inline` | `var(--ds-space-3)` | `--ui-*` |
|
|
5869
6160
|
| `--ui-shell-topbar-backdrop-blur` | `20px` | `--ui-*` |
|
|
5870
6161
|
| `--ui-shell-brand-min-width` | `120px` | `--ui-*` |
|
|
@@ -5872,27 +6163,32 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5872
6163
|
| `--ui-shell-brand-height` | `32px` | `--ui-*` |
|
|
5873
6164
|
| `--ui-shell-account-cluster-height` | `32px` | `--ui-*` |
|
|
5874
6165
|
| `--ui-shell-account-gap` | `10px` | `--ui-*` |
|
|
6166
|
+
| `--ui-shell-account-avatar-size` | `24px` | `--ui-*` |
|
|
5875
6167
|
| `--ui-shell-control-size` | `32px` | `--ui-*` |
|
|
5876
6168
|
| `--ui-shell-topbar-icon-size` | `16px` | `--ui-*` |
|
|
5877
6169
|
| `--ui-shell-utility-icon-size` | `20px` | `--ui-*` |
|
|
5878
6170
|
| `--ui-shell-application-row-gap` | `var(--ds-space-3)` | `--ui-*` |
|
|
5879
|
-
| `--ui-shell-application-row-padding-block` | `var(--ds-space-
|
|
6171
|
+
| `--ui-shell-application-row-padding-block` | `var(--ds-space-2)` | `--ui-*` |
|
|
5880
6172
|
| `--ui-shell-application-row-padding-inline` | `var(--ds-space-3)` | `--ui-*` |
|
|
5881
|
-
| `--ui-shell-application-identity-height` | `
|
|
5882
|
-
| `--ui-shell-application-logo-size` | `
|
|
6173
|
+
| `--ui-shell-application-identity-height` | `32px` | `--ui-*` |
|
|
6174
|
+
| `--ui-shell-application-logo-size` | `32px` | `--ui-*` |
|
|
6175
|
+
| `--ui-shell-application-logo-radius` | `var(--ds-radius-8)` | `--ui-*` |
|
|
5883
6176
|
| `--ui-shell-application-logo-background` | `color-mix(in srgb,var(--application-accent) 8%,var(--application-surface))` | `--ui-*` |
|
|
5884
6177
|
| `--ui-shell-application-logo-foreground` | `var(--application-accent)` | `--ui-*` |
|
|
5885
|
-
| `--ui-shell-application-identity-gap` | `var(--ds-space-
|
|
6178
|
+
| `--ui-shell-application-identity-gap` | `var(--ds-space-1)` | `--ui-*` |
|
|
5886
6179
|
| `--ui-shell-title-line-gap` | `var(--ds-space-2)` | `--ui-*` |
|
|
5887
6180
|
| `--ui-shell-actions-gap` | `var(--ds-space-2)` | `--ui-*` |
|
|
5888
6181
|
| `--ui-shell-global-actions-height` | `var(--ui-shell-control-size)` | `--ui-*` |
|
|
5889
|
-
| `--ui-shell-global-actions-gap` | `var(--ds-space-
|
|
5890
|
-
| `--ui-shell-global-actions-padding-right` | `
|
|
6182
|
+
| `--ui-shell-global-actions-gap` | `var(--ds-space-1)` | `--ui-*` |
|
|
6183
|
+
| `--ui-shell-global-actions-padding-right` | `0px` | `--ui-*` |
|
|
6184
|
+
| `--ui-shell-global-actions-account-gap` | `var(--ds-space-2)` | `--ui-*` |
|
|
5891
6185
|
| `--ui-shell-global-action-group-gap` | `var(--ds-space-1)` | `--ui-*` |
|
|
5892
6186
|
| `--ui-shell-global-action-group-padding-left` | `var(--ds-space-2)` | `--ui-*` |
|
|
5893
6187
|
| `--ui-shell-global-action-size` | `var(--ui-shell-control-size)` | `--ui-*` |
|
|
5894
6188
|
| `--ui-shell-global-action-icon-size` | `18px` | `--ui-*` |
|
|
5895
|
-
| `--ui-shell-global-action-
|
|
6189
|
+
| `--ui-shell-global-action-padding-inline` | `10px` | `--ui-*` |
|
|
6190
|
+
| `--ui-shell-global-action-label-gap` | `var(--ds-space-1)` | `--ui-*` |
|
|
6191
|
+
| `--ui-shell-global-action-radius` | `var(--ds-radius-12)` | `--ui-*` |
|
|
5896
6192
|
| `--ui-shell-global-action-tooltip-offset` | `var(--ds-space-2)` | `--ui-*` |
|
|
5897
6193
|
| `--ui-shell-global-action-tooltip-height` | `28px` | `--ui-*` |
|
|
5898
6194
|
| `--ui-shell-global-action-tooltip-padding-inline` | `10px` | `--ui-*` |
|
|
@@ -5903,8 +6199,8 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5903
6199
|
| `--ui-shell-global-action-popover-radius` | `var(--ds-radius-20)` | `--ui-*` |
|
|
5904
6200
|
| `--ui-shell-global-action-panel-max-height` | `680px` | `--ui-*` |
|
|
5905
6201
|
| `--ui-shell-global-action-panel-viewport-offset` | `120px` | `--ui-*` |
|
|
5906
|
-
| `--ui-shell-module-row-gap` | `
|
|
5907
|
-
| `--ui-shell-module-row-padding-block` | `
|
|
6202
|
+
| `--ui-shell-module-row-gap` | `var(--ds-space-2)` | `--ui-*` |
|
|
6203
|
+
| `--ui-shell-module-row-padding-block` | `0px` | `--ui-*` |
|
|
5908
6204
|
| `--ui-shell-module-row-padding-inline` | `var(--ds-space-3)` | `--ui-*` |
|
|
5909
6205
|
| `--ui-shell-module-trigger-size` | `32px` | `--ui-*` |
|
|
5910
6206
|
| `--ui-shell-module-trigger-icon-size` | `20px` | `--ui-*` |
|
|
@@ -5913,6 +6209,8 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5913
6209
|
| `--ui-shell-tab-gap` | `var(--ds-space-1)` | `--ui-*` |
|
|
5914
6210
|
| `--ui-shell-tab-padding-block` | `6px` | `--ui-*` |
|
|
5915
6211
|
| `--ui-shell-tab-padding-inline` | `var(--ds-space-3)` | `--ui-*` |
|
|
6212
|
+
| `--ui-shell-tab-radius` | `var(--ds-radius-12)` | `--ui-*` |
|
|
6213
|
+
| `--ui-shell-tab-indicator-inset` | `var(--ds-space-3)` | `--ui-*` |
|
|
5916
6214
|
| `--ui-shell-tab-indicator-width` | `80px` | `--ui-*` |
|
|
5917
6215
|
| `--ui-shell-tab-indicator-height` | `2px` | `--ui-*` |
|
|
5918
6216
|
| `--ui-shell-tab-indicator-offset` | `-8px` | `--ui-*` |
|
|
@@ -5925,26 +6223,29 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5925
6223
|
| `--ui-shell-content-background` | `var(--application-elevated)` | `--ui-*` |
|
|
5926
6224
|
| `--ui-shell-content-padding` | `var(--ds-space-3)` | `--ui-*` |
|
|
5927
6225
|
| `--ui-shell-content-gap` | `var(--ds-space-3)` | `--ui-*` |
|
|
5928
|
-
| `--ui-shell-brand-fallback-mark-size` | `
|
|
6226
|
+
| `--ui-shell-brand-fallback-mark-size` | `36px` | `--ui-*` |
|
|
5929
6227
|
| `--ui-shell-brand-fallback-mark-background` | `var(--application-text)` | `--ui-*` |
|
|
5930
6228
|
| `--ui-shell-brand-fallback-mark-radius` | `var(--ds-radius-4)` | `--ui-*` |
|
|
5931
6229
|
| `--ui-shell-brand-fallback-name-gap` | `var(--ds-space-2)` | `--ui-*` |
|
|
5932
|
-
| `--ui-shell-brand-fallback-name-size` | `var(--ds-font-size-
|
|
5933
|
-
| `--ui-shell-brand-fallback-name-line-height` | `var(--ds-line-height-
|
|
6230
|
+
| `--ui-shell-brand-fallback-name-size` | `var(--ds-font-size-20)` | `--ui-*` |
|
|
6231
|
+
| `--ui-shell-brand-fallback-name-line-height` | `var(--ds-line-height-30)` | `--ui-*` |
|
|
5934
6232
|
| `--ui-shell-application-logo-mock-glyph-size` | `24px` | `--ui-*` |
|
|
5935
6233
|
| `--ui-shell-module-switch-trigger-min-width` | `168px` | `--ui-*` |
|
|
5936
|
-
| `--ui-shell-module-switch-trigger-height` | `
|
|
6234
|
+
| `--ui-shell-module-switch-trigger-height` | `48px` | `--ui-*` |
|
|
5937
6235
|
| `--ui-shell-module-switch-trigger-padding-top` | `4px` | `--ui-*` |
|
|
5938
|
-
| `--ui-shell-module-switch-trigger-padding-right` | `
|
|
6236
|
+
| `--ui-shell-module-switch-trigger-padding-right` | `var(--ds-space-3)` | `--ui-*` |
|
|
5939
6237
|
| `--ui-shell-module-switch-trigger-padding-bottom` | `4px` | `--ui-*` |
|
|
5940
|
-
| `--ui-shell-module-switch-trigger-padding-left` | `
|
|
6238
|
+
| `--ui-shell-module-switch-trigger-padding-left` | `var(--ds-space-3)` | `--ui-*` |
|
|
6239
|
+
| `--ui-shell-module-switch-trigger-divider` | `inset calc(-1 * var(--ds-hairline)) 0 0 0 var(--ds-color-border)` | `--ui-*` |
|
|
5941
6240
|
| `--ui-shell-module-switch-trigger-gap` | `var(--ds-space-2)` | `--ui-*` |
|
|
5942
6241
|
| `--ui-shell-module-switch-copy-gap` | `1px` | `--ui-*` |
|
|
5943
6242
|
| `--ui-shell-module-switch-icon-box-size` | `32px` | `--ui-*` |
|
|
5944
6243
|
| `--ui-shell-module-switch-icon-glyph-size` | `18px` | `--ui-*` |
|
|
5945
|
-
| `--ui-shell-module-switch-chevron-size` | `
|
|
5946
|
-
| `--ui-shell-module-switch-
|
|
5947
|
-
| `--ui-shell-module-switch-panel-
|
|
6244
|
+
| `--ui-shell-module-switch-chevron-size` | `20px` | `--ui-*` |
|
|
6245
|
+
| `--ui-shell-module-switch-check-size` | `14px` | `--ui-*` |
|
|
6246
|
+
| `--ui-shell-module-switch-panel-width` | `168px` | `--ui-*` |
|
|
6247
|
+
| `--ui-shell-module-switch-panel-min-width` | `128px` | `--ui-*` |
|
|
6248
|
+
| `--ui-shell-module-switch-panel-padding` | `var(--ds-space-1)` | `--ui-*` |
|
|
5948
6249
|
| `--ui-shell-module-switch-panel-gap` | `2px` | `--ui-*` |
|
|
5949
6250
|
| `--ui-shell-module-switch-item-min-height` | `40px` | `--ui-*` |
|
|
5950
6251
|
| `--ui-shell-module-switch-item-gap` | `var(--ds-space-2)` | `--ui-*` |
|
|
@@ -5953,11 +6254,11 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5953
6254
|
| `--ui-shell-module-switch-item-line-height` | `22px` | `--ui-*` |
|
|
5954
6255
|
| `--ui-shell-module-switch-icon-background` | `var(--ds-color-bg-4)` | `--ui-*` |
|
|
5955
6256
|
| `--ui-shell-module-switch-icon-foreground` | `var(--ds-color-fg-4)` | `--ui-*` |
|
|
5956
|
-
| `--ui-shell-module-switch-panel-background` | `var(--ds-color-canvas)` | `--ui-*` |
|
|
6257
|
+
| `--ui-shell-module-switch-panel-background` | `color-mix(in srgb,var(--ds-color-canvas) 50%,var(--ds-color-surface))` | `--ui-*` |
|
|
5957
6258
|
| `--ui-shell-module-switch-panel-border` | `var(--ds-color-border)` | `--ui-*` |
|
|
5958
6259
|
| `--ui-shell-module-switch-panel-border-rule` | `1px solid var(--ui-shell-module-switch-panel-border)` | `--ui-*` |
|
|
5959
|
-
| `--ui-shell-module-switch-item-hover` | `var(--ds-color-
|
|
5960
|
-
| `--ui-shell-module-switch-item-active` | `
|
|
6260
|
+
| `--ui-shell-module-switch-item-hover` | `var(--ds-color-canvas)` | `--ui-*` |
|
|
6261
|
+
| `--ui-shell-module-switch-item-active` | `transparent` | `--ui-*` |
|
|
5961
6262
|
| `--ui-shell-module-switch-item-active-text` | `var(--ds-color-application-accent)` | `--ui-*` |
|
|
5962
6263
|
| `--ui-shell-global-action-active-background` | `color-mix(in srgb,var(--ds-color-application-accent) 12%,transparent)` | `--ui-*` |
|
|
5963
6264
|
| `--ui-shell-global-action-active-text` | `var(--ds-color-application-accent)` | `--ui-*` |
|
|
@@ -5981,7 +6282,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5981
6282
|
| `--ui-overlay-viewport-gutter` | `var(--ds-space-4)` | `--ui-*` |
|
|
5982
6283
|
| `--ui-application-title-max-width-compact` | `220px` | `--ui-*` |
|
|
5983
6284
|
| `--ui-border-default` | `1px solid var(--application-border)` | `--ui-*` |
|
|
5984
|
-
| `--ui-divider-default` | `
|
|
6285
|
+
| `--ui-divider-default` | `var(--ds-hairline) solid var(--application-divider)` | `--ui-*` |
|
|
5985
6286
|
| `--ui-shadow-surface` | `0 4px 14px color-mix(in srgb,var(--ds-color-text) 4%,transparent)` | `--ui-*` |
|
|
5986
6287
|
| `--ui-shadow-floating` | `0 18px 52px color-mix(in srgb,var(--ds-color-text) 14%,transparent)` | `--ui-*` |
|
|
5987
6288
|
| `--ui-duration-fast` | `150ms` | `--ui-*` |
|
|
@@ -5998,6 +6299,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5998
6299
|
| `--ds-font-size-16` | `16px` | `--ds-*` |
|
|
5999
6300
|
| `--ds-font-size-20` | `20px` | `--ds-*` |
|
|
6000
6301
|
| `--ds-font-size-24` | `24px` | `--ds-*` |
|
|
6302
|
+
| `--ds-font-size-32` | `32px` | `--ds-*` |
|
|
6001
6303
|
| `--ds-font-size-caption` | `var(--ds-font-size-12)` | `--ds-*` |
|
|
6002
6304
|
| `--ds-font-size-body` | `var(--ds-font-size-14)` | `--ds-*` |
|
|
6003
6305
|
| `--ds-font-size-title` | `var(--ds-font-size-16)` | `--ds-*` |
|
|
@@ -6007,6 +6309,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
6007
6309
|
| `--ds-line-height-20` | `20px` | `--ds-*` |
|
|
6008
6310
|
| `--ds-line-height-24` | `24px` | `--ds-*` |
|
|
6009
6311
|
| `--ds-line-height-28` | `28px` | `--ds-*` |
|
|
6312
|
+
| `--ds-line-height-30` | `30px` | `--ds-*` |
|
|
6010
6313
|
| `--ds-line-height-32` | `32px` | `--ds-*` |
|
|
6011
6314
|
| `--ds-line-height-caption` | `var(--ds-line-height-16)` | `--ds-*` |
|
|
6012
6315
|
| `--ds-line-height-body` | `var(--ds-line-height-20)` | `--ds-*` |
|
|
@@ -6018,20 +6321,20 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
6018
6321
|
| `--ds-font-weight-semibold` | `600` | `--ds-*` |
|
|
6019
6322
|
| `--ds-font-weight-bold` | `700` | `--ds-*` |
|
|
6020
6323
|
| `--ds-color-bg-1` | `#ffffff` | `--ds-*` |
|
|
6021
|
-
| `--ds-color-bg-2` | `#
|
|
6022
|
-
| `--ds-color-bg-3` | `#
|
|
6324
|
+
| `--ds-color-bg-2` | `#F5F4F1` | `--ds-*` |
|
|
6325
|
+
| `--ds-color-bg-3` | `#F0EEE9` | `--ds-*` |
|
|
6023
6326
|
| `--ds-color-bg-4` | `#E7E6E2` | `--ds-*` |
|
|
6024
|
-
| `--ds-color-bg-5` | `#
|
|
6327
|
+
| `--ds-color-bg-5` | `#DDDBD5` | `--ds-*` |
|
|
6025
6328
|
| `--ds-color-bg-6` | `#B5A86D` | `--ds-*` |
|
|
6026
|
-
| `--ds-color-fg-1` | `#
|
|
6027
|
-
| `--ds-color-fg-2` | `#
|
|
6028
|
-
| `--ds-color-fg-3` | `#
|
|
6029
|
-
| `--ds-color-fg-4` | `#
|
|
6030
|
-
| `--ds-color-blue-1` | `#
|
|
6329
|
+
| `--ds-color-fg-1` | `#B9B8B6` | `--ds-*` |
|
|
6330
|
+
| `--ds-color-fg-2` | `#9A9994` | `--ds-*` |
|
|
6331
|
+
| `--ds-color-fg-3` | `#696865` | `--ds-*` |
|
|
6332
|
+
| `--ds-color-fg-4` | `#1F1E1A` | `--ds-*` |
|
|
6333
|
+
| `--ds-color-blue-1` | `#0066ff` | `--ds-*` |
|
|
6031
6334
|
| `--ds-color-primary` | `#0071e3` | `--ds-*` |
|
|
6032
|
-
| `--ds-color-green-1` | `#
|
|
6033
|
-
| `--ds-color-orange-1` | `#
|
|
6034
|
-
| `--ds-color-red-1` | `#
|
|
6335
|
+
| `--ds-color-green-1` | `#0dbe73` | `--ds-*` |
|
|
6336
|
+
| `--ds-color-orange-1` | `#ff7b00` | `--ds-*` |
|
|
6337
|
+
| `--ds-color-red-1` | `#e11919` | `--ds-*` |
|
|
6035
6338
|
| `--ds-color-blue-2` | `var(--ds-color-primary)` | `--ds-*` |
|
|
6036
6339
|
| `--ds-color-static-white` | `#ffffff` | `--ds-*` |
|
|
6037
6340
|
| `--ds-color-theme-primary` | `var(--ds-color-primary)` | `--ds-*` |
|
|
@@ -6081,7 +6384,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
6081
6384
|
| `--ds-color-info` | `var(--ds-color-status-info)` | `--ds-*` |
|
|
6082
6385
|
| `--ds-color-hover-neutral` | `color-mix(in srgb,var(--ds-color-text) 6%,transparent)` | `--ds-*` |
|
|
6083
6386
|
| `--ds-color-disabled` | `color-mix(in srgb,var(--ds-color-text) 38%,transparent)` | `--ds-*` |
|
|
6084
|
-
| `--ds-color-overlay` | `color-mix(in srgb,var(--ds-color-text)
|
|
6387
|
+
| `--ds-color-overlay` | `color-mix(in srgb,var(--ds-color-text) 25%,transparent)` | `--ds-*` |
|
|
6085
6388
|
| `--ds-color-drawer-border` | `var(--ds-color-divider)` | `--ds-*` |
|
|
6086
6389
|
| `--ds-color-action-neutral` | `var(--ds-color-text)` | `--ds-*` |
|
|
6087
6390
|
| `--ds-color-hover-accent` | `color-mix(in srgb,var(--ds-color-theme-primary) 8%,transparent)` | `--ds-*` |
|
|
@@ -6089,6 +6392,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
6089
6392
|
| `--ds-color-active-accent` | `color-mix(in srgb,var(--ds-color-theme-primary) 12%,transparent)` | `--ds-*` |
|
|
6090
6393
|
| `--ds-color-active-neutral` | `color-mix(in srgb,var(--ds-color-text) 12%,transparent)` | `--ds-*` |
|
|
6091
6394
|
| `--ds-color-focus` | `var(--ds-color-theme-primary)` | `--ds-*` |
|
|
6395
|
+
| `--ds-color-tint-accent` | `color-mix(in srgb,var(--ds-color-theme-primary) 6%,transparent)` | `--ds-*` |
|
|
6092
6396
|
| `--ds-space-0` | `0px` | `--ds-*` |
|
|
6093
6397
|
| `--ds-space-1` | `4px` | `--ds-*` |
|
|
6094
6398
|
| `--ds-space-2` | `8px` | `--ds-*` |
|
|
@@ -6103,6 +6407,10 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
6103
6407
|
| `--ds-radius-12` | `12px` | `--ds-*` |
|
|
6104
6408
|
| `--ds-radius-16` | `16px` | `--ds-*` |
|
|
6105
6409
|
| `--ds-radius-20` | `20px` | `--ds-*` |
|
|
6410
|
+
| `--ds-radius-control` | `var(--ds-radius-12)` | `--ds-*` |
|
|
6411
|
+
| `--ds-radius-card` | `var(--ds-radius-20)` | `--ds-*` |
|
|
6412
|
+
| `--ds-radius-tag` | `var(--ds-radius-20)` | `--ds-*` |
|
|
6413
|
+
| `--ds-radius-dialog` | `var(--ds-radius-20)` | `--ds-*` |
|
|
6106
6414
|
| `--ds-control-height-24` | `24px` | `--ds-*` |
|
|
6107
6415
|
| `--ds-control-height-28` | `28px` | `--ds-*` |
|
|
6108
6416
|
| `--ds-control-height-32` | `32px` | `--ds-*` |
|
|
@@ -6123,3 +6431,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
6123
6431
|
| `--ds-tab-underline-width` | `2px` | `--ds-*` |
|
|
6124
6432
|
| `--ds-nav-item-height` | `36px` | `--ds-*` |
|
|
6125
6433
|
| `--ds-card-padding` | `var(--ds-space-4)` | `--ds-*` |
|
|
6434
|
+
| `--ds-hairline` | `0.5px` | `--ds-*` |
|
|
6435
|
+
| `--ds-spacing-6` | `6px` | `--ds-*` |
|
|
6436
|
+
| `--ds-spacing-10` | `10px` | `--ds-*` |
|
|
6437
|
+
| `--ds-spacing-20` | `20px` | `--ds-*` |
|