@apexhub/apex-ui-react 1.2.0 → 1.2.2

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.
Files changed (173) hide show
  1. package/dist/index.cjs +3363 -3328
  2. package/dist/index.d.ts +26 -22
  3. package/dist/index.mjs +3363 -3328
  4. package/dist/llm/alert.tokens.txt +1 -1
  5. package/dist/llm/alert.txt +3 -3
  6. package/dist/llm/apex-provider.txt +3 -2
  7. package/dist/llm/auto-complete.tokens.txt +1 -1
  8. package/dist/llm/auto-complete.txt +1 -1
  9. package/dist/llm/avatar.tokens.txt +1 -1
  10. package/dist/llm/avatar.txt +1 -1
  11. package/dist/llm/breadcrumb.tokens.txt +46 -96
  12. package/dist/llm/breadcrumb.txt +8 -8
  13. package/dist/llm/button.tokens.txt +1 -1
  14. package/dist/llm/button.txt +16 -8
  15. package/dist/llm/card.tokens.txt +3 -1
  16. package/dist/llm/card.txt +24 -1
  17. package/dist/llm/cascader.tokens.txt +15 -7
  18. package/dist/llm/cascader.txt +25 -6
  19. package/dist/llm/checkbox.tokens.txt +10 -2
  20. package/dist/llm/checkbox.txt +24 -13
  21. package/dist/llm/collapse.tokens.txt +1 -1
  22. package/dist/llm/collapse.txt +1 -1
  23. package/dist/llm/date-picker.tokens.txt +10 -10
  24. package/dist/llm/date-picker.txt +7 -3
  25. package/dist/llm/divider.tokens.txt +1 -1
  26. package/dist/llm/divider.txt +1 -1
  27. package/dist/llm/drawer.tokens.txt +2 -2
  28. package/dist/llm/drawer.txt +2 -2
  29. package/dist/llm/dropdown.tokens.txt +1 -1
  30. package/dist/llm/dropdown.txt +1 -1
  31. package/dist/llm/form.tokens.txt +3 -1
  32. package/dist/llm/form.txt +1 -1
  33. package/dist/llm/grid.txt +9 -9
  34. package/dist/llm/image.tokens.txt +1 -1
  35. package/dist/llm/image.txt +2 -2
  36. package/dist/llm/input-number.tokens.txt +4 -4
  37. package/dist/llm/input-number.txt +8 -3
  38. package/dist/llm/input.tokens.txt +4 -4
  39. package/dist/llm/input.txt +4 -2
  40. package/dist/llm/layout.tokens.txt +1 -1
  41. package/dist/llm/layout.txt +1 -1
  42. package/dist/llm/menu.tokens.txt +21 -8
  43. package/dist/llm/menu.txt +19 -12
  44. package/dist/llm/message.tokens.txt +1 -1
  45. package/dist/llm/message.txt +1 -1
  46. package/dist/llm/modal.tokens.txt +1 -1
  47. package/dist/llm/modal.txt +9 -9
  48. package/dist/llm/notification.tokens.txt +1 -1
  49. package/dist/llm/notification.txt +1 -1
  50. package/dist/llm/pagination.tokens.txt +6 -4
  51. package/dist/llm/pagination.txt +18 -9
  52. package/dist/llm/popover.tokens.txt +4 -14
  53. package/dist/llm/popover.txt +3 -3
  54. package/dist/llm/progress.tokens.txt +1 -1
  55. package/dist/llm/progress.txt +4 -4
  56. package/dist/llm/radio.tokens.txt +11 -6
  57. package/dist/llm/radio.txt +38 -1
  58. package/dist/llm/rate.tokens.txt +1 -1
  59. package/dist/llm/rate.txt +1 -1
  60. package/dist/llm/select.tokens.txt +4 -4
  61. package/dist/llm/select.txt +8 -7
  62. package/dist/llm/skeleton.tokens.txt +1 -1
  63. package/dist/llm/skeleton.txt +1 -1
  64. package/dist/llm/spin.tokens.txt +1 -1
  65. package/dist/llm/spin.txt +1 -1
  66. package/dist/llm/steps.tokens.txt +1 -1
  67. package/dist/llm/steps.txt +1 -1
  68. package/dist/llm/switch.tokens.txt +1 -1
  69. package/dist/llm/switch.txt +1 -1
  70. package/dist/llm/table.tokens.txt +2 -2
  71. package/dist/llm/table.txt +16 -13
  72. package/dist/llm/tabs.tokens.txt +1 -1
  73. package/dist/llm/tabs.txt +1 -1
  74. package/dist/llm/tag.tokens.txt +1 -2
  75. package/dist/llm/tag.txt +7 -8
  76. package/dist/llm/tooltip.tokens.txt +1 -1
  77. package/dist/llm/tooltip.txt +1 -1
  78. package/dist/llm/tree-select.tokens.txt +7 -6
  79. package/dist/llm/tree-select.txt +32 -22
  80. package/dist/llm/tree.tokens.txt +1 -3
  81. package/dist/llm/tree.txt +11 -15
  82. package/dist/llm/typography.tokens.txt +1 -1
  83. package/dist/llm/typography.txt +1 -1
  84. package/dist/llm/upload.tokens.txt +5 -1
  85. package/dist/llm/upload.txt +4 -2
  86. package/dist/llms-full.txt +321 -184
  87. package/dist/llms.txt +1 -1
  88. package/dist/style.css +1716 -1240
  89. package/llms-full.txt +321 -184
  90. package/llms.txt +1 -1
  91. package/package.json +1 -1
  92. package/src/alert/llm.txt +3 -3
  93. package/src/alert/tokens.txt +1 -1
  94. package/src/apex-provider/llm.txt +3 -2
  95. package/src/auto-complete/llm.txt +1 -1
  96. package/src/auto-complete/tokens.txt +1 -1
  97. package/src/avatar/llm.txt +1 -1
  98. package/src/avatar/tokens.txt +1 -1
  99. package/src/breadcrumb/llm.txt +8 -8
  100. package/src/breadcrumb/tokens.txt +46 -96
  101. package/src/button/llm.txt +16 -8
  102. package/src/button/tokens.txt +1 -1
  103. package/src/card/llm.txt +24 -1
  104. package/src/card/tokens.txt +3 -1
  105. package/src/cascader/llm.txt +25 -6
  106. package/src/cascader/tokens.txt +15 -7
  107. package/src/checkbox/llm.txt +24 -13
  108. package/src/checkbox/tokens.txt +10 -2
  109. package/src/collapse/llm.txt +1 -1
  110. package/src/collapse/tokens.txt +1 -1
  111. package/src/date-picker/llm.txt +7 -3
  112. package/src/date-picker/tokens.txt +10 -10
  113. package/src/divider/llm.txt +1 -1
  114. package/src/divider/tokens.txt +1 -1
  115. package/src/drawer/llm.txt +2 -2
  116. package/src/drawer/tokens.txt +2 -2
  117. package/src/dropdown/llm.txt +1 -1
  118. package/src/dropdown/tokens.txt +1 -1
  119. package/src/form/llm.txt +1 -1
  120. package/src/form/tokens.txt +3 -1
  121. package/src/grid/llm.txt +9 -9
  122. package/src/image/llm.txt +2 -2
  123. package/src/image/tokens.txt +1 -1
  124. package/src/input/llm.txt +4 -2
  125. package/src/input/tokens.txt +4 -4
  126. package/src/input-number/llm.txt +8 -3
  127. package/src/input-number/tokens.txt +4 -4
  128. package/src/layout/llm.txt +1 -1
  129. package/src/layout/tokens.txt +1 -1
  130. package/src/menu/llm.txt +19 -12
  131. package/src/menu/tokens.txt +21 -8
  132. package/src/message/llm.txt +1 -1
  133. package/src/message/tokens.txt +1 -1
  134. package/src/modal/llm.txt +9 -9
  135. package/src/modal/tokens.txt +1 -1
  136. package/src/notification/llm.txt +1 -1
  137. package/src/notification/tokens.txt +1 -1
  138. package/src/pagination/llm.txt +18 -9
  139. package/src/pagination/tokens.txt +6 -4
  140. package/src/popover/llm.txt +3 -3
  141. package/src/popover/tokens.txt +4 -14
  142. package/src/progress/llm.txt +4 -4
  143. package/src/progress/tokens.txt +1 -1
  144. package/src/radio/llm.txt +38 -1
  145. package/src/radio/tokens.txt +11 -6
  146. package/src/rate/llm.txt +1 -1
  147. package/src/rate/tokens.txt +1 -1
  148. package/src/select/llm.txt +8 -7
  149. package/src/select/tokens.txt +4 -4
  150. package/src/skeleton/llm.txt +1 -1
  151. package/src/skeleton/tokens.txt +1 -1
  152. package/src/spin/llm.txt +1 -1
  153. package/src/spin/tokens.txt +1 -1
  154. package/src/steps/llm.txt +1 -1
  155. package/src/steps/tokens.txt +1 -1
  156. package/src/switch/llm.txt +1 -1
  157. package/src/switch/tokens.txt +1 -1
  158. package/src/table/llm.txt +16 -13
  159. package/src/table/tokens.txt +2 -2
  160. package/src/tabs/llm.txt +1 -1
  161. package/src/tabs/tokens.txt +1 -1
  162. package/src/tag/llm.txt +7 -8
  163. package/src/tag/tokens.txt +1 -2
  164. package/src/tooltip/llm.txt +1 -1
  165. package/src/tooltip/tokens.txt +1 -1
  166. package/src/tree/llm.txt +11 -15
  167. package/src/tree/tokens.txt +1 -3
  168. package/src/tree-select/llm.txt +32 -22
  169. package/src/tree-select/tokens.txt +7 -6
  170. package/src/typography/llm.txt +1 -1
  171. package/src/typography/tokens.txt +1 -1
  172. package/src/upload/llm.txt +4 -2
  173. package/src/upload/tokens.txt +5 -1
package/llms-full.txt CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  > Alert:需要在当前页面内展示操作结果、风险提示或补充说明,且信息应持续可见时。
8
8
 
9
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
9
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
10
10
 
11
11
  公开导出:`Alert`。
12
12
 
@@ -108,7 +108,7 @@ export default () => <Alert type="warning" title="可关闭的警告" closable s
108
108
 
109
109
  ### 操作区
110
110
 
111
- 通过 `action` 在右侧放置操作按钮或链接。
111
+ 通过 `action` 在右侧放置操作按钮或链接。示例使用 `text-secondary` 的 medium 按钮;关闭控件使用 medium 图标按钮。
112
112
 
