@moheng-design/ui-skill 1.0.0 → 2.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 +11 -4
- package/bin/cli.js +0 -0
- package/bin/lib/audit.mjs +21 -5
- package/bin/lib/feedback.mjs +20 -3
- package/bin/lib/install.mjs +6 -2
- package/bin/lib/upgrade.mjs +8 -2
- package/generated/SKILL.md +258 -63
- package/generated/contracts.json +650 -119
- package/generated/plugin-data.js +403 -32
- package/generated/reference.md +788 -314
- package/generated/rules.json +436 -33
- package/generated/skills/moheng-ui-audit/SKILL.md +16 -5
- package/generated/skills/moheng-ui-bootstrap/SKILL.md +10 -6
- package/generated/skills/moheng-ui-feedback/SKILL.md +8 -3
- package/generated/skills/moheng-ui-page/SKILL.md +31 -10
- package/generated/skills/moheng-ui-review/SKILL.md +8 -5
- package/generated/skills/moheng-ui-upgrade/SKILL.md +1 -1
- package/generated/unenforced.json +20 -5
- package/handwritten/anti-patterns.md +40 -22
- package/handwritten/canvas-model.md +175 -10
- package/handwritten/conventions.md +198 -136
- package/handwritten/skills/audit.md +9 -1
- package/handwritten/skills/bootstrap.md +8 -4
- package/handwritten/skills/feedback.md +6 -1
- package/handwritten/skills/page.md +30 -9
- package/handwritten/unenforced.md +6 -3
- package/package.json +11 -11
package/generated/contracts.json
CHANGED
|
@@ -20,10 +20,44 @@
|
|
|
20
20
|
"props": [
|
|
21
21
|
{
|
|
22
22
|
"name": "name",
|
|
23
|
-
"type": "
|
|
23
|
+
"type": "IconName",
|
|
24
24
|
"required": true,
|
|
25
|
-
"doc": "
|
|
26
|
-
"values":
|
|
25
|
+
"doc": "图标名,只收已登记字形的 kebab-case 名(`chevron-down`)。\n\n类型是生成的 `IconName` 字面量联合(05 · P1-6):此前是 `string`,未登记名\n过 tsc、过 strict lint,运行时渲染成空方盒。现在清单外的名字在 tsc 与\n`prop-enum` 两处被拒。数据里存图标名时把字段类型写成 `IconName`,\n不要写 `string` 再断言。\n\n类型层不再收 Pascal 写法(`ChevronDown`):两种写法并收会让取值表翻倍,\n且收窄当时库内、文档站示例与验证页里没有一处 Pascal 用法。运行时仍把\nPascal / 下划线写法归一成 kebab,未经类型检查的 JS 调用方不受影响。",
|
|
26
|
+
"values": [
|
|
27
|
+
"activity",
|
|
28
|
+
"arrow-down",
|
|
29
|
+
"arrow-up",
|
|
30
|
+
"calendar",
|
|
31
|
+
"check",
|
|
32
|
+
"chevron-down",
|
|
33
|
+
"chevron-left",
|
|
34
|
+
"chevron-right",
|
|
35
|
+
"chevron-up",
|
|
36
|
+
"circle-alert",
|
|
37
|
+
"circle-check",
|
|
38
|
+
"circle-check-big",
|
|
39
|
+
"columns-2",
|
|
40
|
+
"download",
|
|
41
|
+
"ellipsis",
|
|
42
|
+
"funnel",
|
|
43
|
+
"info",
|
|
44
|
+
"kanban",
|
|
45
|
+
"layout-grid",
|
|
46
|
+
"list",
|
|
47
|
+
"message-square",
|
|
48
|
+
"minus",
|
|
49
|
+
"pencil",
|
|
50
|
+
"plus",
|
|
51
|
+
"refresh-cw",
|
|
52
|
+
"search",
|
|
53
|
+
"settings",
|
|
54
|
+
"shield-check",
|
|
55
|
+
"sliders-horizontal",
|
|
56
|
+
"trash-2",
|
|
57
|
+
"triangle-alert",
|
|
58
|
+
"upload",
|
|
59
|
+
"x"
|
|
60
|
+
]
|
|
27
61
|
},
|
|
28
62
|
{
|
|
29
63
|
"name": "size",
|
|
@@ -69,10 +103,8 @@
|
|
|
69
103
|
"order": 1,
|
|
70
104
|
"contract": "contracts/foundation/actions/button.ts",
|
|
71
105
|
"summary": "Foundation 按钮 —— 按钮排版、几何、圆角与基础交互的唯一 Foundation Owner。",
|
|
72
|
-
"doc": "Foundation 按钮 —— 按钮排版、几何、圆角与基础交互的唯一 Foundation Owner。\n\n已登记契约:14/20 字号、12px 行内内边距、4px 图标间隙、16px 圆角、32px 默认高度。\n16px 圆角在 32px 高度下使等宽图标按钮自然成圆,系统内**没有**独立的 pill / circle token。\n\n
|
|
73
|
-
"replaces": [
|
|
74
|
-
"button"
|
|
75
|
-
],
|
|
106
|
+
"doc": "Foundation 按钮 —— 按钮排版、几何、圆角与基础交互的唯一 Foundation Owner。\n\n已登记契约:14/20 字号、12px 行内内边距、4px 图标间隙、16px 圆角、32px 默认高度。\n16px 圆角在 32px 高度下使等宽图标按钮自然成圆,系统内**没有**独立的 pill / circle token。\n\n**业务页面一律用 `SystemButton`**,本组件只供库内组件使用(实践报告 P1-1 裁决)。\n业务页面不得再造第二套基础按钮视觉。\n\n按下态只有颜色变化 —— 不得有缩放、位移或阴影变化。\n\n原生 `<button>` 的替换目标是 `SystemButton`,替换登记写在那份契约的 JSDoc 上。",
|
|
107
|
+
"replaces": [],
|
|
76
108
|
"nativeBase": "ButtonHTMLAttributes<HTMLButtonElement>",
|
|
77
109
|
"omitted": [
|
|
78
110
|
"size"
|
|
@@ -115,7 +147,7 @@
|
|
|
115
147
|
"name": "disabled",
|
|
116
148
|
"type": "boolean",
|
|
117
149
|
"required": false,
|
|
118
|
-
"doc": "禁用。禁用时不触发 onClick 并移出 tab 顺序。\n禁用作用于整个交互单元 ——
|
|
150
|
+
"doc": "禁用。禁用时不触发 onClick 并移出 tab 顺序。\n禁用作用于整个交互单元 —— 不得只禁用文字而保留图标可点。\n\n传 `aria-disabled=\"true\"` 得到同一套禁用外观但保持可聚焦(`SystemButton`\n的 loading 即此写法);本组件不拦截事件,阻断动作由设置它的一方负责。",
|
|
119
151
|
"values": null
|
|
120
152
|
},
|
|
121
153
|
{
|
|
@@ -174,7 +206,7 @@
|
|
|
174
206
|
"order": 1,
|
|
175
207
|
"contract": "contracts/foundation/actions/toggle.ts",
|
|
176
208
|
"summary": "单个两态可按下控件 —— 用于一个独立的格式或显示开关。",
|
|
177
|
-
"doc": "单个两态可按下控件 —— 用于一个独立的格式或显示开关。\n\n在多个选项中择一请用 `ToggleGroup`;页面模式切换一律不用本组件。\n\n选中态为淡强调色洗(`--application-selected`)+
|
|
209
|
+
"doc": "单个两态可按下控件 —— 用于一个独立的格式或显示开关。\n\n在多个选项中择一请用 `ToggleGroup`;页面模式切换一律不用本组件。\n\n选中态为淡强调色洗(`--application-selected`)+ 强调前景,另有 1px 前景色描边 ——\n描边是非颜色标识,纯文字内容下选中也不只靠颜色表达,调用方无须另补。\n\n通过 `aria-pressed` 上报状态。",
|
|
178
210
|
"replaces": [],
|
|
179
211
|
"nativeBase": "ButtonHTMLAttributes<HTMLButtonElement>",
|
|
180
212
|
"omitted": [
|
|
@@ -225,7 +257,7 @@
|
|
|
225
257
|
"name": "children",
|
|
226
258
|
"type": "ReactNode",
|
|
227
259
|
"required": false,
|
|
228
|
-
"doc": "开关内容。`iconOnly` 为 true 时放单个 `Icon
|
|
260
|
+
"doc": "开关内容。`iconOnly` 为 true 时放单个 `Icon`",
|
|
229
261
|
"values": null
|
|
230
262
|
}
|
|
231
263
|
],
|
|
@@ -353,7 +385,7 @@
|
|
|
353
385
|
"name": "month",
|
|
354
386
|
"type": "Date",
|
|
355
387
|
"required": false,
|
|
356
|
-
"doc": "
|
|
388
|
+
"doc": "显示的月份。仅取年月,日被忽略。\n\n年月变化时视图跟随;年月不变的重渲染不重置用户已翻到的月份。",
|
|
357
389
|
"values": null
|
|
358
390
|
},
|
|
359
391
|
{
|
|
@@ -369,6 +401,13 @@
|
|
|
369
401
|
"required": false,
|
|
370
402
|
"doc": "选中日期变化回调",
|
|
371
403
|
"values": null
|
|
404
|
+
},
|
|
405
|
+
{
|
|
406
|
+
"name": "today",
|
|
407
|
+
"type": "Date",
|
|
408
|
+
"required": false,
|
|
409
|
+
"doc": "「今天」。仅取年月日,按本地时区解读。默认取当前本地日期(06 · P2-20)。\n\n决定今日高亮(`aria-current=\"date\"`)、未传 `month` 时的初始月份、以及没有\n选中日时 Tab 停顿的回落位置。以服务端时间为准的业务、服务端渲染(避免跨零点\n的水合不一致)与测试(固定日期)传入它;其余场景不传。",
|
|
410
|
+
"values": null
|
|
372
411
|
}
|
|
373
412
|
],
|
|
374
413
|
"helpers": []
|
|
@@ -424,6 +463,13 @@
|
|
|
424
463
|
"required": false,
|
|
425
464
|
"doc": "可见标签,渲染在方框右侧,与方框同属一个 `<label>` 因而可点击",
|
|
426
465
|
"values": null
|
|
466
|
+
},
|
|
467
|
+
{
|
|
468
|
+
"name": "invalid",
|
|
469
|
+
"type": "boolean",
|
|
470
|
+
"required": false,
|
|
471
|
+
"doc": "校验失败态。方框描边转为 danger 色,内部 `<input>` 带 `aria-invalid`(06 · P1-16)。\n置于 `Field` 内时须与 `Field.error` 同时设置 —— 两者不联动,见 I5。",
|
|
472
|
+
"values": null
|
|
427
473
|
}
|
|
428
474
|
],
|
|
429
475
|
"helpers": []
|
|
@@ -474,7 +520,7 @@
|
|
|
474
520
|
"name": "placeholder",
|
|
475
521
|
"type": "string",
|
|
476
522
|
"required": false,
|
|
477
|
-
"doc": "
|
|
523
|
+
"doc": "输入框占位文字。默认「搜索选项」—— 写范围而非指令(02 §8 表单与说明文案)",
|
|
478
524
|
"values": null
|
|
479
525
|
},
|
|
480
526
|
{
|
|
@@ -490,6 +536,13 @@
|
|
|
490
536
|
"required": false,
|
|
491
537
|
"doc": "禁用",
|
|
492
538
|
"values": null
|
|
539
|
+
},
|
|
540
|
+
{
|
|
541
|
+
"name": "invalid",
|
|
542
|
+
"type": "boolean",
|
|
543
|
+
"required": false,
|
|
544
|
+
"doc": "校验失败态。外壳边框转为 danger 色,输入框带 `aria-invalid`(06 · P1-16)。\n置于 `Field` 内时须与 `Field.error` 同时设置 —— 两者不联动,见 I5。",
|
|
545
|
+
"values": null
|
|
493
546
|
}
|
|
494
547
|
],
|
|
495
548
|
"helpers": [
|
|
@@ -549,7 +602,7 @@
|
|
|
549
602
|
"name": "error",
|
|
550
603
|
"type": "ReactNode",
|
|
551
604
|
"required": false,
|
|
552
|
-
"doc": "错误文字,12/16 字号 danger 色。设置后取代 `description`。\n\n**不会自动把内部控件切到 invalid 态** —— 控件的 `invalid` 需另行设置。见 I5
|
|
605
|
+
"doc": "错误文字,12/16 字号 danger 色。设置后取代 `description`。\n\n**不会自动把内部控件切到 invalid 态** —— 控件的 `invalid` 需另行设置。见 I5。\n给了 `htmlFor` 时,错误(或说明)并入该控件的 `aria-describedby`,有错误时控件\n若没有 `aria-invalid` 则补上 —— 只是读屏语义,失败态视觉仍归控件的 `invalid`。",
|
|
553
606
|
"values": null
|
|
554
607
|
},
|
|
555
608
|
{
|
|
@@ -563,7 +616,14 @@
|
|
|
563
616
|
"name": "htmlFor",
|
|
564
617
|
"type": "string",
|
|
565
618
|
"required": false,
|
|
566
|
-
"doc": "关联内部控件的 id。透传给内部 `<label for
|
|
619
|
+
"doc": "关联内部控件的 id。透传给内部 `<label for>`,并据此把说明 / 错误关联到控件\n(`aria-describedby`)。控件包在别的组件里(`InputGroup`、`Popover`)时同样生效",
|
|
620
|
+
"values": null
|
|
621
|
+
},
|
|
622
|
+
{
|
|
623
|
+
"name": "span",
|
|
624
|
+
"type": "'full'",
|
|
625
|
+
"required": false,
|
|
626
|
+
"doc": "网格跨度。`full` 时本行占满所在网格的全部列(输出 `data-span`,由本组件\nCSS 写 `grid-column: 1 / -1`)。父级不是网格时无效果。\n\n取代此前登记的 `style={{ gridColumn: '1 / -1' }}` —— 内联 style 违反 §1.7\n(实践报告 P1-3,裁决:以规范为准)。",
|
|
567
627
|
"values": null
|
|
568
628
|
},
|
|
569
629
|
{
|
|
@@ -639,6 +699,13 @@
|
|
|
639
699
|
"required": false,
|
|
640
700
|
"doc": "禁用整组。背景转为 `--ds-color-bg-3`",
|
|
641
701
|
"values": null
|
|
702
|
+
},
|
|
703
|
+
{
|
|
704
|
+
"name": "invalid",
|
|
705
|
+
"type": "boolean",
|
|
706
|
+
"required": false,
|
|
707
|
+
"doc": "校验失败态。外壳边框转为 danger 色(06 · P1-16)。\n\n只管外壳视觉:壳是包装元素而非控件,`aria-invalid` 不落在它上面。读屏语义由\n内部控件承担 —— 内部 `Input` 同设 `invalid`(壳内它的边框已被剥掉,只剩\n`aria-invalid` 生效),或经 `Field.htmlFor` 由 Field 补上。\n置于 `Field` 内时须与 `Field.error` 同时设置 —— 两者不联动,见 I5。",
|
|
708
|
+
"values": null
|
|
642
709
|
}
|
|
643
710
|
],
|
|
644
711
|
"helpers": []
|
|
@@ -691,6 +758,13 @@
|
|
|
691
758
|
"required": false,
|
|
692
759
|
"doc": "禁用整组",
|
|
693
760
|
"values": null
|
|
761
|
+
},
|
|
762
|
+
{
|
|
763
|
+
"name": "invalid",
|
|
764
|
+
"type": "boolean",
|
|
765
|
+
"required": false,
|
|
766
|
+
"doc": "校验失败态。全部方框边框转为 danger 色,每个方框带 `aria-invalid`(06 · P1-16)。\n置于 `Field` 内时须与 `Field.error` 同时设置 —— 两者不联动,见 I5。",
|
|
767
|
+
"values": null
|
|
694
768
|
}
|
|
695
769
|
],
|
|
696
770
|
"helpers": []
|
|
@@ -854,6 +928,13 @@
|
|
|
854
928
|
"required": false,
|
|
855
929
|
"doc": "整组禁用。单个选项的禁用用 `RadioGroupItem.disabled`",
|
|
856
930
|
"values": null
|
|
931
|
+
},
|
|
932
|
+
{
|
|
933
|
+
"name": "invalid",
|
|
934
|
+
"type": "boolean",
|
|
935
|
+
"required": false,
|
|
936
|
+
"doc": "校验失败态。全部圆点描边转为 danger 色,`role=\"radiogroup\"` 的根元素带\n`aria-invalid`(06 · P1-16)。\n置于 `Field` 内时须与 `Field.error` 同时设置 —— 两者不联动,见 I5。",
|
|
937
|
+
"values": null
|
|
857
938
|
}
|
|
858
939
|
],
|
|
859
940
|
"helpers": [
|
|
@@ -931,7 +1012,7 @@
|
|
|
931
1012
|
"name": "placeholder",
|
|
932
1013
|
"type": "string",
|
|
933
1014
|
"required": false,
|
|
934
|
-
"doc": "未选中时的占位文字,以 placeholder
|
|
1015
|
+
"doc": "未选中时的占位文字,以 placeholder 色显示。默认「未选择」—— 写状态而非指令,\n不写「请选择」(02 §8 表单与说明文案,07 · C-4)",
|
|
935
1016
|
"values": null
|
|
936
1017
|
},
|
|
937
1018
|
{
|
|
@@ -1088,6 +1169,13 @@
|
|
|
1088
1169
|
"required": false,
|
|
1089
1170
|
"doc": "可见标签,渲染在轨道右侧,与轨道同属一个 `<label>` 因而可点击",
|
|
1090
1171
|
"values": null
|
|
1172
|
+
},
|
|
1173
|
+
{
|
|
1174
|
+
"name": "busy",
|
|
1175
|
+
"type": "boolean",
|
|
1176
|
+
"required": false,
|
|
1177
|
+
"doc": "落库中(06 · P3-17)。`onCheckedChange` 发起的保存尚未返回时设为 true。\n\n期间控件**保持可聚焦**、带 `aria-busy`,点击与空格不再切换(不改内部状态、\n不调 `onCheckedChange`),滑块内显示进行中指示。不要用 `disabled` 表达这段\n等待 —— 它让按钮失焦,焦点掉到 `body`,键盘用户得从页首重新找回来。",
|
|
1178
|
+
"values": null
|
|
1091
1179
|
}
|
|
1092
1180
|
],
|
|
1093
1181
|
"helpers": []
|
|
@@ -1254,8 +1342,8 @@
|
|
|
1254
1342
|
"group": "navigation-command",
|
|
1255
1343
|
"order": 3,
|
|
1256
1344
|
"contract": "contracts/foundation/navigation-command/command.ts",
|
|
1257
|
-
"summary": "键盘优先的命令面板 ——
|
|
1258
|
-
"doc": "键盘优先的命令面板 ——
|
|
1345
|
+
"summary": "键盘优先的命令面板 —— 以 `dialog` 形态作为全局搜索与执行入口。",
|
|
1346
|
+
"doc": "键盘优先的命令面板 —— 以 `dialog` 形态作为全局搜索与执行入口。\n\n本地筛选。**筛选后无命中的分组整组消失**,不显示空标题。\n\n### `dialog` 形态(06 · P1-15)\n面板自身就是模态框:与 `Dialog` 共用同一个基座(遮罩、Esc、焦点陷阱、关闭后\n焦点恢复、滚动锁定),打开时焦点落在输入框,没有标题栏与关闭按钮 —— 搜索行\n就是头部;宽度受视口边距约束,不溢出。此前只能把本组件放进 `Dialog`:不传\n`title` 仍渲染空标题栏、初始焦点落在「关闭」、420px 宽在 Dialog 主体内溢出,\n且与「不得被带边框的容器包裹」互相矛盾。\n\n目录中已登记,但**尚未在生产业务代码中集成**。见 I20。",
|
|
1259
1347
|
"replaces": [],
|
|
1260
1348
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
1261
1349
|
"omitted": [
|
|
@@ -1273,7 +1361,7 @@
|
|
|
1273
1361
|
"name": "placeholder",
|
|
1274
1362
|
"type": "string",
|
|
1275
1363
|
"required": false,
|
|
1276
|
-
"doc": "
|
|
1364
|
+
"doc": "输入框占位文字。默认「搜索命令」—— 写范围而非指令(02 §8 表单与说明文案)",
|
|
1277
1365
|
"values": null
|
|
1278
1366
|
},
|
|
1279
1367
|
{
|
|
@@ -1287,7 +1375,28 @@
|
|
|
1287
1375
|
"name": "onSelect",
|
|
1288
1376
|
"type": "(value: string) => void",
|
|
1289
1377
|
"required": false,
|
|
1290
|
-
"doc": "
|
|
1378
|
+
"doc": "命令选中回调。`dialog` 形态下选中后是否收起由调用方在这里决定",
|
|
1379
|
+
"values": null
|
|
1380
|
+
},
|
|
1381
|
+
{
|
|
1382
|
+
"name": "dialog",
|
|
1383
|
+
"type": "boolean",
|
|
1384
|
+
"required": false,
|
|
1385
|
+
"doc": "以模态外壳渲染。可访问名取 `aria-label` / `aria-labelledby`(同时落在模态框与\n输入框上),缺省时回落到 `placeholder`",
|
|
1386
|
+
"values": null
|
|
1387
|
+
},
|
|
1388
|
+
{
|
|
1389
|
+
"name": "open",
|
|
1390
|
+
"type": "boolean",
|
|
1391
|
+
"required": false,
|
|
1392
|
+
"doc": "`dialog` 形态下是否打开。为 false 时渲染 `null`;非 `dialog` 形态忽略",
|
|
1393
|
+
"values": null
|
|
1394
|
+
},
|
|
1395
|
+
{
|
|
1396
|
+
"name": "onOpenChange",
|
|
1397
|
+
"type": "(open: boolean) => void",
|
|
1398
|
+
"required": false,
|
|
1399
|
+
"doc": "`dialog` 形态下的开合回调:Esc 与遮罩点击以 `false` 调用",
|
|
1291
1400
|
"values": null
|
|
1292
1401
|
}
|
|
1293
1402
|
],
|
|
@@ -1355,7 +1464,7 @@
|
|
|
1355
1464
|
"order": 3,
|
|
1356
1465
|
"contract": "contracts/foundation/navigation-command/context-menu.ts",
|
|
1357
1466
|
"summary": "内容区域上的右键菜单 —— 行、卡片、看板块。",
|
|
1358
|
-
"doc": "内容区域上的右键菜单 —— 行、卡片、看板块。\n\n⚠ **绝不能是某个动作的唯一入口。** 记录级动作必须同时出现在行尾或详情中 ——\n
|
|
1467
|
+
"doc": "内容区域上的右键菜单 —— 行、卡片、看板块。\n\n⚠ **绝不能是某个动作的唯一入口。** 记录级动作必须同时出现在行尾或详情中 ——\n右键是加速器,不是可达性路径。\n\n菜单内的点击、指针与键盘事件在菜单根截停,**不冒泡**到 `children` 及其祖先 ——\n放在可点击的记录行里,选中条目不会连带触发行的 `onClick` / 回车。\n高亮项每次打开都清空;Esc 关闭或选中后,焦点回到打开菜单前持有焦点的元素。\n任一祖先滚动或窗口尺寸变化时菜单收起。",
|
|
1359
1468
|
"replaces": [],
|
|
1360
1469
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
1361
1470
|
"omitted": [
|
|
@@ -1436,7 +1545,7 @@
|
|
|
1436
1545
|
"order": 3,
|
|
1437
1546
|
"contract": "contracts/foundation/navigation-command/menubar.ts",
|
|
1438
1547
|
"summary": "桌面风格的水平菜单条,用于编辑器型工作面 —— 报表设计器、看板配置器。",
|
|
1439
|
-
"doc": "桌面风格的水平菜单条,用于编辑器型工作面 —— 报表设计器、看板配置器。\n\n⚠ **只能位于 Content Canvas 内部。** Shell 拥有自己的导航,不承载菜单条。\n**绝不用作页面导航** —— 那是 Shell 的职责。\n\n目录中已登记,但**尚未在生产业务代码中集成**。见 I20。",
|
|
1548
|
+
"doc": "桌面风格的水平菜单条,用于编辑器型工作面 —— 报表设计器、看板配置器。\n\n⚠ **只能位于 Content Canvas 内部。** Shell 拥有自己的导航,不承载菜单条。\n**绝不用作页面导航** —— 那是 Shell 的职责。\n\n键盘按 WAI-ARIA menubar 模式:菜单条只有一个 Tab 停靠点,← / → 在顶级菜单项间\n循环;Enter / 空格 / ↓ 打开并高亮首个可用项,↑ 打开并高亮末项;面板内 ↑ / ↓ /\nHome / End 移动并跳过禁用项,Enter / 空格选中,← / → 切到相邻顶级菜单;\n选中与 Esc 后焦点回到顶级菜单项,Tab 收起面板并离开菜单条。\n\n目录中已登记,但**尚未在生产业务代码中集成**。见 I20。",
|
|
1440
1549
|
"replaces": [],
|
|
1441
1550
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
1442
1551
|
"omitted": [
|
|
@@ -1522,7 +1631,7 @@
|
|
|
1522
1631
|
"order": 3,
|
|
1523
1632
|
"contract": "contracts/foundation/navigation-command/navigation-menu.ts",
|
|
1524
1633
|
"summary": "水平导航,条目可展开富内容面板。",
|
|
1525
|
-
"doc": "水平导航,条目可展开富内容面板。\n\n激活态是 **2px 强调色下划线 + medium 字重**,绝不是 pill 背景,也不只靠颜色。\n\n⚠ 这是 Foundation 基元。**应用二级导航请用 `ApplicationSecondaryNavigation`** ——\n那里每个标签强制 `图标 +
|
|
1634
|
+
"doc": "水平导航,条目可展开富内容面板。\n\n激活态是 **2px 强调色下划线 + medium 字重**,绝不是 pill 背景,也不只靠颜色。\n\n⚠ 这是 Foundation 基元。**应用二级导航请用 `ApplicationSecondaryNavigation`** ——\n那里每个标签强制 `图标 + 文字`,本基元不施加该约束。\n\n面板在悬停、聚焦或点击时展开;指针离开槽位后延时 150ms 收起,其间移入面板即取消。\nEsc 收起面板,焦点在面板内时回到条目。激活项标 `aria-current`,取值由 `current`\n区分「切换页面」(默认 `page`)与「页内切换」(`true`)。",
|
|
1526
1635
|
"replaces": [],
|
|
1527
1636
|
"nativeBase": "HTMLAttributes<HTMLElement>",
|
|
1528
1637
|
"omitted": [],
|
|
@@ -1554,6 +1663,16 @@
|
|
|
1554
1663
|
"required": false,
|
|
1555
1664
|
"doc": "选中值变化回调",
|
|
1556
1665
|
"values": null
|
|
1666
|
+
},
|
|
1667
|
+
{
|
|
1668
|
+
"name": "current",
|
|
1669
|
+
"type": "'page' | 'true'",
|
|
1670
|
+
"required": false,
|
|
1671
|
+
"doc": "激活项输出的 `aria-current` 取值(06 · P3-13)。条目各自对应一个页面时用默认的\n`page`;条目只切换同一页面内的区域或主题时传 `true` —— 读屏不再报成「当前页面」",
|
|
1672
|
+
"values": [
|
|
1673
|
+
"page",
|
|
1674
|
+
"true"
|
|
1675
|
+
]
|
|
1557
1676
|
}
|
|
1558
1677
|
],
|
|
1559
1678
|
"helpers": [
|
|
@@ -1631,8 +1750,8 @@
|
|
|
1631
1750
|
"group": "navigation-command",
|
|
1632
1751
|
"order": 3,
|
|
1633
1752
|
"contract": "contracts/foundation/navigation-command/sidebar.ts",
|
|
1634
|
-
"summary": "Content Canvas 内部的垂直导航面 ——
|
|
1635
|
-
"doc": "Content Canvas 内部的垂直导航面 ——
|
|
1753
|
+
"summary": "Content Canvas 内部的垂直导航面 —— 设置页目录。",
|
|
1754
|
+
"doc": "Content Canvas 内部的垂直导航面 —— 设置页目录。\nSPLIT 左栏不用本组件,一律用 `ApplicationSplitListSidebar`(07 · C-15)。\n\n⚠ **这不是 Shell。** Shell 没有左侧全局栏;工作台侧栏是 `GlobalSidebar`,\n属于 Application Module 层。两者不可互相替代。",
|
|
1636
1755
|
"replaces": [],
|
|
1637
1756
|
"nativeBase": "HTMLAttributes<HTMLElement>",
|
|
1638
1757
|
"omitted": [],
|
|
@@ -1737,7 +1856,7 @@
|
|
|
1737
1856
|
"order": 3,
|
|
1738
1857
|
"contract": "contracts/foundation/navigation-command/tabs.ts",
|
|
1739
1858
|
"summary": "页面区域内的局部标签页 —— Business View 标签、SPLIT 右栏内容标签、详情分节。",
|
|
1740
|
-
"doc": "页面区域内的局部标签页 —— Business View 标签、SPLIT 右栏内容标签、详情分节。\n\n32px 高,6/12 内边距,激活态是 **2px 强调色下划线 + medium 字重**,\n明确**不是** pill 背景。\n\n⚠ **`items` 为空时整个组件渲染 `null`** —— 不渲染空标签行、不画分隔线、\n不保留高度。规范明令禁止为空标签行预留占位。\n\n这是页面区域内的控件,不是 Shell 的二级导航(那是 `ApplicationSecondaryNavigation
|
|
1859
|
+
"doc": "页面区域内的局部标签页 —— Business View 标签、SPLIT 右栏内容标签、详情分节。\n\n32px 高,6/12 内边距,激活态是 **2px 强调色下划线 + medium 字重**,\n明确**不是** pill 背景。\n\n⚠ **`items` 为空时整个组件渲染 `null`** —— 不渲染空标签行、不画分隔线、\n不保留高度。规范明令禁止为空标签行预留占位。\n\n这是页面区域内的控件,不是 Shell 的二级导航(那是 `ApplicationSecondaryNavigation`)。\n\n传入的 `aria-label` / `aria-labelledby` 落在 `role=\"tablist\"` 上,不落在根节点。",
|
|
1741
1860
|
"replaces": [],
|
|
1742
1861
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
1743
1862
|
"omitted": [
|
|
@@ -1776,7 +1895,7 @@
|
|
|
1776
1895
|
"name": "children",
|
|
1777
1896
|
"type": "ReactNode",
|
|
1778
1897
|
"required": false,
|
|
1779
|
-
"doc": "标签面板内容。提供时渲染在标签行下方,带 `--ds-space-3`
|
|
1898
|
+
"doc": "标签面板内容。提供时渲染在标签行下方,带 `--ds-space-3` 上边距。\n\n根与面板都是列向 flex,面板吃掉根的剩余高度:根在定高父级里拿到高度时\n(调用方给根 `flex: 1; min-block-size: 0` 一类的类名),面板内的\n`ApplicationDataDisplay` 拿到有界高度、自己滚动。面板的直接子节点各成一个\nflex 项 —— 行内混排的文字须包一层块级元素。\n\n渲染面板时,激活标签以 `aria-controls` 指向它,它以 `aria-labelledby` 指回激活标签。",
|
|
1780
1899
|
"values": null
|
|
1781
1900
|
}
|
|
1782
1901
|
],
|
|
@@ -1855,7 +1974,7 @@
|
|
|
1855
1974
|
"order": 4,
|
|
1856
1975
|
"contract": "contracts/foundation/data-content-layout/avatar.ts",
|
|
1857
1976
|
"summary": "人员或组织的身份标记 —— 人员选择器、联系人列表、审计轨迹、记录负责人。",
|
|
1858
|
-
"doc": "人员或组织的身份标记 —— 人员选择器、联系人列表、审计轨迹、记录负责人。\n\n
|
|
1977
|
+
"doc": "人员或组织的身份标记 —— 人员选择器、联系人列表、审计轨迹、记录负责人。\n\n无图片时回退为文字缩写:**中文名取末字,拉丁名取首字母缩写**。\n取末字(07 · C-8):「张伟」→「伟」,占位符「成员 A」→「A」—— 取首字时同姓者与\n同一占位符前缀下的头像缩写全相同,无从区分。\n\n⚠ **绝不用 Emoji 或装饰性字形代替头像。**",
|
|
1859
1978
|
"replaces": [],
|
|
1860
1979
|
"nativeBase": "HTMLAttributes<HTMLSpanElement>",
|
|
1861
1980
|
"omitted": [],
|
|
@@ -1864,7 +1983,7 @@
|
|
|
1864
1983
|
"name": "name",
|
|
1865
1984
|
"type": "string",
|
|
1866
1985
|
"required": false,
|
|
1867
|
-
"doc": "
|
|
1986
|
+
"doc": "姓名或组织名。用于生成回退缩写,同时作为头像图片的替代文本(不渲染原生悬浮提示)",
|
|
1868
1987
|
"values": null
|
|
1869
1988
|
},
|
|
1870
1989
|
{
|
|
@@ -1901,7 +2020,7 @@
|
|
|
1901
2020
|
"order": 4,
|
|
1902
2021
|
"contract": "contracts/foundation/data-content-layout/badge.ts",
|
|
1903
2022
|
"summary": "紧凑的状态或分类标签 —— 行、卡片、指标、详情头。",
|
|
1904
|
-
"doc": "紧凑的状态或分类标签 —— 行、卡片、指标、详情头。\n\n20px 高,4px 圆角,12/16 字号。\n\n⚠ **状态色只来自功能状态色板。** 图表分类色(20 色)绝不能用来表达状态。\n\n一个 tone
|
|
2023
|
+
"doc": "紧凑的状态或分类标签 —— 行、卡片、指标、详情头。\n\n20px 高,4px 圆角,12/16 字号。\n\n⚠ **状态色只来自功能状态色板。** 图表分类色(20 色)绝不能用来表达状态。\n\n一个 tone 在同一维度内只能有一个含义 —— 不要在 A 页面用 warning 表示「待整改」、\n在 B 页面用它表示「即将到期」。同屏有两个状态维度(处理状态与风险等级)时,\n用 `variant` 区分维度:一个维度 `soft`、另一个 `outline`,tone 可以跨维度复用(07 · C-9)。",
|
|
1905
2024
|
"replaces": [],
|
|
1906
2025
|
"nativeBase": "HTMLAttributes<HTMLSpanElement>",
|
|
1907
2026
|
"omitted": [],
|
|
@@ -1910,7 +2029,7 @@
|
|
|
1910
2029
|
"name": "tone",
|
|
1911
2030
|
"type": "'neutral' | 'accent' | 'success' | 'warning' | 'danger' | 'info'",
|
|
1912
2031
|
"required": false,
|
|
1913
|
-
"doc": "语义色调。每个 tone
|
|
2032
|
+
"doc": "语义色调。每个 tone 在同一维度内含义唯一;不同维度用 `variant` 区分",
|
|
1914
2033
|
"values": [
|
|
1915
2034
|
"neutral",
|
|
1916
2035
|
"accent",
|
|
@@ -1993,7 +2112,7 @@
|
|
|
1993
2112
|
"order": 4,
|
|
1994
2113
|
"contract": "contracts/foundation/data-content-layout/card.ts",
|
|
1995
2114
|
"summary": "标准页面承载面 —— CardList 磁贴、工作台面板、图表容器、表单分节。",
|
|
1996
|
-
"doc": "标准页面承载面 —— CardList 磁贴、工作台面板、图表容器、表单分节。\n\n已登记契约:**只有两档密度** —— `default`(16px 节奏)与 `sm`(12px),\n16px 圆角,1px 边框,**默认无装饰阴影**。不要给它加阴影。",
|
|
2115
|
+
"doc": "标准页面承载面 —— CardList 磁贴、工作台面板、图表容器、表单分节。\n\n已登记契约:**只有两档密度** —— `default`(16px 节奏)与 `sm`(12px),\n`default` 的节奏随视口密度档收为 16 / 12 / 10(07 · C-17),`sm` 在 Compact 档同取 10;\n16px 圆角,1px 边框,**默认无装饰阴影**。不要给它加阴影。",
|
|
1997
2116
|
"replaces": [],
|
|
1998
2117
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
1999
2118
|
"omitted": [
|
|
@@ -2004,7 +2123,7 @@
|
|
|
2004
2123
|
"name": "density",
|
|
2005
2124
|
"type": "'default' | 'sm'",
|
|
2006
2125
|
"required": false,
|
|
2007
|
-
"doc": "密度。`default` 内边距与间隙均 16px
|
|
2126
|
+
"doc": "密度。`default` 内边距与间隙均 16px(Condensed 视口 12、Compact 视口 10),\n`sm` 均 12px(Compact 视口 10)。没有第三档 —— 视口档不是 prop,由 `@media` 自动生效",
|
|
2008
2127
|
"values": [
|
|
2009
2128
|
"default",
|
|
2010
2129
|
"sm"
|
|
@@ -2098,7 +2217,7 @@
|
|
|
2098
2217
|
"order": 4,
|
|
2099
2218
|
"contract": "contracts/foundation/data-content-layout/chart.ts",
|
|
2100
2219
|
"summary": "图表基元 —— ANALYSIS 分析页、指标卡、报表摘要。",
|
|
2101
|
-
"doc": "图表基元 —— ANALYSIS 分析页、指标卡、报表摘要。\n\n
|
|
2220
|
+
"doc": "图表基元 —— ANALYSIS 分析页、指标卡、报表摘要。\n\n系列配色取自共享的 20 色分类色板\n(`--application-categorical-01…20`,`hsl(H, 24%, 53%)`,H 每 18° 一步)。\n按系列数跳步取色:共 n 条系列时,从 01 号色起每隔 ⌊20/n⌋ 号取一色,使相邻系列的\n色相拉开(2 条差 180°、3 条差 108°;11 条起才逐号取)。首条系列恒为 01 号色。\n同亮度设计使整组图表读起来是一家人。\n\n⚠ **分类色只编码分类,绝不能替代功能状态色。**\n「红色系列」不等于「危险」——状态请用 `Badge` 或 `ApplicationMetricStatus`。\n\n⚠ 当图表是当前的 Data Presentation 时,\n其设置按钮**必须**写作「图表设置」,不得写成通用的「视图设置」。\n\n根节点渲染为 `role=\"figure\"`,可访问名称由调用方以 `aria-label`(或\n`aria-labelledby`)给出,落在该 figure 上;绘图 svg 是 `aria-hidden` 的,\n标签行与图例文字对读屏器保持可读。",
|
|
2102
2221
|
"replaces": [],
|
|
2103
2222
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
2104
2223
|
"omitted": [],
|
|
@@ -2107,7 +2226,7 @@
|
|
|
2107
2226
|
"name": "type",
|
|
2108
2227
|
"type": "'line' | 'area' | 'bar'",
|
|
2109
2228
|
"required": false,
|
|
2110
|
-
"doc": "
|
|
2229
|
+
"doc": "图表类型。默认 `'line'`",
|
|
2111
2230
|
"values": [
|
|
2112
2231
|
"line",
|
|
2113
2232
|
"area",
|
|
@@ -2118,35 +2237,35 @@
|
|
|
2118
2237
|
"name": "series",
|
|
2119
2238
|
"type": "ChartSeries[]",
|
|
2120
2239
|
"required": true,
|
|
2121
|
-
"doc": "
|
|
2240
|
+
"doc": "数据系列集合。配色按数组顺序与系列总数分配(跳步规则见组件说明)",
|
|
2122
2241
|
"values": null
|
|
2123
2242
|
},
|
|
2124
2243
|
{
|
|
2125
2244
|
"name": "labels",
|
|
2126
2245
|
"type": "string[]",
|
|
2127
2246
|
"required": false,
|
|
2128
|
-
"doc": "X 轴标签。见 D6 ——
|
|
2247
|
+
"doc": "X 轴标签。见 D6 —— 折线 / 面积图按均分排布,与数据点不对齐;\n柱状图按等宽列居中,标签数等于类目数时落在各柱组中心。\n标签不折行,放不下时以省略号截断,完整文字见悬停提示",
|
|
2129
2248
|
"values": null
|
|
2130
2249
|
},
|
|
2131
2250
|
{
|
|
2132
2251
|
"name": "height",
|
|
2133
2252
|
"type": "number",
|
|
2134
2253
|
"required": false,
|
|
2135
|
-
"doc": "绘图区高度,单位 px",
|
|
2254
|
+
"doc": "绘图区高度,单位 px。默认 200",
|
|
2136
2255
|
"values": null
|
|
2137
2256
|
},
|
|
2138
2257
|
{
|
|
2139
2258
|
"name": "showLegend",
|
|
2140
2259
|
"type": "boolean",
|
|
2141
2260
|
"required": false,
|
|
2142
|
-
"doc": "
|
|
2261
|
+
"doc": "显示图例。默认 `true`",
|
|
2143
2262
|
"values": null
|
|
2144
2263
|
},
|
|
2145
2264
|
{
|
|
2146
2265
|
"name": "showGrid",
|
|
2147
2266
|
"type": "boolean",
|
|
2148
2267
|
"required": false,
|
|
2149
|
-
"doc": "
|
|
2268
|
+
"doc": "显示水平网格线。默认 `true`",
|
|
2150
2269
|
"values": null
|
|
2151
2270
|
}
|
|
2152
2271
|
],
|
|
@@ -2356,7 +2475,7 @@
|
|
|
2356
2475
|
"order": 4,
|
|
2357
2476
|
"contract": "contracts/foundation/data-content-layout/message-scroller.ts",
|
|
2358
2477
|
"summary": "消息流的滚动容器。",
|
|
2359
|
-
"doc": "消息流的滚动容器。\n\n⚠
|
|
2478
|
+
"doc": "消息流的滚动容器。\n\n⚠ 这是一个**有界的、正交的**滚动区域,是页面级纵向滚动持有者(按页型归属,06 · D-4)\n之外的合法局部例外。**必须给显式高度** —— 不得在 Content Canvas 内堆叠无界的\n垂直滚动容器。",
|
|
2360
2479
|
"replaces": [],
|
|
2361
2480
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
2362
2481
|
"omitted": [],
|
|
@@ -2372,7 +2491,7 @@
|
|
|
2372
2491
|
"name": "stickToBottom",
|
|
2373
2492
|
"type": "boolean",
|
|
2374
2493
|
"required": false,
|
|
2375
|
-
"doc": "
|
|
2494
|
+
"doc": "新内容到达时自动滚到底部 —— 仅当用户此前已贴近底部(48px 阈值内)时生效,\n翻阅历史时不打断(D7 已在阶段 4 修正)。",
|
|
2376
2495
|
"values": null
|
|
2377
2496
|
},
|
|
2378
2497
|
{
|
|
@@ -2443,7 +2562,7 @@
|
|
|
2443
2562
|
"name": "label",
|
|
2444
2563
|
"type": "ReactNode",
|
|
2445
2564
|
"required": false,
|
|
2446
|
-
"doc": "轨道上方的说明文字,12/16 label
|
|
2565
|
+
"doc": "轨道上方的说明文字,12/16 label 色。同时是 progressbar 的可访问名称\n(以 `aria-labelledby` 关联)。不给 `label` 时应传 `aria-label`,\n它同样落在 progressbar 上而不是根节点",
|
|
2447
2566
|
"values": null
|
|
2448
2567
|
}
|
|
2449
2568
|
],
|
|
@@ -2456,7 +2575,7 @@
|
|
|
2456
2575
|
"order": 4,
|
|
2457
2576
|
"contract": "contracts/foundation/data-content-layout/resizable.ts",
|
|
2458
2577
|
"summary": "带可拖拽分隔条的双栏布局,支撑 SPLIT 工作面。",
|
|
2459
|
-
"doc": "带可拖拽分隔条的双栏布局,支撑 SPLIT 工作面。\n\n默认左栏 360px,与 `--ui-sidebar-list-width`
|
|
2578
|
+
"doc": "带可拖拽分隔条的双栏布局,支撑 SPLIT 工作面。\n\n默认左栏 360px,与 `--ui-sidebar-list-width` 的 Standard 档一致。\n\n宽度类 prop 收**数字或 CSS 长度字符串**(06 · P1-20):数字按 px,字符串原样\n交给 CSS —— 传 `'var(--ui-sidebar-list-width)'` 即跟随密度档(360 / 300),\n也可以写 `'30%'`、`'20rem'`。**拖拽与方向键调整后回调的恒为 px 数字**,按调整\n那一刻的渲染宽度换算;受控方把它写回 `size` 之后,该栏就不再跟随原字符串里的\n`var()` / 百分比 —— 要恢复跟随,把 `size` 写回原字符串。\n\n⚠ **拖动分栏永远不改变 `pageMode`。** 它只是布局调整。\n\n需要已登记的 SPLIT 结构时用 `ApplicationSplitListSidebar`,\n本组件只是裸的分栏器。",
|
|
2460
2579
|
"replaces": [],
|
|
2461
2580
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
2462
2581
|
"omitted": [],
|
|
@@ -2477,37 +2596,37 @@
|
|
|
2477
2596
|
},
|
|
2478
2597
|
{
|
|
2479
2598
|
"name": "defaultSize",
|
|
2480
|
-
"type": "number",
|
|
2599
|
+
"type": "number | string",
|
|
2481
2600
|
"required": false,
|
|
2482
|
-
"doc": "
|
|
2601
|
+
"doc": "左栏初始宽度。数字按 px,字符串为任意 CSS 长度。默认 360",
|
|
2483
2602
|
"values": null
|
|
2484
2603
|
},
|
|
2485
2604
|
{
|
|
2486
2605
|
"name": "size",
|
|
2487
|
-
"type": "number",
|
|
2606
|
+
"type": "number | string",
|
|
2488
2607
|
"required": false,
|
|
2489
|
-
"doc": "
|
|
2608
|
+
"doc": "受控左栏宽度。数字按 px,字符串为任意 CSS 长度(如 `'var(--ui-sidebar-list-width)'`)",
|
|
2490
2609
|
"values": null
|
|
2491
2610
|
},
|
|
2492
2611
|
{
|
|
2493
2612
|
"name": "onSizeChange",
|
|
2494
2613
|
"type": "(size: number) => void",
|
|
2495
2614
|
"required": false,
|
|
2496
|
-
"doc": "
|
|
2615
|
+
"doc": "宽度变化回调。拖动过程中持续触发。\n**参数恒为 px 数字**(已钳在 `min`–`max` 之间),不回传字符串",
|
|
2497
2616
|
"values": null
|
|
2498
2617
|
},
|
|
2499
2618
|
{
|
|
2500
2619
|
"name": "min",
|
|
2501
|
-
"type": "number",
|
|
2620
|
+
"type": "number | string",
|
|
2502
2621
|
"required": false,
|
|
2503
|
-
"doc": "
|
|
2622
|
+
"doc": "左栏最小宽度,只约束拖拽与方向键。数字按 px,字符串为任意 CSS 长度。默认 240",
|
|
2504
2623
|
"values": null
|
|
2505
2624
|
},
|
|
2506
2625
|
{
|
|
2507
2626
|
"name": "max",
|
|
2508
|
-
"type": "number",
|
|
2627
|
+
"type": "number | string",
|
|
2509
2628
|
"required": false,
|
|
2510
|
-
"doc": "
|
|
2629
|
+
"doc": "左栏最大宽度,只约束拖拽与方向键。数字按 px,字符串为任意 CSS 长度。默认 720",
|
|
2511
2630
|
"values": null
|
|
2512
2631
|
}
|
|
2513
2632
|
],
|
|
@@ -2520,7 +2639,7 @@
|
|
|
2520
2639
|
"order": 4,
|
|
2521
2640
|
"contract": "contracts/foundation/data-content-layout/scroll-area.ts",
|
|
2522
2641
|
"summary": "有界滚动区域,带细样式滚动条 —— 长筛选列表、宽表格、必须单行的标签条。",
|
|
2523
|
-
"doc": "有界滚动区域,带细样式滚动条 —— 长筛选列表、宽表格、必须单行的标签条。\n\n⚠
|
|
2642
|
+
"doc": "有界滚动区域,带细样式滚动条 —— 长筛选列表、宽表格、必须单行的标签条。\n\n⚠ **每个页面只有一个页面级纵向滚动持有者**:结果集页面是 `ApplicationDataDisplay`\n的主体,其余页面是 Content Canvas(06 · D-4)。\n本组件只用于**正交方向**(水平)或**局部有界**的溢出。\n绝不堆叠无界的垂直滚动容器。",
|
|
2524
2643
|
"replaces": [],
|
|
2525
2644
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
2526
2645
|
"omitted": [],
|
|
@@ -2591,7 +2710,7 @@
|
|
|
2591
2710
|
"name": "spacing",
|
|
2592
2711
|
"type": "string | number",
|
|
2593
2712
|
"required": false,
|
|
2594
|
-
"doc": "分隔线两侧的外边距。应传 token,如 `var(--
|
|
2713
|
+
"doc": "分隔线两侧的外边距。应传 token,如 `var(--application-space-2)`",
|
|
2595
2714
|
"values": null
|
|
2596
2715
|
}
|
|
2597
2716
|
],
|
|
@@ -2700,7 +2819,7 @@
|
|
|
2700
2819
|
"name": "onRowClick",
|
|
2701
2820
|
"type": "(row: R) => void",
|
|
2702
2821
|
"required": false,
|
|
2703
|
-
"doc": "行点击回调。设置后整行 `cursor: pointer
|
|
2822
|
+
"doc": "行点击回调。设置后整行 `cursor: pointer`、可聚焦,Enter / 空格同样触发",
|
|
2704
2823
|
"values": null
|
|
2705
2824
|
},
|
|
2706
2825
|
{
|
|
@@ -2940,8 +3059,8 @@
|
|
|
2940
3059
|
"group": "feedback-overlay",
|
|
2941
3060
|
"order": 5,
|
|
2942
3061
|
"contract": "contracts/foundation/feedback-overlay/collapsible.ts",
|
|
2943
|
-
"summary": "单个显隐区域,由一个触发器控制 ——
|
|
2944
|
-
"doc": "单个显隐区域,由一个触发器控制 ——
|
|
3062
|
+
"summary": "单个显隐区域,由一个触发器控制 —— 详情页的次要分节、表单里的高级选项。",
|
|
3063
|
+
"doc": "单个显隐区域,由一个触发器控制 —— 详情页的次要分节、表单里的高级选项。\n\n⚠ **折叠只改变入口,绝不移除能力。** 被收起的内容仍然存在、仍可使用。\n\n⚠ 查询工具栏的「更多筛选」**不用本组件**,一律用 `Popover`:就地展开会把工具栏\n撑高(实测 99px → 452px),SPLIT 页的两栏随之被压扁(06 · D-4)。\n\n多个并列的折叠区请用 `Accordion`。",
|
|
2945
3064
|
"replaces": [
|
|
2946
3065
|
"details",
|
|
2947
3066
|
"summary"
|
|
@@ -2953,7 +3072,7 @@
|
|
|
2953
3072
|
"name": "label",
|
|
2954
3073
|
"type": "ReactNode",
|
|
2955
3074
|
"required": false,
|
|
2956
|
-
"doc": "
|
|
3075
|
+
"doc": "触发器文字,如「版本记录」",
|
|
2957
3076
|
"values": null
|
|
2958
3077
|
},
|
|
2959
3078
|
{
|
|
@@ -3045,6 +3164,13 @@
|
|
|
3045
3164
|
"doc": "关闭回调。点击遮罩与关闭按钮都会触发",
|
|
3046
3165
|
"values": null
|
|
3047
3166
|
},
|
|
3167
|
+
{
|
|
3168
|
+
"name": "initialFocus",
|
|
3169
|
+
"type": "RefObject<HTMLElement | null>",
|
|
3170
|
+
"required": false,
|
|
3171
|
+
"doc": "打开时的初始焦点(06 · P3-1)。缺省时落在面板内首个可聚焦元素 —— 标题栏的\n关闭按钮。键盘优先的内容(首个输入框、搜索框)应把它的 ref 传进来。\n目标须在本组件内;关闭后焦点照常回到打开前的元素",
|
|
3172
|
+
"values": null
|
|
3173
|
+
},
|
|
3048
3174
|
{
|
|
3049
3175
|
"name": "children",
|
|
3050
3176
|
"type": "ReactNode",
|
|
@@ -3094,7 +3220,7 @@
|
|
|
3094
3220
|
"name": "side",
|
|
3095
3221
|
"type": "'right' | 'left'",
|
|
3096
3222
|
"required": false,
|
|
3097
|
-
"doc": "
|
|
3223
|
+
"doc": "停靠侧,默认 `right`。两侧均生效(F2 已在阶段 4 修正)",
|
|
3098
3224
|
"values": [
|
|
3099
3225
|
"right",
|
|
3100
3226
|
"left"
|
|
@@ -3131,7 +3257,7 @@
|
|
|
3131
3257
|
"order": 5,
|
|
3132
3258
|
"contract": "contracts/foundation/feedback-overlay/dropdown-menu.ts",
|
|
3133
3259
|
"summary": "触发器 + 菜单面板,低频动作的收纳处 —— 上下文区或行尾的「**更多**」按钮。",
|
|
3134
|
-
"doc": "触发器 + 菜单面板,低频动作的收纳处 ——\n上下文区或行尾的「**更多**」按钮。\n\n⚠ **Page Mode Switch 绝不能被折叠进来。** 它必须始终可见 ——\n这是 Shell
|
|
3260
|
+
"doc": "触发器 + 菜单面板,低频动作的收纳处 ——\n上下文区或行尾的「**更多**」按钮。\n\n⚠ **Page Mode Switch 绝不能被折叠进来。** 它必须始终可见 ——\n这是 Shell 契约的硬性要求,不是布局偏好。\n\n键盘打开(Enter / 空格 / ↓)高亮首个可用项,↑ 高亮末项,鼠标打开不预先高亮;\nTab 收起菜单。Esc 关闭或选中后焦点回到 `trigger` —— 选中时先归还焦点再调\n`onSelect`,在 `onSelect` 里打开的 `AlertDialog` 关闭后焦点因此回到触发器。",
|
|
3135
3261
|
"replaces": [],
|
|
3136
3262
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
3137
3263
|
"omitted": [
|
|
@@ -3273,7 +3399,7 @@
|
|
|
3273
3399
|
"order": 5,
|
|
3274
3400
|
"contract": "contracts/foundation/feedback-overlay/popover.ts",
|
|
3275
3401
|
"summary": "锚定式浮层面板 —— 筛选器、呈现设置、日期选择器。",
|
|
3276
|
-
"doc": "锚定式浮层面板 —— 筛选器、呈现设置、日期选择器。\n\n⚠ **呈现设置面板必须按当前呈现方式命名**\n(列设置 / 卡片设置 / 看板设置 / 日历设置 / 图表设置 / 时间轴设置),\n禁止通用的「视图设置」。\n\n⚠ **呈现设置不得改变**搜索、筛选、业务视图或页面模式 ——\n它只调整当前呈现方式的展示细节。\n\n共享的全局动作弹层(720px 宽、20px 圆角、680px 最高)\n由 `ApplicationGlobalActionPanel`
|
|
3402
|
+
"doc": "锚定式浮层面板 —— 筛选器、呈现设置、日期选择器。\n\n⚠ **呈现设置面板必须按当前呈现方式命名**\n(列设置 / 列表设置 / 卡片设置 / 看板设置 / 日历设置 / 图表设置 / 时间轴设置),\n禁止通用的「视图设置」。\n\n⚠ **呈现设置不得改变**搜索、筛选、业务视图或页面模式 ——\n它只调整当前呈现方式的展示细节。\n\n共享的全局动作弹层(720px 宽、20px 圆角、680px 最高)\n由 `ApplicationGlobalActionPanel` 承载,不要用本组件手工拼装。\n\n关闭时焦点若在面板内(Esc,或面板内的控件经 `onOpenChange(false)` 收起),\n焦点回到 `trigger`。",
|
|
3277
3403
|
"replaces": [],
|
|
3278
3404
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
3279
3405
|
"omitted": [],
|
|
@@ -3282,7 +3408,14 @@
|
|
|
3282
3408
|
"name": "trigger",
|
|
3283
3409
|
"type": "ReactNode",
|
|
3284
3410
|
"required": false,
|
|
3285
|
-
"doc": "
|
|
3411
|
+
"doc": "触发元素。组件向它注入 `aria-expanded`,须为单个能接收该属性的 React 元素",
|
|
3412
|
+
"values": null
|
|
3413
|
+
},
|
|
3414
|
+
{
|
|
3415
|
+
"name": "anchor",
|
|
3416
|
+
"type": "HTMLElement | null",
|
|
3417
|
+
"required": false,
|
|
3418
|
+
"doc": "外部锚点。触发器由别的组件渲染、只经回调交出元素时传入(例如\n`TopNavigationPrimaryBar` 的 `onAppSwitch` / `onAccount`):面板贴它定位,\n点它不算外部点击(开合由它自己的点击切换),收起时焦点还给它;Tab 顺序按\n「锚点 → 面板 → 锚点之后的元素」接上,面板在 DOM 中不必紧跟锚点。\n\n传了本项即不再渲染 `trigger`,组件根也不占布局;`aria-expanded` 不会注入,\n须由渲染该触发器的组件输出。必须受控使用(`open` + `onOpenChange`)。",
|
|
3286
3419
|
"values": null
|
|
3287
3420
|
},
|
|
3288
3421
|
{
|
|
@@ -3434,7 +3567,7 @@
|
|
|
3434
3567
|
"name": "position",
|
|
3435
3568
|
"type": "'bottom-right' | 'bottom-left' | 'top-right' | 'top-left'",
|
|
3436
3569
|
"required": false,
|
|
3437
|
-
"doc": "
|
|
3570
|
+
"doc": "堆栈位置,默认 `top-right`(07 · C-20)。\n右下角会盖住批量栏、弹窗页脚一类底部动作条,因此不作默认",
|
|
3438
3571
|
"values": [
|
|
3439
3572
|
"bottom-right",
|
|
3440
3573
|
"bottom-left",
|
|
@@ -3488,6 +3621,60 @@
|
|
|
3488
3621
|
}
|
|
3489
3622
|
]
|
|
3490
3623
|
},
|
|
3624
|
+
{
|
|
3625
|
+
"name": "SonnerProvider",
|
|
3626
|
+
"layer": "Foundation",
|
|
3627
|
+
"group": "feedback-overlay",
|
|
3628
|
+
"order": 5,
|
|
3629
|
+
"contract": "contracts/foundation/feedback-overlay/sonner-provider.ts",
|
|
3630
|
+
"summary": "`Sonner` 的调用入口 —— 挂在应用根,子树里任何位置用 `useToast()` 弹出提示。",
|
|
3631
|
+
"doc": "`Sonner` 的调用入口 —— 挂在应用根,子树里任何位置用 `useToast()` 弹出提示。\n\n内部持有提示集合并渲染唯一的 `Sonner`(07 · C-10)。\n\n此前 `Sonner` 只有受控用法:「全应用只挂一个」+「`toasts` 由调用方持有」意味着\n每个项目都要先自建一层 context 才能在页面里弹一条提示(05 · P2-8)。本组件就是\n那层 context,收进库内后各项目不再各写一份。受控的 `Sonner` 保留不变。",
|
|
3632
|
+
"replaces": [],
|
|
3633
|
+
"nativeBase": null,
|
|
3634
|
+
"omitted": [],
|
|
3635
|
+
"props": [
|
|
3636
|
+
{
|
|
3637
|
+
"name": "children",
|
|
3638
|
+
"type": "ReactNode",
|
|
3639
|
+
"required": false,
|
|
3640
|
+
"doc": "应用根的子树。其中任何位置都可以用 `useToast()`",
|
|
3641
|
+
"values": null
|
|
3642
|
+
},
|
|
3643
|
+
{
|
|
3644
|
+
"name": "position",
|
|
3645
|
+
"type": "'bottom-right' | 'bottom-left' | 'top-right' | 'top-left'",
|
|
3646
|
+
"required": false,
|
|
3647
|
+
"doc": "堆栈位置,原样传给内部的 `Sonner`。默认 `top-right`,理由见 `Sonner` 的 `position`",
|
|
3648
|
+
"values": [
|
|
3649
|
+
"bottom-right",
|
|
3650
|
+
"bottom-left",
|
|
3651
|
+
"top-right",
|
|
3652
|
+
"top-left"
|
|
3653
|
+
]
|
|
3654
|
+
},
|
|
3655
|
+
{
|
|
3656
|
+
"name": "className",
|
|
3657
|
+
"type": "string",
|
|
3658
|
+
"required": false,
|
|
3659
|
+
"doc": "追加到内部 `Sonner` 堆栈根上的类名",
|
|
3660
|
+
"values": null
|
|
3661
|
+
}
|
|
3662
|
+
],
|
|
3663
|
+
"helpers": [
|
|
3664
|
+
{
|
|
3665
|
+
"name": "ToastFunction",
|
|
3666
|
+
"doc": "`useToast()` 的返回值。本身可调用:`toast({ title: '已保存', tone: 'success' })`\n弹出一条提示并返回其 id。",
|
|
3667
|
+
"members": [
|
|
3668
|
+
{
|
|
3669
|
+
"name": "dismiss",
|
|
3670
|
+
"type": "(id: string) => void",
|
|
3671
|
+
"required": true,
|
|
3672
|
+
"doc": "按 id 提前消除一条提示,如点了「撤销」之后。自动消失与关闭按钮不需要调它"
|
|
3673
|
+
}
|
|
3674
|
+
]
|
|
3675
|
+
}
|
|
3676
|
+
]
|
|
3677
|
+
},
|
|
3491
3678
|
{
|
|
3492
3679
|
"name": "Spinner",
|
|
3493
3680
|
"layer": "Foundation",
|
|
@@ -3717,7 +3904,7 @@
|
|
|
3717
3904
|
"order": 6,
|
|
3718
3905
|
"contract": "contracts/application-atomic/list-table-pagination.ts",
|
|
3719
3906
|
"summary": "列表 / 表格分页 —— 结果区间、总数、每页条数与翻页步进。",
|
|
3720
|
-
"doc": "列表 / 表格分页 —— 结果区间、总数、每页条数与翻页步进。\n数据展示区的标准页脚,LIST 页面模式的默认配置。\n\n⚠
|
|
3907
|
+
"doc": "列表 / 表格分页 —— 结果区间、总数、每页条数与翻页步进。\n数据展示区的标准页脚,LIST 页面模式的默认配置。\n\n⚠ **分页状态按业务视图各记一份**:切换 Business View 时回到该视图上次所在的页,\n切换 Page Mode 与从详情返回时保持当前页 —— 规范要求恢复来源上下文。\n搜索、筛选、排序变化时复位到第 1 页(07 · C-13)。\n\n没有总数与每页条数需求时,用 Foundation `Pagination`。",
|
|
3721
3908
|
"replaces": [],
|
|
3722
3909
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
3723
3910
|
"omitted": [],
|
|
@@ -3932,48 +4119,56 @@
|
|
|
3932
4119
|
"order": 6,
|
|
3933
4120
|
"contract": "contracts/application-atomic/system-button.ts",
|
|
3934
4121
|
"summary": "应用语义按钮 —— **整个产品的默认动作按钮**。",
|
|
3935
|
-
"doc": "应用语义按钮 —— **整个产品的默认动作按钮**。\n\n它是 Foundation `Button` 之上的薄适配层:只负责应用意图、loading 与产品状态,\n**绝不重新实现按钮的排版与几何**。\n\n⚠ **页面不得自建平台级或业务级的按钮变体。** 改一次应用强调色,\n全部 SystemButton 同时换肤 —— 逐页 fork 会摧毁这个性质。\n\n
|
|
3936
|
-
"replaces": [
|
|
4122
|
+
"doc": "应用语义按钮 —— **整个产品的默认动作按钮**。\n\n它是 Foundation `Button` 之上的薄适配层:只负责应用意图、loading 与产品状态,\n**绝不重新实现按钮的排版与几何**。\n\n⚠ **页面不得自建平台级或业务级的按钮变体。** 改一次应用强调色,\n全部 SystemButton 同时换肤 —— 逐页 fork 会摧毁这个性质。\n\n**业务页面的按钮一律用本组件**,Foundation `Button` 只供库内组件使用\n(实践报告 P1-1 裁决)。",
|
|
4123
|
+
"replaces": [
|
|
4124
|
+
"button"
|
|
4125
|
+
],
|
|
3937
4126
|
"nativeBase": "ButtonHTMLAttributes<HTMLButtonElement>",
|
|
3938
4127
|
"omitted": [],
|
|
3939
4128
|
"props": [
|
|
3940
4129
|
{
|
|
3941
4130
|
"name": "intent",
|
|
3942
|
-
"type": "'primary' | 'secondary' | 'quiet' | '
|
|
4131
|
+
"type": "'primary' | 'secondary' | 'quiet' | 'link' | 'destructive'",
|
|
3943
4132
|
"required": false,
|
|
3944
|
-
"doc": "应用意图。映射到 Foundation Button 的 variant
|
|
4133
|
+
"doc": "应用意图。映射到 Foundation Button 的 variant:`quiet` → ghost,其余同名。",
|
|
3945
4134
|
"values": [
|
|
3946
4135
|
"primary",
|
|
3947
4136
|
"secondary",
|
|
3948
4137
|
"quiet",
|
|
3949
|
-
"icon",
|
|
3950
4138
|
"link",
|
|
3951
4139
|
"destructive"
|
|
3952
4140
|
]
|
|
3953
4141
|
},
|
|
3954
4142
|
{
|
|
3955
4143
|
"name": "size",
|
|
3956
|
-
"type": "'default' | 'compact' | '
|
|
4144
|
+
"type": "'default' | 'compact' | 'sm'",
|
|
3957
4145
|
"required": false,
|
|
3958
|
-
"doc": "尺寸。见 T2 —— `compact` 目前与 `default`
|
|
4146
|
+
"doc": "尺寸。见 T2 —— `compact` 目前与 `default` 无视觉差异。\n`sm` 映射 Foundation Button 的 28px 档,只用于嵌进 32px 控件内部的动作\n(`InputGroup` 的尾部按钮),不得用来压缩页面上的独立按钮。",
|
|
3959
4147
|
"values": [
|
|
3960
4148
|
"default",
|
|
3961
4149
|
"compact",
|
|
3962
|
-
"
|
|
4150
|
+
"sm"
|
|
3963
4151
|
]
|
|
3964
4152
|
},
|
|
4153
|
+
{
|
|
4154
|
+
"name": "iconOnly",
|
|
4155
|
+
"type": "boolean",
|
|
4156
|
+
"required": false,
|
|
4157
|
+
"doc": "等宽图标按钮:宽度收敛为与高度相等,行内内边距归零。直接映射到 Foundation\n`Button` 的 `iconOnly`,与 `intent` / `size` 正交。为 true 时**必须**提供 `aria-label`。",
|
|
4158
|
+
"values": null
|
|
4159
|
+
},
|
|
3965
4160
|
{
|
|
3966
4161
|
"name": "loading",
|
|
3967
4162
|
"type": "boolean",
|
|
3968
4163
|
"required": false,
|
|
3969
|
-
"doc": "加载中。阻断交互并设置 `aria-busy
|
|
4164
|
+
"doc": "加载中。阻断交互并设置 `aria-busy`,同时渲染一个行内转圈;`iconOnly` 时转圈\n替换原图标的位置,按钮尺寸不变。与 `disabled` 都会阻断动作,但语义不同:loading 是暂时的。\n\n实现不用原生 `disabled`:渲染 `aria-disabled=\"true\"` 并在 `onClick` 中\n`preventDefault`(同时挡住 `type=\"submit\"` 的表单提交),按钮保持可聚焦,\n焦点不会在点击后掉到 `<body>`。",
|
|
3970
4165
|
"values": null
|
|
3971
4166
|
},
|
|
3972
4167
|
{
|
|
3973
4168
|
"name": "children",
|
|
3974
4169
|
"type": "ReactNode",
|
|
3975
4170
|
"required": false,
|
|
3976
|
-
"doc": "
|
|
4171
|
+
"doc": "按钮内容。`iconOnly` 时为单个 `Icon` 元素",
|
|
3977
4172
|
"values": null
|
|
3978
4173
|
}
|
|
3979
4174
|
],
|
|
@@ -3986,7 +4181,7 @@
|
|
|
3986
4181
|
"order": 7,
|
|
3987
4182
|
"contract": "contracts/application-module/navigation/application-module-switcher.ts",
|
|
3988
4183
|
"summary": "应用二级导航的**左半部分** —— 你在哪个模块,以及如何切换。",
|
|
3989
|
-
"doc": "应用二级导航的**左半部分** —— 你在哪个模块,以及如何切换。\n\n### 触发器\nStandard 最小宽 168 / 高 40,Compact 148 / 32;\
|
|
4184
|
+
"doc": "应用二级导航的**左半部分** —— 你在哪个模块,以及如何切换。\n\n### 触发器\nStandard 最小宽 168 / 高 40,Compact 148 / 32;\n32×32 浅灰底图标块(8px 圆角,18px 正文色字形,`--ui-shell-module-switch-icon-*`),\n名称 16/20 **700**,14px chevron 右对齐。\n\n⚠ **绝不能简化成一个小图标,也绝不能移除。**\n\n### 面板\n`position: fixed`,`top: --ui-shell-application-total-height`,\n`left: 0`,`bottom: 0`,宽 `--ui-shell-module-switch-panel-width`(320px,受视口限制),白色表面,\n**1px 右边线,无圆角,无阴影**,自带垂直滚动。\n条目最小高 40,内边距 8/12,圆角 12,文字 14/22。\n\n⚠ **点击当前模块不发生跳转。** 路由计算由调用方负责。\n\n### 键盘\n按 WAI-ARIA menu button 模式:打开即聚焦首个可用模块(触发器上按 ↑ 打开则聚焦末项),\n↑ / ↓ / Home / End 在模块间移动并跳过禁用项,Esc 与外部点击经 `onOpenChange(false)`\n收起,Esc 后焦点回到触发器,Tab 收起面板并离开。",
|
|
3990
4185
|
"replaces": [],
|
|
3991
4186
|
"nativeBase": "ButtonHTMLAttributes<HTMLButtonElement>",
|
|
3992
4187
|
"omitted": [
|
|
@@ -4083,7 +4278,7 @@
|
|
|
4083
4278
|
"order": 7,
|
|
4084
4279
|
"contract": "contracts/application-module/navigation/application-primary-navigation.ts",
|
|
4085
4280
|
"summary": "`APPLICATION.PRIMARY_NAV` —— 固定 Shell 的**第二带**。",
|
|
4086
|
-
"doc": "`APPLICATION.PRIMARY_NAV` —— 固定 Shell 的**第二带**。\nStandard 64px / Compact 52px。\n\n**左侧**:应用身份 —— logo 48×48(Compact 40×40)置于 8% 强调色瓦片上,\n名称 16/24 **700**,说明 12/16 400(Compact
|
|
4281
|
+
"doc": "`APPLICATION.PRIMARY_NAV` —— 固定 Shell 的**第二带**。\nStandard 64px / Compact 52px。\n\n**左侧**:应用身份 —— logo 48×48(Compact 40×40)置于 8% 强调色瓦片上,\n名称 16/24 **700**,说明 12/16 400(Compact 档隐藏)。\n\nCompact 档由 `@media` 驱动(07 · C-18),与 Shell 三带 52/64/48 → 44/52/40 同一断点:\n视口宽 ≤1180px 或高 ≤720px。调用方不必、也不得自行判定断点。\n\n**右侧**:**恰好这五个已登记全局动作,且顺序固定**:\n\n 消息 → 待办 → 运行总览 → 风险预警 → 设置\n\n32×32 触发器,18px 字形,8px 间距。\n前四个打开共享 Popover,**设置打开 Drawer**。\n\n### ⚠ 硬性约束\n- **绝不渲染第二个设置入口**\n- logo 瓦片是 8% 强调色混入表面色,**绝不是饱和强调色块**\n- Compact 档可隐藏说明,但**必须保留** logo、名称与全部五个动作入口",
|
|
4087
4282
|
"replaces": [],
|
|
4088
4283
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
4089
4284
|
"omitted": [],
|
|
@@ -4104,10 +4299,44 @@
|
|
|
4104
4299
|
},
|
|
4105
4300
|
{
|
|
4106
4301
|
"name": "appGlyph",
|
|
4107
|
-
"type": "
|
|
4302
|
+
"type": "IconName",
|
|
4108
4303
|
"required": false,
|
|
4109
|
-
"doc": "应用 logo mock 字形的图标名(24px
|
|
4110
|
-
"values":
|
|
4304
|
+
"doc": "应用 logo mock 字形的图标名(24px),默认 `'shield-check'`。\n与 `<Icon name>` 同为已登记字形名(05 · P1-6),清单外的名字在类型层被拒",
|
|
4305
|
+
"values": [
|
|
4306
|
+
"activity",
|
|
4307
|
+
"arrow-down",
|
|
4308
|
+
"arrow-up",
|
|
4309
|
+
"calendar",
|
|
4310
|
+
"check",
|
|
4311
|
+
"chevron-down",
|
|
4312
|
+
"chevron-left",
|
|
4313
|
+
"chevron-right",
|
|
4314
|
+
"chevron-up",
|
|
4315
|
+
"circle-alert",
|
|
4316
|
+
"circle-check",
|
|
4317
|
+
"circle-check-big",
|
|
4318
|
+
"columns-2",
|
|
4319
|
+
"download",
|
|
4320
|
+
"ellipsis",
|
|
4321
|
+
"funnel",
|
|
4322
|
+
"info",
|
|
4323
|
+
"kanban",
|
|
4324
|
+
"layout-grid",
|
|
4325
|
+
"list",
|
|
4326
|
+
"message-square",
|
|
4327
|
+
"minus",
|
|
4328
|
+
"pencil",
|
|
4329
|
+
"plus",
|
|
4330
|
+
"refresh-cw",
|
|
4331
|
+
"search",
|
|
4332
|
+
"settings",
|
|
4333
|
+
"shield-check",
|
|
4334
|
+
"sliders-horizontal",
|
|
4335
|
+
"trash-2",
|
|
4336
|
+
"triangle-alert",
|
|
4337
|
+
"upload",
|
|
4338
|
+
"x"
|
|
4339
|
+
]
|
|
4111
4340
|
},
|
|
4112
4341
|
{
|
|
4113
4342
|
"name": "activeAction",
|
|
@@ -4140,7 +4369,7 @@
|
|
|
4140
4369
|
"name": "compact",
|
|
4141
4370
|
"type": "boolean",
|
|
4142
4371
|
"required": false,
|
|
4143
|
-
"doc": "Compact
|
|
4372
|
+
"doc": "强制 Compact 档:隐藏应用说明,其余一律保留。",
|
|
4144
4373
|
"values": null
|
|
4145
4374
|
}
|
|
4146
4375
|
],
|
|
@@ -4257,7 +4486,7 @@
|
|
|
4257
4486
|
"name": "footer",
|
|
4258
4487
|
"type": "ReactNode",
|
|
4259
4488
|
"required": false,
|
|
4260
|
-
"doc": "
|
|
4489
|
+
"doc": "栏底内容。栏底入口(如「设置」)直接放 `SidebarRailButton`(07 · C-15)",
|
|
4261
4490
|
"values": null
|
|
4262
4491
|
}
|
|
4263
4492
|
],
|
|
@@ -4307,7 +4536,7 @@
|
|
|
4307
4536
|
"order": 7,
|
|
4308
4537
|
"contract": "contracts/application-module/navigation/top-navigation-primary-bar.ts",
|
|
4309
4538
|
"summary": "`PLATFORM.TOP_USER_BAR` —— 固定 Shell 的**第一带**。",
|
|
4310
|
-
"doc": "`PLATFORM.TOP_USER_BAR` —— 固定 Shell 的**第一带**。\nStandard 52px / Compact 44px,**没有第三种高度**。\n\n栅格 `auto minmax(0,1fr) auto`;应用切换与账户触发器 32×32,\n动作簇间距 10px,右边距 12px。\n\n### ⚠ 品牌标识必须始终可见\n没有真实的 120×32 资产时,渲染已登记的 mock:\n**28×28 纯色块 + 8px 间隙 + 企业名称(14/20 700)**。\n色块内部**不得**再绘制伪 Logo。\n\n### ⚠ Shell 契约禁止添加未登记元素\n
|
|
4539
|
+
"doc": "`PLATFORM.TOP_USER_BAR` —— 固定 Shell 的**第一带**。\nStandard 52px / Compact 44px,**没有第三种高度**。\n\n栅格 `auto minmax(0,1fr) auto`;应用切换与账户触发器 32×32,\n动作簇间距 10px,右边距 12px。\n\n### ⚠ 品牌标识必须始终可见\n没有真实的 120×32 资产时,渲染已登记的 mock:\n**28×28 纯色块 + 8px 间隙 + 企业名称(14/20 700)**。\n色块内部**不得**再绘制伪 Logo。\n\n### ⚠ Shell 契约禁止添加未登记元素\n不得加搜索框、面包屑、通知铃铛、页面标题、卡片或阴影。\n\n### 两个面板的接法(06 · P1-13)\n回调交出被点的触发器,传给 `Popover` 的 `anchor` 即可锚定;开合由调用方受控,\n同时回写 `appSwitchOpen` / `accountOpen`,触发器据此输出 `aria-expanded`。\n再点触发器即收起 —— Popover 不把外部锚点上的点击当作外部点击。写法:回调里\n记下触发器并切换开合(`setAnchor(trigger); setOpen((v) => !v)`),Popover 传\n`anchor={anchor} open={open} onOpenChange={setOpen}`。",
|
|
4311
4540
|
"replaces": [],
|
|
4312
4541
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
4313
4542
|
"omitted": [],
|
|
@@ -4337,21 +4566,35 @@
|
|
|
4337
4566
|
"name": "accountName",
|
|
4338
4567
|
"type": "string",
|
|
4339
4568
|
"required": false,
|
|
4340
|
-
"doc": "
|
|
4569
|
+
"doc": "账户名。同时是账户按钮的可访问名与头像缩写的来源;缩写规则与 `Avatar` 相同 ——\n中文取末字(「成员 A」→「A」),拉丁名取首字母(07 · C-8)。缺省时头像显示「账」",
|
|
4341
4570
|
"values": null
|
|
4342
4571
|
},
|
|
4343
4572
|
{
|
|
4344
4573
|
"name": "onAppSwitch",
|
|
4345
|
-
"type": "() => void",
|
|
4574
|
+
"type": "(trigger: HTMLButtonElement) => void",
|
|
4346
4575
|
"required": false,
|
|
4347
|
-
"doc": "
|
|
4576
|
+
"doc": "应用切换回调。参数是被点的触发器,供 `Popover` 的 `anchor` 锚定;\n不需要锚定的调用方照旧写无参函数",
|
|
4348
4577
|
"values": null
|
|
4349
4578
|
},
|
|
4350
4579
|
{
|
|
4351
4580
|
"name": "onAccount",
|
|
4352
|
-
"type": "() => void",
|
|
4581
|
+
"type": "(trigger: HTMLButtonElement) => void",
|
|
4353
4582
|
"required": false,
|
|
4354
|
-
"doc": "
|
|
4583
|
+
"doc": "账户菜单回调。参数同 `onAppSwitch`",
|
|
4584
|
+
"values": null
|
|
4585
|
+
},
|
|
4586
|
+
{
|
|
4587
|
+
"name": "appSwitchOpen",
|
|
4588
|
+
"type": "boolean",
|
|
4589
|
+
"required": false,
|
|
4590
|
+
"doc": "应用切换面板是否展开。传入(含 `false`)即声明该触发器控制一个弹出面板:\n输出 `aria-haspopup=\"dialog\"` 与 `aria-expanded`。缺省时两者都不输出 ——\n不知道面板开没开,宁可不说也不能说错。面板内容根应声明 `role=\"dialog\"` 与可访问名",
|
|
4591
|
+
"values": null
|
|
4592
|
+
},
|
|
4593
|
+
{
|
|
4594
|
+
"name": "accountOpen",
|
|
4595
|
+
"type": "boolean",
|
|
4596
|
+
"required": false,
|
|
4597
|
+
"doc": "账户面板是否展开。语义同 `appSwitchOpen`",
|
|
4355
4598
|
"values": null
|
|
4356
4599
|
}
|
|
4357
4600
|
],
|
|
@@ -4394,7 +4637,7 @@
|
|
|
4394
4637
|
"name": "data",
|
|
4395
4638
|
"type": "number[]",
|
|
4396
4639
|
"required": false,
|
|
4397
|
-
"doc": "
|
|
4640
|
+
"doc": "走势数据点。纵轴按本组数据的 min–max 归一化(不从 0 起算),\n只表达形状、不表达绝对量级;全部相等时画在中线",
|
|
4398
4641
|
"values": null
|
|
4399
4642
|
},
|
|
4400
4643
|
{
|
|
@@ -4677,7 +4920,7 @@
|
|
|
4677
4920
|
"order": 8,
|
|
4678
4921
|
"contract": "contracts/application-module/statistics/metrics.ts",
|
|
4679
4922
|
"summary": "指标区容器,同时承载 `numeric` 与 `icon` 两种基础语义。",
|
|
4680
|
-
"doc": "指标区容器,同时承载 `numeric` 与 `icon` 两种基础语义。\n\n其他语义的卡片作为 `children`
|
|
4923
|
+
"doc": "指标区容器,同时承载 `numeric` 与 `icon` 两种基础语义。\n\n其他语义的卡片作为 `children` 传入,由本容器统一等高排列。\n\n⚠ 加载与失败由 `state` 表达(06 · P2-10):`loading` 渲染与卡片同壳同高的骨架,\n`error` 渲染一张横跨整行的卡片承载 `error` 节点。两者都不是「无指标」的替身 ——\n页面没有真实指标时仍是整个区域不渲染。",
|
|
4681
4924
|
"replaces": [],
|
|
4682
4925
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
4683
4926
|
"omitted": [],
|
|
@@ -4693,7 +4936,7 @@
|
|
|
4693
4936
|
"name": "columns",
|
|
4694
4937
|
"type": "number",
|
|
4695
4938
|
"required": false,
|
|
4696
|
-
"doc": "
|
|
4939
|
+
"doc": "列数。默认取卡片总数 —— `metrics` 条目数加 `children` 中的卡片数\n(null / false / undefined 不计入),钳在 1–6 之间",
|
|
4697
4940
|
"values": null
|
|
4698
4941
|
},
|
|
4699
4942
|
{
|
|
@@ -4702,6 +4945,24 @@
|
|
|
4702
4945
|
"required": false,
|
|
4703
4946
|
"doc": "其他语义的指标卡(trend / chart / status / primary-secondary)",
|
|
4704
4947
|
"values": null
|
|
4948
|
+
},
|
|
4949
|
+
{
|
|
4950
|
+
"name": "state",
|
|
4951
|
+
"type": "MetricStripState",
|
|
4952
|
+
"required": false,
|
|
4953
|
+
"doc": "加载状态,默认 `ready`。`loading` 时不渲染 `metrics` 与 `children`,改渲染\n内置骨架:张数同 `columns` 的缺省算法(无卡片时为 4),每张与指标卡同壳同高;\n`error` 时渲染一张横跨整行的卡片,内容取 `error`",
|
|
4954
|
+
"values": [
|
|
4955
|
+
"ready",
|
|
4956
|
+
"loading",
|
|
4957
|
+
"error"
|
|
4958
|
+
]
|
|
4959
|
+
},
|
|
4960
|
+
{
|
|
4961
|
+
"name": "error",
|
|
4962
|
+
"type": "ReactNode",
|
|
4963
|
+
"required": false,
|
|
4964
|
+
"doc": "`state=\"error\"` 时的内容。应说明失败原因并提供重试(如「指标加载失败」+「重试」),\n措辞不得与数据展示区的 Error 共用。不传时显示内置的「指标加载失败」",
|
|
4965
|
+
"values": null
|
|
4705
4966
|
}
|
|
4706
4967
|
],
|
|
4707
4968
|
"helpers": [
|
|
@@ -4884,7 +5145,7 @@
|
|
|
4884
5145
|
"order": 9,
|
|
4885
5146
|
"contract": "contracts/application-module/content/application-data-display.ts",
|
|
4886
5147
|
"summary": "Canvas 的**数据展示区**。",
|
|
4887
|
-
"doc": "Canvas 的**数据展示区**。\n\n承载**恰好一种** Data Presentation,外加它的选择态、分页与局部系统状态。\n\n⚠ **绝不持有第二套独立的查询状态** —— 搜索、筛选、排序全部属于\n`ApplicationQueryToolbar`。本区域只负责展示与选择。\n\n⚠ **同一个呈现组件必须能同时服务 LIST 页面模式与 SPLIT 右栏。**\n为同一份业务数据写两套近乎相同的实现是被禁止的。\n\n⚠ **六种状态各有各的节点与各自的措辞。**\nLoading / Empty / Error / No Permission / Not Found 绝不共用文案 ——\n
|
|
5148
|
+
"doc": "Canvas 的**数据展示区**。\n\n承载**恰好一种** Data Presentation,外加它的选择态、分页与局部系统状态。\n\n⚠ **绝不持有第二套独立的查询状态** —— 搜索、筛选、排序全部属于\n`ApplicationQueryToolbar`。本区域只负责展示与选择。\n\n⚠ **同一个呈现组件必须能同时服务 LIST 页面模式与 SPLIT 右栏。**\n为同一份业务数据写两套近乎相同的实现是被禁止的。\n\n⚠ **六种状态各有各的节点与各自的措辞。**\nLoading / Empty / Error / No Permission / Not Found 绝不共用文案 ——\n「当前口径下无数据」「你没有权限」「未找到」「请求失败」是四句不同的话。\n第六种 Partial Failure 不替换呈现,而是在 ready 态经 `notice` 叠一条 `Alert`。",
|
|
4888
5149
|
"replaces": [],
|
|
4889
5150
|
"nativeBase": "HTMLAttributes<HTMLElement>",
|
|
4890
5151
|
"omitted": [],
|
|
@@ -4894,7 +5155,15 @@
|
|
|
4894
5155
|
"type": "DataPresentation",
|
|
4895
5156
|
"required": false,
|
|
4896
5157
|
"doc": "当前呈现方式。应与 `ApplicationQueryToolbar` 的取值保持一致",
|
|
4897
|
-
"values":
|
|
5158
|
+
"values": [
|
|
5159
|
+
"DataTable",
|
|
5160
|
+
"RecordList",
|
|
5161
|
+
"CardList",
|
|
5162
|
+
"KanbanBoard",
|
|
5163
|
+
"Calendar",
|
|
5164
|
+
"Chart",
|
|
5165
|
+
"Timeline"
|
|
5166
|
+
]
|
|
4898
5167
|
},
|
|
4899
5168
|
{
|
|
4900
5169
|
"name": "state",
|
|
@@ -4917,6 +5186,13 @@
|
|
|
4917
5186
|
"doc": "批量动作条,应传 `ListBatchActionBar`。有记录被选中时才出现",
|
|
4918
5187
|
"values": null
|
|
4919
5188
|
},
|
|
5189
|
+
{
|
|
5190
|
+
"name": "notice",
|
|
5191
|
+
"type": "ReactNode",
|
|
5192
|
+
"required": false,
|
|
5193
|
+
"doc": "区域级提示,承载 **Partial Failure**(05 · P2-2):应传 `Alert`,说明哪部分没取到并给出重试。\n\n固定在批量条之下、呈现之上,**不随内容滚动**;**只在 `state=\"ready\"` 时渲染** ——\n其余五种状态整块换成对应槽位,部分失败无从谈起。此前没有这个位置,调用方只能把\nAlert 塞进 `children` 顶部,与呈现组件同处滚动区,滚走后读者就看不到哪些字段缺失。",
|
|
5194
|
+
"values": null
|
|
5195
|
+
},
|
|
4920
5196
|
{
|
|
4921
5197
|
"name": "pagination",
|
|
4922
5198
|
"type": "ReactNode",
|
|
@@ -4965,6 +5241,13 @@
|
|
|
4965
5241
|
"required": false,
|
|
4966
5242
|
"doc": "`state=\"ready\"` 时渲染的呈现组件",
|
|
4967
5243
|
"values": null
|
|
5244
|
+
},
|
|
5245
|
+
{
|
|
5246
|
+
"name": "bodyRef",
|
|
5247
|
+
"type": "Ref<HTMLDivElement>",
|
|
5248
|
+
"required": false,
|
|
5249
|
+
"doc": "主体滚动容器的 ref —— 批量条与分页之间、自身滚动的那一层(06 · P2-4)。\n\n供「从详情返回列表时还原滚动位置」:离开前读它的 `scrollTop` 存进跨路由存活的\n状态,回来后在 `state` 首次变为 `ready` 时写回。主体容器跨状态切换不重建,\n同一个 ref 在 loading → ready 之间一直指向同一个元素。\n\n走具名 prop 而不是 `ref`:`ref` 在 React 18 不交给函数组件,且根元素也不是\n滚动的那一层;具名 prop 在 18 与 19 下行为一致。",
|
|
5250
|
+
"values": null
|
|
4968
5251
|
}
|
|
4969
5252
|
],
|
|
4970
5253
|
"helpers": []
|
|
@@ -4976,7 +5259,7 @@
|
|
|
4976
5259
|
"order": 9,
|
|
4977
5260
|
"contract": "contracts/application-module/content/application-filter-list.ts",
|
|
4978
5261
|
"summary": "完整的筛选维度列表 —— **「更多筛选」的面板主体**。",
|
|
4979
|
-
"doc": "完整的筛选维度列表 —— **「更多筛选」的面板主体**。\n\n⚠
|
|
5262
|
+
"doc": "完整的筛选维度列表 —— **「更多筛选」的面板主体**。\n\n⚠ **必须包含搜索**,外加常用筛选之外的每一个可筛选维度 ——\n常用筛选里出现的维度不再进「更多筛选」,同一维度只有一个入口(07 · C-11)。\n\n⚠ **它持有草稿:在点「应用」之前,任何改动都不生效。**\n\n⚠ 应用后,**每一条生效条件都必须回写到查询工具栏的筛选标签行**,\n且用户能逐个移除。筛选状态只存在于面板内部是不合规的。",
|
|
4980
5263
|
"replaces": [],
|
|
4981
5264
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
4982
5265
|
"omitted": [
|
|
@@ -5120,7 +5403,7 @@
|
|
|
5120
5403
|
"name": "updatedAt",
|
|
5121
5404
|
"type": "string",
|
|
5122
5405
|
"required": false,
|
|
5123
|
-
"doc": "
|
|
5406
|
+
"doc": "最后更新时刻,只写 `HH:mm`(如 `09:12`,07 · C-12)。仅在 `normal` 状态显示为「更新于 09:12」",
|
|
5124
5407
|
"values": null
|
|
5125
5408
|
},
|
|
5126
5409
|
{
|
|
@@ -5181,11 +5464,25 @@
|
|
|
5181
5464
|
"order": 9,
|
|
5182
5465
|
"contract": "contracts/application-module/content/application-page-layout-container.ts",
|
|
5183
5466
|
"summary": "每个业务页面的脚手架 —— 直接放进 Content Canvas 内。",
|
|
5184
|
-
"doc": "每个业务页面的脚手架 —— 直接放进 Content Canvas 内。\n\n把 Canvas 组织为**固定顺序**的标准区域:\n\n 上下文区 → 指标区(可选)→ 数据控制 → 数据展示\n\n**区域顺序不可调整。**\n\n本组件拥有页面内容根的内边距与间隙(Standard 12px / Condensed 10px /\nCompact 8px,来自 `--ui-page-gutter` 与 `--ui-section-gap`)。\nContent Canvas 宿主自身内边距为零,因此不会产生双重外边距 ——\n**不要在它外面再包一层自己的 padding。**\n\n⚠ 页面没有真实指标时传 `metrics={undefined}
|
|
5467
|
+
"doc": "每个业务页面的脚手架 —— 直接放进 Content Canvas 内。\n\n把 Canvas 组织为**固定顺序**的标准区域:\n\n 上下文区 → 指标区(可选)→ 数据控制 → 数据展示\n\n**区域顺序不可调整。**\n\n本组件拥有页面内容根的内边距与间隙(Standard 12px / Condensed 10px /\nCompact 8px,来自 `--ui-page-gutter` 与 `--ui-section-gap`)。\nContent Canvas 宿主自身内边距为零,因此不会产生双重外边距 ——\n**不要在它外面再包一层自己的 padding。**\n\n⚠ 页面没有真实指标时传 `metrics={undefined}`,**绝不用占位卡凑数**。\n\n`pageType` 必填:五层 Canvas 模型的 L1 只有本组件这一个承载者,\n不传即结构不完整(实践报告 P1-2)。",
|
|
5185
5468
|
"replaces": [],
|
|
5186
5469
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
5187
5470
|
"omitted": [],
|
|
5188
5471
|
"props": [
|
|
5472
|
+
{
|
|
5473
|
+
"name": "pageType",
|
|
5474
|
+
"type": "'WORKBENCH' | 'MANAGEMENT' | 'LEDGER' | 'ANALYSIS' | 'REPORT' | 'DETAIL'",
|
|
5475
|
+
"required": true,
|
|
5476
|
+
"doc": "L1 页面类型。输出为根节点的 `data-page-type`,不改变区域顺序与留白。\n\n唯一受它影响的是纵向尺寸:`DETAIL` 页的容器随内容增高、由 Content Canvas\n滚动;其余页型的容器可收缩到 Canvas 高度,数据展示区拿到剩余高度后\n由 `ApplicationDataDisplay` 内部滚动。\n\n`DETAIL` 页的内容结构用 `ApplicationRecordDetailBody`,仍以本组件为内容根。",
|
|
5477
|
+
"values": [
|
|
5478
|
+
"WORKBENCH",
|
|
5479
|
+
"MANAGEMENT",
|
|
5480
|
+
"LEDGER",
|
|
5481
|
+
"ANALYSIS",
|
|
5482
|
+
"REPORT",
|
|
5483
|
+
"DETAIL"
|
|
5484
|
+
]
|
|
5485
|
+
},
|
|
5189
5486
|
{
|
|
5190
5487
|
"name": "header",
|
|
5191
5488
|
"type": "ReactNode",
|
|
@@ -5224,7 +5521,7 @@
|
|
|
5224
5521
|
"order": 9,
|
|
5225
5522
|
"contract": "contracts/application-module/content/application-query-toolbar.ts",
|
|
5226
5523
|
"summary": "**数据控制区** —— 统一承载 Canvas 五层模型的 L3 业务视图与 L4 数据控制。",
|
|
5227
|
-
"doc": "**数据控制区** —— 统一承载 Canvas 五层模型的 L3 业务视图与 L4 数据控制。\n\n### 固定三行契约\n\n| 行 | 内容 | 渲染条件 |\n|---|---|---|\n| 1 | 业务视图标签(2–4 个稳定工作视角) | 仅当确有视图 |\n| 2 | 结果摘要 │ 搜索 + 常用筛选 + 更多 │ 排序 + 呈现设置 | always |\n| 3 | 已生效筛选标签(可移除 + 重置全部) | 仅当有筛选生效 |\n\n### ⚠ 搜索\n**通过 Enter 或明确的搜索动作提交,绝不逐字实时搜索。**\n\n### ⚠ 筛选\n工具栏内常驻 **2–3 个**常用筛选,其余进「更多筛选」,\n由「应用」提交,并**回写到第三行的标签**。\n\n### ⚠ 呈现设置按钮必须按当前呈现方式命名\nDataTable → 列设置 · CardList → 卡片设置 · KanbanBoard → 看板设置 ·\nCalendar → 日历设置 · Chart → 图表设置 · Timeline → 时间轴设置。\n**通用的「视图设置」被明令禁止。**\n无真实可配置项时(`hasPresentationSettings={false}`)按钮不渲染且不占位。\n每种呈现方式**各自独立存储**其设置。\n\n### ⚠ Page Mode Switch 不属于本组件\n它位于上下文区(`ApplicationPageHeader`)。\n`viewModeSwitch` **仅用于 SPLIT 右栏**,且只改 `dataPresentation`,永不改 `pageMode`。",
|
|
5524
|
+
"doc": "**数据控制区** —— 统一承载 Canvas 五层模型的 L3 业务视图与 L4 数据控制。\n\n### 固定三行契约\n\n| 行 | 内容 | 渲染条件 |\n|---|---|---|\n| 1 | 业务视图标签(2–4 个稳定工作视角) | 仅当确有视图 |\n| 2 | 结果摘要 │ 搜索 + 常用筛选 + 更多 │ 排序 + 呈现设置 | always |\n| 3 | 已生效筛选标签(可移除 + 重置全部) | 仅当有筛选生效 |\n\n### ⚠ 搜索\n**通过 Enter 或明确的搜索动作提交,绝不逐字实时搜索。**\n\n### ⚠ 筛选\n工具栏内常驻 **2–3 个**常用筛选,其余进「更多筛选」,\n由「应用」提交,并**回写到第三行的标签**。\n\n### ⚠ 呈现设置按钮必须按当前呈现方式命名\nDataTable → 列设置 · RecordList → 列表设置 · CardList → 卡片设置 · KanbanBoard → 看板设置 ·\nCalendar → 日历设置 · Chart → 图表设置 · Timeline → 时间轴设置。\n**通用的「视图设置」被明令禁止。**\n无真实可配置项时(`hasPresentationSettings={false}`,或不传\n`onPresentationSettings`)按钮不渲染且不占位。\n每种呈现方式**各自独立存储**其设置。\n\n### ⚠ Page Mode Switch 不属于本组件\n它位于上下文区(`ApplicationPageHeader`)。\n`viewModeSwitch` **仅用于 SPLIT 右栏**,且只改 `dataPresentation`,永不改 `pageMode`。",
|
|
5228
5525
|
"replaces": [],
|
|
5229
5526
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
5230
5527
|
"omitted": [],
|
|
@@ -5282,7 +5579,14 @@
|
|
|
5282
5579
|
"name": "searchPlaceholder",
|
|
5283
5580
|
"type": "string",
|
|
5284
5581
|
"required": false,
|
|
5285
|
-
"doc": "
|
|
5582
|
+
"doc": "搜索占位文字。应写明搜索范围,如「搜索任务名称或编号」。\n\n**无默认值**(05 · P1-7):此前缺省为 `'搜索'`,不传即违反 SearchField\n「不得写成不含范围的『搜索』」,且同时充当可访问名。缺省时占位文字取\n`searchAriaLabel`,二者都缺省则不显示占位文字。",
|
|
5583
|
+
"values": null
|
|
5584
|
+
},
|
|
5585
|
+
{
|
|
5586
|
+
"name": "searchAriaLabel",
|
|
5587
|
+
"type": "string",
|
|
5588
|
+
"required": false,
|
|
5589
|
+
"doc": "搜索框的可访问名,必须写明搜索范围。优先级:本 prop → `searchPlaceholder`。\n\n占位文字写示例、可访问名写范围时分开传;二者同文时只传 `searchPlaceholder`\n即可。两者都缺省时可访问名回落为「搜索当前结果」并在开发构建下告警一次 ——\nSearchField 的 `ariaLabel` 必填,不能留空,而写明范围只有调用方做得到(05 · P1-7)",
|
|
5286
5590
|
"values": null
|
|
5287
5591
|
},
|
|
5288
5592
|
{
|
|
@@ -5296,14 +5600,14 @@
|
|
|
5296
5600
|
"name": "moreFilters",
|
|
5297
5601
|
"type": "ReactNode",
|
|
5298
5602
|
"required": false,
|
|
5299
|
-
"doc": "
|
|
5603
|
+
"doc": "「更多筛选」触发器,一律是 `Popover` 承载的 `ApplicationFilterList`;不得用 `Collapsible` 就地展开(06 · D-4)",
|
|
5300
5604
|
"values": null
|
|
5301
5605
|
},
|
|
5302
5606
|
{
|
|
5303
5607
|
"name": "sort",
|
|
5304
5608
|
"type": "ReactNode",
|
|
5305
5609
|
"required": false,
|
|
5306
|
-
"doc": "
|
|
5610
|
+
"doc": "排序控件,传 `Select`。DataTable 呈现下表头排序是第二入口,两处共享同一份排序状态(07 · C-2)",
|
|
5307
5611
|
"values": null
|
|
5308
5612
|
},
|
|
5309
5613
|
{
|
|
@@ -5334,6 +5638,7 @@
|
|
|
5334
5638
|
"doc": "当前呈现方式。**决定呈现设置按钮的文案**",
|
|
5335
5639
|
"values": [
|
|
5336
5640
|
"DataTable",
|
|
5641
|
+
"RecordList",
|
|
5337
5642
|
"CardList",
|
|
5338
5643
|
"KanbanBoard",
|
|
5339
5644
|
"Calendar",
|
|
@@ -5345,14 +5650,21 @@
|
|
|
5345
5650
|
"name": "hasPresentationSettings",
|
|
5346
5651
|
"type": "boolean",
|
|
5347
5652
|
"required": false,
|
|
5348
|
-
"doc": "是否有可配置的呈现设置。false
|
|
5653
|
+
"doc": "是否有可配置的呈现设置。false 时按钮不渲染且不占位。\n\n缺省时按是否提供 `onPresentationSettings` 推断(05 · P1-7):此前缺省为\n`true`,不传即渲染一个点了没反应的设置按钮,默认值站在了违规一边。\n显式传入仍优先",
|
|
5349
5654
|
"values": null
|
|
5350
5655
|
},
|
|
5351
5656
|
{
|
|
5352
5657
|
"name": "onPresentationSettings",
|
|
5353
|
-
"type": "() => void",
|
|
5658
|
+
"type": "(event: MouseEvent<HTMLButtonElement>) => void",
|
|
5354
5659
|
"required": false,
|
|
5355
|
-
"doc": "
|
|
5660
|
+
"doc": "呈现设置点击回调。参数是按钮的点击事件,`event.currentTarget` 即设置按钮本身,\n供调用方把面板锚定在它上面、或关闭后把焦点还给它(06 · P2-6)。\n不读参数的无参回调照旧可用",
|
|
5661
|
+
"values": null
|
|
5662
|
+
},
|
|
5663
|
+
{
|
|
5664
|
+
"name": "presentationSettingsOpen",
|
|
5665
|
+
"type": "boolean",
|
|
5666
|
+
"required": false,
|
|
5667
|
+
"doc": "呈现设置面板当前是否展开。传入后设置按钮输出 `aria-expanded`,读屏据此报出开合;\n不传则不输出 —— 面板由调用方持有,组件无从得知开合,宁可不报也不报错(06 · P2-6)",
|
|
5356
5668
|
"values": null
|
|
5357
5669
|
},
|
|
5358
5670
|
{
|
|
@@ -5532,16 +5844,23 @@
|
|
|
5532
5844
|
},
|
|
5533
5845
|
{
|
|
5534
5846
|
"name": "value",
|
|
5535
|
-
"type": "string",
|
|
5847
|
+
"type": "string | null",
|
|
5536
5848
|
"required": false,
|
|
5537
|
-
"doc": "当前选中项。`undefined`
|
|
5849
|
+
"doc": "当前选中项。`undefined` 与 `null` 都表示未定位,是合法状态",
|
|
5538
5850
|
"values": null
|
|
5539
5851
|
},
|
|
5540
5852
|
{
|
|
5541
5853
|
"name": "onValueChange",
|
|
5542
5854
|
"type": "(value: string) => void",
|
|
5543
5855
|
"required": false,
|
|
5544
|
-
"doc": "
|
|
5856
|
+
"doc": "选中项变化回调。只回传条目值,不回传 `null` —— 取消定位走 `onClear`",
|
|
5857
|
+
"values": null
|
|
5858
|
+
},
|
|
5859
|
+
{
|
|
5860
|
+
"name": "onClear",
|
|
5861
|
+
"type": "() => void",
|
|
5862
|
+
"required": false,
|
|
5863
|
+
"doc": "取消定位回调(06 · P2-1)。提供时**再次选择当前项即取消定位**(点击或 Enter / 空格),\n调用方在此把 `value` 写回 `null`;当前项另带描述「再次选择取消定位」。\n不提供时再次选择当前项照旧回调 `onValueChange`,不会取消定位",
|
|
5545
5864
|
"values": null
|
|
5546
5865
|
},
|
|
5547
5866
|
{
|
|
@@ -5612,7 +5931,7 @@
|
|
|
5612
5931
|
"order": 10,
|
|
5613
5932
|
"contract": "contracts/application-module/lists/application-record-list.ts",
|
|
5614
5933
|
"summary": "结构化记录列表 —— 非表格形态的 `structured list` 数据呈现方式。",
|
|
5615
|
-
"doc": "结构化记录列表 —— 非表格形态的 `structured list` 数据呈现方式。\n\n适用于表格列数过剩、但行仍需扫视的场景。\n\n⚠
|
|
5934
|
+
"doc": "结构化记录列表 —— 非表格形态的 `structured list` 数据呈现方式。\n\n适用于表格列数过剩、但行仍需扫视的场景。\n\n⚠ **记录级动作位于行尾** —— 点动作绝不能顺带打开详情。行点击忽略来自行内\n可交互元素的事件,`renderRow` 接管时同样成立,调用方不必手动阻止冒泡。\n勾选记录应唤出 `ListBatchActionBar`。\n\n⚠ 与 DataTable 一样,它的呈现设置按钮读作**「列设置」**。\n\n⚠ 右键菜单绝不能是某个动作的唯一入口 —— 动作必须同时出现在行尾或详情中。",
|
|
5616
5935
|
"replaces": [],
|
|
5617
5936
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
5618
5937
|
"omitted": [],
|
|
@@ -5628,7 +5947,7 @@
|
|
|
5628
5947
|
"name": "selectable",
|
|
5629
5948
|
"type": "boolean",
|
|
5630
5949
|
"required": false,
|
|
5631
|
-
"doc": "
|
|
5950
|
+
"doc": "启用行选择。为 true 时行首渲染勾选框,列表顶部另有一行吸顶的全选框\n(`ListSelectionCheckbox scope=\"all\"`,06 · P3-2):全选 / 全不选只作用于本次传入的\n`records`,`selected` 里不在 `records` 中的 id(如其他页已选)原样保留",
|
|
5632
5951
|
"values": null
|
|
5633
5952
|
},
|
|
5634
5953
|
{
|
|
@@ -5649,14 +5968,14 @@
|
|
|
5649
5968
|
"name": "activeId",
|
|
5650
5969
|
"type": "string",
|
|
5651
5970
|
"required": false,
|
|
5652
|
-
"doc": "SPLIT 右栏或抽屉流程中的当前对象 id",
|
|
5971
|
+
"doc": "SPLIT 右栏或抽屉流程中的当前对象 id。该行输出 `aria-current=\"true\"`",
|
|
5653
5972
|
"values": null
|
|
5654
5973
|
},
|
|
5655
5974
|
{
|
|
5656
5975
|
"name": "onOpen",
|
|
5657
5976
|
"type": "(record: R) => void",
|
|
5658
5977
|
"required": false,
|
|
5659
|
-
"doc": "
|
|
5978
|
+
"doc": "打开记录回调。点击行主体、或行聚焦时按 Enter / 空格触发",
|
|
5660
5979
|
"values": null
|
|
5661
5980
|
},
|
|
5662
5981
|
{
|
|
@@ -5706,7 +6025,7 @@
|
|
|
5706
6025
|
"name": "actions",
|
|
5707
6026
|
"type": "ReactNode",
|
|
5708
6027
|
"required": false,
|
|
5709
|
-
"doc": "
|
|
6028
|
+
"doc": "行尾的记录级动作。组件包一层阻止事件冒泡,点动作不会误触打开详情"
|
|
5710
6029
|
}
|
|
5711
6030
|
]
|
|
5712
6031
|
}
|
|
@@ -5804,6 +6123,16 @@
|
|
|
5804
6123
|
"doc": "宽度,单位 px。推荐 680",
|
|
5805
6124
|
"values": null
|
|
5806
6125
|
},
|
|
6126
|
+
{
|
|
6127
|
+
"name": "side",
|
|
6128
|
+
"type": "'left' | 'right'",
|
|
6129
|
+
"required": false,
|
|
6130
|
+
"doc": "从哪一侧滑出。默认 `right`。来源在右侧(右栏、周末日格)时传 `left`,\n免得 680px 的抽屉正好盖住刚点的那一处(06 · P2-8)",
|
|
6131
|
+
"values": [
|
|
6132
|
+
"left",
|
|
6133
|
+
"right"
|
|
6134
|
+
]
|
|
6135
|
+
},
|
|
5807
6136
|
{
|
|
5808
6137
|
"name": "primaryAction",
|
|
5809
6138
|
"type": "ReactNode",
|
|
@@ -5842,7 +6171,7 @@
|
|
|
5842
6171
|
"order": 11,
|
|
5843
6172
|
"contract": "contracts/application-module/overlays/application-form-dialog.ts",
|
|
5844
6173
|
"summary": "业务对象的新建与编辑表单对话框。",
|
|
5845
|
-
"doc": "业务对象的新建与编辑表单对话框。\n\n已登记宽度:`small` 720px、`large` 960px,**只有这两种**,\n且**绝不超出有效视口**。\n\n字段以 `Field` 子元素传入,默认排布在两列网格上;\n
|
|
6174
|
+
"doc": "业务对象的新建与编辑表单对话框。\n\n已登记宽度:`small` 720px、`large` 960px,**只有这两种**,\n且**绝不超出有效视口**。\n\n字段以 `Field` 子元素传入,默认排布在两列网格上;\n需要跨列的字段给 `Field` 传 `span=\"full\"`。\n\n⚠ **提交失败显示为主体顶部的 `Alert`,不是 toast** ——\n用户必须处理的失败绝不能放进转瞬即逝的提示里。",
|
|
5846
6175
|
"replaces": [],
|
|
5847
6176
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
5848
6177
|
"omitted": [
|
|
@@ -5946,7 +6275,7 @@
|
|
|
5946
6275
|
"order": 11,
|
|
5947
6276
|
"contract": "contracts/application-module/overlays/application-global-action-panel.ts",
|
|
5948
6277
|
"summary": "四个 popover 型全局动作**共享的同一个面板** —— 消息 / 待办 / 运行总览 / 风险预警。",
|
|
5949
|
-
"doc": "四个 popover 型全局动作**共享的同一个面板** ——\n消息 / 待办 / 运行总览 / 风险预警。\n\n⚠ **一个面板,四套内容。绝不为每个动作单独造一个弹层。**\n\n宽 720px(`--ui-shell-global-action-popover-width`),20px 圆角,\n最大高 680px,由 16px 边距约束在视口内,在整个 Shell
|
|
6278
|
+
"doc": "四个 popover 型全局动作**共享的同一个面板** ——\n消息 / 待办 / 运行总览 / 风险预警。\n\n⚠ **一个面板,四套内容。绝不为每个动作单独造一个弹层。**\n\n宽 720px(`--ui-shell-global-action-popover-width`),20px 圆角,\n最大高 680px,由 16px 边距约束在视口内,在整个 Shell 堆叠之下展开 ——\n视口约束按「视口高 − 外壳总高 − 16px」计算,底边不越出视口。\n\n非模态:不锁滚动、不陷阱焦点。**Esc 关闭**由本组件承担(进库内的 Esc 层级栈,\n上层浮层先响应),关闭后焦点归还给打开它的全局动作按钮。外点击关闭由调用方判定。\n\n⚠ **设置**打开的是 Drawer / Sheet,不走本面板;\n且**绝不能存在第二个设置入口**。",
|
|
5950
6279
|
"replaces": [],
|
|
5951
6280
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
5952
6281
|
"omitted": [
|
|
@@ -5995,18 +6324,52 @@
|
|
|
5995
6324
|
"doc": "面板底部内容,如「全部标记为已读」",
|
|
5996
6325
|
"values": null
|
|
5997
6326
|
},
|
|
6327
|
+
{
|
|
6328
|
+
"name": "state",
|
|
6329
|
+
"type": "'ready' | 'loading' | 'empty' | 'error' | 'no-permission'",
|
|
6330
|
+
"required": false,
|
|
6331
|
+
"doc": "面板主体的系统状态(06 · P2-18)。`ready` 渲染 `children`,其余渲染对应槽位:\n`loading` → `loading`、`empty` → `emptyState`、`error` → `error`、\n`no-permission` → `noPermission`。缺省时保持原行为:有 `children` 渲染它,\n否则渲染 `emptyState`",
|
|
6332
|
+
"values": [
|
|
6333
|
+
"ready",
|
|
6334
|
+
"loading",
|
|
6335
|
+
"empty",
|
|
6336
|
+
"error",
|
|
6337
|
+
"no-permission"
|
|
6338
|
+
]
|
|
6339
|
+
},
|
|
6340
|
+
{
|
|
6341
|
+
"name": "loading",
|
|
6342
|
+
"type": "ReactNode",
|
|
6343
|
+
"required": false,
|
|
6344
|
+
"doc": "Loading 状态内容。应传贴近条目结构的 `Skeleton`,而非通用转圈",
|
|
6345
|
+
"values": null
|
|
6346
|
+
},
|
|
5998
6347
|
{
|
|
5999
6348
|
"name": "emptyState",
|
|
6000
6349
|
"type": "ReactNode",
|
|
6001
6350
|
"required": false,
|
|
6002
|
-
"doc": "无条目时的空态,应传 `Empty
|
|
6351
|
+
"doc": "无条目时的空态,应传 `Empty`。文案须点明当前标签的口径,区别于无权限与加载失败",
|
|
6352
|
+
"values": null
|
|
6353
|
+
},
|
|
6354
|
+
{
|
|
6355
|
+
"name": "error",
|
|
6356
|
+
"type": "ReactNode",
|
|
6357
|
+
"required": false,
|
|
6358
|
+
"doc": "Error 状态内容。应说明失败原因并提供重试",
|
|
6359
|
+
"values": null
|
|
6360
|
+
},
|
|
6361
|
+
{
|
|
6362
|
+
"name": "noPermission",
|
|
6363
|
+
"type": "ReactNode",
|
|
6364
|
+
"required": false,
|
|
6365
|
+
"doc": "No Permission 状态内容。措辞必须区别于空态",
|
|
6003
6366
|
"values": null
|
|
6004
6367
|
},
|
|
6005
6368
|
{
|
|
6006
6369
|
"name": "onClose",
|
|
6007
6370
|
"type": "() => void",
|
|
6008
6371
|
"required": false,
|
|
6009
|
-
"doc": "
|
|
6372
|
+
"doc": "关闭回调。关闭按钮与 Esc 都会调用;外点击由调用方自行调用",
|
|
6010
6373
|
"values": null
|
|
6011
6374
|
},
|
|
6012
6375
|
{
|
|
@@ -6147,7 +6510,7 @@
|
|
|
6147
6510
|
"order": 12,
|
|
6148
6511
|
"contract": "contracts/application-module/collaboration/contacts-collaboration-workspace.ts",
|
|
6149
6512
|
"summary": "「人员与组织」工作台 —— **三栏**:组织树定位器 · 成员列表 · 成员详情。",
|
|
6150
|
-
"doc": "「人员与组织」工作台 —— **三栏**:组织树定位器 · 成员列表 · 成员详情。\n\n⚠ 这是一个**受控的整体结构**:**整体复用它**,\n不要在每个页面重新搭一遍三栏布局。\n\n详情栏应传 `ApplicationRecordDetailBody
|
|
6513
|
+
"doc": "「人员与组织」工作台 —— **三栏**:组织树定位器 · 成员列表 · 成员详情。\n\n⚠ 这是一个**受控的整体结构**:**整体复用它**,\n不要在每个页面重新搭一遍三栏布局。\n\n详情栏应传 `ApplicationRecordDetailBody`,与其他详情载体保持同一份主体。\n\n⚠ **系统状态与 `ApplicationDataDisplay` 同一套取值、同一套槽位命名**(06 · P1-17)。\n非 `ready` 时对应槽位顶替成员栏与详情栏两栏,组织树定位器保留 —— 某个机构\n加载失败、无权限或已撤销时,读者仍要能换一个机构。六种状态各写各的措辞。",
|
|
6151
6514
|
"replaces": [],
|
|
6152
6515
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
6153
6516
|
"omitted": [],
|
|
@@ -6205,7 +6568,70 @@
|
|
|
6205
6568
|
"name": "detail",
|
|
6206
6569
|
"type": "ReactNode",
|
|
6207
6570
|
"required": false,
|
|
6208
|
-
"doc": "成员详情,应传 `ApplicationRecordDetailBody`",
|
|
6571
|
+
"doc": "成员详情,应传 `ApplicationRecordDetailBody`。未选中成员时**不传**,详情栏显示 `detailEmpty`",
|
|
6572
|
+
"values": null
|
|
6573
|
+
},
|
|
6574
|
+
{
|
|
6575
|
+
"name": "peopleEmpty",
|
|
6576
|
+
"type": "ReactNode",
|
|
6577
|
+
"required": false,
|
|
6578
|
+
"doc": "`ready` 且当前机构下没有成员时成员栏的内容。\n缺省为内置的 `Empty`「此机构下无成员」;需要附带动作时覆盖",
|
|
6579
|
+
"values": null
|
|
6580
|
+
},
|
|
6581
|
+
{
|
|
6582
|
+
"name": "detailEmpty",
|
|
6583
|
+
"type": "ReactNode",
|
|
6584
|
+
"required": false,
|
|
6585
|
+
"doc": "未传 `detail` 时详情栏的内容。缺省为内置的 `Empty`「未选择成员」。\n不得为了填满详情栏而自动选中第一个成员",
|
|
6586
|
+
"values": null
|
|
6587
|
+
},
|
|
6588
|
+
{
|
|
6589
|
+
"name": "state",
|
|
6590
|
+
"type": "DataDisplayState",
|
|
6591
|
+
"required": false,
|
|
6592
|
+
"doc": "当前系统状态,取值同 `ApplicationDataDisplay`。`ready` 渲染成员栏与详情栏,\n其余状态渲染对应槽位,顶替成员栏与详情栏两栏;组织树始终保留",
|
|
6593
|
+
"values": [
|
|
6594
|
+
"ready",
|
|
6595
|
+
"loading",
|
|
6596
|
+
"empty",
|
|
6597
|
+
"error",
|
|
6598
|
+
"no-permission",
|
|
6599
|
+
"not-found"
|
|
6600
|
+
]
|
|
6601
|
+
},
|
|
6602
|
+
{
|
|
6603
|
+
"name": "loading",
|
|
6604
|
+
"type": "ReactNode",
|
|
6605
|
+
"required": false,
|
|
6606
|
+
"doc": "Loading 状态内容。应传贴近「成员列表 · 详情」两栏结构的 `Skeleton`",
|
|
6607
|
+
"values": null
|
|
6608
|
+
},
|
|
6609
|
+
{
|
|
6610
|
+
"name": "empty",
|
|
6611
|
+
"type": "ReactNode",
|
|
6612
|
+
"required": false,
|
|
6613
|
+
"doc": "Empty 状态内容(整个工作台无数据)。应传 `Empty`,文案须点明当前口径",
|
|
6614
|
+
"values": null
|
|
6615
|
+
},
|
|
6616
|
+
{
|
|
6617
|
+
"name": "error",
|
|
6618
|
+
"type": "ReactNode",
|
|
6619
|
+
"required": false,
|
|
6620
|
+
"doc": "Error 状态内容。应说明失败原因并提供重试",
|
|
6621
|
+
"values": null
|
|
6622
|
+
},
|
|
6623
|
+
{
|
|
6624
|
+
"name": "noPermission",
|
|
6625
|
+
"type": "ReactNode",
|
|
6626
|
+
"required": false,
|
|
6627
|
+
"doc": "No Permission 状态内容。措辞必须区别于 Empty",
|
|
6628
|
+
"values": null
|
|
6629
|
+
},
|
|
6630
|
+
{
|
|
6631
|
+
"name": "notFound",
|
|
6632
|
+
"type": "ReactNode",
|
|
6633
|
+
"required": false,
|
|
6634
|
+
"doc": "Not Found 状态内容(如机构不存在或已撤销)。措辞必须区别于 Empty 与 No Permission",
|
|
6209
6635
|
"values": null
|
|
6210
6636
|
}
|
|
6211
6637
|
],
|
|
@@ -6249,7 +6675,7 @@
|
|
|
6249
6675
|
"order": 12,
|
|
6250
6676
|
"contract": "contracts/application-module/collaboration/files-collaboration-workspace.ts",
|
|
6251
6677
|
"summary": "「文件」工作台 —— 左侧文件夹定位器 · 中间文件表 · 右侧可选预览栏。",
|
|
6252
|
-
"doc": "「文件」工作台 —— 左侧文件夹定位器 · 中间文件表 · 右侧可选预览栏。\n\n文件表是共享的 `Table`,固定列为 **名称 / 所有者 / 大小 / 更新时间**。\n\n⚠ **没有选中项时省略 `preview`**,而不是显示一条空的预览栏 ——\n
|
|
6678
|
+
"doc": "「文件」工作台 —— 左侧文件夹定位器 · 中间文件表 · 右侧可选预览栏。\n\n文件表是共享的 `Table`,固定列为 **名称 / 所有者 / 大小 / 更新时间**。\n\n⚠ **没有选中项时省略 `preview`**,而不是显示一条空的预览栏 ——\n与「无真实指标时不渲染指标区」同一条原则。\n\n⚠ **系统状态与 `ApplicationDataDisplay` 同一套取值、同一套槽位命名**(06 · P1-17)。\n非 `ready` 时对应槽位顶替文件表,预览栏不渲染;文件夹定位器与工具栏保留 ——\n换个文件夹、在空目录里上传,都不该被状态挡住。",
|
|
6253
6679
|
"replaces": [],
|
|
6254
6680
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
6255
6681
|
"omitted": [],
|
|
@@ -6328,7 +6754,49 @@
|
|
|
6328
6754
|
"name": "empty",
|
|
6329
6755
|
"type": "ReactNode",
|
|
6330
6756
|
"required": false,
|
|
6331
|
-
"doc": "空态,应传 `Empty
|
|
6757
|
+
"doc": "空态,应传 `Empty`。文案须点明是「此目录下」。\n`ready` 且 `files` 为空时由文件表显示,`state=\"empty\"` 时顶替文件表显示",
|
|
6758
|
+
"values": null
|
|
6759
|
+
},
|
|
6760
|
+
{
|
|
6761
|
+
"name": "state",
|
|
6762
|
+
"type": "DataDisplayState",
|
|
6763
|
+
"required": false,
|
|
6764
|
+
"doc": "当前系统状态,取值同 `ApplicationDataDisplay`。`ready` 渲染文件表与预览栏,\n其余状态渲染对应槽位,顶替文件表;文件夹树与工具栏始终保留",
|
|
6765
|
+
"values": [
|
|
6766
|
+
"ready",
|
|
6767
|
+
"loading",
|
|
6768
|
+
"empty",
|
|
6769
|
+
"error",
|
|
6770
|
+
"no-permission",
|
|
6771
|
+
"not-found"
|
|
6772
|
+
]
|
|
6773
|
+
},
|
|
6774
|
+
{
|
|
6775
|
+
"name": "loading",
|
|
6776
|
+
"type": "ReactNode",
|
|
6777
|
+
"required": false,
|
|
6778
|
+
"doc": "Loading 状态内容。应传贴近文件表结构的 `Skeleton`",
|
|
6779
|
+
"values": null
|
|
6780
|
+
},
|
|
6781
|
+
{
|
|
6782
|
+
"name": "error",
|
|
6783
|
+
"type": "ReactNode",
|
|
6784
|
+
"required": false,
|
|
6785
|
+
"doc": "Error 状态内容。应说明失败原因并提供重试",
|
|
6786
|
+
"values": null
|
|
6787
|
+
},
|
|
6788
|
+
{
|
|
6789
|
+
"name": "noPermission",
|
|
6790
|
+
"type": "ReactNode",
|
|
6791
|
+
"required": false,
|
|
6792
|
+
"doc": "No Permission 状态内容。措辞必须区别于 Empty",
|
|
6793
|
+
"values": null
|
|
6794
|
+
},
|
|
6795
|
+
{
|
|
6796
|
+
"name": "notFound",
|
|
6797
|
+
"type": "ReactNode",
|
|
6798
|
+
"required": false,
|
|
6799
|
+
"doc": "Not Found 状态内容(如文件夹不存在或已删除)。措辞必须区别于 Empty 与 No Permission",
|
|
6332
6800
|
"values": null
|
|
6333
6801
|
}
|
|
6334
6802
|
],
|
|
@@ -6378,7 +6846,7 @@
|
|
|
6378
6846
|
"order": 12,
|
|
6379
6847
|
"contract": "contracts/application-module/collaboration/schedule-collaboration-workspace.ts",
|
|
6380
6848
|
"summary": "「日程」工作台 —— 粒度切换 · 月格 · 当日议程栏。",
|
|
6381
|
-
"doc": "「日程」工作台 —— 粒度切换 · 月格 · 当日议程栏。**周一为一周起始**。\n\n⚠ **区别于 `CALENDAR` 页面模式** —— 那是整页承载面,本组件是工作台面。\n\n⚠ 选择日历型承载面之前,**必须先命名日期字段与真实的观察粒度** ——\n`CALENDAR`
|
|
6849
|
+
"doc": "「日程」工作台 —— 粒度切换 · 月格 · 当日议程栏。**周一为一周起始**。\n\n⚠ **区别于 `CALENDAR` 页面模式** —— 那是整页承载面,本组件是工作台面。\n\n⚠ 选择日历型承载面之前,**必须先命名日期字段与真实的观察粒度** ——\n`CALENDAR` 页面模式两者都要求。\n\n⚠ **系统状态与 `ApplicationDataDisplay` 同一套取值、同一套槽位命名**(06 · P1-17)。\n非 `ready` 时对应槽位顶替月格,议程栏不渲染;标题行(粒度切换、工具栏)保留 ——\n某个月加载失败时读者仍要能翻到别的月份。",
|
|
6382
6850
|
"replaces": [],
|
|
6383
6851
|
"nativeBase": "HTMLAttributes<HTMLDivElement>",
|
|
6384
6852
|
"omitted": [],
|
|
@@ -6390,6 +6858,13 @@
|
|
|
6390
6858
|
"doc": "当前显示的月份",
|
|
6391
6859
|
"values": null
|
|
6392
6860
|
},
|
|
6861
|
+
{
|
|
6862
|
+
"name": "onMonthChange",
|
|
6863
|
+
"type": "(month: Date) => void",
|
|
6864
|
+
"required": false,
|
|
6865
|
+
"doc": "翻页回调,回传目标月份的 1 日。**提供时工作台内置「上一页 · 今天 · 下一页」三个控件**,\n不提供时不渲染(翻页由调用方自理,保持旧行为)。\n\n翻页按粒度走:月档翻一个月;周档、日档把焦点日前后移 7 天 / 1 天,经 `onSelectDate`\n回传新的焦点日,跨月时同时回调本函数。周档、日档未提供 `onSelectDate` 时按月翻。\n「今天」回调今天所在月份,并经 `onSelectDate` 选中今天",
|
|
6866
|
+
"values": null
|
|
6867
|
+
},
|
|
6393
6868
|
{
|
|
6394
6869
|
"name": "events",
|
|
6395
6870
|
"type": "ScheduleEvent[]",
|
|
@@ -6435,6 +6910,62 @@
|
|
|
6435
6910
|
"required": false,
|
|
6436
6911
|
"doc": "工具栏内容",
|
|
6437
6912
|
"values": null
|
|
6913
|
+
},
|
|
6914
|
+
{
|
|
6915
|
+
"name": "agendaEmpty",
|
|
6916
|
+
"type": "ReactNode",
|
|
6917
|
+
"required": false,
|
|
6918
|
+
"doc": "选中日期当天没有事件时议程栏的内容。缺省为内置的 `Empty`「当日无日程」;\n需要附带「新建」之类的动作时覆盖",
|
|
6919
|
+
"values": null
|
|
6920
|
+
},
|
|
6921
|
+
{
|
|
6922
|
+
"name": "state",
|
|
6923
|
+
"type": "DataDisplayState",
|
|
6924
|
+
"required": false,
|
|
6925
|
+
"doc": "当前系统状态,取值同 `ApplicationDataDisplay`。`ready` 渲染月格与议程栏,\n其余状态渲染对应槽位,顶替月格;标题行始终保留",
|
|
6926
|
+
"values": [
|
|
6927
|
+
"ready",
|
|
6928
|
+
"loading",
|
|
6929
|
+
"empty",
|
|
6930
|
+
"error",
|
|
6931
|
+
"no-permission",
|
|
6932
|
+
"not-found"
|
|
6933
|
+
]
|
|
6934
|
+
},
|
|
6935
|
+
{
|
|
6936
|
+
"name": "loading",
|
|
6937
|
+
"type": "ReactNode",
|
|
6938
|
+
"required": false,
|
|
6939
|
+
"doc": "Loading 状态内容。应传贴近月格结构的 `Skeleton`",
|
|
6940
|
+
"values": null
|
|
6941
|
+
},
|
|
6942
|
+
{
|
|
6943
|
+
"name": "empty",
|
|
6944
|
+
"type": "ReactNode",
|
|
6945
|
+
"required": false,
|
|
6946
|
+
"doc": "Empty 状态内容。应传 `Empty`,文案须点明当前口径(如「本月」)",
|
|
6947
|
+
"values": null
|
|
6948
|
+
},
|
|
6949
|
+
{
|
|
6950
|
+
"name": "error",
|
|
6951
|
+
"type": "ReactNode",
|
|
6952
|
+
"required": false,
|
|
6953
|
+
"doc": "Error 状态内容。应说明失败原因并提供重试",
|
|
6954
|
+
"values": null
|
|
6955
|
+
},
|
|
6956
|
+
{
|
|
6957
|
+
"name": "noPermission",
|
|
6958
|
+
"type": "ReactNode",
|
|
6959
|
+
"required": false,
|
|
6960
|
+
"doc": "No Permission 状态内容。措辞必须区别于 Empty",
|
|
6961
|
+
"values": null
|
|
6962
|
+
},
|
|
6963
|
+
{
|
|
6964
|
+
"name": "notFound",
|
|
6965
|
+
"type": "ReactNode",
|
|
6966
|
+
"required": false,
|
|
6967
|
+
"doc": "Not Found 状态内容(如日历不存在或已删除)。措辞必须区别于 Empty 与 No Permission",
|
|
6968
|
+
"values": null
|
|
6438
6969
|
}
|
|
6439
6970
|
],
|
|
6440
6971
|
"helpers": [
|