@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
@@ -1,6 +1,6 @@
1
1
  # Menu Token 明细
2
2
 
3
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照)。
3
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
4
4
 
5
5
  按需读取:[组件用法](./menu.txt) · [主题与覆盖规则](../llms-theme.txt)。
6
6
 
@@ -48,6 +48,19 @@
48
48
  | `--menu-button-spacing-padding-x` | `padding` | `var(--apex-spacing-8)` | `.apex-menu-button.apex-icon-menu-button` |
49
49
  | `--menu-button-spacing-padding-x` | `padding` | `var(--apex-spacing-12)` | `.apex-menu-button.apex-primary-menu-button` |
50
50
  | `--menu-button-spacing-padding-x` | `padding` | `var(--apex-spacing-8)` | `.apex-menu-button.apex-secondary-menu-button` |
51
+ | `--menu-button-stroke-active` | `border-color` | `var(--apex-stroke-neutral-quaternary)` | `.apex-menu-button.apex-primary-menu-button` |
52
+ | `--menu-button-stroke-active` | `border-color` | `var(--apex-stroke-neutral-quaternary)` | `.apex-menu-button.apex-secondary-menu-button` |
53
+ | `--menu-button-stroke-default` | `border` | `var(--apex-stroke-neutral-secondary)` | `.apex-menu-button.apex-primary-menu-button` |
54
+ | `--menu-button-stroke-default` | `border` | `var(--apex-stroke-neutral-secondary)` | `.apex-menu-button.apex-secondary-menu-button` |
55
+ | `--menu-button-stroke-disabled` | `border-color` | `var(--apex-stroke-neutral-primary)` | `.apex-menu-button.apex-primary-menu-button` |
56
+ | `--menu-button-stroke-disabled` | `border-color` | `var(--apex-stroke-neutral-primary)` | `.apex-menu-button.apex-secondary-menu-button` |
57
+ | `--menu-button-stroke-hover` | `border-color` | `var(--apex-stroke-neutral-tertiary)` | `.apex-menu-button.apex-primary-menu-button` |
58
+ | `--menu-button-stroke-hover` | `border-color` | `var(--apex-stroke-neutral-tertiary)` | `.apex-menu-button.apex-secondary-menu-button` |
59
+ | `--menu-button-stroke-selected` | `border-color` | `var(--apex-stroke-neutral-secondary)` | `.apex-menu-button.apex-primary-menu-button` |
60
+ | `--menu-button-stroke-selected` | `border-color` | `var(--apex-stroke-brand-transparent)` | `.apex-menu-button.apex-secondary-menu-button` |
61
+ | `--menu-button-stroke-stroke` | `border` | `var(--apex-border-1)` | `.apex-menu-button.apex-icon-menu-button` |
62
+ | `--menu-button-stroke-stroke` | `border` | `var(--apex-border-1)` | `.apex-menu-button.apex-primary-menu-button` |
63
+ | `--menu-button-stroke-stroke` | `border` | `var(--apex-border-1)` | `.apex-menu-button.apex-secondary-menu-button` |
51
64
  | `--menu-button-text-active` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-menu-button.apex-primary-menu-button` |
52
65
  | `--menu-button-text-active` | `color` | `var(--apex-text-neutral-primary)` | `.apex-menu-button.apex-secondary-menu-button` |
53
66
  | `--menu-button-text-default` | `color` | `var(--apex-text-neutral-primary)` | `.apex-menu-button.apex-primary-menu-button` |
@@ -62,13 +75,13 @@
62
75
  | `--menu-fill-container-default` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-menu.apex-default-menu` |
63
76
  | `--menu-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-menu.apex-container-md-menu` |
64
77
  | `--menu-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-menu.apex-container-sm-menu` |