113
113
  ```tsx
114
114
  import { Alert, Button } from '@apexhub/apex-ui-react'
@@ -119,7 +119,7 @@ export default () => (
119
119
  title="提交失败"
120
120
  description="网络异常,请稍后重试。"
121
121
  action={
122
- <Button type="danger" color="error" size="small">
122
+ <Button variant="text-secondary" size="medium">
123
123
  重试
124
124
  </Button>
125
125
  }
@@ -176,7 +176,7 @@ Apex Alert 使用 `title` 作为主标题字段,语义更清晰,也与 Messa
176
176
 
177
177
  > ApexProvider:在应用或微前端子应用最外层包裹,确保组件库 Token、主题、滚动条样式在整个组件树生效。
178
178
 
179
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
179
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
180
180
 
181
181
  公开导出:`ApexProvider`、`useConfig`。
182
182
 
@@ -443,7 +443,7 @@ export default () => {
443
443
  </Form.Item>
444
444
  </Form>
445
445
 
446
- <Pagination total={60} defaultCurrent={1} showQuickJumper showSizeChanger />
446
+ <Pagination total={60} defaultCurrent={1} showSizeChanger />
447
447
 
448
448
  <DatePicker />
449
449
  </div>
@@ -468,6 +468,7 @@ const canvasStyle: CSSProperties = {
468
468
  gap: 16,
469
469
  maxWidth: 480,
470
470
  background: 'var(--apex-fill-neutral-secondary)',
471
+ color: 'var(--apex-text-neutral-primary)',
471
472
  borderRadius: 8,
472
473
  }
473
474
 
@@ -547,7 +548,7 @@ export default () => {
547
548
 
548
549
  > AutoComplete:为自由文本输入提供历史记录、关键词或搜索建议。没有匹配建议时,输入内容仍会保留。
549
550
 
550
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
551
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
551
552
 
552
553
  公开导出:`AutoComplete`。
553
554
 
@@ -923,7 +924,7 @@ export default function Demo() {
923
924
 
924
925
  > Avatar:需要展示用户、团队或业务实体的缩略标识,且空间有限时。
925
926
 
926
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
927
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
927
928
 
928
929
  公开导出:`Avatar`、`AvatarGroup`。
929
930
 
@@ -1125,7 +1126,7 @@ export default () => (
1125
1126
 
1126
1127
  > Breadcrumb:页面层级较深,用户需要知道「当前在哪」并快速返回上级时。
1127
1128
 
1128
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
1129
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
1129
1130
 
1130
1131
  公开导出:`Breadcrumb`、`BreadcrumbLink`、`BreadcrumbSeparatorIcon`、`isBreadcrumbSeparatorItem`。
1131
1132
 
@@ -1141,9 +1142,9 @@ import { Breadcrumb, BreadcrumbSeparatorIcon } from '@apexhub/apex-ui-react'
1141
1142
  import '@apexhub/apex-ui-react/style.css'
1142
1143
 
1143
1144
  const items: BreadcrumbItemType[] = [
1144
- { type: 'section', title: '项目管理' },
1145
- { title: 'Install Now', href: '#', onClick: (e) => e.preventDefault() },
1146
- { title: 'Install Now' },
1145
+ { type: 'section', title: '首页', href: '/' },
1146
+ { title: 'Button', href: '/components/button' },
1147
+ { title: 'Breadcrumb' },
1147
1148
  ]
1148
1149
 
1149
1150
  export default () => <Breadcrumb items={items} separator={<BreadcrumbSeparatorIcon />} />
@@ -1178,10 +1179,10 @@ export default () => <Breadcrumb items={items} separator={<BreadcrumbSeparatorIc
1178
1179
  | --- | --- | --- | --- | --- |
1179
1180
  | type | 栏目标题项;使用 heading-3 字阶与默认字色,其后自动渲染竖向 Divider | `"section"` | 否 | — |
1180
1181
  | title | 展示名称(可内嵌图标) | `React.ReactNode` | 否 | — |
1181
- | href | 链接;与 `path` 互斥,同时存在时优先 `href` | `string` | 否 | — |
1182
+ | href | 上级项链接;末项作为当前页始终不可点击。与 `path` 共存时优先 `href` | `string` | 否 | — |
1182
1183
  | path | 相对路径段;累加并支持 `:key` + `Breadcrumb.params` | `string` | 否 | — |
1183
1184
  | className | 该项最外层 DOM 的类名(`li` 或链接/文案壳层,非 `Breadcrumb` 根) | `string` | 否 | — |
1184
- | onClick | 单击事件 | `React.MouseEventHandler<HTMLAnchorElement \| HTMLElement>` | 否 | — |
1185
+ | onClick | 上级链接单击事件;末项不会绑定 | `React.MouseEventHandler<HTMLAnchorElement \| HTMLElement>` | 否 | — |
1185
1186
 
1186
1187
  ### BreadcrumbSeparatorItem
1187
1188
 
@@ -1202,7 +1203,7 @@ type BreadcrumbItemType = BreadcrumbRouteItem | BreadcrumbSeparatorItem
1202
1203
 
1203
1204
  ### BreadcrumbItemRender
1204
1205
 
1205
- 自定义项渲染
1206
+ 自定义上级项渲染(当前页始终使用 `title`,避免生成可点击节点)
1206
1207
 
1207
1208
  ```typescript
