@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/README.md
CHANGED
|
@@ -191,7 +191,7 @@ SKILL.md 头部写死了版本号与校验指令,agent 读到版本不一致
|
|
|
191
191
|
| `pnpm generate` | 生成 `generated/` 全部产物 |
|
|
192
192
|
| `pnpm check:generate` | 只校验不落盘,供 CI 用 |
|
|
193
193
|
| `pnpm extract` | 只跑契约提取,供排查用 |
|
|
194
|
-
| `pnpm test` | 四份测试共
|
|
194
|
+
| `pnpm test` | 四份测试共 180 条:生成器负向 25 条 + lint 行为 135 条 + 命令行为 20 条 |
|
|
195
195
|
|
|
196
196
|
### 生成器必须能失败
|
|
197
197
|
|
package/bin/cli.js
CHANGED
|
File without changes
|
package/bin/lib/upgrade.mjs
CHANGED
|
@@ -6,8 +6,8 @@
|
|
|
6
6
|
* --from <旧版 contracts.json> 必填,升级前从 node_modules 拷出来的那份
|
|
7
7
|
* --to <新版 contracts.json> 可选,默认本包 generated/contracts.json
|
|
8
8
|
*
|
|
9
|
-
*
|
|
10
|
-
*
|
|
9
|
+
* 比四层:组件增删、prop 增删与必填翻转、枚举值增删、类型与弃用标记的变化。
|
|
10
|
+
* 契约是唯一事实来源(§6.2),差异从它算,不从 CHANGELOG 抄。
|
|
11
11
|
*/
|
|
12
12
|
|
|
13
13
|
import { existsSync, readFileSync, writeFileSync } from 'node:fs'
|
|
@@ -51,6 +51,9 @@ export async function run(argv) {
|
|
|
51
51
|
const requiredFlips = []
|
|
52
52
|
const removedValues = []
|
|
53
53
|
const addedValues = []
|
|
54
|
+
const narrowed = []
|
|
55
|
+
const retyped = []
|
|
56
|
+
const deprecated = []
|
|
54
57
|
|
|
55
58
|
for (const [name, next] of after) {
|
|
56
59
|
const prev = before.get(name)
|
|
@@ -69,16 +72,34 @@ export async function run(argv) {
|
|
|
69
72
|
const pp = prevProps.get(pname)
|
|
70
73
|
if (!pp) continue
|
|
71
74
|
if (!pp.required && np.required) requiredFlips.push(`\`${name}.${pname}\` 变为必填`)
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
75
|
+
/* 旧版契约里没有 deprecated 字段(提取器后来才加),缺省按未弃用算 */
|
|
76
|
+
if (pp.deprecated == null && np.deprecated != null) {
|
|
77
|
+
deprecated.push(`\`${name}.${pname}\`${np.deprecated ? `:${np.deprecated.replace(/\s*\n\s*/g, '')}` : ''}`)
|
|
78
|
+
}
|
|
79
|
+
const label = `\`${name}.${pname}\`:\`${pp.type}\` → \`${np.type}\``
|
|
80
|
+
if (pp.values && np.values) {
|
|
81
|
+
const pv = new Set(pp.values)
|
|
82
|
+
const nv = new Set(np.values)
|
|
83
|
+
for (const v of pv) if (!nv.has(v)) removedValues.push(`\`${name}.${pname}\` 不再接受 \`${v}\``)
|
|
84
|
+
for (const v of nv) if (!pv.has(v)) addedValues.push(`\`${name}.${pname}\` 新增 \`${v}\``)
|
|
85
|
+
} else if (np.values) {
|
|
86
|
+
/* 自由类型收窄成固定取值(`string` → `IconName`)是破坏性的:旧代码里任意写的
|
|
87
|
+
* 值此后在 tsc 与 prop-enum 两处被拒。逐值列成「新增的枚举值」会把它排进最后一节,
|
|
88
|
+
* 读起来像可选增强 —— 与「新增且必填」混进「新增的 prop」是同一个错。
|
|
89
|
+
* 类型名不变而旧版没解出取值的(旧提取器解不开 import 进来的别名),不是契约变化,不报 */
|
|
90
|
+
if (pp.type !== np.type) narrowed.push(`${label},只收 ${np.values.length} 个取值,取值表见 reference.md`)
|
|
91
|
+
} else if (pp.type !== np.type) {
|
|
92
|
+
retyped.push(label)
|
|
93
|
+
}
|
|
76
94
|
}
|
|
77
95
|
}
|
|
78
96
|
|
|
79
97
|
section('删除的 prop(props-whitelist 会报)', removedProps)
|
|
80
98
|
section('变为必填的 prop(引用处必须补)', requiredFlips)
|
|
81
99
|
section('删除的枚举值(prop-enum 会报)', removedValues)
|
|
100
|
+
section('收窄为固定取值的 prop(tsc 与 prop-enum 会报,引用处必须核对)', narrowed)
|
|
101
|
+
section('类型变化的 prop(引用处须核对)', retyped)
|
|
102
|
+
section('标为弃用的 prop(下一次升级前迁走)', deprecated)
|
|
82
103
|
section('新增的 prop', addedProps)
|
|
83
104
|
section('新增的枚举值', addedValues)
|
|
84
105
|
|
package/generated/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: moheng-ui
|
|
3
|
-
description: 用 @moheng-design/ui 写 React 界面时加载。含
|
|
3
|
+
description: 用 @moheng-design/ui 写 React 界面时加载。含 94 个组件的清单与常用 props、原生元素到组件的替换映射表、Application Module 层强绑定的五层 Canvas 模型使用前提,以及样式覆盖、换肤与暗色的正确做法。凡涉及按钮、输入、选择、表格、浮层、导航、页面骨架等任何界面代码,均适用。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
<!-- 生成文件 —— 请勿手改。源:@moheng-design/ui 的 contracts/ 与 mappings.json,生成器:scripts/generate.mjs -->
|
|
@@ -46,20 +46,20 @@ import '@moheng-design/ui/styles.css'
|
|
|
46
46
|
|
|
47
47
|
### 可用的 token
|
|
48
48
|
|
|
49
|
-
组件的全部颜色、尺度与层级由 CSS 自定义属性表达,共
|
|
49
|
+
组件的全部颜色、尺度与层级由 CSS 自定义属性表达,共 389 条。
|
|
50
50
|
覆盖样式、与组件对齐尺度时读它们,**不得写字面色值、尺寸、圆角、间距**。
|
|
51
51
|
|
|
52
|
-
消费方可用的是 `--application-*`(
|
|
53
|
-
`--ds-*`(
|
|
52
|
+
消费方可用的是 `--application-*`(101 条)与 `--ui-*`(145 条),共 246 条。
|
|
53
|
+
`--ds-*`(143 条)是 Foundation 内部实现,不构成公开接口,
|
|
54
54
|
任意小版本都可能改动。例外是上一节的换肤入口 `--ds-color-theme-primary`,
|
|
55
55
|
与只读的焦点环几何 `--ds-focus-ring-width` / `--ds-focus-ring-offset`。
|
|
56
56
|
|
|
57
57
|
命名形如 `--<层>-<分组>-<项>`。消费方可用的分组与条数:
|
|
58
58
|
|
|
59
|
-
- **`--application-*`**(
|
|
60
|
-
- **`--ui-*`**(
|
|
59
|
+
- **`--application-*`**(101 条)—— `categorical` 20、`radius` 10、`space` 6、`font-size` 5、`line-height` 5、`button` 4、`font-weight` 4、`form-dialog` 3;另有 44 条不带分组段,形如 `--application-canvas`
|
|
60
|
+
- **`--ui-*`**(145 条)—— `shell` 117、`viewport` 7、`z` 4、`card` 3、`duration` 2、`shadow` 2、`application` 1、`border` 1、`control` 1、`divider` 1、`ease` 1、`overlay` 1、`page` 1、`section` 1、`sidebar` 1、`surface` 1
|
|
61
61
|
|
|
62
|
-
|
|
62
|
+
389 条 token 的完整名值表见
|
|
63
63
|
`node_modules/@moheng-design/ui-skill/generated/reference.md` 的「Token 全表」一节 ——
|
|
64
64
|
该文件随包分发,不会过期。两层各自的取用规则见下文「组合约定」。
|
|
65
65
|
|
|
@@ -104,7 +104,7 @@ import '@moheng-design/ui/styles.css'
|
|
|
104
104
|
|
|
105
105
|
## 组件清单
|
|
106
106
|
|
|
107
|
-
|
|
107
|
+
94 个组件全部在 `@moheng-design/ui` 单包内:Foundation 60 个、Application Atomic 8 个、Application Module 26 个。
|
|
108
108
|
|
|
109
109
|
表中 `*` 标记必填 prop,括号内是枚举的全部取值。完整签名见 reference.md。
|
|
110
110
|
|
|
@@ -112,24 +112,25 @@ import '@moheng-design/ui/styles.css'
|
|
|
112
112
|
|
|
113
113
|
| 组件 | 用途 | 常用 props |
|
|
114
114
|
|---|---|---|
|
|
115
|
-
| `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)、`size`(14 / 16 / 18 / 20 / 24) |
|
|
115
|
+
| `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)、`size`(14 / 16 / 18 / 20 / 24) |
|
|
116
116
|
|
|
117
117
|
### Foundation · actions(4)
|
|
118
118
|
|
|
119
119
|
| 组件 | 用途 | 常用 props |
|
|
120
120
|
|---|---|---|
|
|
121
|
-
| `Button` | Foundation 按钮 —— 按钮排版、几何、圆角与基础交互的唯一 Foundation Owner。 | `children`*、`variant`(primary / secondary / outline / ghost / destructive / link)、`size`(xs / sm / default / lg) |
|
|
121
|
+
| `Button` | Foundation 按钮 —— 按钮排版、几何、圆角与基础交互的唯一 Foundation Owner。 | `children`*、`variant`(primary / secondary / outline / ghost / destructive / destructive-outline / link)、`size`(xs / sm / default / lg) |
|
|
122
122
|
| `ButtonGroup` | 把一组相关 Button 合并为一个分段控件或间隔簇。 | `orientation`(horizontal / vertical) |
|
|
123
123
|
| `Toggle` | 单个两态可按下控件 —— 用于一个独立的格式或显示开关。 | `size`(sm / default / lg) |
|
|
124
124
|
| `ToggleGroup` | 一组分段式开关,用于**一个局部显示选择** —— 密度、对齐方式、局部视图标记。 | `items`*、`type`(single / multiple)、`size`(sm / default / lg) |
|
|
125
125
|
|
|
126
|
-
### Foundation · input-selection(
|
|
126
|
+
### Foundation · input-selection(15)
|
|
127
127
|
|
|
128
128
|
| 组件 | 用途 | 常用 props |
|
|
129
129
|
|---|---|---|
|
|
130
130
|
| `Calendar` | 月格日期选择器,**周一为一周起始**(一…日)。 | — |
|
|
131
131
|
| `Checkbox` | 独立的布尔选择,16px 方形,4px 圆角,选中时填充强调色。 | — |
|
|
132
132
|
| `Combobox` | 输入即筛选的单选控件 —— 选项多到不便逐条扫视,但又不构成一次数据查询时使用。 | `options`* |
|
|
133
|
+
| `DateInput` | 单个日期的录入控件:与 `Input` 同高同壳(32px、12px 圆角、1px 描边),右侧带 16px 日历图标,点击弹出 `Calendar` 月格,选中即回填并收起。 | — |
|
|
133
134
|
| `Field` | 表单行:标签 + 控件 + 一行说明**或**错误。 | — |
|
|
134
135
|
| `Input` | 单行文本控件。 | — |
|
|
135
136
|
| `InputGroup` | 单一焦点壳,包裹前置/后置附加物与一个控件 —— 图标、单位、提交按钮。 | — |
|
|
@@ -152,7 +153,7 @@ import '@moheng-design/ui/styles.css'
|
|
|
152
153
|
| `ContextMenu` | 内容区域上的右键菜单 —— 行、卡片、看板块。 | `items`* |
|
|
153
154
|
| `Menubar` | 桌面风格的水平菜单条,用于编辑器型工作面 —— 报表设计器、看板配置器。 | `menus`* |
|
|
154
155
|
| `NavigationMenu` | 水平导航,条目可展开富内容面板。 | `items`*、`current`(page / true) |
|
|
155
|
-
| `Pagination` |
|
|
156
|
+
| `Pagination` | 裸分页步进器:首页 · 上一页 · 页码窗口 · 下一页 · 末页。 | — |
|
|
156
157
|
| `Sidebar` | Content Canvas 内部的垂直导航面 —— 设置页目录。 | `groups`* |
|
|
157
158
|
| `Tabs` | 页面区域内的局部标签页 —— Business View 标签、SPLIT 右栏内容标签、详情分节。 | `items`* |
|
|
158
159
|
|
|
@@ -191,33 +192,34 @@ import '@moheng-design/ui/styles.css'
|
|
|
191
192
|
| `DropdownMenu` | 触发器 + 菜单面板,低频动作的收纳处 —— 上下文区或行尾的「**更多**」按钮。 | `items`*、`align`(start / end) |
|
|
192
193
|
| `HoverCard` | 悬停时展示的富预览 —— 人员、机构、关联记录。 | — |
|
|
193
194
|
| `Popover` | 锚定式浮层面板 —— 筛选器、呈现设置、日期选择器。 | `align`(start / end) |
|
|
194
|
-
| `Sheet` | 从任意边缘滑出的面板,用于**辅助性内容** ——
|
|
195
|
+
| `Sheet` | 从任意边缘滑出的面板,用于**辅助性内容** —— 帮助面板、附件预览。 | `side`(right / left / top / bottom) |
|
|
195
196
|
| `Sonner` | 转瞬即逝的提示堆栈 —— **确认某件事已经发生**(已保存、已导出、3 条已办结)。 | `toasts`*、`position`(bottom-right / bottom-left / top-right / top-left) |
|
|
196
197
|
| `SonnerProvider` | `Sonner` 的调用入口 —— 挂在应用根,子树里任何位置用 `useToast()` 弹出提示。 | `position`(bottom-right / bottom-left / top-right / top-left) |
|
|
197
198
|
| `Spinner` | 不确定时长的**原地**等待 —— 刷新中的按钮、提交中的对话框。 | — |
|
|
198
199
|
| `Tooltip` | 悬停或聚焦时出现的短标签,用于**为纯图标控件命名** —— 五个全局动作触发器、工具栏图标按钮。 | `side`(top / bottom / left / right) |
|
|
199
200
|
|
|
200
|
-
### Application Atomic(
|
|
201
|
+
### Application Atomic(8)
|
|
201
202
|
|
|
202
203
|
| 组件 | 用途 | 常用 props |
|
|
203
204
|
|---|---|---|
|
|
205
|
+
| `ApplicationDateRangeFilter` | 查询工具栏主控制行中的**日期区间**快捷筛选,与 `ApplicationFilterMenu` 同为一个 常驻维度,放进 `ApplicationQueryToolbar` 的 `commonFilters`。 | `label`* |
|
|
204
206
|
| `ApplicationFilterMenu` | 查询工具栏主控制行中的常驻快捷筛选 —— **一个高频维度**。 | `options`* |
|
|
205
207
|
| `ListSelectionCheckbox` | 列表 / 表格 / 卡片网格 / 看板的记录选择框。 | `scope`(row / all) |
|
|
206
|
-
| `ListTablePagination` | 列表 / 表格分页 ——
|
|
208
|
+
| `ListTablePagination` | 列表 / 表格分页 —— 摘要、每页条数、页码窗口与跳页。 | — |
|
|
207
209
|
| `SearchField` | 共享的紧凑搜索入口 —— **产品内每一处纯文本搜索**: 查询工具栏、目录搜索、人员与文件选择器。 | `ariaLabel`* |
|
|
208
210
|
| `SidebarAppLinkButton` | 应用快捷入口 —— 从工作台侧栏或应用切换器跳转到另一个应用。 | — |
|
|
209
211
|
| `SidebarRailButton` | 工作台菜单栏条目 —— 56px 宽的列内,图标在上、标签在下。 | — |
|
|
210
|
-
| `SystemButton` | 应用语义按钮 —— **整个产品的默认动作按钮**。 | `intent`(primary / secondary / quiet / link / destructive)、`size`(default / compact / sm) |
|
|
212
|
+
| `SystemButton` | 应用语义按钮 —— **整个产品的默认动作按钮**。 | `intent`(primary / secondary / quiet / link / destructive / destructive-outline)、`size`(default / compact / sm) |
|
|
211
213
|
|
|
212
214
|
### Application Module · navigation(5)
|
|
213
215
|
|
|
214
216
|
| 组件 | 用途 | 常用 props |
|
|
215
217
|
|---|---|---|
|
|
216
218
|
| `ApplicationModuleSwitcher` | 应用二级导航的**左半部分** —— 你在哪个模块,以及如何切换。 | — |
|
|
217
|
-
| `ApplicationPrimaryNavigation` | `APPLICATION.PRIMARY_NAV` ——
|
|
218
|
-
| `ApplicationSecondaryNavigation` | `APPLICATION.SECONDARY_NAV` ——
|
|
219
|
+
| `ApplicationPrimaryNavigation` | `APPLICATION.PRIMARY_NAV` —— GAP Design kit「通用导航 / 应用一级导航」。 | `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)、`activeAction`(messages / todos / overview / risk / settings) |
|
|
220
|
+
| `ApplicationSecondaryNavigation` | `APPLICATION.SECONDARY_NAV` —— GAP Design kit「应用二级导航」,外壳的最后一带 (基础版第二带、集团版第三带)。 | — |
|
|
219
221
|
| `GlobalSidebar` | 工作台左侧 72px 菜单栏,由 `SidebarRailButton` 构成。 | — |
|
|
220
|
-
| `TopNavigationPrimaryBar` | `PLATFORM.TOP_USER_BAR` ——
|
|
222
|
+
| `TopNavigationPrimaryBar` | `PLATFORM.TOP_USER_BAR` —— GAP Design kit「集团顶部导航」,**只在集团版外壳出现** (本带 + 应用一级 + 应用二级,共 144)。 | — |
|
|
221
223
|
|
|
222
224
|
### Application Module · statistics(5)
|
|
223
225
|
|
|
@@ -253,8 +255,8 @@ import '@moheng-design/ui/styles.css'
|
|
|
253
255
|
| 组件 | 用途 | 常用 props |
|
|
254
256
|
|---|---|---|
|
|
255
257
|
| `ApplicationDetailDrawer` | DETAIL 的**抽屉载体** —— 打开一条记录的详情而不丢失身后的列表。 | `side`(left / right) |
|
|
256
|
-
| `ApplicationFormDialog` | 业务对象的新建与编辑表单对话框。 | `size`(small / large) |
|
|
257
|
-
| `ApplicationGlobalActionPanel` | 四个 popover 型全局动作**共享的同一个面板** —— 消息 / 待办 /
|
|
258
|
+
| `ApplicationFormDialog` | 业务对象的新建与编辑表单对话框。 | `size`(small / large / xlarge) |
|
|
259
|
+
| `ApplicationGlobalActionPanel` | 四个 popover 型全局动作**共享的同一个面板** —— 消息 / 待办 / 总览 / 风险预警。 | `state`(ready / loading / empty / error / no-permission) |
|
|
258
260
|
| `PeoplePickerDialog` | 人员 / 组织选择器 —— 指派人、审核人、通知接收人、共享对象。 | — |
|
|
259
261
|
|
|
260
262
|
### Application Module · collaboration(3)
|
|
@@ -282,25 +284,34 @@ Application
|
|
|
282
284
|
└─ Overlay Dialog / Drawer / Popover / Menu / Toast
|
|
283
285
|
```
|
|
284
286
|
|
|
285
|
-
### Shell
|
|
287
|
+
### Shell 导航带
|
|
286
288
|
|
|
287
|
-
|
|
289
|
+
固定骨架,**没有左侧全局栏**。导航带永不滚动。几何以 GAP Design kit「框架结构」为准,外壳有两种形态:
|
|
290
|
+
|
|
291
|
+
| 形态 | 带(自上而下) | Standard 总高 | Compact 总高 |
|
|
292
|
+
|---|---|---:|---:|
|
|
293
|
+
| 基础版 | 应用一级 + 应用二级 | 96px | 80px |
|
|
294
|
+
| 集团版 | 集团顶部 + 应用一级 + 应用二级 | 144px | 120px |
|
|
288
295
|
|
|
289
296
|
| 带 | 组件 | Standard | Compact |
|
|
290
297
|
|---|---|---:|---:|
|
|
291
|
-
|
|
|
292
|
-
| 应用一级导航 `APPLICATION.PRIMARY_NAV` | `ApplicationPrimaryNavigation` |
|
|
298
|
+
| 集团顶部导航 `PLATFORM.TOP_USER_BAR`(仅集团版) | `TopNavigationPrimaryBar` | 48px | 40px |
|
|
299
|
+
| 应用一级导航 `APPLICATION.PRIMARY_NAV` | `ApplicationPrimaryNavigation` | 48px | 40px |
|
|
293
300
|
| 应用二级导航 `APPLICATION.SECONDARY_NAV` | `ApplicationSecondaryNavigation` | 48px | 40px |
|
|
294
301
|
| Content Canvas | `ApplicationPageLayoutContainer` | 剩余视口 | 剩余视口 |
|
|
295
302
|
|
|
303
|
+
账户头像在基础版里是 `ApplicationPrimaryNavigation` 的 `account`,在集团版里在 `TopNavigationPrimaryBar`,
|
|
304
|
+
一个外壳只有一处。外壳总高读 `--ui-shell-application-total-height`:渲染了 `TopNavigationPrimaryBar` 时它自动计入
|
|
305
|
+
集团顶栏,宿主不必区分两种形态。
|
|
306
|
+
|
|
296
307
|
Compact 档在视口宽 ≤1180px 或高 ≤720px 时生效(`--ui-viewport-compact-max-width` / `-height`),
|
|
297
|
-
|
|
308
|
+
各带高度由同一组 `@media` 一并切换,宿主不得自行复刻断点。
|
|
298
309
|
|
|
299
310
|
宿主 padding 为零 —— padding 属于页面内容根。
|
|
300
311
|
|
|
301
312
|
### 宿主布局
|
|
302
313
|
|
|
303
|
-
本库不提供宿主组件(07 · C-5
|
|
314
|
+
本库不提供宿主组件(07 · C-5:组件留到第二个真实项目再抽),导航带 + Canvas 的宿主由应用
|
|
304
315
|
自己写,标准写法如下(类名由宿主自定,只读 `--application-*` 与 `--ui-*`):
|
|
305
316
|
|
|
306
317
|
```css
|
|
@@ -310,14 +321,14 @@ body {
|
|
|
310
321
|
margin: 0;
|
|
311
322
|
}
|
|
312
323
|
|
|
313
|
-
.app-shell { /*
|
|
324
|
+
.app-shell { /* 导航带 + Canvas,整体占满视口 */
|
|
314
325
|
display: flex;
|
|
315
326
|
flex-direction: column;
|
|
316
327
|
block-size: 100dvh;
|
|
317
328
|
background: var(--application-canvas);
|
|
318
329
|
}
|
|
319
330
|
|
|
320
|
-
.app-shell__bands { /*
|
|
331
|
+
.app-shell__bands { /* 包住全部导航带;不进滚动容器,即永不滚动 */
|
|
321
332
|
flex: none;
|
|
322
333
|
z-index: var(--ui-z-shell);
|
|
323
334
|
}
|
|
@@ -513,7 +524,7 @@ DETAIL ApplicationPageLayoutContainer pageType="DETAIL"
|
|
|
513
524
|
### 关键尺寸
|
|
514
525
|
|
|
515
526
|
抽屉宽 680px(`--application-drawer-width: 1280px` 是宽/全屏变体);
|
|
516
|
-
表单对话框 720px / 960px;`SPLIT` 左栏 360px(Compact 300px);
|
|
527
|
+
表单对话框 720px / 960px / 1280px;`SPLIT` 左栏 360px(Compact 300px);
|
|
517
528
|
卡片网格默认 ≥1440 五列、Condensed 四列、Compact 三列,卡片最小宽 220px。
|
|
518
529
|
列数读 `--ui-card-columns-default`,三档由 `viewport.css` 的 `@media` 在 `:root` 上改写(5 / 4 / 3),
|
|
519
530
|
最小宽读 `--ui-card-min-width`,卡间距读 `--ui-card-gap`;系统内没有卡片网格组件,
|
|
@@ -618,7 +629,7 @@ UI 文案不用第二人称,也不写「请」:写 `无权查看本模块`
|
|
|
618
629
|
确认说明写后果(`删除后 3 条记录不可恢复`),不写请求;占位文字写示例或范围
|
|
619
630
|
(`例如:季度巡检记录`),不写指令;无权限的出路点明找谁(`联系本模块管理员开通`)。
|
|
620
631
|
|
|
621
|
-
> 逐组件的组合约定(
|
|
632
|
+
> 逐组件的组合约定(94 个章节:何时使用、何时改用其他组件、禁止与使用边界)
|
|
622
633
|
> 见 `node_modules/@moheng-design/ui-skill/generated/reference.md`。
|
|
623
634
|
|
|
624
635
|
## 反例
|
|
@@ -783,15 +794,17 @@ import '@moheng-design/ui/styles.css'
|
|
|
783
794
|
### 通用的「视图设置」按钮
|
|
784
795
|
|
|
785
796
|
```jsx
|
|
786
|
-
// 不要这样写
|
|
797
|
+
// 不要这样写 —— 自己拼一个设置按钮,名字还是通用的
|
|
787
798
|
<SystemButton>视图设置</SystemButton>
|
|
799
|
+
<SystemButton>自定义</SystemButton>
|
|
788
800
|
|
|
789
|
-
// 要这样写 ——
|
|
790
|
-
<
|
|
791
|
-
<
|
|
801
|
+
// 要这样写 —— 交给工具栏,它按当前呈现方式命名
|
|
802
|
+
<ApplicationQueryToolbar presentation="DataTable" onPresentationSettings={openColumns} /> {/* 列设置 */}
|
|
803
|
+
<ApplicationQueryToolbar presentation="KanbanBoard" onPresentationSettings={openBoard} /> {/* 看板设置 */}
|
|
792
804
|
```
|
|
793
805
|
|
|
794
|
-
|
|
806
|
+
呈现设置是一个*概念*,不是一个按钮名。工具栏的设置按钮按 GAP Design kit 是 32×32 纯图标,
|
|
807
|
+
名字落在可访问名与悬停提示上,必须按当前呈现方式命名:
|
|
795
808
|
`列设置` / `列表设置` / `卡片设置` / `看板设置` / `日历设置` / `图表设置` / `时间轴设置`。
|
|
796
809
|
|
|
797
810
|
### 六种数据状态共用一句话
|