65
- | `--menu-spacing-gap-md` | `gap`、`margin-inline-start`、`max-width`、`padding`、`padding-bottom`、`width` | `var(--apex-spacing-12)` | `.apex-menu.apex-container-md-menu` |
66
- | `--menu-spacing-gap-md` | `gap`、`margin-inline-start`、`max-width`、`padding`、`padding-bottom`、`width` | `var(--apex-spacing-8)` | `.apex-menu.apex-container-sm-menu` |
67
- | `--menu-spacing-gap-sm` | `gap`、`inset-inline-start`、`margin-block`、`margin-block-start`、`padding` | `var(--apex-spacing-4)` | `.apex-menu-sliding-panel` |
68
- | `--menu-spacing-gap-sm` | `gap`、`inset-inline-start`、`margin-block`、`margin-block-start`、`padding` | `var(--apex-spacing-4)` | `.apex-menu.apex-container-md-menu` |
69
- | `--menu-spacing-gap-sm` | `gap`、`inset-inline-start`、`margin-block`、`margin-block-start`、`padding` | `var(--apex-spacing-4)` | `.apex-menu.apex-container-sm-menu` |
70
- | `--menu-spacing-gap-sublist` | `padding-inline-start` | `var(--apex-spacing-12)` | `.apex-menu.apex-container-md-menu` |
71
- | `--menu-spacing-gap-sublist` | `padding-inline-start` | `var(--apex-spacing-12)` | `.apex-menu.apex-container-sm-menu` |
78
+ | `--menu-spacing-gap-md` | `gap`、`margin-block-start`、`padding`、`padding-bottom` | `var(--apex-spacing-12)` | `.apex-menu.apex-container-md-menu` |
79
+ | `--menu-spacing-gap-md` | `gap`、`margin-block-start`、`padding`、`padding-bottom` | `var(--apex-spacing-8)` | `.apex-menu.apex-container-sm-menu` |
80
+ | `--menu-spacing-gap-sm` | `gap`、`margin-block`、`margin-block-end`、`margin-inline-start`、`max-width`、`padding`、`width` | `var(--apex-spacing-4)` | `.apex-menu-sliding-panel` |
81
+ | `--menu-spacing-gap-sm` | `gap`、`margin-block`、`margin-block-end`、`margin-inline-start`、`max-width`、`padding`、`width` | `var(--apex-spacing-4)` | `.apex-menu.apex-container-md-menu` |
82
+ | `--menu-spacing-gap-sm` | `gap`、`margin-block`、`margin-block-end`、`margin-inline-start`、`max-width`、`padding`、`width` | `var(--apex-spacing-4)` | `.apex-menu.apex-container-sm-menu` |
83
+ | `--menu-spacing-gap-sublist` | `margin-inline-start`、`max-width`、`padding-inline-start`、`width` | `var(--apex-spacing-12)` | `.apex-menu.apex-container-md-menu` |
84
+ | `--menu-spacing-gap-sublist` | `margin-inline-start`、`max-width`、`padding-inline-start`、`width` | `var(--apex-spacing-12)` | `.apex-menu.apex-container-sm-menu` |
72
85
  | `--menu-spacing-padding-x` | `padding` | `var(--apex-spacing-8)` | `.apex-menu-sliding-panel` |
73
86
  | `--menu-spacing-padding-x` | `padding` | `var(--apex-spacing-8)` | `.apex-menu.apex-container-md-menu` |
74
87
  | `--menu-spacing-padding-x` | `padding` | `var(--apex-spacing-4)` | `.apex-menu.apex-container-sm-menu` |
package/dist/llm/menu.txt CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Menu:侧栏持久导航,需要在图标 rail 与展开列表之间切换时。
4
4
 
5
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
6
6
 
7
7
  公开导出:`isKeySelected`、`Menu`。
8
8
 
@@ -11,7 +11,7 @@
11
11
  ## 快速开始
12
12
 
13
13
  ```tsx
14
- import { Button, Menu, MenuItemType } from '@apexhub/apex-ui-react'
14
+ import { Button, Menu, type MenuItemType } from '@apexhub/apex-ui-react'
15
15
 
16
16
  import { useState } from 'react'
17
17
 
@@ -33,13 +33,20 @@ const items: MenuItemType[] = [
33
33
 
34
34
  export default () => {
35
35
  const [collapsed, setCollapsed] = useState(false)
36
+
36
37
  return (
37
- <div>
38
- <Button onClick={() => setCollapsed(!collapsed)}>{collapsed ? '展开' : '收起'}</Button>
39
- <br />
40
- <br />
41
- <Menu items={items} collapsed={collapsed} onCollapse={setCollapsed} />
42
- </div>
38
+ <Menu
39
+ items={items}
40
+ collapsed={collapsed}
41
+ onCollapse={setCollapsed}
42
+ defaultOpenKeys={['workspace']}
43
+ defaultSelectedKeys={['projects']}
44
+ footer={
45
+ <Button type="text" onClick={() => setCollapsed((current) => !current)}>
46
+ {collapsed ? '展开菜单' : '收起菜单'}
47
+ </Button>
48
+ }
49
+ />
43
50
  )
44
51
  }
45
52
  ```