1208
1209
  type BreadcrumbItemRender = (
@@ -1279,7 +1280,7 @@ export default () => <Breadcrumb separator={<BreadcrumbSeparatorIcon />} items={
1279
1280
 
1280
1281
  ### 路径参数与自定义渲染
1281
1282
 
1282
- 通过 `path` 与 `params` 拼接路径,也可以用 `itemRender` 自定义每一项展示。
1283
+ 通过 `path` 与 `params` 拼接路径,也可以用 `itemRender` 自定义上级项展示。未解析的路径参数不会生成链接;当前项始终使用 `title`,避免自定义渲染产生可点击节点。
1283
1284
 
1284
1285
  ```tsx
1285
1286
  import type { BreadcrumbItemRender, BreadcrumbItemType } from '@apexhub/apex-ui-react'
@@ -1379,7 +1380,7 @@ export default () => <Breadcrumb items={items} />
1379
1380
 
1380
1381
  > Button:标记一个或多个操作(提交、确认、跳转等)时。
1381
1382
 
1382
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
1383
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
1383
1384
 
1384
1385
  公开导出:`Button`。
1385
1386
 
@@ -1410,8 +1411,8 @@ export default () => <Button type="primary">主要按钮</Button>
1410
1411
  | 属性 | 说明 | 类型 | 必填 | 默认值 | 版本 |
1411
1412
  | --- | --- | --- | --- | --- | --- |
1412
1413
  | type | 按钮类型,控制外观样式<br>- `default`:默认边框按钮(白底)<br>- `primary`:主色实心按钮<br>- `danger`:危险操作(边框红色)<br>- `text`:纯文字,无边框无背景<br>- `link`:链接样式,无边框无背景<br>注:`tabCapsule` 为 Tabs capsule 内部变体,不在对外 API 中暴露。 | `"default" \| "primary" \| "danger" \| "text" \| "link"` | 否 | `'default'` | `0.1.0` |
1413
- | variant | Figma visual style. When provided, it overrides the style implied by `type`.<br>- `main`: solid emphasis<br>- `outline`: bordered emphasis<br>- `secondary`: neutral filled action<br>- `text` / `link`: low-emphasis actions<br>- `icon`: icon-only action with hover fill<br>- `icon-transparent`: icon-only action, fully transparent background | `"text" \| "link" \| "main" \| "outline" \| "secondary" \| "icon" \| "icon-transparent" \| null` | 否 | — | `0.1.0` |
1414
- | tone | Visual intent. `main`, `outline`, and `icon` support every tone;<br>`icon-transparent`, `secondary`, `text`, and `link` use `default`.<br>`secondary`, `text`, and `link` use `default`.<br>When omitted, the legacy `danger` type resolves to `error`; other types<br>resolve to `default`. | `"default" \| "error" \| "success" \| "warning" \| null` | 否 | — | `0.1.0` |
1414
+ | variant | Figma visual style. When provided, it overrides the style implied by `type`.<br>- `main`: solid emphasis<br>- `outline`: bordered emphasis<br>- `secondary`: neutral filled action<br>- `text` / `text-secondary` / `link`: low-emphasis actions<br>- `icon` / `icon-primary`: icon-only actions with hover fill<br>- `icon-transparent`: icon-only action, fully transparent background | `"text" \| "link" \| "main" \| "outline" \| "secondary" \| "text-secondary" \| "icon" \| "icon-primary" \| "icon-transparent" \| null` | 否 | — | `0.1.0` |
1415
+ | tone | Visual intent. `main`, `outline`, and `icon` support every tone;<br>`icon-primary`, `icon-transparent`, `secondary`, `text`,<br>`text-secondary`, and `link` use `default`.<br>When omitted, the legacy `danger` type resolves to `error`; other types<br>resolve to `default`. | `"default" \| "error" \| "success" \| "warning" \| null` | 否 | — | `0.1.0` |
1415
1416
  | size | 按钮尺寸(`medium` 32px / `small` 24px;水平内边距共用 `--button-spacing-padding-x`) | `"small" \| "medium" \| null` | 否 | `'medium'` | `0.1.0` |
1416
1417
  | disabled | 是否禁用。禁用时不可点击,视觉降级 | `boolean` | 否 | `false` | — |
1417
1418
  | loading | 是否显示加载状态。<br>loading 为 true 时:不可点击,icon 位置替换为 loading 指示器 | `boolean` | 否 | `false` | `0.1.0` |
@@ -1421,6 +1422,7 @@ export default () => <Button type="primary">主要按钮</Button>
1421
1422
  | target | 链接 target。依赖 `href`,仅在 `href` 存在时生效。 | `string` | 否 | — | — |
1422
1423
  | asChild | 将按钮的样式与 props 合并到直接子元素上,而非渲染内置 `<button>` / `<a>`。<br>用于多态组合——让任意元素(如 `<a>`、路由 `Link`)拥有按钮外观。<br>优先级高于 `href` / `htmlType`。 | `boolean` | 否 | `false` | `0.1.0` |
1423
1424
  | icon | 前置图标。loading 为 true 时此 prop 被 loading 指示器替换 | `React.ReactNode` | 否 | — | — |
1425
+ | suffixIcon | 尾部图标;loading 时仍保留在文案后方。 | `React.ReactNode` | 否 | — | — |
1424
1426
  | block | 是否撑满父容器宽度(`display: flex; width: 100%`) | `boolean \| null` | 否 | `false` | `0.1.0` |
1425
1427
  | className | 根节点类名 | `string` | 否 | — | — |
1426
1428
  | style | 根节点内联样式(禁止硬编码色值,优先 CSS Token) | `React.CSSProperties` | 否 | — | — |
@@ -1451,7 +1453,7 @@ type ButtonVariants = VariantProps<typeof buttonVariants>
1451
1453
 
1452
1454
  ### 外观类型
1453
1455
 
1454
- 通过 `type` 控制外观:`default`、`primary`、`danger`、`text`、`link`。`main` / `outline` / `icon` 等 Figma 样式可通过 `variant` + `tone` 组合;显式传入 `variant` 时优先于 `type`。
1456
+ 通过 `type` 控制外观:`default`、`primary`、`danger`、`text`、`link`。`main` / `outline` / `icon` 等 Figma 样式可通过 `variant` + `tone` 组合;`text-secondary` 对应设计稿的透明文字样式,`icon-primary` 对应主色图标按钮。显式传入 `variant` 时优先于 `type`。
1455
1457
 
1456
1458
  ```tsx
1457
1459
  import { Button } from '@apexhub/apex-ui-react'
@@ -1469,7 +1471,7 @@ export default () => (
1469
1471
 
1470
1472
  ### 尺寸
1471
1473
 
1472
- 提供 `medium`(默认)与 `small` 两种尺寸。
1474
+ 提供 `medium`(默认)与 `small` 两种尺寸。对应文字为 14px / 20px 与 12px / 16px;前后图标占位分别为 20px 与 16px。
1473
1475
 
1474
1476
  ```tsx
1475
1477
  import { Button } from '@apexhub/apex-ui-react'
@@ -1527,9 +1529,9 @@ export default () => (
1527
1529
  )
1528
1530
  ```
1529
1531
 
1530
- ### 前置图标
1532
+ ### 图标
1531
1533
 
1532
- 通过 `icon` 在文案前插入图标;`loading` 时 icon 区会被 loading 指示器替换。
1534
+ 通过 `icon` 在文案前插入图标,`suffixIcon` 在文案后插入图标;`loading` 时前置 icon 会被 loading 指示器替换。
1533
1535
 
1534
1536
  ```tsx
1535
1537
  import { Button } from '@apexhub/apex-ui-react'
@@ -1546,7 +1548,14 @@ export default () => (
1546
1548
  <Button type="primary" icon={<StarIcon />}>
1547
1549
  主要带图标
1548
1550
  </Button>
1551
+ <Button type="primary" icon={<StarIcon />} suffixIcon={<StarIcon />}>
1552
+ 前后图标
1553
+ </Button>
1554
+ <Button variant="text-secondary" suffixIcon={<StarIcon />}>
1555
+ 透明文字
1556
+ </Button>
1549
1557
  <Button type="primary" icon={<StarIcon />} aria-label="收藏" />
1558
+ <Button variant="icon-primary" icon={<StarIcon />} aria-label="收藏(主色图标)" />
1550
1559
  </div>
1551
1560
  )
1552
1561
  ```
@@ -1599,7 +1608,7 @@ export default () => (
1599
1608
 
1600
1609
  ## DOM 结构
1601
1610
 
1602
- 该入口未声明静态 `data-slot`;请使用公开的样式属性。
1611
+ 源码声明的静态 `data-slot`:`button-loading-icon`、`button-icon`、`button-suffix-icon`、`button-content`。具体节点随模式和状态出现,不表示固定嵌套顺序。
1603
1612
 
1604
1613
  ## 样式定制
1605
1614
 
@@ -1644,7 +1653,7 @@ export default () => (
1644
1653
 
1645
1654
  > Card:需要将一组相关信息收纳在带边框的容器内,与页面背景区分时。
1646
1655
 
1647
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
1656
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
1648
1657
 
1649
1658
  公开导出:`Card`。
1650
1659
 
@@ -1678,6 +1687,7 @@ export default () => (
1678
1687
 
1679
1688
  | 属性 | 说明 | 类型 | 必填 | 默认值 |
1680
1689
  | --- | --- | --- | --- | --- |
1690
+ | variant | 卡片表面层级;primary 用于页面主容器,secondary 用于嵌套区域 | `"primary" \| "secondary"` | 否 | — |
1681
1691
  | title | 卡片标题,存在时渲染头部区域 | `React.ReactNode` | 否 | — |
1682
1692
  | extra | 卡片右上角操作区域;与 title 任一存在即渲染 header | `React.ReactNode` | 否 | — |
1683
1693
  | children | 卡片内容区 | `React.ReactNode` | 否 | — |
@@ -1715,6 +1725,28 @@ export default () => (
1715
1725
  )
1716
1726
  ```
1717
1727
 
1728
+ ### 表面层级
1729
+
1730
+ React Card 可用 `variant` 切换 `primary`(默认)和 `secondary` 表面。悬停、按下以及通过 `data-selected` 标记选中时,边框会显示对应状态。
1731
+
1732
+ ```tsx
1733
+ import { Card } from '@apexhub/apex-ui-react'
1734
+
1735
+ export default () => (
1736
+ <div style={{ display: 'flex', flexWrap: 'wrap', gap: 16 }}>
1737
+ <Card title="主表面" variant="primary" style={{ width: 240 }}>
1738
+ 页面中的主要内容区域
1739
+ </Card>
1740
+ <Card title="次级表面" variant="secondary" style={{ width: 240 }}>
1741
+ 需要区分层级的内容区域
1742
+ </Card>
1743
+ <Card title="已选中" variant="secondary" data-selected="" style={{ width: 240 }}>
1744
+ 通过 data-selected 标记选中状态
1745
+ </Card>
1746
+ </div>
1747
+ )
1748
+ ```
1749
+
1718
1750
  ## DOM 结构
1719
1751
 
1720
1752
  源码声明的静态 `data-slot`:`card`、`card-header`、`card-title`、`card-extra`、`card-body`。具体节点随模式和状态出现,不表示固定嵌套顺序。
@@ -1742,7 +1774,7 @@ export default () => (
1742
1774
 
1743
1775
  > Cascader:选项具有清晰的层级关系(省市区、分类目录等),需要从根到叶逐级选择时。
1744
1776
 
1745
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
1777
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
1746
1778
 
1747
1779
  公开导出:`Cascader`。
1748
1780
 
@@ -2008,7 +2040,7 @@ type MaxTagCount = number | 'responsive'
2008
2040
 
2009
2041
  ### 默认值
2010
2042
 
2011
- 通过 `defaultValue` 设置非受控初始选中路径。
2043
+ 通过 `defaultValue` 设置非受控初始选中路径。示例可悬停查看清除按钮:medium/large 的下拉箭头为 16px、small 为 14px;清除按钮保持 14px。
2012
2044
 
2013
2045
  ```tsx
2014
2046
  import { Cascader } from '@apexhub/apex-ui-react'
@@ -2419,7 +2451,7 @@ export default () => (
2419
2451
 
2420
2452
  ### 禁用选项
2421
2453
 
2422
- 在 `options` 中为单项设置 `disabled: true` 禁止选中。
2454
+ 在 `options` 中为单项设置 `disabled: true` 禁止选中。多选时预选一个可用子项,父级显示半选;点击父级只勾选可用子项,不会勾选禁用子项。
2423
2455
 
2424
2456
  ```tsx
2425
2457
  import type { CascaderOption } from '@apexhub/apex-ui-react'
@@ -2465,9 +2497,27 @@ const options: CascaderOption[] = [
2465
2497
  },
2466
2498
  ]
2467
2499
 
2500
+ const multipleOptions: CascaderOption[] = [
2501
+ {
2502
+ value: 'team',
2503
+ label: '项目组',
2504
+ children: [
2505
+ { value: 'design', label: '设计', isLeaf: true },
2506
+ { value: 'engineering', label: '研发', isLeaf: true },
2507
+ { value: 'archived', label: '已归档', disabled: true, isLeaf: true },
2508
+ ],
2509
+ },
2510
+ ]
2511
+
2468
2512
  export default () => (
2469
- <div style={cascaderWrapStyle}>
2470
- <Cascader options={options} placeholder="禁用选项" />
2513
+ <div style={{ ...cascaderWrapStyle, display: 'flex', flexDirection: 'column', gap: 12 }}>
2514
+ <Cascader options={options} placeholder="禁用父级" />
2515
+ <Cascader
2516
+ multiple
2517
+ options={multipleOptions}
2518
+ defaultValue={[['team', 'design']]}
2519
+ placeholder="多选与禁用子项"
2520
+ />
2471
2521
  </div>
2472
2522
  )
2473
2523
  ```
@@ -2563,7 +2613,7 @@ export default () => (
2563
2613
 
2564
2614
  ### 只读
2565
2615
 
2566
- `readOnly` 为 true 时仅展示已选值,不可打开下拉、不可清除或修改;与 `disabled` 正交,适合表单预览等场景。
2616
+ `readOnly` 为 true 时不可打开下拉、不可清除或修改;视觉使用禁用配色,但仍可聚焦。示例对照空值与已选路径。
2567
2617
 
2568
2618
  ```tsx
2569
2619
  import { Cascader } from '@apexhub/apex-ui-react'
@@ -2603,6 +2653,7 @@ export default () => (
2603
2653
  placeholder="可编辑"
2604
2654
  allowClear
2605
2655
  />
2656
+ <Cascader options={CASCADER_OPTIONS} readOnly placeholder="只读空值" />
2606
2657
  <Cascader
2607
2658
  options={CASCADER_OPTIONS}
2608
2659
  defaultValue={['zhejiang', 'hangzhou', 'xihu']}
@@ -2643,7 +2694,7 @@ export default () => (
2643
2694
 
2644
2695
  > Checkbox:用户可从多个选项中任选零个、一个或多个时(与 Radio 互斥单选相对)。
2645
2696
 
2646
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
2697
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
2647
2698
 
2648
2699
  公开导出:`Checkbox`、`CheckboxGroup`。
2649
2700
 
@@ -2785,17 +2836,28 @@ export default () => (
2785
2836
  import { Checkbox } from '@apexhub/apex-ui-react'
2786
2837
 
2787
2838
  export default () => (
2788
- <div style={{ display: 'flex', flexDirection: 'column', gap: 12 }}>
2789
- <Checkbox>未选中</Checkbox>
2790
- <Checkbox defaultChecked>已选中</Checkbox>
2791
- <Checkbox indeterminate>半选</Checkbox>
2792
- <Checkbox disabled>禁用 - 未选</Checkbox>
2793
- <Checkbox disabled defaultChecked>
2794
- 禁用 - 选中
2795
- </Checkbox>
2796
- <Checkbox disabled indeterminate>
2797
- 禁用 - 半选
2798
- </Checkbox>
2839
+ <div
2840
+ style={{
2841
+ display: 'grid',
2842
+ gridTemplateColumns: 'auto repeat(3, minmax(72px, 1fr))',
2843
+ alignItems: 'center',
2844
+ columnGap: 16,
2845
+ rowGap: 12,
2846
+ width: 'min(100%, 360px)',
2847
+ }}
2848
+ >
2849
+ <span />
2850
+ <span>未选中</span>
2851
+ <span>已选中</span>
2852
+ <span>半选</span>
2853
+ <span>默认</span>
2854
+ <Checkbox aria-label="默认-未选中" />
2855
+ <Checkbox defaultChecked aria-label="默认-已选中" />
2856
+ <Checkbox indeterminate aria-label="默认-半选" />
2857
+ <span>禁用</span>
2858
+ <Checkbox disabled aria-label="禁用-未选中" />
2859
+ <Checkbox disabled defaultChecked aria-label="禁用-已选中" />
2860
+ <Checkbox disabled indeterminate aria-label="禁用-半选" />
2799
2861
  </div>
2800
2862
  )
2801
2863
  ```
@@ -2923,7 +2985,7 @@ import type * as React from 'react'
2923
2985
 
2924
2986
  const styles: CheckboxProps['styles'] = {
2925
2987
  root: {
2926
- '--checkbox-gap': 'var(--apex-spacing-3)',
2988
+ '--checkbox-spacing-gap': 'var(--apex-spacing-8)',
2927
2989
  } as React.CSSProperties,
2928
2990
  indicator: {
2929
2991
  opacity: 0.9,
@@ -2978,7 +3040,7 @@ export default () => (
2978
3040
 
2979
3041
  > Collapse:页面信息量大,需要将次要内容默认折叠、按需展开时。
2980
3042
 
2981
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
3043
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
2982
3044
 
2983
3045
  公开导出:`Collapse`。
2984
3046
 
@@ -3311,7 +3373,7 @@ export default () => (
3311
3373
 
3312
3374
  > DatePicker:用户需要选择单个日期或日期范围,且精确到日、周、月、季、年等不同粒度时。
3313
3375
 
3314
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
3376
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
3315
3377
 
3316
3378
  公开导出:`DatePicker`、`RangePicker`。
3317
3379
 
@@ -3609,15 +3671,19 @@ export default () => (
3609
3671
 
3610
3672
  ### 只读
3611
3673
 
3612
- `readOnly` 为 true 时仅展示选中值,不可打开面板或修改;与 `disabled` 正交,触发器仍可聚焦。
3674
+ `readOnly` 为 true 时仅展示选中值,不可打开面板或修改;视觉使用禁用配色,触发器仍可聚焦。示例对照空值与已填值的单日期和日期范围。
3613
3675
 
3614
3676
  ```tsx
3615
3677
  import { DatePicker, RangePicker } from '@apexhub/apex-ui-react'
3616
3678
 
3679
+ import dayjs from 'dayjs'
3680
+
3617
3681
  export default () => (
3618
3682
  <div style={{ display: 'flex', flexDirection: 'column', gap: 12, padding: 24 }}>
3619
3683
  <DatePicker readOnly placeholder="只读,不可打开面板" />
3684
+ <DatePicker readOnly defaultValue={dayjs('2026-11-19')} />
3620
3685
  <RangePicker readOnly placeholder={['开始日期', '结束日期']} />
3686
+ <RangePicker readOnly defaultValue={[dayjs('2026-11-01'), dayjs('2026-11-19')]} />
3621
3687
  </div>
3622
3688
  )
3623
3689
  ```
@@ -3701,7 +3767,7 @@ export default () => (
3701
3767
 
3702
3768
  ## DOM 结构
3703
3769
 
3704
- 源码声明的静态 `data-slot`:`date-picker-shortcuts`、`date-picker-shortcut`、`date-picker-suffix`、`range-picker-trigger`、`date-picker-clear`、`range-picker-panel`、`date-picker-panel-body`、`date-picker-panel-day`、`date-picker-panel-footer`、`date-picker-panel-header`、`date-picker-panel`、`date-picker-panel-time-shortcut`、`date-picker-panel-time`。具体节点随模式和状态出现,不表示固定嵌套顺序。
3770
+ 源码声明的静态 `data-slot`:`date-picker-shortcuts`、`date-picker-shortcut`、`date-picker-prefix`、`range-picker-trigger`、`date-picker-clear`、`range-picker-panel`、`date-picker-panel-body`、`date-picker-panel-day`、`date-picker-panel-footer`、`date-picker-panel-header`、`date-picker-panel`、`date-picker-panel-time-shortcut`、`date-picker-panel-time`。具体节点随模式和状态出现,不表示固定嵌套顺序。
3705
3771
 
3706
3772
  ## 样式定制
3707
3773
 
@@ -3738,7 +3804,7 @@ export default () => (
3738
3804
 
3739
3805
  > Divider:需要在区块之间做视觉分隔、区分内容层次时。
3740
3806
 
3741
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
3807
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
3742
3808
 
3743
3809
  公开导出:`Divider`。
3744
3810
 
@@ -3902,7 +3968,7 @@ export default () => (
3902
3968
 
3903
3969
  > Drawer:需要从屏幕边缘滑出面板展示详情、表单或临时任务,且保留原页面上下文时。
3904
3970
 
3905
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
3971
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
3906
3972
 
3907
3973
  公开导出:`Drawer`。
3908
3974
 
@@ -4236,7 +4302,7 @@ export default () => {
4236
4302
  body: 'custom-drawer-body',
4237
4303
  }}
4238
4304
  styles={{
4239
- body: { paddingBlock: 'var(--drawer-padding)' },
4305
+ body: { paddingBlock: 'var(--drawer-spacing-padding)' },
4240
4306
  }}
4241
4307
  drawerRender={(node) => <div data-demo="drawer-shell">{node}</div>}
4242
4308
  onClose={() => setOpen(false)}
@@ -4274,7 +4340,7 @@ export default () => {
4274
4340
 
4275
4341
  > Dropdown:在触发器附近展示一组快捷操作或菜单项时。
4276
4342
 
4277
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
4343
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
4278
4344
 
4279
4345
  公开导出:`Dropdown`。
4280
4346
 
@@ -4697,7 +4763,7 @@ v1 不提供该 prop;下拉菜单通过 Radix Portal 挂载到 `document.body`
4697
4763
 
4698
4764
  > Form:需要收集、校验并提交一组结构化字段数据时。
4699
4765
 
4700
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
4766
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
4701
4767
 
4702
4768
  公开导出:`Form`、`FormItem`、`useForm`。
4703
4769
 
@@ -5041,7 +5107,7 @@ v1 不支持点号或方括号嵌套路径,`name` 须为单层字符串字段
5041
5107
 
5042
5108
  > Grid:页面区块需要按 24 栅格划分宽度与响应式列数时。
5043
5109
 
5044
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
5110
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
5045
5111
 
5046
5112
  公开导出:`Col`、`Row`、`useBreakpoint`。
5047
5113
 
@@ -5057,7 +5123,7 @@ import type { CSSProperties } from 'react'
5057
5123
  import '@apexhub/apex-ui-react/style.css'
5058
5124
 
5059
5125
  const boxStyle: CSSProperties = {
5060
- background: 'var(--apex-fill-neutral-secondary, #f5f5f5)',
5126
+ background: 'var(--apex-fill-neutral-secondary)',
5061
5127
  padding: '8px 0',
5062
5128
  textAlign: 'center',
5063
5129
  borderRadius: 4,
@@ -5214,7 +5280,7 @@ import { Col, Row } from '@apexhub/apex-ui-react'
5214
5280
  import type { CSSProperties } from 'react'
5215
5281
 
5216
5282
  const boxStyle: CSSProperties = {
5217
- background: 'var(--apex-fill-neutral-secondary, #f5f5f5)',
5283
+ background: 'var(--apex-fill-neutral-secondary)',
5218
5284
  padding: '8px 0',
5219
5285
  textAlign: 'center',
5220
5286
  borderRadius: 4,
@@ -5245,7 +5311,7 @@ import { Col, Row } from '@apexhub/apex-ui-react'
5245
5311
  import type { CSSProperties } from 'react'
5246
5312
 
5247
5313
  const boxStyle: CSSProperties = {
5248
- background: 'var(--apex-fill-neutral-secondary, #f5f5f5)',
5314
+ background: 'var(--apex-fill-neutral-secondary)',
5249
5315
  padding: '8px 0',
5250
5316
  textAlign: 'center',
5251
5317
  borderRadius: 4,
@@ -5301,7 +5367,7 @@ import { Col, Divider, Row, Typography } from '@apexhub/apex-ui-react'
5301
5367
  import type { CSSProperties } from 'react'
5302
5368
 
5303
5369
  const boxStyle: CSSProperties = {
5304
- background: 'var(--apex-fill-neutral-secondary, #f5f5f5)',
5370
+ background: 'var(--apex-fill-neutral-secondary)',
5305
5371
  padding: '8px 0',
5306
5372
  textAlign: 'center',
5307
5373
  borderRadius: 4,
@@ -5309,7 +5375,7 @@ const boxStyle: CSSProperties = {
5309
5375
 
5310
5376
  const rowStyle: CSSProperties = {
5311
5377
  width: '100%',
5312
- backgroundColor: 'color-mix(in srgb, white 6%, black)',
5378
+ backgroundColor: 'var(--apex-fill-neutral-primary)',
5313
5379
  borderRadius: 4,
5314
5380
  }
5315
5381
 
@@ -5359,7 +5425,7 @@ import { Col, Row } from '@apexhub/apex-ui-react'
5359
5425
  import type { CSSProperties } from 'react'
5360
5426
 
5361
5427
  const boxStyle: CSSProperties = {
5362
- background: 'var(--apex-fill-neutral-secondary, #f5f5f5)',
5428
+ background: 'var(--apex-fill-neutral-secondary)',
5363
5429
  padding: '8px 0',
5364
5430
  textAlign: 'center',
5365
5431
  borderRadius: 4,
@@ -5395,7 +5461,7 @@ export default () => (
5395
5461
  import { Col, Row } from '@apexhub/apex-ui-react'
5396
5462
 
5397
5463
  const boxStyle = {
5398
- background: 'var(--apex-fill-neutral-secondary, #f5f5f5)',
5464
+ background: 'var(--apex-fill-neutral-secondary)',
5399
5465
  padding: '8px 12px',
5400
5466
  borderRadius: 4,
5401
5467
  display: 'flex',
@@ -5425,7 +5491,7 @@ import { Col, Row } from '@apexhub/apex-ui-react'
5425
5491
  import type { CSSProperties } from 'react'
5426
5492
 
5427
5493
  const boxStyle: CSSProperties = {
5428
- background: 'var(--apex-fill-neutral-secondary, #f5f5f5)',
5494
+ background: 'var(--apex-fill-neutral-secondary)',
5429
5495
  padding: '8px 0',
5430
5496
  textAlign: 'center',
5431
5497
  borderRadius: 4,
@@ -5463,7 +5529,7 @@ export default () => (
5463
5529
 
5464
5530
  > Image:需要以缩略图形式展示图片,并支持点击放大预览时。
5465
5531
 
5466
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
5532
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
5467
5533
 
5468
5534
  公开导出:`Image`。
5469
5535
 
@@ -5867,7 +5933,7 @@ export default () => {
5867
5933
  ## 行为要点
5868
5934
 
5869
5935
  - **URL 所有权**:Image 只接收可用 URL 字符串,**不接收 `File`/`Blob`**,不调用 `revokeObjectURL`。如果你使用 `URL.createObjectURL` 生成的 `blob:` 地址,需自行管理生命周期。
5870
- - **变换工具栏**:预览层内置缩放(步进 0.25,范围 0.25–5)、左右旋转、1:1 原始尺寸、适应视口、占满视口。切图/关闭/重开时变换复位。
5936
+ - **变换工具栏**:预览层使用 medium 图标按钮,内置缩放(步进 0.25,范围 0.25–5)、左右旋转、1:1 原始尺寸、适应视口、占满视口。切图/关闭/重开时变换复位。
5871
5937
  - **键盘**:打开后焦点陷阱;`Esc` 在占满视口时先退出占满再关闭;`←` / `→` 切图;关闭后焦点回触发元素。
5872
5938
  - **边界**:单图无 prev/next 控件;索引越界时禁用不循环;`fallback` 再失败不递归。
5873
5939
 
@@ -5894,7 +5960,7 @@ PreviewGroup 的受控状态(`open`/`current`)在顶层而非嵌套在 `prev
5894
5960
 
5895
5961
  > Input:需要通过键盘录入单行或多行文本内容时。
5896
5962
 
5897
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
5963
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
5898
5964
 
5899
5965
  公开导出:`Input`。
5900
5966
 
@@ -6150,14 +6216,16 @@ export default () => (
6150
6216
 
6151
6217
  ### 只读
6152
6218
 
6153
- `readOnly` 为 true 时可查看内容但不可修改,无 hover 交互态;与 `disabled` 正交,控件仍可聚焦。
6219
+ `readOnly` 为 true 时可查看内容但不可修改,无 hover 交互态;视觉使用禁用配色,但控件仍可聚焦。示例同时展示空值占位和已填内容。
6154
6220
 
6155
6221
  ```tsx
6156
6222
  import { Input } from '@apexhub/apex-ui-react'
6157
6223
 
6158
6224
  export default () => (
6159
6225
  <div style={{ display: 'flex', flexDirection: 'column', gap: 12, maxWidth: 320 }}>
6226
+ <Input readOnly placeholder="只读空值" />
6160
6227
  <Input readOnly defaultValue="只读输入框" />
6228
+ <Input type="textarea" readOnly rows={3} placeholder="只读文本域空值" />
6161
6229
  <Input type="textarea" readOnly rows={3} defaultValue="只读文本域" />
6162
6230
  </div>
6163
6231
  )
@@ -6319,7 +6387,7 @@ export default () => {
6319
6387
 
6320
6388
  > InputNumber:需要录入有上下界的数值,并支持步进增减时。
6321
6389
 
6322
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
6390
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
6323
6391
 
6324
6392
  公开导出:`InputNumber`。
6325
6393
 
@@ -6601,12 +6669,17 @@ export default () => <InputNumber disabled defaultValue={5} min={0} max={100} />
6601
6669
 
6602
6670
  ### 只读
6603
6671
 
6604
- `readOnly` 为 true 时可查看数值但不可编辑,步进按钮与键盘输入一并禁用。
6672
+ `readOnly` 为 true 时可查看数值但不可编辑,步进按钮与键盘输入一并禁用;空值占位和已填数值均使用禁用配色。
6605
6673
 
6606
6674
  ```tsx
6607
6675
  import { InputNumber } from '@apexhub/apex-ui-react'
6608
6676
 
6609
- export default () => <InputNumber readOnly defaultValue={5} min={0} max={100} />
6677
+ export default () => (
6678
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 12, maxWidth: 280 }}>
6679
+ <InputNumber readOnly placeholder="只读空值" min={0} max={100} />
6680
+ <InputNumber readOnly defaultValue={5} min={0} max={100} />
6681
+ </div>
6682
+ )
6610
6683
  ```
6611
6684
 
6612
6685
  ### 小数步长与格式化
@@ -6808,7 +6881,7 @@ export default () => (
6808
6881
 
6809
6882
  > Layout:搭建后台页面的 Header、侧栏、内容区与 Footer 等整体结构时。
6810
6883
 
6811
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
6884
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
6812
6885
 
6813
6886
  公开导出:`Layout`、`LayoutSiderDrawerBody`、`LayoutSiderDrawerHeader`、`LayoutSiderMenuCollapsed`、`LayoutSiderMenuMaximized`。
6814
6887
 
@@ -7109,7 +7182,7 @@ export default () => (
7109
7182
 
7110
7183
  > Menu:侧栏持久导航,需要在图标 rail 与展开列表之间切换时。
7111
7184
 
7112
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
7185
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
7113
7186
 
7114
7187
  公开导出:`isKeySelected`、`Menu`。
7115
7188
 
@@ -7118,7 +7191,7 @@ export default () => (
7118
7191
  ## 快速开始
7119
7192
 
7120
7193
  ```tsx
7121
- import { Button, Menu, MenuItemType } from '@apexhub/apex-ui-react'
7194
+ import { Button, Menu, type MenuItemType } from '@apexhub/apex-ui-react'
7122
7195
 
7123
7196
  import { useState } from 'react'
7124
7197
 
@@ -7140,13 +7213,20 @@ const items: MenuItemType[] = [
7140
7213
 
7141
7214
  export default () => {
7142
7215
  const [collapsed, setCollapsed] = useState(false)
7216
+
7143
7217
  return (
7144
- <div>
7145
- <Button onClick={() => setCollapsed(!collapsed)}>{collapsed ? '展开' : '收起'}</Button>
7146
- <br />
7147
- <br />
7148
- <Menu items={items} collapsed={collapsed} onCollapse={setCollapsed} />
7149
- </div>
7218
+ <Menu
7219
+ items={items}
7220
+ collapsed={collapsed}
7221
+ onCollapse={setCollapsed}
7222
+ defaultOpenKeys={['workspace']}
7223
+ defaultSelectedKeys={['projects']}
7224
+ footer={
7225
+ <Button type="text" onClick={() => setCollapsed((current) => !current)}>
7226
+ {collapsed ? '展开菜单' : '收起菜单'}
7227
+ </Button>
7228
+ }
7229
+ />
7150
7230
  )
7151
7231
  }
7152
7232
  ```
@@ -7372,8 +7452,8 @@ const railStyle = {
7372
7452
  flexDirection: 'column' as const,
7373
7453
  width: 'fit-content',
7374
7454
  height: '100%',
7375
- backgroundColor: '#151618',
7376
- borderRight: '1px solid #2d30367a',
7455
+ backgroundColor: 'var(--apex-fill-neutral-secondary)',
7456
+ borderRight: 'var(--apex-border-1) solid var(--apex-stroke-neutral-tertiary)',
7377
7457
  padding: 8,
7378
7458
  boxSizing: 'border-box' as const,
7379
7459
  justifyContent: 'space-between' as const,
@@ -7582,7 +7662,7 @@ export default () => {
7582
7662
 
7583
7663
  ### 自定义顶栏
7584
7664
 
7585
- 通过 `header` 与 `footer` 插槽自定义收窄与展开态的顶栏、底栏内容。
7665
+ 通过 `header` 与 `footer` 插槽自定义收窄与展开态的顶栏、底栏内容;展开态的顶栏沿用菜单 Token 表面样式。
7586
7666
 
7587
7667
  ```tsx
7588
7668
  import { Avatar, Button, Card, Dropdown, Menu, Typography } from '@apexhub/apex-ui-react'
@@ -7700,7 +7780,7 @@ export default () => {
7700
7780
  height: '100%',
7701
7781
  cursor: 'pointer',
7702
7782
  backgroundColor: profileHovered
7703
- ? 'color-mix(in srgb, var(--card-fill-container-primary) 90%, white 10%)'
7783
+ ? 'var(--apex-fill-neutral-tertiary)'
7704
7784
  : undefined,
7705
7785
  transition: 'background-color 0.15s ease',
7706
7786
  }}
@@ -7792,7 +7872,7 @@ Dropdown 复用 `MenuItemType` 类型定义,但 UI 与交互独立:Menu 面
7792
7872
 
7793
7873
  > Message:操作结果的轻量全局反馈(成功、失败、警告、进行中等)时。
7794
7874
 
7795
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
7875
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
7796
7876
 
7797
7877
  公开导出:`message`。
7798
7878
 
@@ -8096,7 +8176,7 @@ v1 采用全局 singleton 挂载,不读取 React Context,因此不提供 `us
8096
8176
 
8097
8177
  > Modal:需要用户阅读并确认、取消或提交,且应暂时阻断当前页面操作时。
8098
8178
 
8099
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
8179
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
8100
8180
 
8101
8181
  公开导出:`Modal`。
8102
8182
 
@@ -8167,7 +8247,7 @@ export default () => {
8167
8247
  | styles | 各语义节点的内联样式,支持对象或函数 | `Partial<Record<SemanticDOM, React.CSSProperties>> \| ((info: { props: ModalProps }) => Partial<Record<SemanticDOM, React.CSSProperties>>)` | 否 | — |
8168
8248
  | title | 标题。`undefined`(缺省)且无关闭钮时自动补 sr-only 标题以满足无障碍;<br>`null` 时消费方在 `children` 中自行提供标题(如 `Modal.confirm`),不渲染标题区且不兜底 sr-only,须配合 `titleId` 关联无障碍名称。 | `React.ReactNode` | 否 | — |
8169
8249
  | open | 是否显示弹窗(受控;必填) | `boolean` | 是 | — |
8170
- | width | 自定义宽度(px 数字或 CSS 长度);设置后覆盖 `size` 对应的宽度。<br>面板高度按内容自然增长,不受宽度对应尺寸档的最小高度约束;超出视口时由外层容器整体滚动。<br>未显式传 `size` 时,数字或 px 宽度仍按 420 / 560 / 720 断点匹配尺寸样式。<br>兼容:`size` 省略时 `sm` / `md` 字符串仍按 `size` 处理。 | `string \| number` | 否 | — |
8250
+ | width | 自定义宽度(px 数字或 CSS 长度);设置后覆盖 `size` 对应的宽度。<br>面板高度按内容自然增长,不受宽度对应尺寸档的最小高度约束;超出视口时由外层容器整体滚动。<br>未显式传 `size` 时,数字或 px 宽度仍按 420 / 720 / 1000 断点匹配尺寸样式。<br>兼容:`size` 省略时 `sm` / `md` 字符串仍按 `size` 处理。 | `string \| number` | 否 | — |
8171
8251
  | wrapClassName | 含蒙层的容器 className | `string` | 否 | — |
8172
8252
  | onCancel | 点击蒙层、右上角关闭或 Cancel 时触发 | `(e: React.MouseEvent<HTMLElement> \| React.KeyboardEvent<HTMLElement>) => void` | 否 | — |
8173
8253
  | onOk | 点击 OK 时触发 | `(e: React.MouseEvent<HTMLElement>) => void` | 否 | — |
@@ -8356,7 +8436,7 @@ export default () => {
8356
8436
 
8357
8437
  ### 尺寸与宽度
8358
8438
 
8359
- `size` 映射预设宽度:`sm` 420px、`md` 560px(默认)、`lg` 720px。传入 `width`(数字或 CSS 长度)时会覆盖 `size` 对应的宽度。
8439
+ `size` 对应三档宽度:`sm` 420px、`md` 720px(默认)、`xl` 1000px;`lg` 为 720px 的兼容别名。传入 `width`(数字或 CSS 长度)时会覆盖预设宽度。
8360
8440
 
8361
8441
  ```tsx
8362
8442
  import { Button, Modal } from '@apexhub/apex-ui-react'
@@ -8364,14 +8444,14 @@ import { Button, Modal } from '@apexhub/apex-ui-react'
8364
8444
  import { useState } from 'react'
8365
8445
 
8366
8446
  export default () => {
8367
- const [kind, setKind] = useState<'sm' | 'md' | 'lg' | 'custom' | null>(null)
8447
+ const [kind, setKind] = useState<'sm' | 'md' | 'xl' | 'custom' | null>(null)
8368
8448
 
8369
8449
  return (
8370
8450
  <>
8371
8451
  <div style={{ display: 'flex', gap: 8, flexWrap: 'wrap' }}>
8372
8452
  <Button onClick={() => setKind('sm')}>sm(420px)</Button>
8373
- <Button onClick={() => setKind('md')}>md(560px)</Button>
8374
- <Button onClick={() => setKind('lg')}>lg(720px)</Button>
8453
+ <Button onClick={() => setKind('md')}>md(720px)</Button>
8454
+ <Button onClick={() => setKind('xl')}>xl(1000px)</Button>
8375
8455
  <Button onClick={() => setKind('custom')}>自定义 width</Button>
8376
8456
  </div>
8377
8457
  <Modal
@@ -8393,13 +8473,13 @@ export default () => {
8393
8473
  使用 size=&quot;md&quot;。
8394
8474
  </Modal>
8395
8475
  <Modal
8396
- open={kind === 'lg'}
8397
- size="lg"
8476
+ open={kind === 'xl'}
8477
+ size="xl"
8398
8478
  title="大尺寸"
8399
8479
  onCancel={() => setKind(null)}
8400
8480
  onOk={() => setKind(null)}
8401
8481
  >
8402
- 使用 size=&quot;lg&quot;。
8482
+ 使用 size=&quot;xl&quot;。
8403
8483
  </Modal>
8404
8484
  <Modal
8405
8485
  open={kind === 'custom'}
@@ -8683,7 +8763,7 @@ export default () => {
8683
8763
 
8684
8764
  > Notification:操作完成后的全局反馈,需要用户注意到但不必立即处理时。
8685
8765
 
8686
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
8766
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
8687
8767
 
8688
8768
  公开导出:`notification`。
8689
8769
 
@@ -9069,7 +9149,7 @@ v1 采用静态 singleton root 挂载,不经过组件树,因此无法读取
9069
9149
 
9070
9150
  > Pagination:数据量较大、需要分批次浏览列表或表格时。
9071
9151
 
9072
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
9152
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
9073
9153
 
9074
9154
  公开导出:`Pagination`。
9075
9155
 
@@ -9088,7 +9168,7 @@ export default () => <Pagination total={85} defaultCurrent={1} />
9088
9168
  ## 何时使用
9089
9169
 
9090
9170
  - 数据量较大、需要分批次浏览列表或表格时。
9091
- - 需要让用户切换每页条数或快速跳转到指定页时。
9171
+ - 需要让用户切换每页条数时;Vue 版也支持快速跳转到指定页。
9092
9172
  - 纯滚动加载场景不必使用 Pagination;仅一页时可配合 `hideOnSinglePage` 隐藏分页器。
9093
9173
 
9094
9174
  ## API
@@ -9109,8 +9189,8 @@ export default () => <Pagination total={85} defaultCurrent={1} />
9109
9189
  | pageSizeOptions | pageSize 切换器的可选档位。 | `number[]` | 否 | `[10, 20, 50, 100]` |
9110
9190
  | disabled | 整体禁用 | `boolean` | 否 | `false` |
9111
9191
  | showSizeChanger | 显示 pageSize 切换器。<br>未传 → total > 50 时自动 true;显式 false → 永远关;显式 true → 永远开 | `boolean` | 否 | — |
9112
- | showQuickJumper | 显示快速跳转输入 | `boolean` | 否 | `false` |
9113
- | showTotal | 自定义总数显示函数;不传则不渲染总数区域 | `ShowTotalFn` | 否 | — |
9192
+ | showQuickJumper | 兼容旧调用方;当前 React 设计不渲染快速跳转输入 | `boolean` | 否 | — |
9193
+ | showTotal | 兼容旧调用方;当前 React 设计不渲染总数区域 | `ShowTotalFn` | 否 | — |
9114
9194
  | hideOnSinglePage | 总页数 ≤ 1 时不渲染整个组件 | `boolean` | 否 | `false` |
9115
9195
  | itemRender | 自定义每项渲染。<br>所有可点项(prev/next/jump-prev/jump-next/page)都调用此函数。<br>业务方应用 React.cloneElement(originalElement, ...) 保留 a11y props。 | `ItemRender` | 否 | — |
9116
9196
  | responsive | 开启容器宽度自适应(ResizeObserver 四档)。 | `boolean` | 否 | `false` |
@@ -9156,7 +9236,7 @@ type PageItemType = 'page' | 'prev' | 'next' | 'jump-prev' | 'jump-next'
9156
9236
 
9157
9237
  ### 每页条数切换
9158
9238
 
9159
- 数据量较大时(默认 `total > 50`)会自动显示条数切换器,也可通过 `showSizeChanger` 强制开启或关闭。无论是否展示条数切换器或快速跳转,分页器外部高度都保持 36px;内部页码按钮与条数切换 / 快速跳转里的 Select、Input(`size="medium"` = 28px)同高,切换配置时不会引起布局跳动。
9239
+ 数据量较大时(默认 `total > 50`)会自动显示条数切换器,也可通过 `showSizeChanger` 强制开启或关闭。
9160
9240
 
9161
9241
  ```tsx
9162
9242
  import { Pagination } from '@apexhub/apex-ui-react'
@@ -9201,7 +9281,9 @@ export default () => {
9201
9281
  }
9202
9282
  ```
9203
9283
 
9204
- ### 快速跳转
9284
+ ### 受控用法 (quick-jumper)
9285
+
9286
+ **快速跳转**
9205
9287
 
9206
9288
  `showQuickJumper` 展示跳转输入框,输入页码后按 Enter 跳转。
9207
9289
 
@@ -9224,14 +9306,21 @@ export default () => {
9224
9306
  }
9225
9307
  ```
9226
9308
 
9227
- ### 显示总数
9309
+ ### 受控用法 (show-total)
9310
+
9311
+ **显示总数**
9228
9312
 
9229
9313
  `showTotal` 自定义总数展示文案,接收 `(total, range) => 自定义节点`。
9230
9314
 
9231
9315
  ```tsx
9232
9316
  import { Pagination } from '@apexhub/apex-ui-react'
9233
9317
 
9234
- export default () => <Pagination total={128} showTotal={(total) => `共 ${total} 条`} />
9318
+ export default () => (
9319
+ <Pagination
9320
+ total={128}
9321
+ showTotal={(total, range) => `共 ${total} 条,当前 ${range[0]}-${range[1]}`}
9322
+ />
9323
+ )
9235
9324
  ```
9236
9325
 
9237
9326
  ### 禁用
@@ -9268,7 +9357,7 @@ export default () => <Pagination total={50} disabled />
9268
9357
 
9269
9358
  ### `responsive` 如何工作?
9270
9359
 
9271
- 开启后组件通过 ResizeObserver 监听容器宽度,按阈值自动隐藏部分控件(如窄屏隐藏 `showTotal`、更窄时隐藏条数切换器等)。默认 `false`,须显式传入 `responsive`。
9360
+ 开启后组件通过 ResizeObserver 监听容器宽度,按阈值自动调整布局;Vue 版会逐步隐藏总数与条数切换器,React 版只调整当前实际渲染的控件。默认 `false`,须显式传入 `responsive`。
9272
9361
 
9273
9362
  ### `pageSizeOptions` 可以自定义吗?
9274
9363
 
@@ -9280,7 +9369,7 @@ export default () => <Pagination total={50} disabled />
9280
9369
 
9281
9370
  > Popover:需要在触发元素旁展示标题 + 正文,且正文内可包含链接、按钮等可交互元素时。
9282
9371
 
9283
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
9372
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
9284
9373
 
9285
9374
  公开导出:`Popover`。
9286
9375
 
@@ -9306,7 +9395,7 @@ export default () => (
9306
9395
 
9307
9396
  - 需要在触发元素旁展示标题 + 正文,且正文内可包含链接、按钮等可交互元素时。
9308
9397
  - 点击或悬停展开补充说明、快捷操作面板时。
9309
- - 树选择器、多列表单等宽面板会按内容自然展开,并在接近可用边界时自动收缩。
9398
+ - 默认内容适合简短的补充信息;宽面板可通过 `className` 调整宽度,并在接近可用边界时自动收缩。
9310
9399
  - 若只需单行文字提示、无交互内容,请使用 Tooltip,而不是 Popover。
9311
9400
 
9312
9401
  ## API
@@ -9508,7 +9597,7 @@ v1 仅支持单值触发方式,避免组合触发带来的状态复杂度;
9508
9597
 
9509
9598
  ### Popover 内容有固定最大宽度吗?
9510
9599
 
9511
- 没有。Popover 默认最小宽度由组件 Token 决定,内容会自然展开;运行时仅根据浮层可用空间限制最大宽度,避免超出视口或所在浮层边界。业务需要固定面板宽度时,可通过 `style`、`styles.popup` 或 `className` 设置。
9600
+ React Popover 默认最小宽度为 80px、最大宽度为 420px,并受浮层可用空间限制。需要更宽的业务面板时,可通过 `className` 覆盖最大宽度,并确保内容在可用空间内布局。
9512
9601
 
9513
9602
  ---
9514
9603
 
@@ -9516,7 +9605,7 @@ v1 仅支持单值触发方式,避免组合触发带来的状态复杂度;
9516
9605
 
9517
9606
  > Progress:需要向用户展示任务、上传、加载等操作的完成百分比时。
9518
9607
 
9519
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
9608
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
9520
9609
 
9521
9610
  公开导出:`Progress`。
9522
9611
 
@@ -9633,7 +9722,7 @@ export default () => (
9633
9722
 
9634
9723
  通过 `success.percent` 在轨道内叠加已成功部分;`format` 第二个参数为成功段百分比,可用于自定义文案。
9635
9724
 
9636
- 以下示例在悬停整条轨道时,于目标进度(`percent`)末端显示标记线与 Tooltip;信息区文案展示成功段百分比。段颜色通过覆盖 `--progress-fill-brand` / `--progress-fill-success` 对调(仅演示)。
9725
+ 以下示例在悬停整条轨道时,于目标进度(`percent`)末端显示标记线与 Tooltip;信息区文案展示成功段百分比。段颜色通过覆盖 `--progress-bar-brand` / `--progress-bar-success` 对调(仅演示)。
9637
9726
 
9638
9727
  ```tsx
9639
9728
  import { Progress, Tooltip } from '@apexhub/apex-ui-react'
@@ -9759,8 +9848,8 @@ const SuccessSegmentHoverMark = () => {
9759
9848
  format={(_percent, success) => `${success ?? 0}%`}
9760
9849
  style={
9761
9850
  {
9762
- '--progress-fill-brand': percentStripColor,
9763
- '--progress-fill-success': successStripColor,
9851
+ '--progress-bar-brand': percentStripColor,
9852
+ '--progress-bar-success': successStripColor,
9764
9853
  } as React.CSSProperties
9765
9854
  }
9766
9855
  />
@@ -9798,7 +9887,7 @@ export default () => <SuccessSegmentHoverMark />
9798
9887
 
9799
9888
  > Radio:用户必须从多个互斥选项中选择一个时(如性别、配送方式)。
9800
9889
 
9801
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
9890
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
9802
9891
 
9803
9892
  公开导出:`Radio`、`RadioGroup`、`RadioIndicator`。
9804
9893
 
@@ -10005,6 +10094,43 @@ export default () => (
10005
10094
  )
10006
10095
  ```
10007
10096
 
10097
+ ### 状态对照
10098
+
10099
+ 并排展示默认与禁用状态下的未选中、已选中 Radio,便于对照控件图形与文字间距。
10100
+
10101
+ ```tsx
10102
+ import { Radio } from '@apexhub/apex-ui-react'
10103
+
10104
+ export default () => (
10105
+ <div
10106
+ style={{
10107
+ display: 'grid',
10108
+ gridTemplateColumns: 'auto repeat(2, minmax(88px, 1fr))',
10109
+ alignItems: 'center',
10110
+ columnGap: 16,
10111
+ rowGap: 12,
10112
+ width: 'min(100%, 280px)',
10113
+ }}
10114
+ >
10115
+ <span />
10116
+ <span>未选中</span>
10117
+ <span>已选中</span>
10118
+ <span>默认</span>
10119
+ <Radio value="default-unchecked">默认-未选中</Radio>
10120
+ <Radio value="default-checked" defaultChecked>
10121
+ 默认-已选中
10122
+ </Radio>
10123
+ <span>禁用</span>
10124
+ <Radio value="disabled-unchecked" disabled>
10125
+ 禁用-未选中
10126
+ </Radio>
10127
+ <Radio value="disabled-checked" disabled defaultChecked>
10128
+ 禁用-已选中
10129
+ </Radio>
10130
+ </div>
10131
+ )
10132
+ ```
10133
+
10008
10134
  ### 受控用法
10009
10135
 
10010
10136
  通过 `value` 和 变更事件 控制选中项。
@@ -10149,7 +10275,7 @@ export default () => (
10149
10275
 
10150
10276
  > Rate:需要对服务、内容或商品进行星级评价时。
10151
10277
 
10152
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
10278
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
10153
10279
 
10154
10280
  公开导出:`Rate`、`StarFilled`。
10155
10281
 
@@ -10393,7 +10519,7 @@ export default () => {
10393
10519
 
10394
10520
  > Select:选项来自预设列表,需要从其中选择一个或多个值时。
10395
10521
 
10396
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
10522
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
10397
10523
 
10398
10524
  公开导出:`Select`。
10399
10525
 
@@ -10779,7 +10905,7 @@ type MaxTagCount = number | 'responsive'
10779
10905
 
10780
10906
  ### 尺寸
10781
10907
 
10782
- 支持 `large`(32px)、`medium`(默认,28px)、`small`(24px)三种尺寸。
10908
+ 支持 `large`、`medium`(默认)、`small` 三种尺寸。示例选中值并开启清除:large/medium 的下拉箭头为 16px,small 为 14px,清除按钮均为 14px。
10783
10909
 
10784
10910
  ```tsx
10785
10911
  import { Select } from '@apexhub/apex-ui-react'
@@ -10791,9 +10917,9 @@ const options = [
10791
10917
 
10792
10918
  export default () => (
10793
10919
  <div style={{ display: 'flex', gap: 12, alignItems: 'center', flexWrap: 'wrap' }}>
10794
- <Select size="large" placeholder="large" options={options} />
10795
- <Select size="medium" placeholder="medium" options={options} />
10796
- <Select size="small" placeholder="small" options={options} />
10920
+ <Select size="large" defaultValue="react" allowClear options={options} />
10921
+ <Select size="medium" defaultValue="react" allowClear options={options} />
10922
+ <Select size="small" defaultValue="react" allowClear options={options} />
10797
10923
  </div>
10798
10924
  )
10799
10925
  ```
@@ -10820,7 +10946,7 @@ export default () => (
10820
10946
 
10821
10947
  ### 只读
10822
10948
 
10823
- `readOnly` 不可打开下拉、不可改值,仅展示已选内容;与 `disabled` 正交,适合表单只读态。
10949
+ `readOnly` 不可打开下拉、不可改值;视觉使用禁用配色,但仍可聚焦。示例包含空值、单选和多选。
10824
10950
 
10825
10951
  ```tsx
10826
10952
  import { Select } from '@apexhub/apex-ui-react'
@@ -10833,6 +10959,7 @@ const options = [
10833
10959
 
10834
10960
  export default () => (
10835
10961
  <div style={{ display: 'flex', gap: 12, alignItems: 'center', flexWrap: 'wrap' }}>
10962
+ <Select readOnly placeholder="只读空值" options={options} style={{ minWidth: 160 }} />
10836
10963
  <Select readOnly defaultValue="a" options={options} />
10837
10964
  <Select
10838
10965
  mode="multiple"
@@ -11218,7 +11345,7 @@ export default () => (
11218
11345
 
11219
11346
  ### `readOnly` 和 `disabled` 有什么区别?
11220
11347
 
11221
- `disabled` 展示禁用态且不可交互;`readOnly` 仅展示已选值、不可打开下拉或改值,视觉更接近正常态,适合表单只读场景。二者可独立使用,一般不同时需要。
11348
+ `disabled` 不可交互;`readOnly` 同样使用禁用配色且不可打开下拉或改值,但保留可聚焦语义,适合表单只读场景。
11222
11349
 
11223
11350
  ---
11224
11351
 
@@ -11226,7 +11353,7 @@ export default () => (
11226
11353
 
11227
11354
  > Skeleton:页面、卡片或表格数据仍在加载,需要先稳定布局并降低等待感时。
11228
11355
 
11229
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
11356
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
11230
11357
 
11231
11358
  公开导出:`Skeleton`。
11232
11359
 
@@ -11504,7 +11631,7 @@ Skeleton 默认就是占位内容,因此不传 `loading` 与 `loading={true}`
11504
11631
 
11505
11632
  > Spin:局部区域正在加载数据,需要覆盖指示器且不阻断整页时。
11506
11633
 
11507
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
11634
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
11508
11635
 
11509
11636
  公开导出:`Spin`。
11510
11637
 
@@ -11801,7 +11928,7 @@ Spin 仅表达不确定等待;有具体百分比时请使用 Progress 组件
11801
11928
 
11802
11929
  > Steps:分步表单、向导、下单流程等需要展示当前所处阶段时。
11803
11930
 
11804
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
11931
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
11805
11932
 
11806
11933
  公开导出:`Steps`。
11807
11934
 
@@ -12104,7 +12231,7 @@ v1 仅提供默认序号图标步骤条,不提供点状(dot)类型;需
12104
12231
 
12105
12232
  > Switch:需要立即生效的开关型设置(如启用通知、暗色模式)时。
12106
12233
 
12107
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
12234
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
12108
12235
 
12109
12236
  公开导出:`Switch`、`SwitchRoot`、`SwitchThumb`。
12110
12237
 
@@ -12323,7 +12450,7 @@ Switch 不提供 `value` / `defaultValue` 别名;与 Form 集成时请使用 `
12323
12450
 
12324
12451
  > Table:需要以行列形式展示、浏览结构化数据(列表、台账、报表)时。
12325
12452
 
12326
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
12453
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
12327
12454
 
12328
12455
  公开导出:`Table`、`TableSummary`。
12329
12456
 
@@ -12375,8 +12502,8 @@ export default () => <Table columns={columns} data={data} />
12375
12502
  | columns | 列定义 | `TableColumn<RecordType>[]` | 否 | `[]` |
12376
12503
  | data | 数据;空数组渲染空态 | `RecordType[]` | 否 | `[]` |
12377
12504
  | rowKey | 行键,映射到 TanStack `getRowId` | `RowKey<RecordType>` | 否 | `'key'` |
12378
- | loading | 加载态;普通表格用 3 行骨架占位,`scroll.y` / `flexHeight` 场景按表体可用高度自动填满。<br>骨架行高跟随 `size`(`--table-size-height-content` + block padding,视觉 28/32/40),加载时替换数据行。 | `boolean` | 否 | `false` |
12379
- | size | 尺寸;`small` / `medium` / `large` 对应 token 的 sm / md / la。<br>单元格内容区最小高度为 `--table-size-height-content`,加上 `--table-spacing-padding-y` 后视觉下限 28/32/40。<br>表体可继续被内容撑高,不锁死行高。<br>字号全 size 一致:表头 `text-*-body`(14/20),内容 `text-*-caption`(12/18)。<br>非 `ellipsis` 纯文本列可多行撑高;`ellipsis` 纯文本列保持单行截断。<br>- `small` — 紧凑<br>- `medium` — 标准<br>- `large` — 宽松(默认) | `"small" \| "medium" \| "large"` | 否 | `'large'` |
12505
+ | loading | 加载态;普通表格用 3 行骨架占位,`scroll.y` / `flexHeight` 场景按表体可用高度自动填满。<br>骨架行高跟随 `size`(`--table-size-height-content` + block padding,视觉 32/40/40),加载时替换数据行。 | `boolean` | 否 | `false` |
12506
+ | size | 尺寸;`small` 使用 block-md token,`medium` / `large` 使用 block-la token。<br>单元格内容区最小高度为 `--table-size-height-content`,加上 `--table-spacing-padding-y` 后视觉下限 32/40/40。<br>表体可继续被内容撑高,不锁死行高。<br>字号全 size 一致:表头 `text-*-body`(14/20),内容 `text-*-caption`(12/18)。<br>非 `ellipsis` 纯文本列可多行撑高;`ellipsis` 纯文本列保持单行截断。<br>- `small` — 紧凑<br>- `medium` — 标准<br>- `large` — 宽松(默认) | `"small" \| "medium" \| "large"` | 否 | `'large'` |
12380
12507
  | showHeader | 是否渲染 `<thead>` | `boolean` | 否 | `true` |
12381
12508
  | rowClassName | 行 className | `string \| ((record: RecordType, index: number) => string)` | 否 | — |
12382
12509
  | onRow | 行原生属性透传 | `(record: RecordType, index: number) => React.HTMLAttributes<HTMLTableRowElement>` | 否 | — |
@@ -12417,7 +12544,7 @@ type TableEllipsisConfig = boolean | TypographyEllipsisConfig
12417
12544
  | defaultSelectedRowKeys | 非受控初始已选 row key 数组 | `Key[]` | 否 | `[]` |
12418
12545
  | columnWidth | 选择列宽 | `number \| string` | 否 | `48(`showIndex` 为 true)/ 40(`showIndex` 为 false)` |
12419
12546
  | hideSelectAll | 是否隐藏全选 checkbox(仅 `checkbox` 模式) | `boolean` | 否 | `false` |
12420
- | showIndex | 是否将序号与选择列合并:默认显示序号,行 hover / 已选 / 键盘焦点时切换为选择控件。<br>序号按当前页连续编号(分页时为全局序号:`(current - 1) * pageSize + index + 1`)。 | `boolean` | 否 | `true` |
12547
+ | showIndex | 是否将序号与选择列合并:启用后默认显示序号,行 hover / 已选 / 键盘焦点时切换为选择控件。<br>序号按当前页连续编号(分页时为全局序号:`(current - 1) * pageSize + index + 1`)。 | `boolean` | 否 | `false` |
12421
12548
  | fixed | 固定选择列方向;须配合 `scroll.x` 与数字 `columnWidth` 使用 | `"left" \| "right"` | 否 | — |
12422
12549
  | onChange | 选中变化回调 | `(selectedRowKeys: Key[], selectedRows: RecordType[]) => void` | 否 | — |
12423
12550
  | getCheckboxProps | 单行禁用配置 | `(record: RecordType) => { disabled?: boolean }` | 否 | — |
@@ -12586,7 +12713,7 @@ type RowKey<RecordType> = string | keyof RecordType | ((record: RecordType, inde
12586
12713
 
12587
12714
  ### 尺寸
12588
12715
 
12589
- 通过 `size` 切换密度:表头最小高度 `small`(28px)/ `medium`(32px)/ `large`(40px,默认);表体行高由内容撑开。字号在各档保持一致:表头 14px、内容 12px。
12716
+ 通过 `size` 切换密度:表头和表体行高下限为 `small`(32px)/ `medium`(40px)/ `large`(40px,默认);表体可由多行内容继续撑高。字号在各档保持一致:表头 14px、内容 12px。
12590
12717
 
12591
12718
  ```tsx
12592
12719
  import { Table } from '@apexhub/apex-ui-react'
@@ -12668,7 +12795,7 @@ export default () => (
12668
12795
 
12669
12796
  ### 分页
12670
12797
 
12671
- 通过 `pagination` 配置分页;设为 `false` 可关闭分页区。内嵌分页器保留 Pagination 自身的 36px 高度与容器留白,开启 `showSizeChanger` 或 `showQuickJumper` 时仍与独立 Pagination 保持一致。
12798
+ 通过 `pagination` 配置分页;设为 `false` 可关闭分页区。两端均支持页码导航、`showSizeChanger` 和 `showTotal`。React Table 会在页码控件左侧单独渲染总数文案。Vue 版还支持 `showQuickJumper`;React 版仅保留该旧参数以兼容调用方,当前不渲染快速跳转。
12672
12799
 
12673
12800
  ```tsx
12674
12801
  import { Table } from '@apexhub/apex-ui-react'
@@ -12690,7 +12817,11 @@ export default () => (
12690
12817
  <Table
12691
12818
  columns={columns}
12692
12819
  data={data}
12693
- pagination={{ defaultPageSize: 10, showSizeChanger: true }}
12820
+ pagination={{
12821
+ defaultPageSize: 10,
12822
+ showSizeChanger: true,
12823
+ showTotal: (total, range) => `共 ${total} 条,当前 ${range[0]}-${range[1]}`,
12824
+ }}
12694
12825
  />
12695
12826
  )
12696
12827
  ```
@@ -12764,7 +12895,7 @@ export default () => (
12764
12895
 
12765
12896
  ### 行选择
12766
12897
 
12767
- 配置 `rowSelection` 开启多选或单选列。默认将**序号与选择列合并**:单元格显示行号,鼠标悬停当前行(或已选 / 键盘焦点)时切换为复选框;点击即可选中。设 `showIndex: false` 可恢复为始终显示选择控件。分页开启时序号为全局连续编号。
12898
+ 配置 `rowSelection` 开启多选或单选列,选择控件默认常显,点击即可选中。需要在同一列复用序号时显式设置 `showIndex: true`,鼠标悬停当前行(或已选 / 键盘焦点)时切换为选择控件;分页开启时序号为全局连续编号。
12768
12899
 
12769
12900
  ```tsx
12770
12901
  import { Table } from '@apexhub/apex-ui-react'
@@ -12803,7 +12934,7 @@ export default () => {
12803
12934
 
12804
12935
  `rowSelection.fixed` 可将选择列固定在左侧或右侧;须配合 `scroll.x` 与数字 `columnWidth` 使用。与 `column.fixed: 'left'` 叠加时,选择列始终在最左并参与偏移计算。
12805
12936
 
12806
- 本例设置 `rowSelection.showIndex: false`,复选框始终显示,无需悬停行。
12937
+ 本例使用默认配置,复选框始终显示,无需悬停行。
12807
12938
 
12808
12939
  ```tsx
12809
12940
  import { Button, Table } from '@apexhub/apex-ui-react'
@@ -12855,7 +12986,6 @@ export default () => {
12855
12986
  pagination={false}
12856
12987
  rowSelection={{
12857
12988
  fixed: 'left',
12858
- showIndex: false,
12859
12989
  columnWidth: 48,
12860
12990
  selectedRowKeys: selectedKeys,
12861
12991
  onChange: (keys) => setSelectedKeys(keys),
@@ -13019,7 +13149,7 @@ import { Table, Tag } from '@apexhub/apex-ui-react'
13019
13149
  type ProductRecord = {
13020
13150
  key: string
13021
13151
  name: string
13022
- tags: Array<{ label: string; color: 'brand' | 'success' | 'warning' | 'error' | 'default' }>
13152
+ tags: Array<{ label: string; color: 'brand' | 'success' | 'warning' | 'error' | 'grey' }>
13023
13153
  }
13024
13154
 
13025
13155
  const LONG_TAG_LABELS = {
@@ -13044,7 +13174,7 @@ const data: ProductRecord[] = [
13044
13174
  tags: [
13045
13175
  { label: LONG_TAG_LABELS.region, color: 'brand' },
13046
13176
  { label: '季度复盘待办:整理本月续约风险清单并同步客户成功经理', color: 'warning' },
13047
- { label: LONG_TAG_LABELS.category, color: 'default' },
13177
+ { label: LONG_TAG_LABELS.category, color: 'grey' },
13048
13178
  ],
13049
13179
  },
13050
13180
  {
@@ -13343,7 +13473,7 @@ export default () => (
13343
13473
 
13344
13474
  ## DOM 结构
13345
13475
 
13346
- 源码声明的静态 `data-slot`:`table-element`、`table-scroll-shell`、`table-scroll`、`table-empty-fixed`、`table-summary-wrap`、`table-element-summary`、`table-container`、`table`、`table-header-wrap`、`table-element-header`、`table-expand-trigger`、`table-selection-cell`、`table-selection-index`、`table-selection-all`、`table-selection-radio`、`table-selection-checkbox`、`table-virtual-spacer`、`table-expanded-row`、`table-expanded-cell`、`table-tbody`、`table-cell-head`、`table-cell`、`table-col`、`table-row-empty`、`table-cell-empty`、`table-empty-image`、`table-thead`、`table-row`、`table-pagination`、`table-scrollbar`、`table-scrollbar-track-y`、`table-scrollbar-thumb-y`、`table-scrollbar-track-x`、`table-scrollbar-thumb-x`、`table-skeleton-row`、`table-skeleton-cell`、`table-summary`、`table-summary-row`、`table-summary-cell`。具体节点随模式和状态出现,不表示固定嵌套顺序。
13476
+ 源码声明的静态 `data-slot`:`table-element`、`table-scroll-shell`、`table-scroll`、`table-empty-fixed`、`table-summary-wrap`、`table-element-summary`、`table-container`、`table`、`table-header-wrap`、`table-element-header`、`table-expand-trigger`、`table-selection-cell`、`table-selection-index`、`table-selection-all`、`table-selection-radio`、`table-selection-checkbox`、`table-virtual-spacer`、`table-expanded-row`、`table-expanded-cell`、`table-tbody`、`table-cell-head`、`table-cell`、`table-col`、`table-row-empty`、`table-cell-empty`、`table-empty-image`、`table-thead`、`table-row`、`table-pagination`、`table-pagination-total`、`table-scrollbar`、`table-scrollbar-track-y`、`table-scrollbar-thumb-y`、`table-scrollbar-track-x`、`table-scrollbar-thumb-x`、`table-skeleton-row`、`table-skeleton-cell`、`table-summary`、`table-summary-row`、`table-summary-cell`。具体节点随模式和状态出现,不表示固定嵌套顺序。
13347
13477
 
13348
13478
  ## 样式定制
13349
13479
 
@@ -13372,7 +13502,7 @@ export default () => (
13372
13502
 
13373
13503
  > Tabs:需要在同一页面区域内切换多组相关内容,且各面板互斥展示时。
13374
13504
 
13375
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
13505
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
13376
13506
 
13377
13507
  公开导出:`Tabs`。
13378
13508
 
@@ -13681,7 +13811,7 @@ Apex Tabs 仅支持 `items` 配置式,不支持 `Tabs.TabPane` 复合写法。
13681
13811
 
13682
13812
  > Tag:需要标记状态、分类、属性等短文本信息时(如「进行中」「VIP」)。
13683
13813
 
13684
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
13814
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
13685
13815
 
13686
13816
  公开导出:`Tag`。
13687
13817
 
@@ -13712,7 +13842,7 @@ export default () => <Tag>默认标签</Tag>
13712
13842
  | 属性 | 说明 | 类型 | 必填 | 默认值 |
13713
13843
  | --- | --- | --- | --- | --- |
13714
13844
  | closeIcon | 自定义关闭按钮。`false`/`null` 隐藏,`true` 使用默认图标,传入 ReactNode 自定义。 | `React.ReactNode` | 否 | `false` |
13715
- | color | 标签色(支持预设值与自定义色字符串)。<br>自定义字符串会作为 `backgroundColor` / `borderColor` 注入 inline style;<br>`data-color` 同步输出原始值,便于消费方覆盖。 | `TagColor` | 否 | `'default'` |
13845
+ | color | 标签色(支持预设值与自定义色字符串)。<br>自定义字符串会作为 `backgroundColor` / `borderColor` 注入 inline style;<br>`data-color` 同步输出原始值,便于消费方覆盖。 | `TagColor` | 否 | `'grey'` |
13716
13846
  | disabled | 是否禁用标签交互。 | `boolean` | 否 | `false` |
13717
13847
  | href | 点击跳转地址,存在时渲染为 a 标签。 | `string` | 否 | — |
13718
13848
  | target | a 标签 target,href 存在时生效。 | `string` | 否 | — |
@@ -13731,7 +13861,7 @@ type TagVariant = 'filled' | 'solid' | 'outlined'
13731
13861
  ### TagPresetColor
13732
13862
 
13733
13863
  ```typescript
13734
- type TagPresetColor = 'default' | 'brand' | 'success' | 'warning' | 'error'
13864
+ type TagPresetColor = 'default' | 'brand' | 'success' | 'warning' | 'error' | 'grey'
13735
13865
  ```
13736
13866
 
13737
13867
  ### TagColor
@@ -13754,7 +13884,7 @@ type TagSize = 'lg' | 'md' | 'sm'
13754
13884
 
13755
13885
  ### 样式变体
13756
13886
 
13757
- 通过 `variant` 切换浅底、实心和描边三种视觉样式。
13887
+ 当前设计 Token 支持浅底 `filled` 和中性描边 `outlined` 两种预设视觉样式。
13758
13888
 
13759
13889
  ```tsx
13760
13890
  import { Tag } from '@apexhub/apex-ui-react'
@@ -13762,7 +13892,6 @@ import { Tag } from '@apexhub/apex-ui-react'
13762
13892
  export default () => (
13763
13893
  <div style={{ display: 'flex', gap: 8, flexWrap: 'wrap' }}>
13764
13894
  <Tag variant="filled">Filled</Tag>
13765
- <Tag variant="solid">Solid</Tag>
13766
13895
  <Tag variant="outlined">Outlined</Tag>
13767
13896
  </div>
13768
13897
  )
@@ -13770,16 +13899,16 @@ export default () => (
13770
13899
 
13771
13900
  ### 多彩标签
13772
13901
 
13773
- 使用 `color` 表示语义色,也可以传入具体色值满足临时标记场景。
13902
+ 使用 `color` 表示语义色,也可以传入具体色值满足临时标记场景。React 版提供 `grey` 预设。`solid` 暂无预设色 Token,不用于预设色示例。
13774
13903
 
13775
13904
  ```tsx
13776
13905
  import type { TagPresetColor, TagVariant } from '@apexhub/apex-ui-react'
13777
13906
 
13778
13907
  import { Divider, Tag } from '@apexhub/apex-ui-react'
13779
13908
 
13780
- const variants: TagVariant[] = ['filled', 'solid', 'outlined']
13909
+ const variants: TagVariant[] = ['filled', 'outlined']
13781
13910
 
13782
- const presets: TagPresetColor[] = ['default', 'brand', 'success', 'warning', 'error']
13911
+ const presets: TagPresetColor[] = ['grey', 'brand', 'success', 'warning', 'error']
13783
13912
 
13784
13913
  const customs = ['#f50', '#2db7f5', '#87d068', '#108ee9']
13785
13914
 
@@ -13989,7 +14118,7 @@ export default () => (
13989
14118
 
13990
14119
  > Tooltip:图标按钮、缩写、截断文本等需要补充说明时。
13991
14120
 
13992
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
14121
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
13993
14122
 
13994
14123
  公开导出:`Tooltip`。
13995
14124
 
@@ -14296,7 +14425,7 @@ export default () => (
14296
14425
 
14297
14426
  > Tree:需要展示具有父子层级关系的数据(目录、组织架构、权限树等)时。
14298
14427
 
14299
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
14428
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
14300
14429
 
14301
14430
  公开导出:`Tree`。
14302
14431
 
@@ -14592,31 +14721,27 @@ Tree 实例方法(通过 `ref` 获取)
14592
14721
 
14593
14722
  ### 勾选
14594
14723
 
14595
- 设置 `checkable` 显示勾选框,配合 `checkedKeys` / 勾选变化事件 管理勾选状态。
14724
+ 设置 `checkable` 显示勾选框,配合 `checkedKeys` / 勾选变化事件 管理勾选状态。示例预选一个子节点,父节点显示半选;点击父节点可勾选其余可用子节点,禁用子节点保持未选。
14596
14725
 
14597
14726
  ```tsx
14598
- import { Tree } from '@apexhub/apex-ui-react'
14599
-
14600
14727
  import type { TreeDataNode } from '@apexhub/apex-ui-react'
14601
14728
 
14602
- const TREE_DATA: TreeDataNode[] = [
14729
+ import { Tree } from '@apexhub/apex-ui-react'
14730
+
14731
+ const treeData: TreeDataNode[] = [
14603
14732
  {
14604
- key: '0-0',
14605
- title: '父节点 0',
14733
+ key: 'team',
14734
+ title: '项目组',
14606
14735
  children: [
14607
- { key: '0-0-0', title: '叶子 0-0' },
14608
- { key: '0-0-1', title: '叶子 0-0-1' },
14736
+ { key: 'design', title: '设计' },
14737
+ { key: 'engineering', title: '研发' },
14738
+ { key: 'archived', title: '已归档', disabled: true },
14609
14739
  ],
14610
14740
  },
14611
- {
14612
- key: '0-1',
14613
- title: '父节点 1',
14614
- children: [{ key: '0-1-0', title: '叶子 0-1-0' }],
14615
- },
14616
14741
  ]
14617
14742
 
14618
14743
  export default () => (
14619
- <Tree treeData={TREE_DATA} checkable defaultExpandAll defaultCheckedKeys={['0-0-0']} />
14744
+ <Tree treeData={treeData} checkable defaultExpandAll defaultCheckedKeys={['design']} />
14620
14745
  )
14621
14746
  ```
14622
14747
 
@@ -14804,7 +14929,7 @@ v1 未实现 `showLine`。若需要连接线样式,请关注后续版本或使
14804
14929
 
14805
14930
  > TreeSelect:表单中需要从层级数据里选取一个或多个节点时(部门、分类、地区等)。
14806
14931
 
14807
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
14932
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
14808
14933
 
14809
14934
  公开导出:`TreeSelect`。
14810
14935
 
@@ -15229,27 +15354,23 @@ export default () => (
15229
15354
 
15230
15355
  ### 勾选
15231
15356
 
15232
- `treeCheckable` 与 `multiple` 配合,通过复选框选择多个节点。
15357
+ `treeCheckable` 与 `multiple` 配合,通过复选框选择多个节点。示例预选一个子节点,可观察父节点半选;悬停一行时,行背景与该行复选框共同显示悬停态。点击父节点只勾选可用子节点,禁用子节点保持未选。
15233
15358
 
15234
15359
  ```tsx
15235
- import { TreeSelect } from '@apexhub/apex-ui-react'
15236
-
15237
15360
  import type { TreeSelectDataNode } from '@apexhub/apex-ui-react'
15238
15361
 
15239
- const TREE_SELECT_DATA: TreeSelectDataNode[] = [
15362
+ import { TreeSelect } from '@apexhub/apex-ui-react'
15363
+
15364
+ const treeData: TreeSelectDataNode[] = [
15240
15365
  {
15241
- value: '0-0',
15242
- title: '父节点 0',
15366
+ value: 'team',
15367
+ title: '项目组',
15243
15368
  children: [
15244
- { value: '0-0-0', title: '叶子 0-0' },
15245
- { value: '0-0-1', title: '叶子 0-0-1' },
15369
+ { value: 'design', title: '设计' },
15370
+ { value: 'engineering', title: '研发' },
15371
+ { value: 'archived', title: '已归档', disabled: true },
15246
15372
  ],
15247
15373
  },
15248
- {
15249
- value: '0-1',
15250
- title: '父节点 1',
15251
- children: [{ value: '0-1-0', title: '叶子 0-1-0' }],
15252
- },
15253
15374
  ]
15254
15375
 
15255
15376
  export default () => (
@@ -15257,10 +15378,10 @@ export default () => (
15257
15378
  style={{ width: '250px' }}
15258
15379
  treeCheckable
15259
15380
  multiple
15260
- treeData={TREE_SELECT_DATA}
15381
+ treeData={treeData}
15261
15382
  treeDefaultExpandAll
15262
- defaultValue={['0-0-0']}
15263
- placeholder="勾选"
15383
+ defaultValue={['design']}
15384
+ placeholder="选择团队"
15264
15385
  />
15265
15386
  )
15266
15387
  ```
@@ -15297,7 +15418,7 @@ export default () => (
15297
15418
 
15298
15419
  ### 尺寸
15299
15420
 
15300
- 支持 `large`、`medium`(默认)、`small` 三种触发器尺寸;弹层选项高度随尺寸档位对齐。
15421
+ 支持 `large`、`medium`(默认)、`small` 三种触发器尺寸;弹层选项高度随尺寸档位对齐。示例选中值并开启清除,以便对照 large/medium 的 16px 箭头、small 的 14px 箭头与各档 14px 清除按钮。
15301
15422
 
15302
15423
  ```tsx
15303
15424
  import { TreeSelect } from '@apexhub/apex-ui-react'
@@ -15322,14 +15443,27 @@ const TREE_SELECT_DATA: TreeSelectDataNode[] = [
15322
15443
 
15323
15444
  export default () => (
15324
15445
  <div style={{ display: 'flex', flexDirection: 'column', gap: 12 }}>
15325
- <TreeSelect size="large" treeData={TREE_SELECT_DATA} treeDefaultExpandAll placeholder="large" />
15446
+ <TreeSelect
15447
+ size="large"
15448
+ treeData={TREE_SELECT_DATA}
15449
+ defaultValue="0-0-0"
15450
+ allowClear
15451
+ treeDefaultExpandAll
15452
+ />
15326
15453
  <TreeSelect
15327
15454
  size="medium"
15328
15455
  treeData={TREE_SELECT_DATA}
15456
+ defaultValue="0-0-0"
15457
+ allowClear
15458
+ treeDefaultExpandAll
15459
+ />
15460
+ <TreeSelect
15461
+ size="small"
15462
+ treeData={TREE_SELECT_DATA}
15463
+ defaultValue="0-0-0"
15464
+ allowClear
15329
15465
  treeDefaultExpandAll
15330
- placeholder="medium"
15331
15466
  />
15332
- <TreeSelect size="small" treeData={TREE_SELECT_DATA} treeDefaultExpandAll placeholder="small" />
15333
15467
  </div>
15334
15468
  )
15335
15469
  ```
@@ -15366,7 +15500,7 @@ export default () => (
15366
15500
 
15367
15501
  ### 只读
15368
15502
 
15369
- `readOnly` 为 true 时仅展示已选值,不可打开下拉、不可清除或修改;与 `disabled` 正交,适合表单预览等场景。
15503
+ `readOnly` 为 true 时不可打开下拉、不可清除或修改;视觉使用禁用配色,但仍可聚焦。示例对照空值、单选和多选。
15370
15504
 
15371
15505
  ```tsx
15372
15506
  import { TreeSelect } from '@apexhub/apex-ui-react'
@@ -15392,6 +15526,7 @@ const TREE_SELECT_DATA: TreeSelectDataNode[] = [
15392
15526
  export default () => (
15393
15527
  <div style={{ display: 'flex', flexDirection: 'column', gap: 16, maxWidth: 320 }}>
15394
15528
  <TreeSelect treeData={TREE_SELECT_DATA} defaultValue="0-0-0" placeholder="可编辑" allowClear />
15529
+ <TreeSelect treeData={TREE_SELECT_DATA} readOnly placeholder="只读空值" />
15395
15530
  <TreeSelect treeData={TREE_SELECT_DATA} defaultValue="0-0-0" readOnly placeholder="只读" />
15396
15531
  <TreeSelect
15397
15532
  treeData={TREE_SELECT_DATA}
@@ -15569,7 +15704,7 @@ v1 不提供该 prop;弹层通过 Portal 挂载到 `document.body`。若需在
15569
15704
 
15570
15705
  > Typography:需要按设计字阶展示标题(`Title`)、正文(`Text`)或段落(`Paragraph`)时。
15571
15706
 
15572
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
15707
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
15573
15708
 
15574
15709
  公开导出:`Typography`、`TypographyParagraph`、`TypographyText`、`TypographyTitle`。
15575
15710
 
@@ -15985,7 +16120,7 @@ export default () => (
15985
16120
 
15986
16121
  > Upload:需要将本地文件上传到服务端,并展示上传进度与结果列表时。
15987
16122
 
15988
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
16123
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
15989
16124
 
15990
16125
  公开导出:`canPreviewFile`、`configureUploadLimits`、`formatFileSize`、`getFileExtension`、`getFileFormatIconName`、`getFileKind`、`getFilePreviewKind`、`getFilePreviewUrl`、`getUploadLimits`、`isDocumentFile`、`isImageFile`、`resetUploadLimits`、`UPLOAD_DEFAULT_MAX_COUNT`、`UPLOAD_DEFAULT_MAX_FILE_SIZE`、`UPLOAD_LIST_IGNORE`、`Upload`。
15991
16126
 
@@ -16346,7 +16481,7 @@ export default () => (
16346
16481
 
16347
16482
  ### 图片列表
16348
16483
 
16349
- `listType="picture"` 以缩略图形式展示文件。
16484
+ `listType="picture"` 以缩略图形式展示文件。示例包含图片与 PDF/DOCX:非图片文件使用 40px 文件类型缩略图,不显示扩展名角标,文件名仍完整显示。
16350
16485
 
16351
16486
  ```tsx
16352
16487
  import type { UploadFile } from '@apexhub/apex-ui-react'
@@ -16406,6 +16541,8 @@ const defaultFileList = [
16406
16541
  status: 'error',
16407
16542
  thumbUrl: UPLOAD_DEMO_IMAGE_GRAY,
16408
16543
  },
16544
+ { uid: '4', name: 'report.pdf', status: 'done' },
16545
+ { uid: '5', name: 'proposal.docx', status: 'done' },
16409
16546
  ] as unknown as UploadFile[]
16410
16547
 
16411
16548
  export default () => (