@moheng-design/ui-skill 3.1.0 → 3.2.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/generated/SKILL.md +18 -17
- package/generated/contracts.json +102 -9
- package/generated/plugin-data.js +96 -7
- package/generated/reference.md +86 -48
- package/generated/rules.json +101 -7
- package/generated/skills/moheng-ui-audit/SKILL.md +1 -1
- package/generated/skills/moheng-ui-bootstrap/SKILL.md +2 -2
- package/generated/skills/moheng-ui-feedback/SKILL.md +2 -2
- package/generated/skills/moheng-ui-page/SKILL.md +1 -1
- package/generated/skills/moheng-ui-review/SKILL.md +2 -2
- package/generated/skills/moheng-ui-upgrade/SKILL.md +1 -1
- package/handwritten/conventions.md +30 -14
- package/package.json +2 -2
package/generated/reference.md
CHANGED
|
@@ -2,11 +2,11 @@
|
|
|
2
2
|
|
|
3
3
|
# @moheng-design/ui 完整参考
|
|
4
4
|
|
|
5
|
-
适用版本:v3.
|
|
5
|
+
适用版本:v3.2.0 —— 本文件随包分发,永远与所安装的 `@moheng-design/ui` 版本配套。
|
|
6
6
|
|
|
7
|
-
共
|
|
7
|
+
共 95 个组件。每个组件含:契约 JSDoc 原文、完整 props 表、
|
|
8
8
|
关联类型,以及手写的组合约定(何时使用 / 何时改用其他组件 / 组合约定 / 禁止与使用边界)。
|
|
9
|
-
文末另有两份全表:
|
|
9
|
+
文末另有两份全表:169 条 lint 规则,以及 401 条 design token 的名值对照。
|
|
10
10
|
|
|
11
11
|
## 目录
|
|
12
12
|
|
|
@@ -16,7 +16,7 @@
|
|
|
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** —— [ApplicationDateRangeFilter](#applicationdaterangefilter)、[ApplicationFilterMenu](#applicationfiltermenu)、[ListSelectionCheckbox](#listselectioncheckbox)、[ListTablePagination](#listtablepagination)、[SearchField](#searchfield)、[SidebarAppLinkButton](#sidebarapplinkbutton)、[SidebarRailButton](#sidebarrailbutton)、[SystemButton](#systembutton)
|
|
19
|
+
- **Application Atomic** —— [ApplicationDateRangeFilter](#applicationdaterangefilter)、[ApplicationFilterMenu](#applicationfiltermenu)、[ApplicationUserProfileCard](#applicationuserprofilecard)、[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)
|
|
@@ -474,7 +474,7 @@ DETAIL ApplicationPageLayoutContainer pageType="DETAIL"
|
|
|
474
474
|
|
|
475
475
|
Foundation 按钮 —— 按钮排版、几何、圆角与基础交互的唯一 Foundation Owner。
|
|
476
476
|
|
|
477
|
-
已登记契约:14/20 字号、
|
|
477
|
+
已登记契约:14/20 字号、10px 行内内边距、2px 图标间隙、12px 圆角、32px 默认高度。
|
|
478
478
|
圆角取控件角色 `--ds-radius-control`(GAP Design kit「圆角12」);等宽图标按钮为 12 圆角方形。
|
|
479
479
|
|
|
480
480
|
**业务页面一律用 `SystemButton`**,本组件只供库内组件使用(实践报告 P1-1 裁决)。
|
|
@@ -488,7 +488,7 @@ Foundation 按钮 —— 按钮排版、几何、圆角与基础交互的唯一
|
|
|
488
488
|
|
|
489
489
|
| prop | 类型 | 必填 | 说明 |
|
|
490
490
|
|---|---|:---:|---|
|
|
491
|
-
| `variant` | `'primary' \| 'secondary' \| 'outline' \| 'ghost' \| 'ghost-accent' \| 'destructive' \| 'destructive-outline' \| 'link'` | 否 | 视觉语义。有 GAP Design kit 对应类型的五档逐态对齐按钮组件集 24:2110: `primary` 用于页面主操作,每个动作组内至多一个;主色实心底,移入变浅、按下变深, 禁用为浅主色底白字(kit「类型=主要」,三态从换肤主色派生); `secondary` 用于次要操作,是默认值;白底、线条色描边,移入只把文字变为主色, 按下为主色 15% 底 + 主色描边 + 主色字,禁用为文字3(kit「类型=二级」); `ghost` 透明底、文字1,移入中性 6% 底、按下中性 25% 底,禁用为文字3(kit「类型=幽灵」, `iconOnly` 即 kit「类型=图标」); `ghost-accent` 透明底、主色字,移入主色 6% 底、按下主色 15% 底(kit「类型=幽灵主要」),
|
|
491
|
+
| `variant` | `'primary' \| 'secondary' \| 'outline' \| 'ghost' \| 'ghost-accent' \| 'row-action' \| 'destructive' \| 'destructive-outline' \| 'link'` | 否 | 视觉语义。有 GAP Design kit 对应类型的五档逐态对齐按钮组件集 24:2110: `primary` 用于页面主操作,每个动作组内至多一个;主色实心底,移入变浅、按下变深, 禁用为浅主色底白字(kit「类型=主要」,三态从换肤主色派生); `secondary` 用于次要操作,是默认值;白底、线条色描边,移入只把文字变为主色, 按下为主色 15% 底 + 主色描边 + 主色字,禁用为文字3(kit「类型=二级」); `ghost` 透明底、文字1,移入中性 6% 底、按下中性 25% 底,禁用为文字3(kit「类型=幽灵」, `iconOnly` 即 kit「类型=图标」); `ghost-accent` 透明底、主色字,移入主色 6% 底、按下主色 15% 底(kit「类型=幽灵主要」), 用于非记录操作的轻强调按钮; `row-action` 用于表格与记录列表的行内文字动作,16/20、无内边距。 `destructive` 用于不可逆的删除类操作(实心危险色); `destructive-outline` 白底、线条色描边、危险色文字;移入时描边变为危险色,按下时再加危险色 10% 底(GAP Design kit「按钮 / 类型=危险」三态), 用于与次要按钮并排的删除类动作; `link` 用于行内跳转,无内边距、带下划线。 `outline`、`destructive`、`link` 在 kit 里没有对应类型。 |
|
|
492
492
|
| `size` | `'xs' \| 'sm' \| 'default' \| 'lg'` | 否 | 尺寸,映射高度 24 / 28 / 32 / 40px。 `default` 读取 `--application-button-height`; `sm` 用于表格行内等紧凑布局;`xs` 用于标签内嵌。 |
|
|
493
493
|
| `iconOnly` | `boolean` | 否 | 等宽图标按钮。宽度收敛为与高度相等,行内内边距归零。 为 true 时**必须**提供 `aria-label`,因为按钮没有可见文字。 |
|
|
494
494
|
| `disabled` | `boolean` | 否 | 禁用。禁用时不触发 onClick 并移出 tab 顺序。 禁用作用于整个交互单元 —— 不得只禁用文字而保留图标可点。 传 `aria-disabled="true"` 得到同一套禁用外观但保持可聚焦(`SystemButton` 的 loading 即此写法);本组件不拦截事件,阻断动作由设置它的一方负责。 |
|
|
@@ -498,7 +498,7 @@ Foundation 按钮 —— 按钮排版、几何、圆角与基础交互的唯一
|
|
|
498
498
|
|
|
499
499
|
**用途。** Foundation 按钮,是按钮排版、几何、圆角与基础交互的唯一 Foundation Owner。
|
|
500
500
|
|
|
501
|
-
**何时使用。** 本组件只供库内组件使用。业务页面的按钮一律用 `SystemButton`,不存在降级到本组件的情形。已登记契约为 14/20 字号、
|
|
501
|
+
**何时使用。** 本组件只供库内组件使用。业务页面的按钮一律用 `SystemButton`,不存在降级到本组件的情形。已登记契约为 14/20 字号、10px 行内内边距、2px 图标间隙、12px 圆角、32px 默认高度;等宽图标按钮为 12 圆角方形,系统内没有独立的 pill 或 circle token。
|
|
502
502
|
|
|
503
503
|
**何时改用其他组件。**
|
|
504
504
|
|
|
@@ -509,7 +509,7 @@ Foundation 按钮 —— 按钮排版、几何、圆角与基础交互的唯一
|
|
|
509
509
|
- 页面区域内的内容分节切换改用 `Tabs`,不得用一排 ghost 按钮模拟。
|
|
510
510
|
- 原生 `<button>` 一律改用本组件(`mappings.json` · `no-native-button`)。
|
|
511
511
|
|
|
512
|
-
**组合约定。** `size` 与 `iconOnly` 是两根正交的轴(04 · A1):`size` 映射高度 24 / 28 / 32 / 40px,`iconOnly` 把宽度收敛为与高度相等并把行内内边距归零,两者可任意组合。`iconOnly` 为 true 时必须提供 `aria-label`,因为按钮没有可见文字。`children` 是必填的 —— 等宽图标按钮的 `children` 就是那个 `Icon` 元素。一个动作组内至多一个 `variant="primary"`;上下文区的页面动作组由 `ApplicationPageHeader` 的 `actions` 承载,同样至多一个。外边距一律由容器负责:动作对交给 `ButtonGroup`(未拼接态以 8px 分隔),页面动作组交给 `ApplicationPageHeader`,批量动作交给 `ListBatchActionBar` 的 `actions`,按钮自身不得带 margin。图标与文字的 4px 间隙由按钮的 gap 提供,不得再包一层带间距的容器。破坏性动作用 `variant="destructive"`,且必须经 `AlertDialog` 确认,批量场景的标题中写明受影响对象的数量。各变体的默认、移入、按下、禁用四态逐个对齐 GAP Design kit 按钮组件集 24:2110:`primary` 移入变浅、按下变深、禁用为浅主色底白字,三档从换肤主色 `--ds-color-theme-primary` 派生,换肤时随之变化;`secondary` 移入只把文字变为主色,按下为主色 15% 底、主色描边与主色字,禁用只把文字退为文字3;`ghost` 移入中性 6% 底、按下中性 25% 底;`ghost-accent` 透明底、主色字,移入主色 6% 底、按下主色 15%
|
|
512
|
+
**组合约定。** `size` 与 `iconOnly` 是两根正交的轴(04 · A1):`size` 映射高度 24 / 28 / 32 / 40px,`iconOnly` 把宽度收敛为与高度相等并把行内内边距归零,两者可任意组合。`iconOnly` 为 true 时必须提供 `aria-label`,因为按钮没有可见文字。`children` 是必填的 —— 等宽图标按钮的 `children` 就是那个 `Icon` 元素。一个动作组内至多一个 `variant="primary"`;上下文区的页面动作组由 `ApplicationPageHeader` 的 `actions` 承载,同样至多一个。外边距一律由容器负责:动作对交给 `ButtonGroup`(未拼接态以 8px 分隔),页面动作组交给 `ApplicationPageHeader`,批量动作交给 `ListBatchActionBar` 的 `actions`,按钮自身不得带 margin。图标与文字的 4px 间隙由按钮的 gap 提供,不得再包一层带间距的容器。破坏性动作用 `variant="destructive"`,且必须经 `AlertDialog` 确认,批量场景的标题中写明受影响对象的数量。各变体的默认、移入、按下、禁用四态逐个对齐 GAP Design kit 按钮组件集 24:2110:`primary` 移入变浅、按下变深、禁用为浅主色底白字,三档从换肤主色 `--ds-color-theme-primary` 派生,换肤时随之变化;`secondary` 移入只把文字变为主色,按下为主色 15% 底、主色描边与主色字,禁用只把文字退为文字3;`ghost` 移入中性 6% 底、按下中性 25% 底;`ghost-accent` 透明底、主色字,移入主色 6% 底、按下主色 15% 底,用于轻强调按钮;记录行动作使用 `row-action`。`outline`、`destructive`、`link` 在 kit 里没有对应类型。本组件不持有任何状态,无 `"use client"`,可直接作为 server component 使用。`aria-disabled="true"` 与原生 `disabled` 同一套禁用外观但保持可聚焦,本组件不拦截事件,阻断动作由设置它的一方负责。`size` 已从 `ButtonHTMLAttributes` 中 `Omit`,契约的四档尺寸取代原生 `size` 属性。
|
|
513
513
|
|
|
514
514
|
**禁止 / 使用边界。**
|
|
515
515
|
|
|
@@ -2018,6 +2018,7 @@ soft 档底色为 tone 语义色 10% 透明(neutral 为文字色 6%),前
|
|
|
2018
2018
|
|
|
2019
2019
|
| prop | 类型 | 必填 | 说明 |
|
|
2020
2020
|
|---|---|:---:|---|
|
|
2021
|
+
| `size` | `'sm' \| 'default' \| 'lg'` | 否 | 小 / 常规(默认)/ 大,高 20 / 24 / 32。 |
|
|
2021
2022
|
| `tone` | `'neutral' \| 'accent' \| 'success' \| 'warning' \| 'danger' \| 'info'` | 否 | 语义色调。每个 tone 在同一维度内含义唯一;不同维度用 `variant` 区分 |
|
|
2022
2023
|
| `variant` | `'soft' \| 'outline'` | 否 | 视觉变体。`soft` 为淡色底,`outline` 为透明底加描边 |
|
|
2023
2024
|
| `children` | `ReactNode` | 否 | 徽标文字。2–4 字名词短语,不承载交互 —— 需要点击请改用 `Button` |
|
|
@@ -2035,7 +2036,7 @@ soft 档底色为 tone 语义色 10% 透明(neutral 为文字色 6%),前
|
|
|
2035
2036
|
- 一级导航上的未读提示改用 `ApplicationPrimaryNavigation` 的 `actionBadges` 圆点;消息条目的未读态改用 `Message` 的 `unread`。
|
|
2036
2037
|
- 键盘按键提示改用 `Kbd`,二者语义不同,不得互换。
|
|
2037
2038
|
|
|
2038
|
-
**组合约定。** `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 字裸名词短语。
|
|
2039
|
+
**组合约定。** `size` 为 sm / default / lg(20 / 24 / 32 高),与 tone、variant 独立。`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 字裸名词短语。
|
|
2039
2040
|
|
|
2040
2041
|
**禁止 / 使用边界。**
|
|
2041
2042
|
- 不得用图表分类色表达状态 —— 分类色只编码分类。
|
|
@@ -2653,7 +2654,7 @@ Chart 的单条数据系列
|
|
|
2653
2654
|
DataTable 承载面 —— LIST 页面模式、LEDGER 台账页、SPLIT 右栏。
|
|
2654
2655
|
|
|
2655
2656
|
表头位于 `--application-table-header`,高 44,文字 14/20 medium 文字2;表体行最小高 56(两行内容 72)。
|
|
2656
|
-
|
|
2657
|
+
操作列的 row-action 使用文本单元格内边距;其他 32 高控件保留紧凑间距。
|
|
2657
2658
|
行与行之间、表头列与列之间是 0.5px 分隔线(`--application-hairline`),**不是投影**。
|
|
2658
2659
|
|
|
2659
2660
|
⚠ 当本组件是当前的 Data Presentation 时,
|
|
@@ -2726,7 +2727,7 @@ Table 的单列定义
|
|
|
2726
2727
|
- 只是一组同构的目录行,无列对齐需求 —— 改用 `Item`。
|
|
2727
2728
|
- 需要手写 `<table>` / `<tr>` / `<td>` —— 一律改用本组件,手写表格拿不到已登记的表头底色、行分隔线与列宽约定。
|
|
2728
2729
|
|
|
2729
|
-
**组合约定。** 本组件不持有外边距,与相邻区块的间隙由 `ApplicationDataDisplay` 与 `ApplicationPageLayoutContainer` 负责;横向溢出在组件内部消化,外部不得再套横向滚动容器。`selectable` 为 true 时必须同时提供 `selected` 与 `onSelectedChange`,否则勾选框点了没有任何反应;选择框由 `ListSelectionCheckbox` 承担,勾选不会顺带触发 `onRowClick`;它的可访问名是「选择」加标题列(首个 `priority: 'primary'` 的列,未声明取首列)单元格的内容。给了 `onRowClick` 的行可聚焦,Enter / 空格触发同一回调,行保留表格行语义、不改作按钮。行点击与按键忽略来自行内可交互元素(按钮、链接、勾选框、菜单等)的事件,`render` 里放这类控件时调用方不必再手动阻止冒泡。任一列设了 `sortable` 时必须同时提供 `sort` 与 `onSortChange`,同列再次点击在 `asc` 与 `desc` 间切换。放进 `ApplicationDataDisplay` 时,表头排序是工具栏 `sort` 槽位(`Select`)的第二入口,`sort` 必须与工具栏取自同一份排序状态(07 · C-2)。`rowKey` 必须指向 `rows` 中真实存在且唯一的字段,缺省值是 `id`。每一列都应显式设置 `priority`:`low` 列在 1180px 宽或 720px 高以下整列隐藏,单元格内边距在 1439px 以下先行压缩,顺序即「先压间距,再压列数,再压优先级」。单独使用时 `rows` 为空必须提供 `empty`,且应当传 `<Empty />`;放进 `ApplicationDataDisplay` 时不另设 `empty`,空结果由数据展示区的 `state="empty"` 与 `empty` 槽位承担(07 · C-6)。批量动作条与分页不属于本组件,分别走 `ApplicationDataDisplay` 的 `batchBar` 与 `pagination` 槽位,前者传 `ListBatchActionBar`,后者传 `ListTablePagination`。有设计稿时,每一列的 `width` 取设计稿的列宽:固定宽的列写数字,弹性列不写 `width`,由表格均分剩余宽度(固定表格布局,GAP Design kit「列表」的弹性列等分)—— 不得全部留空交给浏览器按内容分配。弹性列最窄 88px,容器不够分时表格转为在自身内部横向滚动。表头文字 14/20 medium 文字2。行内动作(「编辑 / 删除」)用 `SystemButton intent="
|
|
2730
|
+
**组合约定。** 本组件不持有外边距,与相邻区块的间隙由 `ApplicationDataDisplay` 与 `ApplicationPageLayoutContainer` 负责;横向溢出在组件内部消化,外部不得再套横向滚动容器。`selectable` 为 true 时必须同时提供 `selected` 与 `onSelectedChange`,否则勾选框点了没有任何反应;选择框由 `ListSelectionCheckbox` 承担,勾选不会顺带触发 `onRowClick`;它的可访问名是「选择」加标题列(首个 `priority: 'primary'` 的列,未声明取首列)单元格的内容。给了 `onRowClick` 的行可聚焦,Enter / 空格触发同一回调,行保留表格行语义、不改作按钮。行点击与按键忽略来自行内可交互元素(按钮、链接、勾选框、菜单等)的事件,`render` 里放这类控件时调用方不必再手动阻止冒泡。任一列设了 `sortable` 时必须同时提供 `sort` 与 `onSortChange`,同列再次点击在 `asc` 与 `desc` 间切换。放进 `ApplicationDataDisplay` 时,表头排序是工具栏 `sort` 槽位(`Select`)的第二入口,`sort` 必须与工具栏取自同一份排序状态(07 · C-2)。`rowKey` 必须指向 `rows` 中真实存在且唯一的字段,缺省值是 `id`。每一列都应显式设置 `priority`:`low` 列在 1180px 宽或 720px 高以下整列隐藏,单元格内边距在 1439px 以下先行压缩,顺序即「先压间距,再压列数,再压优先级」。单独使用时 `rows` 为空必须提供 `empty`,且应当传 `<Empty />`;放进 `ApplicationDataDisplay` 时不另设 `empty`,空结果由数据展示区的 `state="empty"` 与 `empty` 槽位承担(07 · C-6)。批量动作条与分页不属于本组件,分别走 `ApplicationDataDisplay` 的 `batchBar` 与 `pagination` 槽位,前者传 `ListBatchActionBar`,后者传 `ListTablePagination`。有设计稿时,每一列的 `width` 取设计稿的列宽:固定宽的列写数字,弹性列不写 `width`,由表格均分剩余宽度(固定表格布局,GAP Design kit「列表」的弹性列等分)—— 不得全部留空交给浏览器按内容分配。弹性列最窄 88px,容器不够分时表格转为在自身内部横向滚动。表头文字 14/20 medium 文字2。行内动作(「编辑 / 删除」)用 `SystemButton intent="row-action"`(kit「列表操作」303:2664)。文字操作与同一行的表体文字对齐,常规单行仍高 56;调用方不得为此改用 `size="sm"` 或自写单元格样式。列数多、需要横向滚动时,末列「操作」写 `fixed: 'right'` 贴住右缘,首列标题列可写 `fixed: 'left'`;只允许首列声明 `left`、末列声明 `right`,每侧至多一列。附着在列表末尾的进行中状态(「识别中…」「正在加载更多」)经 `trailingRow` 渲染为一条横跨全部列的通栏行,与表体行同为最小高 56;`busy` 为 true 时文字取强调色并带扫光动效;`rows` 为空时它不渲染。
|
|
2730
2731
|
|
|
2731
2732
|
**禁止 / 使用边界。**
|
|
2732
2733
|
- 禁止手写 `<tr>` / `<td>` 作为子元素传入 —— 本组件不接受复合子组件,列与行只能来自 `columns` 与 `rows`。
|
|
@@ -3222,7 +3223,7 @@ Sonner 的单条提示
|
|
|
3222
3223
|
|
|
3223
3224
|
**用途。** 转瞬即逝的提示堆栈,用于确认某件事已经发生 —— 已保存、已导出、3 条已办结。
|
|
3224
3225
|
|
|
3225
|
-
**何时使用。** 当结果是已完成的事实、用户无需据此采取任何行动时,该组件是默认选择。判据是单一的:如果用户错过了这条提示会有损失,它就不该是 toast。`title` 应是已完成事实的陈述。未指定 `duration` 时单条停留 5000ms
|
|
3226
|
+
**何时使用。** 当结果是已完成的事实、用户无需据此采取任何行动时,该组件是默认选择。判据是单一的:如果用户错过了这条提示会有损失,它就不该是 toast。`title` 应是已完成事实的陈述。未指定 `duration` 时单条停留 5000ms,指针停在堆栈上或键盘焦点在提示内时暂停;两者都离开后按剩余时间继续计时。
|
|
3226
3227
|
|
|
3227
3228
|
**何时改用其他组件。**
|
|
3228
3229
|
- 用户必须读到并处理的失败改用 `Alert`,就地呈现在受影响区域顶部。
|
|
@@ -3477,6 +3478,38 @@ Sonner 的单条提示
|
|
|
3477
3478
|
- 不得用它切换 `pageMode` 或 `dataPresentation`,这两者各有专属控件。
|
|
3478
3479
|
- 不得覆盖触发器的高度、圆角与五种状态的外观,也不得把取值拼进 `label` 让触发器回显 —— 取值的视觉位置是已筛选标签行。
|
|
3479
3480
|
|
|
3481
|
+
### ApplicationUserProfileCard
|
|
3482
|
+
|
|
3483
|
+
`import { ApplicationUserProfileCard } from '@moheng-design/ui'` · 契约 `contracts/application-atomic/application-user-profile-card.ts`
|
|
3484
|
+
|
|
3485
|
+
当前账户的身份摘要与可选操作区;浮层定位、开关和账户数据由调用方提供。
|
|
3486
|
+
|
|
3487
|
+
**Props**
|
|
3488
|
+
|
|
3489
|
+
| prop | 类型 | 必填 | 说明 |
|
|
3490
|
+
|---|---|:---:|---|
|
|
3491
|
+
| `name` | `string` | 是 | 显示名称,也是头像的回退依据。 |
|
|
3492
|
+
| `avatarSrc` | `string` | 否 | 头像地址;不传时显示姓名缩写。 |
|
|
3493
|
+
| `badge` | `ReactNode` | 否 | 姓名旁的短身份标签。 |
|
|
3494
|
+
| `description` | `ReactNode` | 否 | 第二行辅助说明,例如已脱敏的联系方式。 |
|
|
3495
|
+
| `children` | `ReactNode` | 否 | 账户操作区;不传时只展示身份。 |
|
|
3496
|
+
|
|
3497
|
+
继承 `HTMLAttributes<HTMLDivElement>` 的全部原生属性。
|
|
3498
|
+
|
|
3499
|
+
**用途。** 展示当前账户的身份摘要和可选账户操作,供顶栏、侧栏及账户页复用。
|
|
3500
|
+
|
|
3501
|
+
**何时使用。** 需要在同一处展示头像、姓名、身份或辅助说明时使用。
|
|
3502
|
+
|
|
3503
|
+
**何时改用其他组件。** 仅展示头像用 `Avatar`;选择其他人员用 `PeoplePickerDialog`。
|
|
3504
|
+
|
|
3505
|
+
**组合约定。** `name` 必填。`badge` 可放小档 `Badge`;`description` 可放组织或脱敏的联系方式。账户动作作为 `children` 传入。需要浮层时放进 `Popover`,显隐与焦点仍由浮层负责。
|
|
3506
|
+
|
|
3507
|
+
**禁止 / 使用边界。**
|
|
3508
|
+
|
|
3509
|
+
- 不得在组件内查询账户、权限或执行登录退出。
|
|
3510
|
+
- 不得为了占位编造私人联系方式,或在无权限时显示敏感信息。
|
|
3511
|
+
- 不得在账户卡里重复放置全局导航已有的设置入口。
|
|
3512
|
+
|
|
3480
3513
|
### ListSelectionCheckbox
|
|
3481
3514
|
|
|
3482
3515
|
`import { ListSelectionCheckbox } from '@moheng-design/ui'` · 契约 `contracts/application-atomic/list-selection-checkbox.ts`
|
|
@@ -3721,7 +3754,7 @@ Foundation `Pagination`(首页 · 上一页 · 页码窗口 · 下一页 ·
|
|
|
3721
3754
|
|
|
3722
3755
|
| prop | 类型 | 必填 | 说明 |
|
|
3723
3756
|
|---|---|:---:|---|
|
|
3724
|
-
| `intent` | `'primary' \| 'secondary' \| 'quiet' \| 'quiet-accent' \| 'link' \| 'destructive' \| 'destructive-outline'` | 否 | 应用意图。映射到 Foundation Button 的 variant:`quiet` → ghost,`quiet-accent` → ghost-accent, 其余同名。 记录级的行内动作(`Table` 操作列、`ApplicationRecordList` 行尾的「编辑 / 删除」)用 `
|
|
3757
|
+
| `intent` | `'primary' \| 'secondary' \| 'quiet' \| 'quiet-accent' \| 'row-action' \| 'link' \| 'destructive' \| 'destructive-outline'` | 否 | 应用意图。映射到 Foundation Button 的 variant:`quiet` → ghost,`quiet-accent` → ghost-accent, 其余同名。 记录级的行内动作(`Table` 操作列、`ApplicationRecordList` 行尾的「编辑 / 删除」)用 `row-action`:16/20 纯文字,移入与按下仅改变文字外观;不使用幽灵按钮底色。 行内删除同样用文字动作,危险提示交给确认对话框。`link` 只留给句中或卡片页脚那种行内链接式动作。 删除类动作两档:`destructive-outline`(白底、线条色描边、危险色文字;移入时描边变为危险色,按下时再加危险色 10% 底(GAP Design kit「按钮 / 类型=危险」三态))用于与次要按钮 并排出现的删除,例如表单里「删除此附件」;`destructive`(实心危险色)只用于 确认弹窗里那个不可逆的最终动作。同一动作组内不得同时出现两档。 |
|
|
3725
3758
|
| `size` | `'default' \| 'compact' \| 'sm'` | 否 | 尺寸。见 T2 —— `compact` 目前与 `default` 无视觉差异。 `sm` 映射 Foundation Button 的 28px 档,只用于嵌进 32px 控件内部的动作 (`InputGroup` 的尾部按钮),不得用来压缩页面上的独立按钮。 |
|
|
3726
3759
|
| `iconOnly` | `boolean` | 否 | 等宽图标按钮:宽度收敛为与高度相等,行内内边距归零。直接映射到 Foundation `Button` 的 `iconOnly`,与 `intent` / `size` 正交。为 true 时**必须**提供 `aria-label`。 |
|
|
3727
3760
|
| `loading` | `boolean` | 否 | 加载中。阻断交互并设置 `aria-busy`,同时渲染一个行内转圈;`iconOnly` 时转圈 替换原图标的位置,按钮尺寸不变。与 `disabled` 都会阻断动作,但语义不同:loading 是暂时的。 实现不用原生 `disabled`:渲染 `aria-disabled="true"` 并在 `onClick` 中 `preventDefault`(同时挡住 `type="submit"` 的表单提交),按钮保持可聚焦, 焦点不会在点击后掉到 `<body>`。 |
|
|
@@ -3731,7 +3764,7 @@ Foundation `Pagination`(首页 · 上一页 · 页码窗口 · 下一页 ·
|
|
|
3731
3764
|
|
|
3732
3765
|
**用途。** 整个产品的默认动作按钮,是 Foundation `Button` 之上只承载应用意图、loading 与产品状态的薄适配层。
|
|
3733
3766
|
|
|
3734
|
-
**何时使用。** 业务页面中的每一个按钮都必须使用本组件,没有例外;Foundation `Button` 只供库内组件使用。改一次应用强调色,全部 `SystemButton` 同时换肤,这个性质正是它存在的理由。该组件绝不重新实现按钮的排版与几何:14/20 字号、32px 高度、12px 圆角全部来自 Foundation `Button`。删除类动作分两档:`intent="destructive-outline"`(白底、线条色描边、危险色文字;移入时描边变为危险色,按下时再加危险色 10% 底(GAP Design kit「按钮 / 类型=危险」三态))用于与次要按钮并排的删除,如表单里「删除此附件」;`intent="destructive"`(实心危险色)只用于 `AlertDialog` 里那个不可逆的最终确认,同一动作组内不得同时出现两档。记录级的行内动作(`Table` 操作列、`ApplicationRecordList` 行尾的「编辑 / 删除」)用 `intent="
|
|
3767
|
+
**何时使用。** 业务页面中的每一个按钮都必须使用本组件,没有例外;Foundation `Button` 只供库内组件使用。改一次应用强调色,全部 `SystemButton` 同时换肤,这个性质正是它存在的理由。该组件绝不重新实现按钮的排版与几何:14/20 字号、32px 高度、12px 圆角全部来自 Foundation `Button`。删除类动作分两档:`intent="destructive-outline"`(白底、线条色描边、危险色文字;移入时描边变为危险色,按下时再加危险色 10% 底(GAP Design kit「按钮 / 类型=危险」三态))用于与次要按钮并排的删除,如表单里「删除此附件」;`intent="destructive"`(实心危险色)只用于 `AlertDialog` 里那个不可逆的最终确认,同一动作组内不得同时出现两档。记录级的行内动作(`Table` 操作列、`ApplicationRecordList` 行尾的「编辑 / 删除」)用 `intent="row-action"`:16/20 纯文字,移入、按下变色,无按钮底;行内删除同样用它,危险提示交给删除前的 `AlertDialog`,kit 的行内没有红色删除。`intent="link"`(无内边距、带下划线)只留给句中或卡片页脚那种链接式动作。各意图的移入、按下、禁用态随 Foundation `Button` 对齐 kit 按钮组件集 24:2110,`primary` 的三态从换肤主色派生。
|
|
3735
3768
|
|
|
3736
3769
|
**何时改用其他组件。**
|
|
3737
3770
|
- 一组相关按钮需要拼接为分段控件或间隔簇:外层用 `ButtonGroup`,组内仍是 `SystemButton`。
|
|
@@ -3758,8 +3791,8 @@ Foundation `Pagination`(首页 · 上一页 · 页码窗口 · 下一页 ·
|
|
|
3758
3791
|
应用二级导航的**左半部分** —— 你在哪个模块,以及如何切换。
|
|
3759
3792
|
|
|
3760
3793
|
#### 触发器(GAP Design kit「应用二级模块切换」)
|
|
3761
|
-
Standard 168×48,Compact 148×40;内边距 4/12
|
|
3762
|
-
名称
|
|
3794
|
+
Standard 168×48,Compact 148×40;内边距 4/12,左侧 16px 模块切换图标;
|
|
3795
|
+
名称 14/20 **medium**,16px chevron 右对齐;右侧 0.5px 分隔线;悬停与展开时 6% 淡底。
|
|
3763
3796
|
|
|
3764
3797
|
⚠ **绝不能简化成一个小图标,也绝不能移除。**
|
|
3765
3798
|
|
|
@@ -3811,7 +3844,7 @@ Standard 168×48,Compact 148×40;内边距 4/12,**没有图标块**;
|
|
|
3811
3844
|
- 跨应用(而非跨模块)跳转:改用 `TopNavigationPrimaryBar` 的 `onAppSwitch`,条目用 `SidebarAppLinkButton`。
|
|
3812
3845
|
- 工作台的图标菜单栏:改用 `GlobalSidebar`;Content Canvas 内的通用垂直导航:改用 `Sidebar`。
|
|
3813
3846
|
|
|
3814
|
-
**组合约定。** `open` 与 `onOpenChange` 必须成对提供 —— 触发器点击只调用 `onOpenChange`,不提供该回调时面板永远无法打开。`currentModule` 必须命中 `modules` 中的一项。点击当前模块既不触发 `onSelect` 也不关闭面板;路由计算由调用方在 `onSelect` 中完成,组件不做任何跳转。几何按 GAP Design kit「应用二级模块切换」:触发器 168×48(Compact 148×40)、内边距 4/12
|
|
3847
|
+
**组合约定。** `open` 与 `onOpenChange` 必须成对提供 —— 触发器点击只调用 `onOpenChange`,不提供该回调时面板永远无法打开。`currentModule` 必须命中 `modules` 中的一项。点击当前模块既不触发 `onSelect` 也不关闭面板;路由计算由调用方在 `onSelect` 中完成,组件不做任何跳转。几何按 GAP Design kit「应用二级模块切换」:触发器 168×48(Compact 148×40)、内边距 4/12、左侧 16px 模块图标,模块名 14/20 medium,16px 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 或外部点击。
|
|
3815
3848
|
|
|
3816
3849
|
**禁止 / 使用边界。**
|
|
3817
3850
|
- 不得把触发器简化成一个小图标,也不得在窄屏下移除它。
|
|
@@ -4306,6 +4339,7 @@ primary-secondary 语义中的单个次级数字
|
|
|
4306
4339
|
|
|
4307
4340
|
| prop | 类型 | 必填 | 说明 |
|
|
4308
4341
|
|---|---|:---:|---|
|
|
4342
|
+
| `surface` | `'plain' \| 'card'` | 否 | 全页面可用;plain 不加底,card 为每项添加卡片表面。 |
|
|
4309
4343
|
| `metrics` | `Metric[]` | 否 | 基础指标集合 |
|
|
4310
4344
|
| `columns` | `number` | 否 | 列数。默认取卡片总数 —— `metrics` 条目数加 `children` 中的卡片数 (null / false / undefined 不计入),钳在 1–6 之间 |
|
|
4311
4345
|
| `children` | `ReactNode` | 否 | 其他语义的指标卡(trend / chart / status / primary-secondary) |
|
|
@@ -4347,7 +4381,7 @@ primary-secondary 语义中的单个次级数字
|
|
|
4347
4381
|
- 行内或表格单元中的状态标签:改用 `Badge`。
|
|
4348
4382
|
- 承载业务内容而非数字的卡片:改用 `Card`。
|
|
4349
4383
|
|
|
4350
|
-
**组合约定。**
|
|
4384
|
+
**组合约定。** 所有页面与抽屉均可使用;在标准页面布局中放进 `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 年 · 不含已冲红」),只写统计口径,不写趋势或操作提示;有设计稿时照稿给出,同一区内要么都写要么都不写,否则等高的卡片里文字基线不齐。`surface="card"` 为每项添加卡片表面、12px 内边距和圆角;默认 `plain`:无边框、无底色、无内边距,直接落在页面底色上,高 76px;标签 12/16、数值 32/32 semibold、说明 12/16 三行之间各 6(GAP Design kit「字段/竖/统计」)。指标数据在途或失败时用 `state` 表达,取值只有 `ready` / `loading` / `error` 三种:`loading` 由组件渲染与指标卡同壳同高的骨架(张数同 `columns` 的缺省算法,无卡片时为 4),调用方不得自拼骨架卡;`error` 渲染一张横跨整行的失败卡,内容经 `error` 传入,应说明失败原因并提供「重试」,不传时显示内置的「指标加载失败」。两种状态下 `metrics` 与 `children` 都不渲染;读屏经组件内置的状态播报获知「指标加载中」/「指标加载失败」。
|
|
4351
4385
|
|
|
4352
4386
|
**禁止 / 使用边界。**
|
|
4353
4387
|
- 不得用 `state="loading"` 长期占位来顶替「无真实指标」—— 无指标时整个区域不渲染。
|
|
@@ -4355,7 +4389,7 @@ primary-secondary 语义中的单个次级数字
|
|
|
4355
4389
|
- 不得给指标卡挂点击跳转,整卡默认只读,`cursor: default` 是已登记行为。
|
|
4356
4390
|
- 不得一行超过 6 张,也不得让同一区内的卡片高度不一致。
|
|
4357
4391
|
- 不得在指标区放置页面动作按钮、搜索框或筛选控件。
|
|
4358
|
-
-
|
|
4392
|
+
- 禁止自行给指标加阴影、边框或白底;需要卡片表面时统一使用 `surface="card"`。
|
|
4359
4393
|
|
|
4360
4394
|
### ApplicationMetricTrend
|
|
4361
4395
|
|
|
@@ -4576,16 +4610,9 @@ Canvas 的**上下文区**(源仓库名 `application-page-header`)。
|
|
|
4576
4610
|
左侧:可选的「返回」· 16px 标题 · 竖线 · 更新时间与刷新。中部:可选的任务状态胶囊(`taskStatus`)。
|
|
4577
4611
|
右侧:页面动作组,再经分隔线之后是**页面级的 Page Mode Switch**。
|
|
4578
4612
|
|
|
4579
|
-
|
|
4580
|
-
|
|
4581
|
-
|
|
4582
|
-
- 标题之后是一条 12px 高的竖线,再接更新时间:完整日期时间(`2026-07-28 10:00`)
|
|
4583
|
-
14/20 文字1,不加「更新于」前缀;传了 `onRefresh` 时时间与其后的 16px 刷新字形
|
|
4584
|
-
合成一枚幽灵按钮(32 高、左右 12、圆角 12),点它即刷新
|
|
4585
|
-
|
|
4586
|
-
外观(GAP Design kit,业财平台 round-01):48px 高的通栏,落在页面底色上、只有一条
|
|
4587
|
-
0.5px 下边线,不是卡片。放在 `ApplicationPageLayoutContainer` 的 `header` 槽位时
|
|
4588
|
-
向两侧与顶部吃掉页面留白,贴满内容区宽度。此前左侧的 3×16 强调色条已移除。
|
|
4613
|
+
页头最小高 52,不更改弹窗头的 48。默认左右布局,标题与时间之间有 12 高分隔线;
|
|
4614
|
+
stacked 让时间位于标题之下,左侧保留强调标记。时间 12/16 文字2,刷新图标 12。
|
|
4615
|
+
返回为可选幽灵按钮;没有刷新回调时只显示时间。
|
|
4589
4616
|
|
|
4590
4617
|
#### 允许出现在这里
|
|
4591
4618
|
新建 / 导入 / 导出 / 更多、刷新、返回、面包屑、Page Mode Switch。
|
|
@@ -4606,6 +4633,7 @@ Canvas 的**上下文区**(源仓库名 `application-page-header`)。
|
|
|
4606
4633
|
|
|
4607
4634
|
| prop | 类型 | 必填 | 说明 |
|
|
4608
4635
|
|---|---|:---:|---|
|
|
4636
|
+
| `layout` | `'horizontal' \| 'stacked'` | 否 | 标题与更新时间左右或上下排列;显式选择,不随视口自动切换。 |
|
|
4609
4637
|
| `title` | `ReactNode` | 否 | 页面标题,16/32 regular 字重,超长省略 |
|
|
4610
4638
|
| `subtitle` | `ReactNode` | 否 | 副标题,紧随标题以 12px label 色显示 |
|
|
4611
4639
|
| `dataStatus` | `'normal' \| 'refreshing' \| 'failed'` | 否 | 数据状态。决定状态文案与刷新按钮的可用性 |
|
|
@@ -4618,7 +4646,7 @@ Canvas 的**上下文区**(源仓库名 `application-page-header`)。
|
|
|
4618
4646
|
| `pageModes` | `PageMode[]` | 否 | 本页**真正开放**的页面模式。少于 2 个则开关完全不渲染 |
|
|
4619
4647
|
| `pageMode` | `PageMode` | 否 | 当前页面模式 |
|
|
4620
4648
|
| `onPageModeChange` | `(mode: PageMode) => void` | 否 | 页面模式变化回调 |
|
|
4621
|
-
| `breadcrumb` | `ReactNode` | 否 | 面包屑。仅当页面需要展示多级路径时提供;单纯「回到上一层」用 `onBack`,两者不得同时传。
|
|
4649
|
+
| `breadcrumb` | `ReactNode` | 否 | 面包屑。仅当页面需要展示多级路径时提供;单纯「回到上一层」用 `onBack`,两者不得同时传。 面包屑在标题上方另占一行,页头可随内容高于 52 |
|
|
4622
4650
|
|
|
4623
4651
|
继承 `HTMLAttributes<HTMLDivElement>` 的全部原生属性,其中 `title` 已被本组件重新定义或移除。
|
|
4624
4652
|
|
|
@@ -4646,13 +4674,13 @@ Canvas 的**上下文区**(源仓库名 `application-page-header`)。
|
|
|
4646
4674
|
- `actions` 承载页面级动作组,元素应为 `SystemButton`,至多一个 primary,直接并列传入、不包 `ButtonGroup`。动作之间的 4px 间隔由组件给出(GAP Design kit「数据更新、操作」的页面操作插槽)。中文标签为 2–4 字裸名词短语:`新建`、`导入`、`导出`、`更多`。
|
|
4647
4675
|
- Page Mode Switch 由 `pageModes`、`pageMode`、`onPageModeChange` 三者共同驱动,三者必须成组提供;只给 `pageModes` 会得到一个点不动的开关。它按 radiogroup 模式只占一个 Tab 停靠点,← / → 切换模式并首尾相接,Home / End 跳到首末项 —— 方向键同样触发 `onPageModeChange`。
|
|
4648
4676
|
- `pageModes` 只列该页面真正开放的模式。少于 2 个时开关完全不渲染且不占位。
|
|
4649
|
-
-
|
|
4650
|
-
- `dataStatus` 为 `normal` 时应同时提供 `updatedAt`,否则数据新鲜度无从判断。`updatedAt` 写完整日期时间 `YYYY-MM-DD HH:mm`(24 小时制、两位补零,如 `2026-07-28 10:00`),组件原样显示为
|
|
4651
|
-
- 传了 `onRefresh` 时,更新时间与其后的
|
|
4677
|
+
- 默认 `layout="horizontal"`,亦可显式选择 `stacked`(时间在标题下,左侧有标记),不按视口自动切换。左右布局按 GAP Design kit「数据更新」排布:可选的「返回」→ 标题 → 12px 竖线 → 更新时间。传 `onBack` 时标题前渲染「返回」幽灵按钮(16px chevron + 文字,32 高、圆角 12),文案经 `backLabel` 可改,组件不跳转、回到哪里由调用方决定;二级页面用它回到来源页。`onBack` 与 `breadcrumb` 不得同时传。
|
|
4678
|
+
- `dataStatus` 为 `normal` 时应同时提供 `updatedAt`,否则数据新鲜度无从判断。`updatedAt` 写完整日期时间 `YYYY-MM-DD HH:mm`(24 小时制、两位补零,如 `2026-07-28 10:00`),组件原样显示为 12/16 次要文字色,不加「更新于」前缀;不得传秒或「刚刚」「5 分钟前」一类相对时间。此条取代 07 · C-12 的「只写 HH:mm」(业财平台 round-01 按 kit 裁决)。
|
|
4679
|
+
- 传了 `onRefresh` 时,更新时间与其后的 12px 刷新字形合成一枚文字按钮,点它即刷新,可访问名为「刷新,2026-07-28 10:00」;没有刷新能力的页面(草稿、向导、一次性结果)不传,时间按纯文字显示,不出现刷新字形。
|
|
4652
4680
|
- 三种数据状态各有各的措辞与可用性:`normal` 显示更新时间,`refreshing` 显示刷新中、字形转圈且按钮不可点,`failed` 显示刷新失败(危险色)且按钮读作 `重试`。
|
|
4653
4681
|
- `title` 为字符串时才会得到悬浮提示。需要悬浮提示又需要补充信息时,标题主体传 `title`,补充信息走 `subtitle`。
|
|
4654
4682
|
- 页面级进行中任务(批量识别、批量导入)的进度经 `taskStatus` 渲染为页头正中的胶囊,`label` 写「正在识别 14/100」,`busy` 为 true 时带强调色转圈;胶囊 32 高、内边距 6/10、主色 6% 底,文字为文字1。任务结束后移除 `taskStatus`,结果写进 `Sonner` 或页面内容。进度不得写进 `subtitle`。
|
|
4655
|
-
-
|
|
4683
|
+
- 外观是最小高 52px 的通栏:落在页面底色上、只有一条 0.5px 下边线,不是卡片;放在 `ApplicationPageLayoutContainer` 的 `header` 槽位时自动吃掉顶部与两侧留白。
|
|
4656
4684
|
- 该组件自身不带外边距,与相邻区域的间距由 `ApplicationPageLayoutContainer` 的区域间隙负责。
|
|
4657
4685
|
- Page Mode Switch 的选中态与 `ToggleGroup` 同为分段控件表达(选中项抬升为表面色),不得改为淡色洗 —— 淡色洗属于独立开关 `Toggle`。
|
|
4658
4686
|
|
|
@@ -5070,7 +5098,7 @@ SPLIT 左栏的单个目录项
|
|
|
5070
5098
|
- 消息流与活动流的条目改用 `Message`,会话气泡改用 `Bubble`。
|
|
5071
5099
|
- 六种系统状态的承载、批量动作条与分页的挂载,由宿主 `ApplicationDataDisplay` 负责,不在本组件内解决。
|
|
5072
5100
|
|
|
5073
|
-
**组合约定。** 本组件必须放进 `ApplicationDataDisplay` 的 `children`,仅在 `state="ready"` 时渲染。外边距由 `ApplicationPageLayoutContainer` 持有(`--ui-page-gutter` 与 `--ui-section-gap`),本组件与其行一律不自带 margin。`selectable` 为 true 时行首由组件自动渲染 `ListSelectionCheckbox`,列表顶部另有一行吸顶的全选框(`scope="all"`,半选态按本次 `records` 里已选的条数派生),调用方不得再自行插一个行勾选框或全选行;全选 / 全不选只增删本次 `records` 的 id,`selected` 里其他页的选择原样保留,因此 `onSelectedChange` 的结果可以直接写回,不必再与别页的选择合并。可选时根节点是 `role="group"`、条目在内层的 list 里,`aria-label` 照旧传给本组件,即为该组与列表的名字。`selected` 与 `onSelectedChange` 必须成对提供,本组件的选择是受控的。选择集合非空时,调用方必须把 `ListBatchActionBar` 交给 `ApplicationDataDisplay` 的 `batchBar`。`activeId` 与选择集合是两回事:前者是 SPLIT 右栏或抽屉流程中的当前对象,只有一个,视觉上是选中底色;后者是勾选集合,视觉上是 4% 淡洗。行点击与 Enter / 空格忽略来自行内可交互元素的事件 —— 按钮、链接、表单控件、勾选框、菜单与菜单项(含经 portal 渲染的菜单面板)都不会顺带触发 `onOpen`;`RecordListItem.actions` 另由组件包一层阻止冒泡,连同动作区的留白一起不开行;放进去的动作用 `SystemButton intent="
|
|
5101
|
+
**组合约定。** 本组件必须放进 `ApplicationDataDisplay` 的 `children`,仅在 `state="ready"` 时渲染。外边距由 `ApplicationPageLayoutContainer` 持有(`--ui-page-gutter` 与 `--ui-section-gap`),本组件与其行一律不自带 margin。`selectable` 为 true 时行首由组件自动渲染 `ListSelectionCheckbox`,列表顶部另有一行吸顶的全选框(`scope="all"`,半选态按本次 `records` 里已选的条数派生),调用方不得再自行插一个行勾选框或全选行;全选 / 全不选只增删本次 `records` 的 id,`selected` 里其他页的选择原样保留,因此 `onSelectedChange` 的结果可以直接写回,不必再与别页的选择合并。可选时根节点是 `role="group"`、条目在内层的 list 里,`aria-label` 照旧传给本组件,即为该组与列表的名字。`selected` 与 `onSelectedChange` 必须成对提供,本组件的选择是受控的。选择集合非空时,调用方必须把 `ListBatchActionBar` 交给 `ApplicationDataDisplay` 的 `batchBar`。`activeId` 与选择集合是两回事:前者是 SPLIT 右栏或抽屉流程中的当前对象,只有一个,视觉上是选中底色;后者是勾选集合,视觉上是 4% 淡洗。行点击与 Enter / 空格忽略来自行内可交互元素的事件 —— 按钮、链接、表单控件、勾选框、菜单与菜单项(含经 portal 渲染的菜单面板)都不会顺带触发 `onOpen`;`RecordListItem.actions` 另由组件包一层阻止冒泡,连同动作区的留白一起不开行;放进去的动作用 `SystemButton intent="row-action"`,与 `Table` 操作列一致。改用 `renderRow` 接管行主体时同样成立,调用方不必再手动阻止冒泡。给了 `onOpen` 的行可聚焦、Enter / 空格打开,行保留列表项语义;`activeId` 那一行输出 `aria-current="true"`。行首勾选框的可访问名为「选择」加记录标题(`renderRow` 接管且 `title` 不是纯文本时回落为「选择此行」)。行高 56px,容得下标题与元信息两行。`presentation` 取 `RecordList`,不得谎报为 `DataTable`;呈现设置按钮读作「列表设置」,且它属于 `ApplicationQueryToolbar`,不属于本组件。
|
|
5074
5102
|
|
|
5075
5103
|
**禁止 / 使用边界。**
|
|
5076
5104
|
- 不得在本组件内持有搜索、筛选、排序状态 —— 那些全部属于 `ApplicationQueryToolbar`,数据展示区绝不持有第二套查询状态。
|
|
@@ -5847,7 +5875,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5847
5875
|
|
|
5848
5876
|
## 规则清单
|
|
5849
5877
|
|
|
5850
|
-
共
|
|
5878
|
+
共 169 条。完整数据见 `generated/rules.json`。
|
|
5851
5879
|
|
|
5852
5880
|
| 规则 id | kind | scope | 级别 | 报错文案 |
|
|
5853
5881
|
|---|---|---|---|---|
|
|
@@ -5874,10 +5902,10 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5874
5902
|
| `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 间距档,出现这类值说明取错了标尺 |
|
|
5875
5903
|
| `no-unregistered-font` | forbid-value | internal | error | 禁止直接书写字族。请改用 var(--ds-font-family),等宽场景用 var(--ds-font-family-mono)。系统只有单一字族,没有展示体,也没有搭配字体 |
|
|
5876
5904
|
| `props-whitelist-icon` | props-whitelist | both | warn | <Icon> 不接受该 prop。已声明的 props:name、size、strokeWidth、color、style。继承自 SVGProps<SVGSVGElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5877
|
-
| `prop-enum-icon-name` | prop-enum | both | warn | <Icon> 的 name 取值须为 'activity' \| 'arrow-down' \| 'arrow-up' \| 'calendar' \| 'check' \| 'chevron-down' \| 'chevron-left' \| 'chevron-right' \| 'chevron-up' \| 'chevrons-left' \| 'chevrons-right' \| 'circle-alert' \| 'circle-check' \| 'circle-check-big' \| 'columns-2' \| 'download' \| 'ellipsis' \| 'eye' \| 'file-text' \| 'funnel' \| 'info' \| 'kanban' \| 'layout-grid' \| 'list' \| 'message-square' \| 'minus' \| 'paperclip' \| 'pencil' \| 'plus' \| 'refresh-cw' \| 'search' \| 'settings' \| 'shield-check' \| 'sliders-horizontal' \| 'trash-2' \| 'triangle-alert' \| 'upload' \| 'x' 之一 |
|
|
5905
|
+
| `prop-enum-icon-name` | prop-enum | both | warn | <Icon> 的 name 取值须为 'activity' \| 'arrow-down' \| 'arrow-up' \| 'calendar' \| 'check' \| 'chevron-down' \| 'chevron-left' \| 'chevron-right' \| 'chevron-up' \| 'chevrons-left' \| 'chevrons-right' \| 'circle-alert' \| 'circle-check' \| 'circle-check-big' \| 'columns-2' \| 'download' \| 'ellipsis' \| 'eye' \| 'file-text' \| 'funnel' \| 'info' \| 'kanban' \| 'layout-grid' \| 'list' \| 'message-square' \| 'minus' \| 'paperclip' \| 'pencil' \| 'plus' \| 'refresh-cw' \| 'search' \| 'settings' \| 'shield-check' \| 'sliders-horizontal' \| 'table-properties' \| 'trash-2' \| 'triangle-alert' \| 'upload' \| 'x' 之一 |
|
|
5878
5906
|
| `prop-enum-icon-size` | prop-enum | both | warn | <Icon> 的 size 取值须为 14 \| 16 \| 18 \| 20 \| 24 之一 |
|
|
5879
5907
|
| `props-whitelist-button` | props-whitelist | both | warn | <Button> 不接受该 prop。已声明的 props:variant、size、iconOnly、disabled、children。继承自 ButtonHTMLAttributes<HTMLButtonElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5880
|
-
| `prop-enum-button-variant` | prop-enum | both | warn | <Button> 的 variant 取值须为 'primary' \| 'secondary' \| 'outline' \| 'ghost' \| 'ghost-accent' \| 'destructive' \| 'destructive-outline' \| 'link' 之一 |
|
|
5908
|
+
| `prop-enum-button-variant` | prop-enum | both | warn | <Button> 的 variant 取值须为 'primary' \| 'secondary' \| 'outline' \| 'ghost' \| 'ghost-accent' \| 'row-action' \| 'destructive' \| 'destructive-outline' \| 'link' 之一 |
|
|
5881
5909
|
| `prop-enum-button-size` | prop-enum | both | warn | <Button> 的 size 取值须为 'xs' \| 'sm' \| 'default' \| 'lg' 之一 |
|
|
5882
5910
|
| `props-whitelist-button-group` | props-whitelist | both | warn | <ButtonGroup> 不接受该 prop。已声明的 props:children、orientation、attached。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5883
5911
|
| `prop-enum-button-group-orientation` | prop-enum | both | warn | <ButtonGroup> 的 orientation 取值须为 'horizontal' \| 'vertical' 之一 |
|
|
@@ -5916,7 +5944,8 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5916
5944
|
| `props-whitelist-aspect-ratio` | props-whitelist | both | warn | <AspectRatio> 不接受该 prop。已声明的 props:ratio、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5917
5945
|
| `props-whitelist-avatar` | props-whitelist | both | warn | <Avatar> 不接受该 prop。已声明的 props:name、src、size、shape。继承自 HTMLAttributes<HTMLSpanElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5918
5946
|
| `prop-enum-avatar-shape` | prop-enum | both | warn | <Avatar> 的 shape 取值须为 'circle' \| 'rounded' 之一 |
|
|
5919
|
-
| `props-whitelist-badge` | props-whitelist | both | warn | <Badge> 不接受该 prop。已声明的 props:tone、variant、children。继承自 HTMLAttributes<HTMLSpanElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5947
|
+
| `props-whitelist-badge` | props-whitelist | both | warn | <Badge> 不接受该 prop。已声明的 props:size、tone、variant、children。继承自 HTMLAttributes<HTMLSpanElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5948
|
+
| `prop-enum-badge-size` | prop-enum | both | warn | <Badge> 的 size 取值须为 'sm' \| 'default' \| 'lg' 之一 |
|
|
5920
5949
|
| `prop-enum-badge-tone` | prop-enum | both | warn | <Badge> 的 tone 取值须为 'neutral' \| 'accent' \| 'success' \| 'warning' \| 'danger' \| 'info' 之一 |
|
|
5921
5950
|
| `prop-enum-badge-variant` | prop-enum | both | warn | <Badge> 的 variant 取值须为 'soft' \| 'outline' 之一 |
|
|
5922
5951
|
| `props-whitelist-bubble` | props-whitelist | both | warn | <Bubble> 不接受该 prop。已声明的 props:side、author、time、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
@@ -5963,6 +5992,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5963
5992
|
| `prop-enum-tooltip-side` | prop-enum | both | warn | <Tooltip> 的 side 取值须为 'top' \| 'bottom' \| 'left' \| 'right' 之一 |
|
|
5964
5993
|
| `props-whitelist-application-date-range-filter` | props-whitelist | both | warn | <ApplicationDateRangeFilter> 不接受该 prop。已声明的 props:label、labelText、value、onValueChange、disabled、today。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5965
5994
|
| `props-whitelist-application-filter-menu` | props-whitelist | both | warn | <ApplicationFilterMenu> 不接受该 prop。已声明的 props:label、options、value、defaultValue、onValueChange、multiple、disabled。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5995
|
+
| `props-whitelist-application-user-profile-card` | props-whitelist | both | warn | <ApplicationUserProfileCard> 不接受该 prop。已声明的 props:name、avatarSrc、badge、description、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5966
5996
|
| `props-whitelist-list-selection-checkbox` | props-whitelist | both | warn | <ListSelectionCheckbox> 不接受该 prop。已声明的 props:checked、indeterminate、onCheckedChange、scope、disabled。继承自 HTMLAttributes<HTMLSpanElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5967
5997
|
| `prop-enum-list-selection-checkbox-scope` | prop-enum | both | warn | <ListSelectionCheckbox> 的 scope 取值须为 'row' \| 'all' 之一 |
|
|
5968
5998
|
| `props-whitelist-list-table-pagination` | props-whitelist | both | warn | <ListTablePagination> 不接受该 prop。已声明的 props:page、pageSize、total、pageSizeOptions、showJumper、onPageChange、onPageSizeChange。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
@@ -5970,11 +6000,11 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5970
6000
|
| `props-whitelist-sidebar-app-link-button` | props-whitelist | both | warn | <SidebarAppLinkButton> 不接受该 prop。已声明的 props:name、glyph、description。继承自 ButtonHTMLAttributes<HTMLButtonElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5971
6001
|
| `props-whitelist-sidebar-rail-button` | props-whitelist | both | warn | <SidebarRailButton> 不接受该 prop。已声明的 props:icon、label、active、badge。继承自 ButtonHTMLAttributes<HTMLButtonElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5972
6002
|
| `props-whitelist-system-button` | props-whitelist | both | warn | <SystemButton> 不接受该 prop。已声明的 props:intent、size、iconOnly、loading、children。继承自 ButtonHTMLAttributes<HTMLButtonElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5973
|
-
| `prop-enum-system-button-intent` | prop-enum | both | warn | <SystemButton> 的 intent 取值须为 'primary' \| 'secondary' \| 'quiet' \| 'quiet-accent' \| 'link' \| 'destructive' \| 'destructive-outline' 之一 |
|
|
6003
|
+
| `prop-enum-system-button-intent` | prop-enum | both | warn | <SystemButton> 的 intent 取值须为 'primary' \| 'secondary' \| 'quiet' \| 'quiet-accent' \| 'row-action' \| 'link' \| 'destructive' \| 'destructive-outline' 之一 |
|
|
5974
6004
|
| `prop-enum-system-button-size` | prop-enum | both | warn | <SystemButton> 的 size 取值须为 'default' \| 'compact' \| 'sm' 之一 |
|
|
5975
6005
|
| `props-whitelist-application-module-switcher` | props-whitelist | both | warn | <ApplicationModuleSwitcher> 不接受该 prop。已声明的 props:moduleName、modules、currentModule、open、onOpenChange、onSelect。继承自 ButtonHTMLAttributes<HTMLButtonElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5976
6006
|
| `props-whitelist-application-primary-navigation` | props-whitelist | both | warn | <ApplicationPrimaryNavigation> 不接受该 prop。已声明的 props:appName、appGlyph、activeAction、actionBadges、onAction、account。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5977
|
-
| `prop-enum-application-primary-navigation-app-glyph` | prop-enum | both | warn | <ApplicationPrimaryNavigation> 的 appGlyph 取值须为 'activity' \| 'arrow-down' \| 'arrow-up' \| 'calendar' \| 'check' \| 'chevron-down' \| 'chevron-left' \| 'chevron-right' \| 'chevron-up' \| 'chevrons-left' \| 'chevrons-right' \| 'circle-alert' \| 'circle-check' \| 'circle-check-big' \| 'columns-2' \| 'download' \| 'ellipsis' \| 'eye' \| 'file-text' \| 'funnel' \| 'info' \| 'kanban' \| 'layout-grid' \| 'list' \| 'message-square' \| 'minus' \| 'paperclip' \| 'pencil' \| 'plus' \| 'refresh-cw' \| 'search' \| 'settings' \| 'shield-check' \| 'sliders-horizontal' \| 'trash-2' \| 'triangle-alert' \| 'upload' \| 'x' 之一 |
|
|
6007
|
+
| `prop-enum-application-primary-navigation-app-glyph` | prop-enum | both | warn | <ApplicationPrimaryNavigation> 的 appGlyph 取值须为 'activity' \| 'arrow-down' \| 'arrow-up' \| 'calendar' \| 'check' \| 'chevron-down' \| 'chevron-left' \| 'chevron-right' \| 'chevron-up' \| 'chevrons-left' \| 'chevrons-right' \| 'circle-alert' \| 'circle-check' \| 'circle-check-big' \| 'columns-2' \| 'download' \| 'ellipsis' \| 'eye' \| 'file-text' \| 'funnel' \| 'info' \| 'kanban' \| 'layout-grid' \| 'list' \| 'message-square' \| 'minus' \| 'paperclip' \| 'pencil' \| 'plus' \| 'refresh-cw' \| 'search' \| 'settings' \| 'shield-check' \| 'sliders-horizontal' \| 'table-properties' \| 'trash-2' \| 'triangle-alert' \| 'upload' \| 'x' 之一 |
|
|
5978
6008
|
| `prop-enum-application-primary-navigation-active-action` | prop-enum | both | warn | <ApplicationPrimaryNavigation> 的 activeAction 取值须为 'messages' \| 'todos' \| 'overview' \| 'risk' \| 'settings' 之一 |
|
|
5979
6009
|
| `props-whitelist-application-secondary-navigation` | props-whitelist | both | warn | <ApplicationSecondaryNavigation> 不接受该 prop。已声明的 props:moduleSwitcher、tabs、value、onValueChange、onNavigationSettings、navigationSettingsOpen、onCloseSettings。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5980
6010
|
| `props-whitelist-global-sidebar` | props-whitelist | both | warn | <GlobalSidebar> 不接受该 prop。已声明的 props:items、value、onValueChange、footer。继承自 HTMLAttributes<HTMLElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
@@ -5983,7 +6013,8 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5983
6013
|
| `props-whitelist-application-metric-primary-secondary` | props-whitelist | both | warn | <ApplicationMetricPrimarySecondary> 不接受该 prop。已声明的 props:label、value、unit、secondary。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5984
6014
|
| `props-whitelist-application-metric-status` | props-whitelist | both | warn | <ApplicationMetricStatus> 不接受该 prop。已声明的 props:label、value、status、statusText、note。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5985
6015
|
| `prop-enum-application-metric-status-status` | prop-enum | both | warn | <ApplicationMetricStatus> 的 status 取值须为 'normal' \| 'warning' \| 'danger' \| 'info' 之一 |
|
|
5986
|
-
| `props-whitelist-application-metric-strip` | props-whitelist | both | warn | <ApplicationMetricStrip> 不接受该 prop。已声明的 props:metrics、columns、children、state、error。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
6016
|
+
| `props-whitelist-application-metric-strip` | props-whitelist | both | warn | <ApplicationMetricStrip> 不接受该 prop。已声明的 props:surface、metrics、columns、children、state、error。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
6017
|
+
| `prop-enum-application-metric-strip-surface` | prop-enum | both | warn | <ApplicationMetricStrip> 的 surface 取值须为 'plain' \| 'card' 之一 |
|
|
5987
6018
|
| `prop-enum-application-metric-strip-state` | prop-enum | both | warn | <ApplicationMetricStrip> 的 state 取值须为 'ready' \| 'loading' \| 'error' 之一 |
|
|
5988
6019
|
| `props-whitelist-application-metric-trend` | props-whitelist | both | warn | <ApplicationMetricTrend> 不接受该 prop。已声明的 props:label、value、unit、delta、direction、period。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5989
6020
|
| `prop-enum-application-metric-trend-direction` | prop-enum | both | warn | <ApplicationMetricTrend> 的 direction 取值须为 'up' \| 'down' \| 'flat' 之一 |
|
|
@@ -5991,7 +6022,8 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
5991
6022
|
| `prop-enum-application-data-display-presentation` | prop-enum | both | warn | <ApplicationDataDisplay> 的 presentation 取值须为 'DataTable' \| 'RecordList' \| 'CardList' \| 'KanbanBoard' \| 'Calendar' \| 'Chart' \| 'Timeline' 之一 |
|
|
5992
6023
|
| `prop-enum-application-data-display-state` | prop-enum | both | warn | <ApplicationDataDisplay> 的 state 取值须为 'ready' \| 'loading' \| 'empty' \| 'error' \| 'no-permission' \| 'not-found' 之一 |
|
|
5993
6024
|
| `props-whitelist-application-filter-list` | props-whitelist | both | warn | <ApplicationFilterList> 不接受该 prop。已声明的 props:groups、values、onChange、onApply、onReset、search。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
5994
|
-
| `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-* 等)可直接传,会透传到底层元素 |
|
|
6025
|
+
| `props-whitelist-application-page-header` | props-whitelist | both | warn | <ApplicationPageHeader> 不接受该 prop。已声明的 props:layout、title、subtitle、dataStatus、updatedAt、onRefresh、onBack、backLabel、taskStatus、actions、pageModes、pageMode、onPageModeChange、breadcrumb。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
6026
|
+
| `prop-enum-application-page-header-layout` | prop-enum | both | warn | <ApplicationPageHeader> 的 layout 取值须为 'horizontal' \| 'stacked' 之一 |
|
|
5995
6027
|
| `prop-enum-application-page-header-data-status` | prop-enum | both | warn | <ApplicationPageHeader> 的 dataStatus 取值须为 'normal' \| 'refreshing' \| 'failed' 之一 |
|
|
5996
6028
|
| `prop-enum-application-page-header-page-mode` | prop-enum | both | warn | <ApplicationPageHeader> 的 pageMode 取值须为 'LIST' \| 'CARD' \| 'SPLIT' \| 'BOARD' \| 'CALENDAR' 之一 |
|
|
5997
6029
|
| `props-whitelist-application-page-layout-container` | props-whitelist | both | warn | <ApplicationPageLayoutContainer> 不接受该 prop。已声明的 props:pageType、header、metrics、dataControl、children。继承自 HTMLAttributes<HTMLDivElement> 的属性(onClick、id、aria-* 等)可直接传,会透传到底层元素 |
|
|
@@ -6019,12 +6051,13 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
6019
6051
|
|
|
6020
6052
|
## 图标字形
|
|
6021
6053
|
|
|
6022
|
-
共
|
|
6054
|
+
共 39 个。`<Icon name>` 只接受下表的名字(类型 `IconName`,清单外的名字在 tsc 与 `prop-enum` 两处被拒),尺寸只取登记档 14 / 16 / 18 / 20 / 24;
|
|
6023
6055
|
绕过类型检查的未登记名字渲染为等尺寸占位盒。确需新字形须先登记进 `@moheng-design/ui` 的图标清单并随包发版,
|
|
6024
6056
|
不得改用内联 `<svg>`。表中用途是该字形在库内的登记用途,业务侧可复用同一字形表达同义动作。
|
|
6025
6057
|
|
|
6026
6058
|
| 名字 | 登记用途 |
|
|
6027
6059
|
|---|---|
|
|
6060
|
+
| `table-properties` | 模块切换触发器的前置字形(16px) |
|
|
6028
6061
|
| `activity` | 全局动作「总览」的字形(18px 档) |
|
|
6029
6062
|
| `arrow-down` | ApplicationMetricTrend 的下降方向字形(14px 档) |
|
|
6030
6063
|
| `arrow-up` | ApplicationMetricTrend 的上升方向字形(14px 档) |
|
|
@@ -6066,7 +6099,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
6066
6099
|
|
|
6067
6100
|
## Token 全表
|
|
6068
6101
|
|
|
6069
|
-
共
|
|
6102
|
+
共 401 条:`--application-*` 107 条、`--ui-*` 145 条、`--ds-*` 149 条。源是 `packages/ui/src/tokens/*.css`(01 §4.1),
|
|
6070
6103
|
本表由其导出产物 `tokens.json` 展平而来 —— CSS 是源,方向不可反转。
|
|
6071
6104
|
|
|
6072
6105
|
值即 CSS 源里的字面量,可直接写进 `var()` 的回退位或用于比对;`var(--…)` 形式表示
|
|
@@ -6153,6 +6186,10 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
6153
6186
|
| `--application-categorical-07` | `var(--ds-color-categorical-07)` | `--application-*` |
|
|
6154
6187
|
| `--application-categorical-08` | `var(--ds-color-categorical-08)` | `--application-*` |
|
|
6155
6188
|
| `--application-categorical-09` | `var(--ds-color-categorical-09)` | `--application-*` |
|
|
6189
|
+
| `--application-page-header-height` | `52px` | `--application-*` |
|
|
6190
|
+
| `--application-page-header-marker` | `linear-gradient(to bottom, color-mix(in srgb,var(--application-accent) 80%,black), color-mix(in srgb,var(--application-accent) 67%,white))` | `--application-*` |
|
|
6191
|
+
| `--application-accent-hover` | `var(--ds-color-theme-primary-hover)` | `--application-*` |
|
|
6192
|
+
| `--application-accent-pressed` | `var(--ds-color-theme-primary-active)` | `--application-*` |
|
|
6156
6193
|
| `--application-radius-0` | `var(--ds-radius-0)` | `--application-*` |
|
|
6157
6194
|
| `--application-radius-4` | `var(--ds-radius-4)` | `--application-*` |
|
|
6158
6195
|
| `--application-radius-8` | `var(--ds-radius-8)` | `--application-*` |
|
|
@@ -6272,7 +6309,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
6272
6309
|
| `--ui-shell-module-switch-trigger-padding-bottom` | `4px` | `--ui-*` |
|
|
6273
6310
|
| `--ui-shell-module-switch-trigger-padding-left` | `var(--ds-space-3)` | `--ui-*` |
|
|
6274
6311
|
| `--ui-shell-module-switch-trigger-divider` | `inset calc(-1 * var(--ds-hairline)) 0 0 0 var(--ds-color-border)` | `--ui-*` |
|
|
6275
|
-
| `--ui-shell-module-switch-trigger-gap` | `var(--ds-space-
|
|
6312
|
+
| `--ui-shell-module-switch-trigger-gap` | `var(--ds-space-1)` | `--ui-*` |
|
|
6276
6313
|
| `--ui-shell-module-switch-copy-gap` | `1px` | `--ui-*` |
|
|
6277
6314
|
| `--ui-shell-module-switch-icon-box-size` | `32px` | `--ui-*` |
|
|
6278
6315
|
| `--ui-shell-module-switch-icon-glyph-size` | `18px` | `--ui-*` |
|
|
@@ -6356,10 +6393,10 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
6356
6393
|
| `--ds-font-weight-semibold` | `600` | `--ds-*` |
|
|
6357
6394
|
| `--ds-font-weight-bold` | `700` | `--ds-*` |
|
|
6358
6395
|
| `--ds-color-bg-1` | `#ffffff` | `--ds-*` |
|
|
6359
|
-
| `--ds-color-bg-2` | `#
|
|
6396
|
+
| `--ds-color-bg-2` | `#F5F5F3` | `--ds-*` |
|
|
6360
6397
|
| `--ds-color-bg-3` | `#F0EEE9` | `--ds-*` |
|
|
6361
6398
|
| `--ds-color-bg-4` | `#E7E6E2` | `--ds-*` |
|
|
6362
|
-
| `--ds-color-bg-5` | `#
|
|
6399
|
+
| `--ds-color-bg-5` | `#DBD9CE` | `--ds-*` |
|
|
6363
6400
|
| `--ds-color-bg-6` | `#B5A86D` | `--ds-*` |
|
|
6364
6401
|
| `--ds-color-fg-1` | `#B9B8B6` | `--ds-*` |
|
|
6365
6402
|
| `--ds-color-fg-2` | `#9A9994` | `--ds-*` |
|
|
@@ -6422,6 +6459,7 @@ Application Module 层的 26 个组件强绑定 `pageType` / `pageMode` / `busin
|
|
|
6422
6459
|
| `--ds-color-overlay` | `color-mix(in srgb,var(--ds-color-text) 25%,transparent)` | `--ds-*` |
|
|
6423
6460
|
| `--ds-color-drawer-border` | `var(--ds-color-divider)` | `--ds-*` |
|
|
6424
6461
|
| `--ds-color-action-neutral` | `var(--ds-color-text)` | `--ds-*` |
|
|
6462
|
+
| `--ds-color-control-pressed` | `#faf9f7` | `--ds-*` |
|
|
6425
6463
|
| `--ds-color-hover-accent` | `color-mix(in srgb,var(--ds-color-theme-primary) 8%,transparent)` | `--ds-*` |
|
|
6426
6464
|
| `--ds-color-selected` | `color-mix(in srgb,var(--ds-color-theme-primary) 8%,transparent)` | `--ds-*` |
|
|
6427
6465
|
| `--ds-color-active-accent` | `color-mix(in srgb,var(--ds-color-theme-primary) 12%,transparent)` | `--ds-*` |
|