@@ -265,8 +272,8 @@ const railStyle = {
265
272
  flexDirection: 'column' as const,
266
273
  width: 'fit-content',
267
274
  height: '100%',
268
- backgroundColor: '#151618',
269
- borderRight: '1px solid #2d30367a',
275
+ backgroundColor: 'var(--apex-fill-neutral-secondary)',
276
+ borderRight: 'var(--apex-border-1) solid var(--apex-stroke-neutral-tertiary)',
270
277
  padding: 8,
271
278
  boxSizing: 'border-box' as const,
272
279
  justifyContent: 'space-between' as const,
@@ -475,7 +482,7 @@ export default () => {
475
482
 
476
483
  ### 自定义顶栏
477
484
 
478
- 通过 `header` 与 `footer` 插槽自定义收窄与展开态的顶栏、底栏内容。
485
+ 通过 `header` 与 `footer` 插槽自定义收窄与展开态的顶栏、底栏内容;展开态的顶栏沿用菜单 Token 表面样式。
479
486
 
480
487
  ```tsx
481
488
  import { Avatar, Button, Card, Dropdown, Menu, Typography } from '@apexhub/apex-ui-react'
@@ -593,7 +600,7 @@ export default () => {
593
600
  height: '100%',
594
601
  cursor: 'pointer',
595
602
  backgroundColor: profileHovered
596
- ? 'color-mix(in srgb, var(--card-fill-container-primary) 90%, white 10%)'
603
+ ? 'var(--apex-fill-neutral-tertiary)'
597
604
  : undefined,
598
605
  transition: 'background-color 0.15s ease',
599
606
  }}
@@ -1,6 +1,6 @@
1
1
  # Message Token 明细
2
2
 
3
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照)。
3
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
4
4
 
5
5
  按需读取:[组件用法](./message.txt) · [主题与覆盖规则](../llms-theme.txt)。
6
6
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Message:操作结果的轻量全局反馈(成功、失败、警告、进行中等)时。
4
4
 
5
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
6
6
 
7
7
  公开导出:`message`。
8
8
 
@@ -1,6 +1,6 @@
1
1
  # Modal Token 明细
2
2
 
3
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照)。
3
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
4
4
 
5
5
  按需读取:[组件用法](./modal.txt) · [主题与覆盖规则](../llms-theme.txt)。
6
6
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Modal:需要用户阅读并确认、取消或提交,且应暂时阻断当前页面操作时。
4
4
 
5
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
6
6
 
7
7
  公开导出:`Modal`。
8
8
 
@@ -73,7 +73,7 @@ export default () => {
73
73
  | styles | 各语义节点的内联样式,支持对象或函数 | `Partial<Record<SemanticDOM, React.CSSProperties>> \| ((info: { props: ModalProps }) => Partial<Record<SemanticDOM, React.CSSProperties>>)` | 否 | — |
74
74
  | title | 标题。`undefined`(缺省)且无关闭钮时自动补 sr-only 标题以满足无障碍;<br>`null` 时消费方在 `children` 中自行提供标题(如 `Modal.confirm`),不渲染标题区且不兜底 sr-only,须配合 `titleId` 关联无障碍名称。 | `React.ReactNode` | 否 | — |
75
75
  | open | 是否显示弹窗(受控;必填) | `boolean` | 是 | — |
76
- | width | 自定义宽度(px 数字或 CSS 长度);设置后覆盖 `size` 对应的宽度。<br>面板高度按内容自然增长,不受宽度对应尺寸档的最小高度约束;超出视口时由外层容器整体滚动。<br>未显式传 `size` 时,数字或 px 宽度仍按 420 / 560 / 720 断点匹配尺寸样式。<br>兼容:`size` 省略时 `sm` / `md` 字符串仍按 `size` 处理。 | `string \| number` | 否 | — |
76
+ | width | 自定义宽度(px 数字或 CSS 长度);设置后覆盖 `size` 对应的宽度。<br>面板高度按内容自然增长,不受宽度对应尺寸档的最小高度约束;超出视口时由外层容器整体滚动。<br>未显式传 `size` 时,数字或 px 宽度仍按 420 / 720 / 1000 断点匹配尺寸样式。<br>兼容:`size` 省略时 `sm` / `md` 字符串仍按 `size` 处理。 | `string \| number` | 否 | — |
77
77
  | wrapClassName | 含蒙层的容器 className | `string` | 否 | — |
78
78
  | onCancel | 点击蒙层、右上角关闭或 Cancel 时触发 | `(e: React.MouseEvent<HTMLElement> \| React.KeyboardEvent<HTMLElement>) => void` | 否 | — |
79
79
  | onOk | 点击 OK 时触发 | `(e: React.MouseEvent<HTMLElement>) => void` | 否 | — |
@@ -262,7 +262,7 @@ export default () => {
262
262
 
263
263
  ### 尺寸与宽度
264
264
 
265
- `size` 映射预设宽度:`sm` 420px、`md` 560px(默认)、`lg` 720px。传入 `width`(数字或 CSS 长度)时会覆盖 `size` 对应的宽度。
265
+ `size` 对应三档宽度:`sm` 420px、`md` 720px(默认)、`xl` 1000px;`lg` 为 720px 的兼容别名。传入 `width`(数字或 CSS 长度)时会覆盖预设宽度。
266
266
 
267
267
  ```tsx
268
268
  import { Button, Modal } from '@apexhub/apex-ui-react'
@@ -270,14 +270,14 @@ import { Button, Modal } from '@apexhub/apex-ui-react'
270
270
  import { useState } from 'react'
271
271
 
272
272
  export default () => {
273
- const [kind, setKind] = useState<'sm' | 'md' | 'lg' | 'custom' | null>(null)
273
+ const [kind, setKind] = useState<'sm' | 'md' | 'xl' | 'custom' | null>(null)
274
274
 
275
275
  return (
276
276
  <>
277
277
  <div style={{ display: 'flex', gap: 8, flexWrap: 'wrap' }}>
278
278
  <Button onClick={() => setKind('sm')}>sm(420px)</Button>
279
- <Button onClick={() => setKind('md')}>md(560px)</Button>
280
- <Button onClick={() => setKind('lg')}>lg(720px)</Button>
279
+ <Button onClick={() => setKind('md')}>md(720px)</Button>
280
+ <Button onClick={() => setKind('xl')}>xl(1000px)</Button>
281
281
  <Button onClick={() => setKind('custom')}>自定义 width</Button>
282
282
  </div>
283
283
  <Modal
@@ -299,13 +299,13 @@ export default () => {
299
299
  使用 size=&quot;md&quot;。
300
300
  </Modal>
301
301
  <Modal
302
- open={kind === 'lg'}
303
- size="lg"
302
+ open={kind === 'xl'}
303
+ size="xl"
304
304
  title="大尺寸"
305
305
  onCancel={() => setKind(null)}
306
306
  onOk={() => setKind(null)}
307
307
  >
308
- 使用 size=&quot;lg&quot;。
308
+ 使用 size=&quot;xl&quot;。
309
309
  </Modal>
310
310
  <Modal
311
311
  open={kind === 'custom'}
@@ -1,6 +1,6 @@
1
1
  # Notification Token 明细
2
2
 
3
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照)。
3
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
4
4
 
5
5
  按需读取:[组件用法](./notification.txt) · [主题与覆盖规则](../llms-theme.txt)。
6
6
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Notification:操作完成后的全局反馈,需要用户注意到但不必立即处理时。
4
4
 
5
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
6
6
 
7
7
  公开导出:`notification`。
8
8
 
@@ -1,6 +1,6 @@
1
1
  # Pagination Token 明细
2
2
 
3
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照)。
3
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
4
4
 
5
5
  按需读取:[组件用法](./pagination.txt) · [主题与覆盖规则](../llms-theme.txt)。
6
6
 
@@ -22,12 +22,14 @@
22
22
  | `--pagination-button-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-pagination-button.apex-default-pagination-button` |
23
23
  | `--pagination-button-spacing-height` | `height` | `var(--apex-size-28)` | `.apex-pagination-button.apex-default-pagination-button` |
24
24
  | `--pagination-button-spacing-height` | `height` | `var(--pagination-height)` | `.apex-pagination.apex-default-pagination` |
25
- | `--pagination-button-spacing-padding-x` | `padding` | `var(--apex-spacing-8)` | `.apex-pagination-button.apex-default-pagination-button` |
26
- | `--pagination-button-spacing-width` | `min-width` | `var(--apex-size-28)` | `.apex-pagination-button.apex-default-pagination-button` |
25
+ | `--pagination-button-spacing-width` | `min-width`、`width` | `var(--apex-size-28)` | `.apex-pagination-button.apex-default-pagination-button` |
27
26
  | `--pagination-button-text-active` | `color` | `var(--apex-text-neutral-primary)` | `.apex-pagination-button.apex-default-pagination-button` |
28
27
  | `--pagination-button-text-hover` | `color` | `var(--apex-text-neutral-primary)` | `.apex-pagination-button.apex-default-pagination-button` |
29
28
  | `--pagination-fill-default` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-pagination.apex-default-pagination` |
30
29
  | `--pagination-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-pagination.apex-default-pagination` |
31
30
  | `--pagination-spacing-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-pagination.apex-default-pagination` |
31
+ | `--pagination-spacing-gap-text` | `gap` | `var(--apex-spacing-16)` | `.apex-pagination.apex-default-pagination` |
32
32
  | `--pagination-spacing-padding-x` | `padding` | `var(--apex-spacing-4)` | `.apex-pagination.apex-default-pagination` |
33
- | `--pagination-spacing-padding-y` | `height`、`padding` | `var(--apex-spacing-4)` | `.apex-pagination.apex-default-pagination` |
33
+ | `--pagination-spacing-padding-y` | `min-height`、`padding` | `var(--apex-spacing-4)` | `.apex-pagination.apex-default-pagination` |
34
+ | `--pagination-stroke-default` | `border` | `var(--apex-stroke-neutral-tertiary)` | `.apex-pagination.apex-default-pagination` |
35
+ | `--pagination-text-default` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-pagination.apex-default-pagination` |
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Pagination:数据量较大、需要分批次浏览列表或表格时。
4
4
 
5
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
6
6
 
7
7
  公开导出:`Pagination`。
8
8
 
@@ -21,7 +21,7 @@ export default () => <Pagination total={85} defaultCurrent={1} />
21
21
  ## 何时使用
22
22
 
23
23
  - 数据量较大、需要分批次浏览列表或表格时。
24
- - 需要让用户切换每页条数或快速跳转到指定页时。
24
+ - 需要让用户切换每页条数时;Vue 版也支持快速跳转到指定页。
25
25
  - 纯滚动加载场景不必使用 Pagination;仅一页时可配合 `hideOnSinglePage` 隐藏分页器。
26
26
 
27
27
  ## API
@@ -42,8 +42,8 @@ export default () => <Pagination total={85} defaultCurrent={1} />
42
42
  | pageSizeOptions | pageSize 切换器的可选档位。 | `number[]` | 否 | `[10, 20, 50, 100]` |
43
43
  | disabled | 整体禁用 | `boolean` | 否 | `false` |
44
44
  | showSizeChanger | 显示 pageSize 切换器。<br>未传 → total > 50 时自动 true;显式 false → 永远关;显式 true → 永远开 | `boolean` | 否 | — |
45
- | showQuickJumper | 显示快速跳转输入 | `boolean` | 否 | `false` |
46
- | showTotal | 自定义总数显示函数;不传则不渲染总数区域 | `ShowTotalFn` | 否 | — |
45
+ | showQuickJumper | 兼容旧调用方;当前 React 设计不渲染快速跳转输入 | `boolean` | 否 | — |
46
+ | showTotal | 兼容旧调用方;当前 React 设计不渲染总数区域 | `ShowTotalFn` | 否 | — |
47
47
  | hideOnSinglePage | 总页数 ≤ 1 时不渲染整个组件 | `boolean` | 否 | `false` |
48
48
  | itemRender | 自定义每项渲染。<br>所有可点项(prev/next/jump-prev/jump-next/page)都调用此函数。<br>业务方应用 React.cloneElement(originalElement, ...) 保留 a11y props。 | `ItemRender` | 否 | — |
49
49
  | responsive | 开启容器宽度自适应(ResizeObserver 四档)。 | `boolean` | 否 | `false` |
@@ -89,7 +89,7 @@ type PageItemType = 'page' | 'prev' | 'next' | 'jump-prev' | 'jump-next'
89
89
 
90
90
  ### 每页条数切换
91
91
 
92
- 数据量较大时(默认 `total > 50`)会自动显示条数切换器,也可通过 `showSizeChanger` 强制开启或关闭。无论是否展示条数切换器或快速跳转,分页器外部高度都保持 36px;内部页码按钮与条数切换 / 快速跳转里的 Select、Input(`size="medium"` = 28px)同高,切换配置时不会引起布局跳动。
92
+ 数据量较大时(默认 `total > 50`)会自动显示条数切换器,也可通过 `showSizeChanger` 强制开启或关闭。
93
93
 
94
94
  ```tsx
95
95
  import { Pagination } from '@apexhub/apex-ui-react'
@@ -134,7 +134,9 @@ export default () => {
134
134
  }
135
135
  ```
136
136
 
137
- ### 快速跳转
137
+ ### 受控用法 (quick-jumper)
138
+
139
+ **快速跳转**
138
140
 
139
141
  `showQuickJumper` 展示跳转输入框,输入页码后按 Enter 跳转。
140
142
 
@@ -157,14 +159,21 @@ export default () => {
157
159
  }
158
160
  ```
159
161
 
160
- ### 显示总数
162
+ ### 受控用法 (show-total)
163
+
164
+ **显示总数**
161
165
 
162
166
  `showTotal` 自定义总数展示文案,接收 `(total, range) => 自定义节点`。
163
167
 
164
168
  ```tsx
165
169
  import { Pagination } from '@apexhub/apex-ui-react'
166
170
 
167
- export default () => <Pagination total={128} showTotal={(total) => `共 ${total} 条`} />
171
+ export default () => (
172
+ <Pagination
173
+ total={128}
174
+ showTotal={(total, range) => `共 ${total} 条,当前 ${range[0]}-${range[1]}`}
175
+ />
176
+ )
168
177
  ```
169
178
 
170
179
  ### 禁用
@@ -201,7 +210,7 @@ export default () => <Pagination total={50} disabled />
201
210
 
202
211
  ### `responsive` 如何工作?
203
212
 
204
- 开启后组件通过 ResizeObserver 监听容器宽度,按阈值自动隐藏部分控件(如窄屏隐藏 `showTotal`、更窄时隐藏条数切换器等)。默认 `false`,须显式传入 `responsive`。
213
+ 开启后组件通过 ResizeObserver 监听容器宽度,按阈值自动调整布局;Vue 版会逐步隐藏总数与条数切换器,React 版只调整当前实际渲染的控件。默认 `false`,须显式传入 `responsive`。
205
214
 
206
215
  ### `pageSizeOptions` 可以自定义吗?
207
216
 
@@ -1,6 +1,6 @@
1
1
  # Popover Token 明细
2
2
 
3
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照)。
3
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
4
4
 
5
5
  按需读取:[组件用法](./popover.txt) · [主题与覆盖规则](../llms-theme.txt)。
6
6
 
@@ -10,19 +10,9 @@
10
10
 
11
11
  | Token | 用途(CSS 属性) | 定义值 | 定义作用域 |
12
12
  | --- | --- | --- | --- |
13
- | `--popover-fill-default` | `background-color`、`fill` | `var(--apex-fill-neutral-tertiary)` | `.apex-popover.apex-default-popover` |
14
- | `--popover-fill-default` | `background-color`、`fill` | `var(--apex-fill-neutral-tertiary)` | `.apex-popover.apex-error-popover` |
15
- | `--popover-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-popover.apex-default-popover` |
16
- | `--popover-spacing-gap` | `gap` | `var(--apex-spacing-8)` | `.apex-popover.apex-default-popover` |
17
13
  | `--popover-spacing-height-max` | `max-height` | `var(--apex-size-560)` | `.apex-popover.apex-default-popover` |
18
- | `--popover-spacing-height-min` | `min-height` | `var(--apex-size-64)` | `.apex-popover.apex-default-popover` |
19
- | `--popover-spacing-padding-x` | `padding` | `var(--apex-spacing-12)` | `.apex-popover.apex-default-popover` |
20
- | `--popover-spacing-padding-y` | `padding` | `var(--apex-spacing-12)` | `.apex-popover.apex-default-popover` |
21
- | `--popover-spacing-width-min` | `min-width` | `var(--apex-size-240)` | `.apex-popover.apex-default-popover` |
22
- | `--popover-stroke-default` | `border`、`stroke` | `var(--apex-stroke-neutral-quinary)` | `.apex-popover.apex-default-popover` |
23
- | `--popover-stroke-default` | `border`、`stroke` | `var(--apex-stroke-error-primary)` | `.apex-popover.apex-error-popover` |
24
- | `--popover-stroke-stroke` | `border`、`margin-bottom`、`margin-top`、`stroke-width` | `var(--apex-border-08)` | `.apex-popover.apex-default-popover` |
25
- | `--popover-text-body` | `color` | `var(--apex-text-neutral-secondary)` | `.apex-popover.apex-default-popover` |
26
- | `--popover-text-body` | `color` | `var(--apex-text-neutral-secondary)` | `.apex-popover.apex-error-popover` |
27
14
  | `--popover-text-title` | `color` | `var(--apex-text-neutral-primary)` | `.apex-popover.apex-default-popover` |
28
15
  | `--popover-text-title` | `color` | `var(--apex-text-neutral-primary)` | `.apex-popover.apex-error-popover` |
16
+ | `--tooltip-fill-default` | `background-color`、`fill` | `var(--apex-fill-neutral-quaternary)` | `.apex-tooltip.apex-default-tooltip` |
17
+ | `--tooltip-stroke-default` | `border`、`stroke` | `var(--apex-stroke-neutral-transparent)` | `.apex-tooltip.apex-default-tooltip` |
18
+ | `--tooltip-stroke-stroke` | `border`、`margin-bottom`、`margin-top`、`stroke-width` | `var(--apex-border-08)` | `.apex-tooltip.apex-default-tooltip` |
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Popover:需要在触发元素旁展示标题 + 正文,且正文内可包含链接、按钮等可交互元素时。
4
4
 
5
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
6
6
 
7
7
  公开导出:`Popover`。
8
8
 
@@ -28,7 +28,7 @@ export default () => (
28
28
 
29
29
  - 需要在触发元素旁展示标题 + 正文,且正文内可包含链接、按钮等可交互元素时。
30
30
  - 点击或悬停展开补充说明、快捷操作面板时。
31
- - 树选择器、多列表单等宽面板会按内容自然展开,并在接近可用边界时自动收缩。
31
+ - 默认内容适合简短的补充信息;宽面板可通过 `className` 调整宽度,并在接近可用边界时自动收缩。
32
32
  - 若只需单行文字提示、无交互内容,请使用 Tooltip,而不是 Popover。
33
33
 
34
34
  ## API
@@ -230,4 +230,4 @@ v1 仅支持单值触发方式,避免组合触发带来的状态复杂度;
230
230
 
231
231
  ### Popover 内容有固定最大宽度吗?
232
232
 
233
- 没有。Popover 默认最小宽度由组件 Token 决定,内容会自然展开;运行时仅根据浮层可用空间限制最大宽度,避免超出视口或所在浮层边界。业务需要固定面板宽度时,可通过 `style`、`styles.popup` 或 `className` 设置。
233
+ React Popover 默认最小宽度为 80px、最大宽度为 420px,并受浮层可用空间限制。需要更宽的业务面板时,可通过 `className` 覆盖最大宽度,并确保内容在可用空间内布局。
@@ -1,6 +1,6 @@
1
1
  # Progress Token 明细
2
2
 
3
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照)。
3
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
4
4
 
5
5
  按需读取:[组件用法](./progress.txt) · [主题与覆盖规则](../llms-theme.txt)。
6
6
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Progress:需要向用户展示任务、上传、加载等操作的完成百分比时。
4
4
 
5
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
6
6
 
7
7
  公开导出:`Progress`。
8
8
 
@@ -119,7 +119,7 @@ export default () => (
119
119
 
120
120
  通过 `success.percent` 在轨道内叠加已成功部分;`format` 第二个参数为成功段百分比,可用于自定义文案。
121
121
 
122
- 以下示例在悬停整条轨道时,于目标进度(`percent`)末端显示标记线与 Tooltip;信息区文案展示成功段百分比。段颜色通过覆盖 `--progress-fill-brand` / `--progress-fill-success` 对调(仅演示)。
122
+ 以下示例在悬停整条轨道时,于目标进度(`percent`)末端显示标记线与 Tooltip;信息区文案展示成功段百分比。段颜色通过覆盖 `--progress-bar-brand` / `--progress-bar-success` 对调(仅演示)。
123
123
 
124
124
  ```tsx
125
125
  import { Progress, Tooltip } from '@apexhub/apex-ui-react'
@@ -245,8 +245,8 @@ const SuccessSegmentHoverMark = () => {
245
245
  format={(_percent, success) => `${success ?? 0}%`}
246
246
  style={
247
247
  {
248
- '--progress-fill-brand': percentStripColor,
249
- '--progress-fill-success': successStripColor,
248
+ '--progress-bar-brand': percentStripColor,
249
+ '--progress-bar-success': successStripColor,
250
250
  } as React.CSSProperties
251
251
  }
252
252
  />
@@ -1,6 +1,6 @@
1
1
  # Radio Token 明细
2
2
 
3
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照)。
3
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
4
4
 
5
5
  按需读取:[组件用法](./radio.txt) · [主题与覆盖规则](../llms-theme.txt)。
6
6
 
@@ -10,12 +10,17 @@
10
10
 
11
11
  | Token | 用途(CSS 属性) | 定义值 | 定义作用域 |
12
12
  | --- | --- | --- | --- |
13
- | `--radio-icon-icon` | `background-color`、`height`、`width` | `var(--apex-size-20)` | `.apex-radio.apex-default-radio` |
13
+ | `--radio-icon-icon` | `height`、`width` | `var(--apex-size-20)` | `.apex-radio.apex-default-radio` |
14
14
  | `--radio-spacing-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-radio.apex-default-radio` |
15
- | `--radio-stoke-stroke` | `border-width` | `var(--apex-border-1)` | `.apex-radio.apex-default-radio` |
16
- | `--radio-stroke-default` | `border-color` | `var(--apex-stroke-neutral-denary)` | `.apex-radio.apex-default-radio` |
17
- | `--radio-stroke-disabled` | `border-color` | `var(--apex-stroke-neutral-quinary)` | `.apex-radio.apex-default-radio` |
18
- | `--radio-stroke-hover` | `border-color` | `var(--apex-stroke-neutral-nonary)` | `.apex-radio.apex-default-radio` |
15
+ | `--radio-stoke-stroke` | `border`、`height`、`width` | `var(--apex-border-1)` | `.apex-radio.apex-default-radio` |
16
+ | `--radio-stroke-active` | `border-color` | `var(--apex-stroke-neutral-septenary)` | `.apex-radio.apex-default-radio` |
17
+ | `--radio-stroke-check-active` | `background-color`、`border-color` | `var(--apex-stroke-brand-tertiary)` | `.apex-radio.apex-default-radio` |
18
+ | `--radio-stroke-check-hover` | `background-color`、`border-color` | `var(--apex-stroke-brand-secondary)` | `.apex-radio.apex-default-radio` |
19
+ | `--radio-stroke-default` | `border` | `var(--apex-stroke-neutral-denary)` | `.apex-radio.apex-default-radio` |
20
+ | `--radio-stroke-disabled` | `background-color`、`border-color` | `var(--apex-stroke-neutral-quinary)` | `.apex-radio.apex-default-radio` |
21
+ | `--radio-stroke-hover` | `border-color` | `var(--apex-stroke-neutral-octonary)` | `.apex-radio.apex-default-radio` |
19
22
  | `--radio-stroke-selected` | `background-color`、`border-color` | `var(--apex-stroke-brand-primary)` | `.apex-radio.apex-default-radio` |
23
+ | `--radio-text-active` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-radio.apex-default-radio` |
20
24
  | `--radio-text-default` | `color` | `var(--apex-text-neutral-primary)` | `.apex-radio.apex-default-radio` |
21
25
  | `--radio-text-disabled` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-radio.apex-default-radio` |
26
+ | `--radio-text-hover` | `color` | `var(--apex-text-neutral-secondary)` | `.apex-radio.apex-default-radio` |
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Radio:用户必须从多个互斥选项中选择一个时(如性别、配送方式)。
4
4
 
5
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
6
6
 
7
7
  公开导出:`Radio`、`RadioGroup`、`RadioIndicator`。
8
8
 
@@ -209,6 +209,43 @@ export default () => (
209
209
  )
210
210
  ```
211
211
 
212
+ ### 状态对照
213
+
214
+ 并排展示默认与禁用状态下的未选中、已选中 Radio,便于对照控件图形与文字间距。
215
+
216
+ ```tsx
217
+ import { Radio } from '@apexhub/apex-ui-react'
218
+
219
+ export default () => (
220
+ <div
221
+ style={{
222
+ display: 'grid',
223
+ gridTemplateColumns: 'auto repeat(2, minmax(88px, 1fr))',
224
+ alignItems: 'center',
225
+ columnGap: 16,
226
+ rowGap: 12,
227
+ width: 'min(100%, 280px)',
228
+ }}
229
+ >
230
+ <span />
231
+ <span>未选中</span>
232
+ <span>已选中</span>
233
+ <span>默认</span>
234
+ <Radio value="default-unchecked">默认-未选中</Radio>
235
+ <Radio value="default-checked" defaultChecked>
236
+ 默认-已选中
237
+ </Radio>
238
+ <span>禁用</span>
239
+ <Radio value="disabled-unchecked" disabled>
240
+ 禁用-未选中
241
+ </Radio>
242
+ <Radio value="disabled-checked" disabled defaultChecked>
243
+ 禁用-已选中
244
+ </Radio>
245
+ </div>
246
+ )
247
+ ```
248
+
212
249
  ### 受控用法
213
250
 
214
251
  通过 `value` 和 变更事件 控制选中项。
@@ -1,6 +1,6 @@
1
1
  # Rate Token 明细
2
2
 
3
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照)。
3
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
4
4
 
5
5
  按需读取:[组件用法](./rate.txt) · [主题与覆盖规则](../llms-theme.txt)。
6
6
 
package/dist/llm/rate.txt CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Rate:需要对服务、内容或商品进行星级评价时。
4
4
 
5
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
6
6
 
7
7
  公开导出:`Rate`、`StarFilled`。
8
8
 
@@ -1,6 +1,6 @@
1
1
  # Select Token 明细
2
2
 
3
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照)。
3
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
4
4
 
5
5
  按需读取:[组件用法](./select.txt) · [主题与覆盖规则](../llms-theme.txt)。
6
6
 
@@ -140,10 +140,10 @@
140
140
  | `--input-stroke-stroke` | `border-width`、`padding-block` | `var(--apex-border-1)` | `.apex-input.apex-sm-input` |
141
141
  | `--input-text-filled-default` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-default-input` |
142
142
  | `--input-text-filled-default` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-elevated-input` |
143
- | `--input-text-filled-disabled` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-secondary)` | `.apex-input.apex-default-input` |
143
+ | `--input-text-filled-disabled` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-disabled)` | `.apex-input.apex-default-input` |
144
144
  | `--input-text-filled-disabled` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-disabled)` | `.apex-input.apex-elevated-input` |
145
- | `--input-text-filled-error` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-default-input` |
146
- | `--input-text-filled-error` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
145
+ | `--input-text-filled-error` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-default-input` |
146
+ | `--input-text-filled-error` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-elevated-input` |
147
147
  | `--input-text-filled-focused` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-default-input` |
148
148
  | `--input-text-filled-focused` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-elevated-input` |
149
149
  | `--input-text-filled-hover` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-default-input` |
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Select:选项来自预设列表,需要从其中选择一个或多个值时。
4
4
 
5
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
6
6
 
7
7
  公开导出:`Select`。
8
8
 
@@ -388,7 +388,7 @@ type MaxTagCount = number | 'responsive'
388
388
 
389
389
  ### 尺寸
390
390
 
391
- 支持 `large`(32px)、`medium`(默认,28px)、`small`(24px)三种尺寸。
391
+ 支持 `large`、`medium`(默认)、`small` 三种尺寸。示例选中值并开启清除:large/medium 的下拉箭头为 16px,small 为 14px,清除按钮均为 14px。
392
392
 
393
393
  ```tsx
394
394
  import { Select } from '@apexhub/apex-ui-react'
@@ -400,9 +400,9 @@ const options = [
400
400
 
401
401
  export default () => (
402
402
  <div style={{ display: 'flex', gap: 12, alignItems: 'center', flexWrap: 'wrap' }}>
403
- <Select size="large" placeholder="large" options={options} />
404
- <Select size="medium" placeholder="medium" options={options} />
405
- <Select size="small" placeholder="small" options={options} />
403
+ <Select size="large" defaultValue="react" allowClear options={options} />
404
+ <Select size="medium" defaultValue="react" allowClear options={options} />
405
+ <Select size="small" defaultValue="react" allowClear options={options} />
406
406
  </div>
407
407
  )
408
408
  ```
@@ -429,7 +429,7 @@ export default () => (
429
429
 
430
430
  ### 只读
431
431
 
432
- `readOnly` 不可打开下拉、不可改值,仅展示已选内容;与 `disabled` 正交,适合表单只读态。
432
+ `readOnly` 不可打开下拉、不可改值;视觉使用禁用配色,但仍可聚焦。示例包含空值、单选和多选。
433
433
 
434
434
  ```tsx
435
435
  import { Select } from '@apexhub/apex-ui-react'
@@ -442,6 +442,7 @@ const options = [
442
442
 
443
443
  export default () => (
444
444
  <div style={{ display: 'flex', gap: 12, alignItems: 'center', flexWrap: 'wrap' }}>
445
+ <Select readOnly placeholder="只读空值" options={options} style={{ minWidth: 160 }} />
445
446
  <Select readOnly defaultValue="a" options={options} />
446
447
  <Select
447
448
  mode="multiple"
@@ -827,4 +828,4 @@ export default () => (
827
828
 
828
829
  ### `readOnly` 和 `disabled` 有什么区别?
829
830
 
830
- `disabled` 展示禁用态且不可交互;`readOnly` 仅展示已选值、不可打开下拉或改值,视觉更接近正常态,适合表单只读场景。二者可独立使用,一般不同时需要。
831
+ `disabled` 不可交互;`readOnly` 同样使用禁用配色且不可打开下拉或改值,但保留可聚焦语义,适合表单只读场景。
@@ -1,6 +1,6 @@
1
1
  # Skeleton Token 明细
2
2
 
3
- 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照)。
3
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
4
4
 
5
5
  按需读取:[组件用法](./skeleton.txt) · [主题与覆盖规则](../llms-theme.txt)。
6
6