@moheng-design/ui 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/contracts/application-atomic/application-date-range-filter.ts +43 -0
- package/contracts/application-atomic/list-table-pagination.ts +17 -5
- package/contracts/application-atomic/search-field.ts +1 -1
- package/contracts/application-atomic/system-button.ts +5 -1
- package/contracts/application-module/content/application-page-header.ts +55 -6
- package/contracts/application-module/content/application-query-toolbar.ts +22 -6
- package/contracts/application-module/content/application-record-detail-body.ts +13 -3
- package/contracts/application-module/navigation/application-module-switcher.ts +11 -11
- package/contracts/application-module/navigation/application-primary-navigation.ts +75 -25
- package/contracts/application-module/navigation/application-secondary-navigation.ts +57 -6
- package/contracts/application-module/navigation/top-navigation-primary-bar.ts +24 -7
- package/contracts/application-module/overlays/application-detail-drawer.ts +16 -5
- package/contracts/application-module/overlays/application-form-dialog.ts +31 -6
- package/contracts/application-module/overlays/application-global-action-panel.ts +3 -3
- package/contracts/application-module/statistics/metrics.ts +9 -2
- package/contracts/foundation/actions/button.ts +5 -4
- package/contracts/foundation/data-content-layout/badge.ts +2 -1
- package/contracts/foundation/data-content-layout/card.ts +1 -1
- package/contracts/foundation/data-content-layout/table.ts +25 -1
- package/contracts/foundation/feedback-overlay/alert-dialog.ts +8 -3
- package/contracts/foundation/feedback-overlay/dialog.ts +14 -2
- package/contracts/foundation/feedback-overlay/sheet.ts +4 -2
- package/contracts/foundation/icon/icon-name.ts +3 -1
- package/contracts/foundation/input-selection/date-input.ts +39 -0
- package/contracts/foundation/input-selection/input.ts +2 -2
- package/contracts/foundation/navigation-command/pagination.ts +8 -4
- package/dist/components/application-atomic/ApplicationDateRangeFilter.js +112 -0
- package/dist/components/application-atomic/ApplicationDateRangeFilter.js.map +1 -0
- package/dist/components/application-atomic/ListTablePagination.js +45 -33
- package/dist/components/application-atomic/ListTablePagination.js.map +1 -1
- package/dist/components/application-atomic/SystemButton.js +2 -1
- package/dist/components/application-atomic/SystemButton.js.map +1 -1
- package/dist/components/application-module/content/ApplicationPageHeader.js +24 -9
- package/dist/components/application-module/content/ApplicationPageHeader.js.map +1 -1
- package/dist/components/application-module/content/ApplicationPageLayoutContainer.js +4 -2
- package/dist/components/application-module/content/ApplicationPageLayoutContainer.js.map +1 -1
- package/dist/components/application-module/content/ApplicationQueryToolbar.js +12 -10
- package/dist/components/application-module/content/ApplicationQueryToolbar.js.map +1 -1
- package/dist/components/application-module/content/ApplicationRecordDetailBody.js +20 -13
- package/dist/components/application-module/content/ApplicationRecordDetailBody.js.map +1 -1
- package/dist/components/application-module/navigation/ApplicationModuleSwitcher.js +5 -6
- package/dist/components/application-module/navigation/ApplicationModuleSwitcher.js.map +1 -1
- package/dist/components/application-module/navigation/ApplicationPrimaryNavigation.js +39 -36
- package/dist/components/application-module/navigation/ApplicationPrimaryNavigation.js.map +1 -1
- package/dist/components/application-module/navigation/ApplicationSecondaryNavigation.js +29 -1
- package/dist/components/application-module/navigation/ApplicationSecondaryNavigation.js.map +1 -1
- package/dist/components/application-module/navigation/TopNavigationPrimaryBar.js +6 -6
- package/dist/components/application-module/navigation/TopNavigationPrimaryBar.js.map +1 -1
- package/dist/components/application-module/overlays/ApplicationDetailDrawer.js +7 -7
- package/dist/components/application-module/overlays/ApplicationDetailDrawer.js.map +1 -1
- package/dist/components/application-module/overlays/ApplicationFormDialog.js +19 -3
- package/dist/components/application-module/overlays/ApplicationFormDialog.js.map +1 -1
- package/dist/components/application-module/overlays/ApplicationGlobalActionPanel.js.map +1 -1
- package/dist/components/application-module/statistics/ApplicationMetricStrip.js +2 -1
- package/dist/components/application-module/statistics/ApplicationMetricStrip.js.map +1 -1
- package/dist/components/foundation/data-content-layout/Table.js +108 -83
- package/dist/components/foundation/data-content-layout/Table.js.map +1 -1
- package/dist/components/foundation/feedback-overlay/AlertDialog.js +8 -4
- package/dist/components/foundation/feedback-overlay/AlertDialog.js.map +1 -1
- package/dist/components/foundation/feedback-overlay/Dialog.js +6 -2
- package/dist/components/foundation/feedback-overlay/Dialog.js.map +1 -1
- package/dist/components/foundation/feedback-overlay/Sheet.js.map +1 -1
- package/dist/components/foundation/input-selection/DateInput.js +70 -0
- package/dist/components/foundation/input-selection/DateInput.js.map +1 -0
- package/dist/components/foundation/navigation-command/Pagination.js +10 -5
- package/dist/components/foundation/navigation-command/Pagination.js.map +1 -1
- package/dist/icon/glyphs.js +2 -0
- package/dist/icon/glyphs.js.map +1 -1
- package/dist/index.js +4 -0
- package/dist/index.js.map +1 -1
- package/dist/internal/CloseButton.js +7 -1
- package/dist/internal/CloseButton.js.map +1 -1
- package/dist/internal/date.js +8 -0
- package/dist/internal/date.js.map +1 -1
- package/dist/styles.css +1104 -434
- package/dist/tokens.css +126 -61
- package/dist-types/contracts/application-atomic/application-date-range-filter.d.ts +36 -0
- package/dist-types/contracts/application-atomic/application-date-range-filter.d.ts.map +1 -0
- package/dist-types/contracts/application-atomic/list-table-pagination.d.ts +12 -2
- package/dist-types/contracts/application-atomic/list-table-pagination.d.ts.map +1 -1
- package/dist-types/contracts/application-atomic/search-field.d.ts +1 -1
- package/dist-types/contracts/application-atomic/system-button.d.ts +5 -1
- package/dist-types/contracts/application-atomic/system-button.d.ts.map +1 -1
- package/dist-types/contracts/application-module/content/application-page-header.d.ts +51 -6
- package/dist-types/contracts/application-module/content/application-page-header.d.ts.map +1 -1
- package/dist-types/contracts/application-module/content/application-query-toolbar.d.ts +22 -6
- package/dist-types/contracts/application-module/content/application-query-toolbar.d.ts.map +1 -1
- package/dist-types/contracts/application-module/content/application-record-detail-body.d.ts +12 -3
- package/dist-types/contracts/application-module/content/application-record-detail-body.d.ts.map +1 -1
- package/dist-types/contracts/application-module/navigation/application-module-switcher.d.ts +8 -10
- package/dist-types/contracts/application-module/navigation/application-module-switcher.d.ts.map +1 -1
- package/dist-types/contracts/application-module/navigation/application-primary-navigation.d.ts +54 -22
- package/dist-types/contracts/application-module/navigation/application-primary-navigation.d.ts.map +1 -1
- package/dist-types/contracts/application-module/navigation/application-secondary-navigation.d.ts +43 -6
- package/dist-types/contracts/application-module/navigation/application-secondary-navigation.d.ts.map +1 -1
- package/dist-types/contracts/application-module/navigation/top-navigation-primary-bar.d.ts +19 -7
- package/dist-types/contracts/application-module/navigation/top-navigation-primary-bar.d.ts.map +1 -1
- package/dist-types/contracts/application-module/overlays/application-detail-drawer.d.ts +9 -4
- package/dist-types/contracts/application-module/overlays/application-detail-drawer.d.ts.map +1 -1
- package/dist-types/contracts/application-module/overlays/application-form-dialog.d.ts +29 -6
- package/dist-types/contracts/application-module/overlays/application-form-dialog.d.ts.map +1 -1
- package/dist-types/contracts/application-module/overlays/application-global-action-panel.d.ts +3 -3
- package/dist-types/contracts/application-module/statistics/metrics.d.ts +7 -1
- package/dist-types/contracts/application-module/statistics/metrics.d.ts.map +1 -1
- package/dist-types/contracts/foundation/actions/button.d.ts +5 -4
- package/dist-types/contracts/foundation/actions/button.d.ts.map +1 -1
- package/dist-types/contracts/foundation/data-content-layout/badge.d.ts +2 -1
- package/dist-types/contracts/foundation/data-content-layout/badge.d.ts.map +1 -1
- package/dist-types/contracts/foundation/data-content-layout/card.d.ts +1 -1
- package/dist-types/contracts/foundation/data-content-layout/table.d.ts +23 -1
- package/dist-types/contracts/foundation/data-content-layout/table.d.ts.map +1 -1
- package/dist-types/contracts/foundation/feedback-overlay/alert-dialog.d.ts +8 -3
- package/dist-types/contracts/foundation/feedback-overlay/alert-dialog.d.ts.map +1 -1
- package/dist-types/contracts/foundation/feedback-overlay/dialog.d.ts +13 -2
- package/dist-types/contracts/foundation/feedback-overlay/dialog.d.ts.map +1 -1
- package/dist-types/contracts/foundation/feedback-overlay/sheet.d.ts +4 -2
- package/dist-types/contracts/foundation/feedback-overlay/sheet.d.ts.map +1 -1
- package/dist-types/contracts/foundation/icon/icon-name.d.ts +2 -2
- package/dist-types/contracts/foundation/icon/icon-name.d.ts.map +1 -1
- package/dist-types/contracts/foundation/input-selection/date-input.d.ts +32 -0
- package/dist-types/contracts/foundation/input-selection/date-input.d.ts.map +1 -0
- package/dist-types/contracts/foundation/input-selection/input.d.ts +2 -2
- package/dist-types/contracts/foundation/navigation-command/pagination.d.ts +8 -4
- package/dist-types/contracts/foundation/navigation-command/pagination.d.ts.map +1 -1
- package/dist-types/src/components/application-atomic/ApplicationDateRangeFilter.d.ts +13 -0
- package/dist-types/src/components/application-atomic/ApplicationDateRangeFilter.d.ts.map +1 -0
- package/dist-types/src/components/application-atomic/ListTablePagination.d.ts +11 -13
- package/dist-types/src/components/application-atomic/ListTablePagination.d.ts.map +1 -1
- package/dist-types/src/components/application-atomic/SystemButton.d.ts.map +1 -1
- package/dist-types/src/components/application-module/content/ApplicationPageHeader.d.ts +10 -4
- package/dist-types/src/components/application-module/content/ApplicationPageHeader.d.ts.map +1 -1
- package/dist-types/src/components/application-module/content/ApplicationPageLayoutContainer.d.ts +4 -0
- package/dist-types/src/components/application-module/content/ApplicationPageLayoutContainer.d.ts.map +1 -1
- package/dist-types/src/components/application-module/content/ApplicationQueryToolbar.d.ts +8 -2
- package/dist-types/src/components/application-module/content/ApplicationQueryToolbar.d.ts.map +1 -1
- package/dist-types/src/components/application-module/content/ApplicationRecordDetailBody.d.ts +1 -10
- package/dist-types/src/components/application-module/content/ApplicationRecordDetailBody.d.ts.map +1 -1
- package/dist-types/src/components/application-module/navigation/ApplicationModuleSwitcher.d.ts +7 -4
- package/dist-types/src/components/application-module/navigation/ApplicationModuleSwitcher.d.ts.map +1 -1
- package/dist-types/src/components/application-module/navigation/ApplicationPrimaryNavigation.d.ts +13 -20
- package/dist-types/src/components/application-module/navigation/ApplicationPrimaryNavigation.d.ts.map +1 -1
- package/dist-types/src/components/application-module/navigation/ApplicationSecondaryNavigation.d.ts +13 -3
- package/dist-types/src/components/application-module/navigation/ApplicationSecondaryNavigation.d.ts.map +1 -1
- package/dist-types/src/components/application-module/navigation/TopNavigationPrimaryBar.d.ts +10 -4
- package/dist-types/src/components/application-module/navigation/TopNavigationPrimaryBar.d.ts.map +1 -1
- package/dist-types/src/components/application-module/overlays/ApplicationDetailDrawer.d.ts +9 -3
- package/dist-types/src/components/application-module/overlays/ApplicationDetailDrawer.d.ts.map +1 -1
- package/dist-types/src/components/application-module/overlays/ApplicationFormDialog.d.ts +2 -2
- package/dist-types/src/components/application-module/overlays/ApplicationFormDialog.d.ts.map +1 -1
- package/dist-types/src/components/application-module/overlays/ApplicationGlobalActionPanel.d.ts +2 -2
- package/dist-types/src/components/application-module/statistics/ApplicationMetricStrip.d.ts.map +1 -1
- package/dist-types/src/components/foundation/data-content-layout/Table.d.ts +5 -5
- package/dist-types/src/components/foundation/data-content-layout/Table.d.ts.map +1 -1
- package/dist-types/src/components/foundation/feedback-overlay/AlertDialog.d.ts +7 -0
- package/dist-types/src/components/foundation/feedback-overlay/AlertDialog.d.ts.map +1 -1
- package/dist-types/src/components/foundation/feedback-overlay/Dialog.d.ts +4 -1
- package/dist-types/src/components/foundation/feedback-overlay/Dialog.d.ts.map +1 -1
- package/dist-types/src/components/foundation/feedback-overlay/Sheet.d.ts +2 -1
- package/dist-types/src/components/foundation/feedback-overlay/Sheet.d.ts.map +1 -1
- package/dist-types/src/components/foundation/input-selection/DateInput.d.ts +13 -0
- package/dist-types/src/components/foundation/input-selection/DateInput.d.ts.map +1 -0
- package/dist-types/src/components/foundation/navigation-command/Pagination.d.ts +6 -1
- package/dist-types/src/components/foundation/navigation-command/Pagination.d.ts.map +1 -1
- package/dist-types/src/icon/glyphs.d.ts.map +1 -1
- package/dist-types/src/index.d.ts +7 -3
- package/dist-types/src/index.d.ts.map +1 -1
- package/dist-types/src/internal/CloseButton.d.ts +11 -1
- package/dist-types/src/internal/CloseButton.d.ts.map +1 -1
- package/dist-types/src/internal/date.d.ts +2 -0
- package/dist-types/src/internal/date.d.ts.map +1 -1
- package/package.json +18 -18
- package/tokens.json +478 -128
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import type { HTMLAttributes, ReactNode } from 'react'
|
|
2
|
+
|
|
3
|
+
/** 日期区间。两端均为本地时区 ISO `yyyy-mm-dd`,缺省一端表示该端不限 */
|
|
4
|
+
export interface DateRangeValue {
|
|
5
|
+
/** 起始日期(含) */
|
|
6
|
+
start?: string
|
|
7
|
+
/** 结束日期(含) */
|
|
8
|
+
end?: string
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* 查询工具栏主控制行中的**日期区间**快捷筛选,与 `ApplicationFilterMenu` 同为一个
|
|
13
|
+
* 常驻维度,放进 `ApplicationQueryToolbar` 的 `commonFilters`。
|
|
14
|
+
*
|
|
15
|
+
* 触发器与 `ApplicationFilterMenu` 同高同壳,生效时回显「接收时间:2026-07-01 – 2026-07-28」。
|
|
16
|
+
* 面板里是起止两张 `Calendar` 月格,由「应用」提交、「清空」撤销 —— 选到一半不生效。
|
|
17
|
+
*
|
|
18
|
+
* ⚠ **已生效的区间必须回写到工具栏第三行的筛选标签行**(`appliedTags`),且标签可移除。
|
|
19
|
+
* 与 `ApplicationFilterMenu` 同一条规矩:筛选状态只存在于触发器上是不合规的。
|
|
20
|
+
*/
|
|
21
|
+
export interface ApplicationDateRangeFilterProps
|
|
22
|
+
extends Omit<HTMLAttributes<HTMLDivElement>, 'defaultValue' | 'onChange'> {
|
|
23
|
+
/** 维度名称,显示在触发器上,如「接收时间」 */
|
|
24
|
+
label: ReactNode
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* 维度名称的纯文本,用于触发器回显与可访问名。
|
|
28
|
+
* `label` 为非字符串时**必须**提供,否则回显为 `[object Object]`。
|
|
29
|
+
*/
|
|
30
|
+
labelText?: string
|
|
31
|
+
|
|
32
|
+
/** 受控值。两端都缺省即未生效 */
|
|
33
|
+
value?: DateRangeValue
|
|
34
|
+
|
|
35
|
+
/** 「应用」提交时的回调。「清空」提交 `{}` */
|
|
36
|
+
onValueChange?: (value: DateRangeValue) => void
|
|
37
|
+
|
|
38
|
+
/** 禁用 */
|
|
39
|
+
disabled?: boolean
|
|
40
|
+
|
|
41
|
+
/** 「今天」,透传给两张 `Calendar` */
|
|
42
|
+
today?: Date
|
|
43
|
+
}
|
|
@@ -1,14 +1,19 @@
|
|
|
1
1
|
import type { HTMLAttributes } from 'react'
|
|
2
2
|
|
|
3
3
|
/**
|
|
4
|
-
* 列表 / 表格分页 ——
|
|
4
|
+
* 列表 / 表格分页 —— 摘要、每页条数、页码窗口与跳页。
|
|
5
5
|
* 数据展示区的标准页脚,LIST 页面模式的默认配置。
|
|
6
6
|
*
|
|
7
|
+
* 形态按 GAP Design kit「分页行」(业财平台 round-01 · pagination/structure 裁决,2026-11-10):
|
|
8
|
+
* 左侧摘要「每页 N 条,共 Z 条数据」12/20 三级文字色,右侧依次为每页条数选择器、
|
|
9
|
+
* Foundation `Pagination`(首页 · 上一页 · 页码窗口 · 下一页 · 末页)与「第 [ ] 页」跳页框,
|
|
10
|
+
* 控件一律 32 高、圆角 12、间隔 4。**本组件包含 `Pagination`**,两者不再是替代关系。
|
|
11
|
+
*
|
|
7
12
|
* ⚠ **分页状态按业务视图各记一份**:切换 Business View 时回到该视图上次所在的页,
|
|
8
13
|
* 切换 Page Mode 与从详情返回时保持当前页 —— 规范要求恢复来源上下文。
|
|
9
14
|
* 搜索、筛选、排序变化时复位到第 1 页(07 · C-13)。
|
|
10
15
|
*
|
|
11
|
-
*
|
|
16
|
+
* 没有总数与每页条数需求时,直接用 Foundation `Pagination`。
|
|
12
17
|
*/
|
|
13
18
|
export interface ListTablePaginationProps extends HTMLAttributes<HTMLDivElement> {
|
|
14
19
|
/** 当前页码,从 1 开始 */
|
|
@@ -23,6 +28,12 @@ export interface ListTablePaginationProps extends HTMLAttributes<HTMLDivElement>
|
|
|
23
28
|
/** 每页条数的可选值 */
|
|
24
29
|
pageSizeOptions?: number[]
|
|
25
30
|
|
|
31
|
+
/**
|
|
32
|
+
* 是否显示「第 [ ] 页」跳页框,默认 `true`(kit 分页行恒有)。回车提交,越界时夹到
|
|
33
|
+
* 1 与总页数之间,提交后清空。总页数很少、跳页没有意义时可传 `false`
|
|
34
|
+
*/
|
|
35
|
+
showJumper?: boolean
|
|
36
|
+
|
|
26
37
|
/** 页码变化回调 */
|
|
27
38
|
onPageChange?: (page: number) => void
|
|
28
39
|
|
|
@@ -33,16 +44,17 @@ export interface ListTablePaginationProps extends HTMLAttributes<HTMLDivElement>
|
|
|
33
44
|
/*
|
|
34
45
|
* ─── 待处理(不阻塞契约) ─────────────────────────────────────────
|
|
35
46
|
*
|
|
36
|
-
* T6
|
|
47
|
+
* T6 ✅ 业财平台 round-01 起内部复用 Pagination 渲染页码区。
|
|
37
48
|
* 源实现只提供「上一页 / 当前页 / 下一页」步进,
|
|
38
49
|
* 而 Foundation Pagination 有完整的页码窗口(首页 + 当前 ±1 + 末页 + 省略号)。
|
|
39
50
|
* 在 1284 条 / 每页 20 条 = 65 页的场景下,用户只能一页页点。
|
|
40
51
|
* 裁决:实现阶段内部复用 Pagination 渲染页码区,
|
|
41
52
|
* 本组件只额外承载结果区间、总数与每页条数选择器。
|
|
53
|
+
* 此前实现以「两份契约写的是替代关系」为由未做,round-01 按 kit 分页行补齐,另加跳页框。
|
|
42
54
|
*
|
|
43
55
|
* T7 未复用 NativeSelect,内联写了原生 <select>。
|
|
44
56
|
* 与 I4 / D1 / F3 同类。改用 NativeSelect。
|
|
45
57
|
*
|
|
46
|
-
* I16
|
|
47
|
-
*
|
|
58
|
+
* I16 中文硬编码:「每页 N 条,共 Z 条数据」「每页 N 条」「第 … 页」「请输入」,
|
|
59
|
+
* 以及 Pagination 的四个步进名。数量与格式均无法覆盖。
|
|
48
60
|
*/
|
|
@@ -4,7 +4,7 @@ import type { ChangeEvent, HTMLAttributes, InputHTMLAttributes } from 'react'
|
|
|
4
4
|
* 共享的紧凑搜索入口 —— **产品内每一处纯文本搜索**:
|
|
5
5
|
* 查询工具栏、目录搜索、人员与文件选择器。
|
|
6
6
|
*
|
|
7
|
-
* 32px 最小高度,
|
|
7
|
+
* 32px 最小高度,12px 圆角,白底 1px 描边(GAP Design kit「表单/输入」),焦点只在外壳表达一次。
|
|
8
8
|
*
|
|
9
9
|
* ⚠ **只在 Enter 时提交。** 规范禁止逐字实时搜索作为默认行为。
|
|
10
10
|
*
|
|
@@ -17,8 +17,12 @@ import type { ButtonHTMLAttributes, ReactNode } from 'react'
|
|
|
17
17
|
export interface SystemButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
|
|
18
18
|
/**
|
|
19
19
|
* 应用意图。映射到 Foundation Button 的 variant:`quiet` → ghost,其余同名。
|
|
20
|
+
*
|
|
21
|
+
* 删除类动作两档:`destructive-outline`(白底、危险色描边与文字)用于与次要按钮
|
|
22
|
+
* 并排出现的删除,例如表单里「删除此附件」;`destructive`(实心危险色)只用于
|
|
23
|
+
* 确认弹窗里那个不可逆的最终动作。同一动作组内不得同时出现两档。
|
|
20
24
|
*/
|
|
21
|
-
intent?: 'primary' | 'secondary' | 'quiet' | 'link' | 'destructive'
|
|
25
|
+
intent?: 'primary' | 'secondary' | 'quiet' | 'link' | 'destructive' | 'destructive-outline'
|
|
22
26
|
|
|
23
27
|
/**
|
|
24
28
|
* 尺寸。见 T2 —— `compact` 目前与 `default` 无视觉差异。
|
|
@@ -1,16 +1,35 @@
|
|
|
1
1
|
import type { HTMLAttributes, ReactNode } from 'react'
|
|
2
2
|
|
|
3
|
+
/** 页头中部的任务状态胶囊 */
|
|
4
|
+
export interface ApplicationPageHeaderTaskStatus {
|
|
5
|
+
/** 胶囊文案,如「正在识别 14/100」 */
|
|
6
|
+
label: ReactNode
|
|
7
|
+
/** 任务进行中。为 true 时胶囊前带转圈,任务结束后改为 false 或移除整个 `taskStatus` */
|
|
8
|
+
busy?: boolean
|
|
9
|
+
}
|
|
10
|
+
|
|
3
11
|
/** Canvas 五层模型的 L2 页面模式 */
|
|
4
12
|
export type PageMode = 'LIST' | 'CARD' | 'SPLIT' | 'BOARD' | 'CALENDAR'
|
|
5
13
|
|
|
6
14
|
/**
|
|
7
15
|
* Canvas 的**上下文区**(源仓库名 `application-page-header`)。
|
|
8
16
|
*
|
|
9
|
-
*
|
|
17
|
+
* 左侧:可选的「返回」· 16px 标题 · 竖线 · 更新时间与刷新。中部:可选的任务状态胶囊(`taskStatus`)。
|
|
10
18
|
* 右侧:页面动作组,再经分隔线之后是**页面级的 Page Mode Switch**。
|
|
11
19
|
*
|
|
20
|
+
* 左侧按 GAP Design kit「数据更新」(业财平台 round-01 裁决,2026-11-10):
|
|
21
|
+
* - 二级页面以「返回」幽灵按钮(16px chevron + 文字,32 高、左右 12、圆角 12)开头,
|
|
22
|
+
* 与标题间隔 8 —— 传 `onBack` 即渲染
|
|
23
|
+
* - 标题之后是一条 12px 高的竖线,再接更新时间:完整日期时间(`2026-07-28 10:00`)
|
|
24
|
+
* 14/20 文字1,不加「更新于」前缀;传了 `onRefresh` 时时间与其后的 16px 刷新字形
|
|
25
|
+
* 合成一枚幽灵按钮(32 高、左右 12、圆角 12),点它即刷新
|
|
26
|
+
*
|
|
27
|
+
* 外观(GAP Design kit,业财平台 round-01):48px 高的通栏,落在页面底色上、只有一条
|
|
28
|
+
* 0.5px 下边线,不是卡片。放在 `ApplicationPageLayoutContainer` 的 `header` 槽位时
|
|
29
|
+
* 向两侧与顶部吃掉页面留白,贴满内容区宽度。此前左侧的 3×16 强调色条已移除。
|
|
30
|
+
*
|
|
12
31
|
* ### 允许出现在这里
|
|
13
|
-
* 新建 / 导入 / 导出 /
|
|
32
|
+
* 新建 / 导入 / 导出 / 更多、刷新、返回、面包屑、Page Mode Switch。
|
|
14
33
|
*
|
|
15
34
|
* ### ⚠ 禁止出现在这里
|
|
16
35
|
* **搜索、常用筛选、排序、SPLIT 视图模式切换、列设置、行级或批量动作。**
|
|
@@ -25,7 +44,7 @@ export type PageMode = 'LIST' | 'CARD' | 'SPLIT' | 'BOARD' | 'CALENDAR'
|
|
|
25
44
|
* 刷新**只更新数据**,绝不重置业务视图、搜索、筛选、排序或页面模式。
|
|
26
45
|
*/
|
|
27
46
|
export interface ApplicationPageHeaderProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
|
|
28
|
-
/** 页面标题,16/
|
|
47
|
+
/** 页面标题,16/32 regular 字重,超长省略 */
|
|
29
48
|
title?: ReactNode
|
|
30
49
|
|
|
31
50
|
/** 副标题,紧随标题以 12px label 色显示 */
|
|
@@ -34,12 +53,39 @@ export interface ApplicationPageHeaderProps extends Omit<HTMLAttributes<HTMLDivE
|
|
|
34
53
|
/** 数据状态。决定状态文案与刷新按钮的可用性 */
|
|
35
54
|
dataStatus?: 'normal' | 'refreshing' | 'failed'
|
|
36
55
|
|
|
37
|
-
/**
|
|
56
|
+
/**
|
|
57
|
+
* 数据更新时间,写完整日期时间 `YYYY-MM-DD HH:mm`(如 `2026-07-28 10:00`),原样显示、
|
|
58
|
+
* 不加前缀(GAP Design kit「数据更新」;推翻 07 · C-12 的「只写 HH:mm」)。
|
|
59
|
+
* 仅在 `normal` 状态显示;`refreshing` / `failed` 显示「刷新中」/「刷新失败」
|
|
60
|
+
*/
|
|
38
61
|
updatedAt?: string
|
|
39
62
|
|
|
40
|
-
/**
|
|
63
|
+
/**
|
|
64
|
+
* 刷新回调。提供时更新时间与刷新字形合成一枚按钮,`refreshing` 状态下不可点、字形转圈。
|
|
65
|
+
* **未提供时不渲染刷新字形,时间按纯文字显示** —— 没有刷新能力的页面(草稿、向导、
|
|
66
|
+
* 一次性结果)不得出现一个点了没反应的按钮。状态文案(时间 / 刷新中 / 刷新失败)不受影响。
|
|
67
|
+
*/
|
|
41
68
|
onRefresh?: () => void
|
|
42
69
|
|
|
70
|
+
/**
|
|
71
|
+
* 返回回调。提供时标题前渲染「返回」幽灵按钮(kit「数据更新-二级页面」)。
|
|
72
|
+
* 组件不做路由跳转,回到哪里、还原哪些上下文由调用方决定。
|
|
73
|
+
* 与 `breadcrumb` 不得同时传 —— 二级页面用返回,需要展示多级路径时才用面包屑
|
|
74
|
+
*/
|
|
75
|
+
onBack?: () => void
|
|
76
|
+
|
|
77
|
+
/** 返回按钮文案,默认「返回」。只在 `onBack` 提供时生效 */
|
|
78
|
+
backLabel?: string
|
|
79
|
+
|
|
80
|
+
/**
|
|
81
|
+
* 页面级进行中任务的状态胶囊,居中显示在页头中部。例如批量识别的「正在识别 14/100」。
|
|
82
|
+
* `busy` 为 true 时胶囊前带转圈。
|
|
83
|
+
*
|
|
84
|
+
* 只表达**本页正在进行的一项任务**的进度;**不得**用它显示数据刷新状态(那是
|
|
85
|
+
* `dataStatus`)、页面说明(那是 `subtitle`)或筛选摘要(那属于 `ApplicationQueryToolbar`)。
|
|
86
|
+
*/
|
|
87
|
+
taskStatus?: ApplicationPageHeaderTaskStatus
|
|
88
|
+
|
|
43
89
|
/** 页面级动作组。**至多一个 primary** */
|
|
44
90
|
actions?: ReactNode
|
|
45
91
|
|
|
@@ -52,7 +98,10 @@ export interface ApplicationPageHeaderProps extends Omit<HTMLAttributes<HTMLDivE
|
|
|
52
98
|
/** 页面模式变化回调 */
|
|
53
99
|
onPageModeChange?: (mode: PageMode) => void
|
|
54
100
|
|
|
55
|
-
/**
|
|
101
|
+
/**
|
|
102
|
+
* 面包屑。仅当页面需要展示多级路径时提供;单纯「回到上一层」用 `onBack`,两者不得同时传。
|
|
103
|
+
* 面包屑在标题上方另占一行,页头因此高于 48
|
|
104
|
+
*/
|
|
56
105
|
breadcrumb?: ReactNode
|
|
57
106
|
}
|
|
58
107
|
|
|
@@ -44,8 +44,16 @@ export type DataPresentation =
|
|
|
44
44
|
* | 行 | 内容 | 渲染条件 |
|
|
45
45
|
* |---|---|---|
|
|
46
46
|
* | 1 | 业务视图标签(2–4 个稳定工作视角) | 仅当确有视图 |
|
|
47
|
-
* | 2 | 结果摘要 │ 搜索 + 常用筛选 + 更多
|
|
48
|
-
* | 3 | 已生效筛选标签(可移除 +
|
|
47
|
+
* | 2 | 结果摘要 │ 搜索 + 排序 + 常用筛选 + 更多 ‖ 视图切换 + 呈现设置 | always |
|
|
48
|
+
* | 3 | 已生效筛选标签(可移除 + 「清空」全部) | 仅当有筛选生效 |
|
|
49
|
+
*
|
|
50
|
+
* 第 2 行左组的顺序固定为「结果摘要 → 搜索 → 排序 → 常用筛选 → 更多」—— 排序紧跟搜索、
|
|
51
|
+
* 在筛选之前(GAP Design kit「数据筛选搜索」的标注;业财平台 round-01 裁决,2026-11-10)。
|
|
52
|
+
* 右组只放 `viewModeSwitch` 与呈现设置。
|
|
53
|
+
*
|
|
54
|
+
* 几何按 kit「数据筛选搜索」(84:2803):三行之间 8;第 2 行左组控件之间 4,摘要与搜索之间
|
|
55
|
+
* 由组件画一条 1×20 的线条色竖线(只在传了 `resultSummary` 时出现);右组之间 4;左右两组之间 12。
|
|
56
|
+
* 调用方传入的排序与筛选控件不得自带外边距 —— 间隔由组件统一给出。
|
|
49
57
|
*
|
|
50
58
|
* ### ⚠ 搜索
|
|
51
59
|
* **通过 Enter 或明确的搜索动作提交,绝不逐字实时搜索。**
|
|
@@ -55,9 +63,11 @@ export type DataPresentation =
|
|
|
55
63
|
* 由「应用」提交,并**回写到第三行的标签**。
|
|
56
64
|
*
|
|
57
65
|
* ### ⚠ 呈现设置按钮必须按当前呈现方式命名
|
|
66
|
+
* 按钮是 32×32 纯图标(16px `sliders-horizontal`,白底描边、圆角 12,kit「列表工具」),
|
|
67
|
+
* 名字落在可访问名与悬停提示上:
|
|
58
68
|
* DataTable → 列设置 · RecordList → 列表设置 · CardList → 卡片设置 · KanbanBoard → 看板设置 ·
|
|
59
69
|
* Calendar → 日历设置 · Chart → 图表设置 · Timeline → 时间轴设置。
|
|
60
|
-
*
|
|
70
|
+
* **通用的「视图设置」被明令禁止**,「自定义」同理 —— 它不说明设的是什么。
|
|
61
71
|
* 无真实可配置项时(`hasPresentationSettings={false}`,或不传
|
|
62
72
|
* `onPresentationSettings`)按钮不渲染且不占位。
|
|
63
73
|
* 每种呈现方式**各自独立存储**其设置。
|
|
@@ -76,7 +86,10 @@ export interface ApplicationQueryToolbarProps extends HTMLAttributes<HTMLDivElem
|
|
|
76
86
|
/** 业务视图变化回调 */
|
|
77
87
|
onBusinessViewChange?: (value: string) => void
|
|
78
88
|
|
|
79
|
-
/**
|
|
89
|
+
/**
|
|
90
|
+
* 结果摘要,渲染为一枚胶囊,如 `<>共 <strong>1,284</strong> 条</>`。
|
|
91
|
+
* 数字用 `<strong>` 包裹即加粗为正文色;有勾选时紧随写已选数(「已选 3 条」)。
|
|
92
|
+
*/
|
|
80
93
|
resultSummary?: ReactNode
|
|
81
94
|
|
|
82
95
|
/** 搜索框受控值 */
|
|
@@ -112,7 +125,10 @@ export interface ApplicationQueryToolbarProps extends HTMLAttributes<HTMLDivElem
|
|
|
112
125
|
/** 「更多筛选」触发器,一律是 `Popover` 承载的 `ApplicationFilterList`;不得用 `Collapsible` 就地展开(06 · D-4) */
|
|
113
126
|
moreFilters?: ReactNode
|
|
114
127
|
|
|
115
|
-
/**
|
|
128
|
+
/**
|
|
129
|
+
* 排序控件,传 `Select`,渲染在搜索框之后、常用筛选之前。
|
|
130
|
+
* DataTable 呈现下表头排序是第二入口,两处共享同一份排序状态(07 · C-2)
|
|
131
|
+
*/
|
|
116
132
|
sort?: ReactNode
|
|
117
133
|
|
|
118
134
|
/** 已生效的筛选标签 */
|
|
@@ -121,7 +137,7 @@ export interface ApplicationQueryToolbarProps extends HTMLAttributes<HTMLDivElem
|
|
|
121
137
|
/** 移除单个标签回调 */
|
|
122
138
|
onRemoveTag?: (id: string) => void
|
|
123
139
|
|
|
124
|
-
/**
|
|
140
|
+
/** 清空全部筛选回调。按钮文案为「清空」,与筛选标签同款胶囊 */
|
|
125
141
|
onResetTags?: () => void
|
|
126
142
|
|
|
127
143
|
/** 当前呈现方式。**决定呈现设置按钮的文案** */
|
|
@@ -2,9 +2,9 @@ import type { HTMLAttributes, ReactNode } from 'react'
|
|
|
2
2
|
|
|
3
3
|
/** 详情中的单个字段 */
|
|
4
4
|
export interface DetailField {
|
|
5
|
-
/** 字段名,
|
|
5
|
+
/** 字段名,14/20 label 色,固定 160px 宽,与值横排 */
|
|
6
6
|
label: ReactNode
|
|
7
|
-
/** 字段值,14/20
|
|
7
|
+
/** 字段值,14/20 medium 字重,长值自动断行 */
|
|
8
8
|
value: ReactNode
|
|
9
9
|
/** React key。`label` 为非字符串时**必须**提供。见 M8 */
|
|
10
10
|
key?: string
|
|
@@ -14,7 +14,7 @@ export interface DetailField {
|
|
|
14
14
|
export interface DetailSection {
|
|
15
15
|
/** React key。`title` 为非字符串时**必须**提供。见 M8 */
|
|
16
16
|
key?: string
|
|
17
|
-
/** 分节标题,16/
|
|
17
|
+
/** 分节标题,16/20 medium 字重,左侧带 2×14 强调色竖条 */
|
|
18
18
|
title: ReactNode
|
|
19
19
|
/** 字段列表,自适应多列网格排布 */
|
|
20
20
|
fields?: DetailField[]
|
|
@@ -39,6 +39,16 @@ export interface ApplicationRecordDetailBodyProps extends HTMLAttributes<HTMLDiv
|
|
|
39
39
|
|
|
40
40
|
/** 分节集合,按顺序渲染 */
|
|
41
41
|
sections?: DetailSection[]
|
|
42
|
+
|
|
43
|
+
/**
|
|
44
|
+
* 侧栏分节。提供时主体变为两栏:左栏(`summary` + `sections`)弹性伸展,
|
|
45
|
+
* 右栏固定 360px,两栏各是一张白卡,间距 12。用于「处理记录」「审批流转」这类
|
|
46
|
+
* **伴随主内容、随它一起看**的内容。
|
|
47
|
+
*
|
|
48
|
+
* 只放一个分节;**不得**把主要字段分节挪进侧栏,也不得用它放对象级动作
|
|
49
|
+
* (动作在载体的动作区)。可用宽度不足 960px 时侧栏落到主栏下方。
|
|
50
|
+
*/
|
|
51
|
+
aside?: DetailSection
|
|
42
52
|
}
|
|
43
53
|
|
|
44
54
|
/*
|
|
@@ -15,18 +15,18 @@ export interface ModuleItem {
|
|
|
15
15
|
/**
|
|
16
16
|
* 应用二级导航的**左半部分** —— 你在哪个模块,以及如何切换。
|
|
17
17
|
*
|
|
18
|
-
* ###
|
|
19
|
-
* Standard
|
|
20
|
-
*
|
|
21
|
-
* 名称 16/20 **700**,14px chevron 右对齐。
|
|
18
|
+
* ### 触发器(GAP Design kit「应用二级模块切换」)
|
|
19
|
+
* Standard 168×48,Compact 148×40;内边距 4/12,**没有图标块**;
|
|
20
|
+
* 名称 16/20 **medium**,20px chevron 右对齐;右侧 0.5px 分隔线;悬停与展开时 6% 淡底。
|
|
22
21
|
*
|
|
23
22
|
* ⚠ **绝不能简化成一个小图标,也绝不能移除。**
|
|
24
23
|
*
|
|
25
24
|
* ### 面板
|
|
26
|
-
*
|
|
27
|
-
*
|
|
28
|
-
* **1px
|
|
29
|
-
* 条目最小高 40,内边距 8/12,圆角 12,文字 14/22
|
|
25
|
+
* 挂在触发器正下方(`position: absolute`),与触发器同宽 168、最窄 128,
|
|
26
|
+
* 底色为导航背景与表面色各半,内边距 4,条目间隔 2,
|
|
27
|
+
* **1px 右边线,无圆角,无阴影**,限高到视口底、自带垂直滚动。
|
|
28
|
+
* 条目最小高 40,内边距 8/12,圆角 12,文字 14/22;悬停取导航背景;
|
|
29
|
+
* 当前模块为强调色 semibold,右侧 14px 对勾。
|
|
30
30
|
*
|
|
31
31
|
* ⚠ **点击当前模块不发生跳转。** 路由计算由调用方负责。
|
|
32
32
|
*
|
|
@@ -45,9 +45,6 @@ export interface ApplicationModuleSwitcherProps extends Omit<ButtonHTMLAttribute
|
|
|
45
45
|
/** 当前模块值。点击它不触发 `onSelect` */
|
|
46
46
|
currentModule?: string
|
|
47
47
|
|
|
48
|
-
/** 触发器图标块内的字形,18px */
|
|
49
|
-
glyph?: ReactNode
|
|
50
|
-
|
|
51
48
|
/** 受控面板开合 */
|
|
52
49
|
open?: boolean
|
|
53
50
|
|
|
@@ -61,4 +58,7 @@ export interface ApplicationModuleSwitcherProps extends Omit<ButtonHTMLAttribute
|
|
|
61
58
|
/*
|
|
62
59
|
* 三方一致。面板的「无圆角、无阴影、仅 1px 右边线」是 readme §1.6
|
|
63
60
|
* 明确点名的特例,实现忠实遵守。
|
|
61
|
+
*
|
|
62
|
+
* 业财平台 round-01 · Shell 裁决(2026-11-10,以 GAP Design kit 为准):触发器去掉图标块,
|
|
63
|
+
* `glyph` 随之删除;面板由贴视口的 320 宽 fixed 侧板改为触发器下方的 168 宽下拉。
|
|
64
64
|
*/
|
|
@@ -5,36 +5,71 @@ import type { IconName } from '../../foundation/icon/icon-name.js'
|
|
|
5
5
|
export type GlobalActionKey = 'messages' | 'todos' | 'overview' | 'risk' | 'settings'
|
|
6
6
|
|
|
7
7
|
/**
|
|
8
|
-
* `
|
|
9
|
-
*
|
|
8
|
+
* 全局动作的承载类型。`'popover'` —— 消息 / 待办 / 总览 / 风险预警四个动作共用的
|
|
9
|
+
* `ApplicationGlobalActionPanel`;`'module'` —— 设置,`ApplicationSecondaryNavigation`
|
|
10
|
+
* 整带换成设置模块(GAP Design kit「框架结构 / 结构=设置」)。
|
|
11
|
+
*/
|
|
12
|
+
export type GlobalActionKind = 'popover' | 'module'
|
|
13
|
+
|
|
14
|
+
/**
|
|
15
|
+
* 基础版外壳里本带承载的账户入口(GAP Design kit「导航组合 / 基础版本」:用户头像在应用一级
|
|
16
|
+
* 导航的最右端)。集团版外壳的账户入口在 `TopNavigationPrimaryBar`,此时不传本项。
|
|
17
|
+
*/
|
|
18
|
+
export interface ApplicationPrimaryNavigationAccount {
|
|
19
|
+
/**
|
|
20
|
+
* 账户名。同时是头像按钮的可访问名与缩写来源,缩写规则与 `Avatar` 相同 ——
|
|
21
|
+
* 中文取末字(「成员 A」→「A」),拉丁名取首字母(07 · C-8)。缺省时头像显示「账」
|
|
22
|
+
*/
|
|
23
|
+
name?: string
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* 账户面板是否展开。传入(含 `false`)即输出 `aria-haspopup="dialog"` 与 `aria-expanded`;
|
|
27
|
+
* 缺省时两者都不输出。面板内容根应声明 `role="dialog"` 与可访问名
|
|
28
|
+
*/
|
|
29
|
+
open?: boolean
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* 头像点击回调。参数是被点的触发器,传给 `Popover` 的 `anchor` 锚定;
|
|
33
|
+
* 回调里切换开合并回写 `open`(与 `TopNavigationPrimaryBar.onAccount` 同一接法)
|
|
34
|
+
*/
|
|
35
|
+
onToggle?: (trigger: HTMLButtonElement) => void
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* `APPLICATION.PRIMARY_NAV` —— GAP Design kit「通用导航 / 应用一级导航」。
|
|
40
|
+
* Standard 48px / Compact 40px,内边距 8/12。
|
|
10
41
|
*
|
|
11
|
-
*
|
|
12
|
-
* 名称 16/24 **700**,说明 12/16 400(Compact 档隐藏)。
|
|
42
|
+
* 外壳有两种形态(kit「导航组合」):
|
|
13
43
|
*
|
|
14
|
-
*
|
|
15
|
-
*
|
|
44
|
+
* | 形态 | 带 | 总高 |
|
|
45
|
+
* |---|---|---:|
|
|
46
|
+
* | 基础版 | 本带 + `ApplicationSecondaryNavigation` | 96 |
|
|
47
|
+
* | 集团版 | `TopNavigationPrimaryBar` + 本带 + `ApplicationSecondaryNavigation` | 144 |
|
|
48
|
+
*
|
|
49
|
+
* **左侧**:应用身份 —— 32×32 logo 瓦片(8px 圆角,8% 强调色混入表面色)+ 4px 间隙 +
|
|
50
|
+
* 应用名 14/20 regular 文字1。kit 里没有应用说明行。
|
|
16
51
|
*
|
|
17
52
|
* **右侧**:**恰好这五个已登记全局动作,且顺序固定**:
|
|
18
53
|
*
|
|
19
|
-
* 消息 → 待办 →
|
|
54
|
+
* 消息 → 待办 → 总览 → 风险预警 → 设置
|
|
20
55
|
*
|
|
21
|
-
* 32
|
|
22
|
-
*
|
|
56
|
+
* 每个动作是「18px 字形 + 文字」:32 高,左右 10,字形与文字间隔 4,圆角 12,文字 14/20 文字2;
|
|
57
|
+
* 动作之间 4px。前四个打开共享 Popover;**设置不弹浮层**,而是让 `ApplicationSecondaryNavigation`
|
|
58
|
+
* 整带换成设置模块(kit「框架结构 / 结构=设置」:模块切换器显示设置模块名,标签换成设置项,
|
|
59
|
+
* 最右的「导航设置」按钮换成关闭叉号)。
|
|
60
|
+
* 基础版传 `account` 时,头像(24×24 圆形)在动作组之后,间隔 8px。
|
|
23
61
|
*
|
|
24
62
|
* ### ⚠ 硬性约束
|
|
25
63
|
* - **绝不渲染第二个设置入口**
|
|
26
64
|
* - logo 瓦片是 8% 强调色混入表面色,**绝不是饱和强调色块**
|
|
27
|
-
* - Compact
|
|
65
|
+
* - Compact 档必须保留 logo、名称与全部五个动作入口
|
|
28
66
|
*/
|
|
29
67
|
export interface ApplicationPrimaryNavigationProps extends HTMLAttributes<HTMLDivElement> {
|
|
30
|
-
/** 应用名称,
|
|
68
|
+
/** 应用名称,14/20 regular。mock 文案登记为「示例应用」 */
|
|
31
69
|
appName?: string
|
|
32
70
|
|
|
33
|
-
/** 应用说明,12/16 400。mock 文案登记为「应用说明信息」 */
|
|
34
|
-
appDescription?: string
|
|
35
|
-
|
|
36
71
|
/**
|
|
37
|
-
* 应用 logo mock 字形的图标名(
|
|
72
|
+
* 应用 logo mock 字形的图标名(20px),默认 `'shield-check'`。
|
|
38
73
|
* 与 `<Icon name>` 同为已登记字形名(05 · P1-6),清单外的名字在类型层被拒
|
|
39
74
|
*/
|
|
40
75
|
appGlyph?: IconName
|
|
@@ -45,20 +80,35 @@ export interface ApplicationPrimaryNavigationProps extends HTMLAttributes<HTMLDi
|
|
|
45
80
|
/** 各动作的未读圆点 */
|
|
46
81
|
actionBadges?: Partial<Record<GlobalActionKey, boolean>>
|
|
47
82
|
|
|
48
|
-
/**
|
|
49
|
-
|
|
83
|
+
/**
|
|
84
|
+
* 动作点击回调。`kind` 指明该动作的承载:`'popover'` 打开共享的 `ApplicationGlobalActionPanel`,
|
|
85
|
+
* `'module'`(只有设置)把 `ApplicationSecondaryNavigation` 换成设置模块
|
|
86
|
+
*/
|
|
87
|
+
onAction?: (key: GlobalActionKey, kind: GlobalActionKind) => void
|
|
50
88
|
|
|
51
89
|
/**
|
|
52
|
-
*
|
|
53
|
-
*
|
|
54
|
-
* @deprecated 下一个 minor 删除。Compact 档已由 `@media` 随视口自动生效(07 · C-18),
|
|
55
|
-
* 不再需要宿主判定断点后传入。在删除之前,传 `true` 仍强制紧凑;传 `false` 或不传
|
|
56
|
-
* 等价,均交给 `@media` 决定
|
|
90
|
+
* 基础版外壳的账户入口。传入即在动作组之后渲染头像;集团版外壳(渲染了
|
|
91
|
+
* `TopNavigationPrimaryBar`)不得传,否则一个外壳里会有两个账户入口
|
|
57
92
|
*/
|
|
58
|
-
|
|
93
|
+
account?: ApplicationPrimaryNavigationAccount
|
|
59
94
|
}
|
|
60
95
|
|
|
61
96
|
/*
|
|
62
|
-
*
|
|
63
|
-
*
|
|
97
|
+
* 五个动作及其顺序被写死在实现中,是对规范的正确固化 —— 调用方无法增删或重排,
|
|
98
|
+
* 这正是「已登记」的含义。
|
|
99
|
+
*
|
|
100
|
+
* ─── 业财平台 round-01 · Shell 裁决(2026-11-10,以 GAP Design kit 为准)───────
|
|
101
|
+
*
|
|
102
|
+
* 本带由 64px「logo 48 + 名称 16/24 700 + 说明 12/16 + 五个 32×32 纯图标动作」改为 kit 的
|
|
103
|
+
* 48px「logo 32 + 名称 14/20 regular + 五个图标 + 文字动作」。随之删除:
|
|
104
|
+
* · appDescription —— kit 没有说明行
|
|
105
|
+
* · compact —— 07 · C-18 起已弃用;本带不再有随 Compact 档隐藏的内容,强制档无物可强制
|
|
106
|
+
* 「运行总览」按 kit 改称「总览」。动作文字常显,内置 Tooltip 一并去掉 —— 提示条只会
|
|
107
|
+
* 重复一遍已经写在按钮上的字。
|
|
108
|
+
*
|
|
109
|
+
* ─── 设置改为模块(2026-11-10,用户按 kit「结构=设置」裁定)──────────────────
|
|
110
|
+
*
|
|
111
|
+
* `onAction` 的 `kind` 由 `'popover' | 'drawer'` 改为 `'popover' | 'module'`:设置不再打开
|
|
112
|
+
* Drawer / Sheet,而是由调用方把二级导航换成设置模块并传 `onCloseSettings`。
|
|
113
|
+
* `activeAction === 'settings'` 时设置动作带激活态,表示设置模块正开着。
|
|
64
114
|
*/
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { HTMLAttributes, ReactNode } from 'react'
|
|
1
|
+
import type { HTMLAttributes, MouseEvent, ReactNode } from 'react'
|
|
2
2
|
|
|
3
3
|
/** 二级导航的业务标签 */
|
|
4
4
|
export interface SecondaryNavTab {
|
|
@@ -21,17 +21,34 @@ export interface SecondaryNavTab {
|
|
|
21
21
|
}
|
|
22
22
|
|
|
23
23
|
/**
|
|
24
|
-
* `APPLICATION.SECONDARY_NAV` ——
|
|
25
|
-
* Standard 48px / Compact 40px。
|
|
24
|
+
* `APPLICATION.SECONDARY_NAV` —— GAP Design kit「应用二级导航」,外壳的最后一带
|
|
25
|
+
* (基础版第二带、集团版第三带)。Standard 48px / Compact 40px,右侧内边距 12。
|
|
26
26
|
*
|
|
27
|
-
*
|
|
27
|
+
* **左侧**:完整的模块切换器,贴左缘。**中间**:当前模块的业务标签,间隔 8。
|
|
28
|
+
* **最右**:一枚已登记的 32×32 纯图标按钮 —— 平时是「导航设置」,设置模块打开时是「关闭设置」。
|
|
29
|
+
*
|
|
30
|
+
* ### 尾部按钮(kit「二级导航设置」24:134 与「结构=设置」230:1104)
|
|
31
|
+
* 32×32、圆角 12、透明底,悬停是 6% 文字色淡底。两种形态互斥,同一时刻至多一枚:
|
|
32
|
+
*
|
|
33
|
+
* | 形态 | 何时渲染 | 字形 | 可访问名 |
|
|
34
|
+
* |---|---|---|---|
|
|
35
|
+
* | 导航设置 | 传了 `onNavigationSettings`,且未传 `onCloseSettings` | 16px `sliders-horizontal`,文字2 | 「导航设置」 |
|
|
36
|
+
* | 关闭设置 | 传了 `onCloseSettings` | 16px 叉号,文字1 | 「关闭设置」 |
|
|
37
|
+
*
|
|
38
|
+
* 两个回调都不传时不渲染,也不占位。
|
|
39
|
+
*
|
|
40
|
+
* ### 设置模块
|
|
41
|
+
* 全局动作「设置」不弹抽屉:它让本带整体换成设置模块 —— `moduleSwitcher` 显示设置模块名,
|
|
42
|
+
* `tabs` 换成设置项,同时传 `onCloseSettings`,尾部按钮随之变为关闭叉号,根元素输出
|
|
43
|
+
* `data-mode="settings"`。关闭时由调用方把模块切换器、标签与 `value` 换回进入设置前的那一组。
|
|
28
44
|
*
|
|
29
45
|
* ### ⚠ 每个标签都是「图标 + 文字」
|
|
30
46
|
* 图标在左、可见文字在右。**纯文字标签被禁止**,
|
|
31
47
|
* **为适应窄屏而丢弃全部图标同样被禁止** —— 标签保持单行并横向滚动,绝不换行。
|
|
32
48
|
*
|
|
33
|
-
* 标签几何:32px 高,内边距 6/12,文字 14/20。
|
|
34
|
-
* 激活态是已登记的 **2px
|
|
49
|
+
* 标签几何:32px 高,内边距 6/12,文字 14/20 文字2。
|
|
50
|
+
* 激活态是已登记的 **2px 下划线**(两端各缩进 12,贴标签底边)加强调色 medium 文字,
|
|
51
|
+
* 绝不是 pill 背景;悬停是 6% 文字色淡底、圆角 12,文字不变色。
|
|
35
52
|
* 图标容器宽度固定,使字重变化不会横向推移文字。
|
|
36
53
|
*
|
|
37
54
|
* ### ⚠ 本带不得承载
|
|
@@ -51,6 +68,29 @@ export interface ApplicationSecondaryNavigationProps extends HTMLAttributes<HTML
|
|
|
51
68
|
|
|
52
69
|
/** 标签变化回调 */
|
|
53
70
|
onValueChange?: (value: string) => void
|
|
71
|
+
|
|
72
|
+
/**
|
|
73
|
+
* 「导航设置」按钮的点击回调(kit「二级导航设置」)。传入即在本带最右端渲染该按钮;
|
|
74
|
+
* 不传即不渲染、不占位。参数是点击事件,`event.currentTarget` 即按钮元素,可传给
|
|
75
|
+
* `Popover` 的 `anchor` 锚定面板,也是面板关闭后焦点的归还目标。
|
|
76
|
+
*
|
|
77
|
+
* 设置模块打开时(传了 `onCloseSettings`)本按钮不渲染 —— 那个位置换成关闭叉号
|
|
78
|
+
*/
|
|
79
|
+
onNavigationSettings?: (event: MouseEvent<HTMLButtonElement>) => void
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* 导航设置面板是否展开。传入(含 `false`)即在按钮上输出 `aria-haspopup="dialog"` 与
|
|
83
|
+
* `aria-expanded`;缺省时两者都不输出。应与 `onNavigationSettings` 成对提供,
|
|
84
|
+
* 面板内容根相应声明 `role="dialog"` 与可访问名
|
|
85
|
+
*/
|
|
86
|
+
navigationSettingsOpen?: boolean
|
|
87
|
+
|
|
88
|
+
/**
|
|
89
|
+
* 设置模块的关闭回调(kit「框架结构 / 结构=设置」)。传入即声明本带当前承载的是设置模块:
|
|
90
|
+
* 最右端渲染关闭叉号(可访问名「关闭设置」)取代「导航设置」按钮,根元素输出
|
|
91
|
+
* `data-mode="settings"`。回调里由调用方换回进入设置前的模块切换器、`tabs` 与 `value`
|
|
92
|
+
*/
|
|
93
|
+
onCloseSettings?: (event: MouseEvent<HTMLButtonElement>) => void
|
|
54
94
|
}
|
|
55
95
|
|
|
56
96
|
/*
|
|
@@ -65,4 +105,15 @@ export interface ApplicationSecondaryNavigationProps extends HTMLAttributes<HTML
|
|
|
65
105
|
*
|
|
66
106
|
* 本组件使用 --ui-shell-* token 是正确的(它就是 Shell 第三带本身),
|
|
67
107
|
* 与 N3(Foundation Tabs 借用同一批 token)性质不同。
|
|
108
|
+
*
|
|
109
|
+
* ─── round-01 之后的 kit 差异补齐(2026-11-10)──────────────────────────────
|
|
110
|
+
*
|
|
111
|
+
* 尾部按钮是**已登记的两个回调**,不是任意 ReactNode 槽位:kit 在这个位置只画了两种东西
|
|
112
|
+
* (导航设置、关闭设置),开一个任意槽位等于允许业务页面往 Shell 里塞未登记元素 ——
|
|
113
|
+
* 与「本带不得承载」那一节冲突。
|
|
114
|
+
*
|
|
115
|
+
* 设置由「打开 Drawer」改为「本带换成设置模块」是用户按 kit 裁定的(推翻了 PrimaryNavigation
|
|
116
|
+
* 与 Drawer / Sheet / GlobalActionPanel 四处的已登记行为)。模式不另设 prop:给了关闭回调
|
|
117
|
+
* 就是设置模块 —— 一个没有关闭入口的设置模块与一个不在设置模块里的关闭叉号都不该存在,
|
|
118
|
+
* 用同一个 prop 表达两者,两种错配在类型上都写不出来。
|
|
68
119
|
*/
|