@apexhub/apex-ui-react 0.0.0-stage → 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 (185) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +37 -2
  3. package/dist/en_US.d.ts +191 -0
  4. package/dist/index.cjs +40727 -0
  5. package/dist/index.d.ts +6873 -0
  6. package/dist/index.mjs +40711 -0
  7. package/dist/llm/alert.tokens.txt +44 -0
  8. package/dist/llm/alert.txt +167 -0
  9. package/dist/llm/apex-provider.txt +369 -0
  10. package/dist/llm/auto-complete.tokens.txt +77 -0
  11. package/dist/llm/auto-complete.txt +373 -0
  12. package/dist/llm/avatar.tokens.txt +38 -0
  13. package/dist/llm/avatar.txt +199 -0
  14. package/dist/llm/breadcrumb.tokens.txt +143 -0
  15. package/dist/llm/breadcrumb.txt +251 -0
  16. package/dist/llm/button.tokens.txt +470 -0
  17. package/dist/llm/button.txt +270 -0
  18. package/dist/llm/card.tokens.txt +29 -0
  19. package/dist/llm/card.txt +118 -0
  20. package/dist/llm/cascader.tokens.txt +261 -0
  21. package/dist/llm/cascader.txt +917 -0
  22. package/dist/llm/checkbox.tokens.txt +36 -0
  23. package/dist/llm/checkbox.txt +343 -0
  24. package/dist/llm/collapse.tokens.txt +84 -0
  25. package/dist/llm/collapse.txt +330 -0
  26. package/dist/llm/date-picker.tokens.txt +171 -0
  27. package/dist/llm/date-picker.txt +428 -0
  28. package/dist/llm/divider.tokens.txt +22 -0
  29. package/dist/llm/divider.txt +161 -0
  30. package/dist/llm/drawer.tokens.txt +71 -0
  31. package/dist/llm/drawer.txt +369 -0
  32. package/dist/llm/dropdown.tokens.txt +59 -0
  33. package/dist/llm/dropdown.txt +420 -0
  34. package/dist/llm/form.tokens.txt +28 -0
  35. package/dist/llm/form.txt +341 -0
  36. package/dist/llm/grid.txt +419 -0
  37. package/dist/llm/image.tokens.txt +28 -0
  38. package/dist/llm/image.txt +428 -0
  39. package/dist/llm/input-number.tokens.txt +159 -0
  40. package/dist/llm/input-number.txt +491 -0
  41. package/dist/llm/input.tokens.txt +136 -0
  42. package/dist/llm/input.txt +424 -0
  43. package/dist/llm/layout.tokens.txt +29 -0
  44. package/dist/llm/layout.txt +298 -0
  45. package/dist/llm/menu.tokens.txt +100 -0
  46. package/dist/llm/menu.txt +687 -0
  47. package/dist/llm/message.tokens.txt +25 -0
  48. package/dist/llm/message.txt +301 -0
  49. package/dist/llm/modal.tokens.txt +96 -0
  50. package/dist/llm/modal.txt +584 -0
  51. package/dist/llm/notification.tokens.txt +79 -0
  52. package/dist/llm/notification.txt +383 -0
  53. package/dist/llm/pagination.tokens.txt +35 -0
  54. package/dist/llm/pagination.txt +217 -0
  55. package/dist/llm/popover.tokens.txt +18 -0
  56. package/dist/llm/popover.txt +233 -0
  57. package/dist/llm/progress.tokens.txt +83 -0
  58. package/dist/llm/progress.txt +279 -0
  59. package/dist/llm/radio.tokens.txt +26 -0
  60. package/dist/llm/radio.txt +385 -0
  61. package/dist/llm/rate.tokens.txt +20 -0
  62. package/dist/llm/rate.txt +241 -0
  63. package/dist/llm/select.tokens.txt +160 -0
  64. package/dist/llm/select.txt +831 -0
  65. package/dist/llm/skeleton.tokens.txt +15 -0
  66. package/dist/llm/skeleton.txt +275 -0
  67. package/dist/llm/spin.tokens.txt +21 -0
  68. package/dist/llm/spin.txt +294 -0
  69. package/dist/llm/steps.tokens.txt +30 -0
  70. package/dist/llm/steps.txt +300 -0
  71. package/dist/llm/switch.tokens.txt +38 -0
  72. package/dist/llm/switch.txt +216 -0
  73. package/dist/llm/table.tokens.txt +94 -0
  74. package/dist/llm/table.txt +1049 -0
  75. package/dist/llm/tabs.tokens.txt +78 -0
  76. package/dist/llm/tabs.txt +306 -0
  77. package/dist/llm/tag.tokens.txt +75 -0
  78. package/dist/llm/tag.txt +304 -0
  79. package/dist/llm/tooltip.tokens.txt +22 -0
  80. package/dist/llm/tooltip.txt +304 -0
  81. package/dist/llm/tree-select.tokens.txt +175 -0
  82. package/dist/llm/tree-select.txt +772 -0
  83. package/dist/llm/tree.tokens.txt +34 -0
  84. package/dist/llm/tree.txt +501 -0
  85. package/dist/llm/typography.tokens.txt +60 -0
  86. package/dist/llm/typography.txt +413 -0
  87. package/dist/llm/upload.tokens.txt +205 -0
  88. package/dist/llm/upload.txt +708 -0
  89. package/dist/llms-full.txt +16826 -0
  90. package/dist/llms-theme.txt +32 -0
  91. package/dist/llms.txt +59 -0
  92. package/dist/locale/en_US.cjs +160 -0
  93. package/dist/locale/en_US.d.ts +4 -0
  94. package/dist/locale/en_US.mjs +161 -0
  95. package/dist/locale/zh_CN.cjs +160 -0
  96. package/dist/locale/zh_CN.d.ts +4 -0
  97. package/dist/locale/zh_CN.mjs +161 -0
  98. package/dist/style.css +20095 -0
  99. package/dist/zh_CN.d.ts +191 -0
  100. package/llms-full.txt +16826 -0
  101. package/llms-theme.txt +32 -0
  102. package/llms.txt +59 -0
  103. package/package.json +118 -3
  104. package/src/alert/llm.txt +167 -0
  105. package/src/alert/tokens.txt +44 -0
  106. package/src/apex-provider/llm.txt +369 -0
  107. package/src/auto-complete/llm.txt +373 -0
  108. package/src/auto-complete/tokens.txt +77 -0
  109. package/src/avatar/llm.txt +199 -0
  110. package/src/avatar/tokens.txt +38 -0
  111. package/src/breadcrumb/llm.txt +251 -0
  112. package/src/breadcrumb/tokens.txt +143 -0
  113. package/src/button/llm.txt +270 -0
  114. package/src/button/tokens.txt +470 -0
  115. package/src/card/llm.txt +118 -0
  116. package/src/card/tokens.txt +29 -0
  117. package/src/cascader/llm.txt +917 -0
  118. package/src/cascader/tokens.txt +261 -0
  119. package/src/checkbox/llm.txt +343 -0
  120. package/src/checkbox/tokens.txt +36 -0
  121. package/src/collapse/llm.txt +330 -0
  122. package/src/collapse/tokens.txt +84 -0
  123. package/src/date-picker/llm.txt +428 -0
  124. package/src/date-picker/tokens.txt +171 -0
  125. package/src/divider/llm.txt +161 -0
  126. package/src/divider/tokens.txt +22 -0
  127. package/src/drawer/llm.txt +369 -0
  128. package/src/drawer/tokens.txt +71 -0
  129. package/src/dropdown/llm.txt +420 -0
  130. package/src/dropdown/tokens.txt +59 -0
  131. package/src/form/llm.txt +341 -0
  132. package/src/form/tokens.txt +28 -0
  133. package/src/grid/llm.txt +419 -0
  134. package/src/image/llm.txt +428 -0
  135. package/src/image/tokens.txt +28 -0
  136. package/src/input/llm.txt +424 -0
  137. package/src/input/tokens.txt +136 -0
  138. package/src/input-number/llm.txt +491 -0
  139. package/src/input-number/tokens.txt +159 -0
  140. package/src/layout/llm.txt +298 -0
  141. package/src/layout/tokens.txt +29 -0
  142. package/src/menu/llm.txt +687 -0
  143. package/src/menu/tokens.txt +100 -0
  144. package/src/message/llm.txt +301 -0
  145. package/src/message/tokens.txt +25 -0
  146. package/src/modal/llm.txt +584 -0
  147. package/src/modal/tokens.txt +96 -0
  148. package/src/notification/llm.txt +383 -0
  149. package/src/notification/tokens.txt +79 -0
  150. package/src/pagination/llm.txt +217 -0
  151. package/src/pagination/tokens.txt +35 -0
  152. package/src/popover/llm.txt +233 -0
  153. package/src/popover/tokens.txt +18 -0
  154. package/src/progress/llm.txt +279 -0
  155. package/src/progress/tokens.txt +83 -0
  156. package/src/radio/llm.txt +385 -0
  157. package/src/radio/tokens.txt +26 -0
  158. package/src/rate/llm.txt +241 -0
  159. package/src/rate/tokens.txt +20 -0
  160. package/src/select/llm.txt +831 -0
  161. package/src/select/tokens.txt +160 -0
  162. package/src/skeleton/llm.txt +275 -0
  163. package/src/skeleton/tokens.txt +15 -0
  164. package/src/spin/llm.txt +294 -0
  165. package/src/spin/tokens.txt +21 -0
  166. package/src/steps/llm.txt +300 -0
  167. package/src/steps/tokens.txt +30 -0
  168. package/src/switch/llm.txt +216 -0
  169. package/src/switch/tokens.txt +38 -0
  170. package/src/table/llm.txt +1049 -0
  171. package/src/table/tokens.txt +94 -0
  172. package/src/tabs/llm.txt +306 -0
  173. package/src/tabs/tokens.txt +78 -0
  174. package/src/tag/llm.txt +304 -0
  175. package/src/tag/tokens.txt +75 -0
  176. package/src/tooltip/llm.txt +304 -0
  177. package/src/tooltip/tokens.txt +22 -0
  178. package/src/tree/llm.txt +501 -0
  179. package/src/tree/tokens.txt +34 -0
  180. package/src/tree-select/llm.txt +772 -0
  181. package/src/tree-select/tokens.txt +175 -0
  182. package/src/typography/llm.txt +413 -0
  183. package/src/typography/tokens.txt +60 -0
  184. package/src/upload/llm.txt +708 -0
  185. package/src/upload/tokens.txt +205 -0
@@ -0,0 +1,420 @@
1
+ # Dropdown
2
+
3
+ > Dropdown:在触发器附近展示一组快捷操作或菜单项时。
4
+
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
6
+
7
+ 公开导出:`Dropdown`。
8
+
9
+ 以下 API 属于 Apex UI;不要据 antd 的同名组件推断额外属性或默认值。默认值列的空缺表示未声明,不代表 `false`。
10
+
11
+ ## 快速开始
12
+
13
+ ```tsx
14
+ import type { MenuItemType } from '@apexhub/apex-ui-react'
15
+
16
+ import { Button, Dropdown } from '@apexhub/apex-ui-react'
17
+
18
+ import '@apexhub/apex-ui-react/style.css'
19
+
20
+ const items: MenuItemType[] = [
21
+ { key: '1', label: '1st item' },
22
+ { key: '2', label: '2nd item' },
23
+ { key: '3', label: '3rd item' },
24
+ { key: '4', label: 'disabled', disabled: true },
25
+ { key: '5', label: 'loading', loading: true },
26
+ ]
27
+
28
+ export default () => (
29
+ <Dropdown trigger={['click']} menu={{ items }}>
30
+ <Button type="primary">Dropdown</Button>
31
+ </Dropdown>
32
+ )
33
+ ```
34
+
35
+ ## 何时使用
36
+
37
+ - 在触发器附近展示一组快捷操作或菜单项时。
38
+ - 需要点击、悬停或右键唤起临时菜单时(触屏上悬停会降级为点击)。
39
+ - 侧栏持久导航请使用 Menu;Dropdown 适合依附于按钮等触发器的临时菜单。
40
+
41
+ ## API
42
+
43
+ 仅使用类型定义支持的属性;原生属性、ref 目标和事件签名因组件而异。关联类型用于解释字段结构;只有「导出类型」中的名称可从包根导入。
44
+
45
+ ### Dropdown
46
+
47
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
48
+ | --- | --- | --- | --- | --- |
49
+ | open | 受控展开状态 | `boolean` | 否 | — |
50
+ | trigger | 触发方式 | `DropdownTriggerAction[]` | 否 | `['hover']` |
51
+ | placement | 弹出位置 | `"bottom" \| "bottomLeft" \| "bottomRight" \| "top" \| "topLeft" \| "topRight" \| "right" \| "rightTop" \| "rightBottom" \| "left" \| "leftTop" \| "leftBottom"` | 否 | `'bottomLeft'` |
52
+ | menu | 菜单配置 | `DropdownMenuProps` | 否 | — |
53
+ | disabled | 是否禁用 | `boolean` | 否 | — |
54
+ | autoAdjustOverflow | 贴边时是否自动调整位置 | `boolean` | 否 | `true` |
55
+ | destroyOnHidden | 关闭后是否卸载弹出层 | `boolean` | 否 | `false` |
56
+ | popupRender | 自定义菜单内容渲染 | `(menus: React.ReactNode) => React.ReactNode` | 否 | — |
57
+ | classNames | 各语义节点 class | `DropdownClassNames` | 否 | — |
58
+ | styles | 各语义节点内联样式 | `DropdownStyles` | 否 | — |
59
+ | onOpenChange | 展开状态变化;点击菜单项关闭时不触发 | `(open: boolean, info: DropdownOpenChangeInfo) => void` | 否 | — |
60
+ | children | 触发器子节点(须为单个可合并 ref 的元素) | `React.ReactElement` | 是 | — |
61
+
62
+ ### DropdownSemanticDOM
63
+
64
+ Dropdown 语义化 DOM,用于 `classNames` / `styles`
65
+
66
+ ```typescript
67
+ type DropdownSemanticDOM = 'root' | 'trigger' | 'popup' | 'menu' | 'item'
68
+ ```
69
+
70
+ ### DropdownPlacement
71
+
72
+ ```typescript
73
+ type DropdownPlacement = | 'bottom'
74
+ | 'bottomLeft'
75
+ | 'bottomRight'
76
+ | 'top'
77
+ | 'topLeft'
78
+ | 'topRight'
79
+ | 'right'
80
+ | 'rightTop'
81
+ | 'rightBottom'
82
+ | 'left'
83
+ | 'leftTop'
84
+ | 'leftBottom'
85
+ ```
86
+
87
+ ### DropdownTriggerAction
88
+
89
+ ```typescript
90
+ type DropdownTriggerAction = 'click' | 'hover' | 'contextMenu'
91
+ ```
92
+
93
+ ### DropdownOpenChangeInfo
94
+
95
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
96
+ | --- | --- | --- | --- | --- |
97
+ | source | — | `"trigger" \| "menu"` | 是 | — |
98
+
99
+ ### DropdownClassNames
100
+
101
+ ```typescript
102
+ type DropdownClassNames = | Partial<Record<DropdownSemanticDOM, string>>
103
+ | ((info: { props: DropdownProps }) => Partial<Record<DropdownSemanticDOM, string>>)
104
+ ```
105
+
106
+ ### DropdownStyles
107
+
108
+ ```typescript
109
+ type DropdownStyles = | Partial<Record<DropdownSemanticDOM, React.CSSProperties>>
110
+ | ((info: { props: DropdownProps }) => Partial<Record<DropdownSemanticDOM, React.CSSProperties>>)
111
+ ```
112
+
113
+ 其他组件的类型不在此展开:`DropdownMenuProps` 见 `../menu/llm.txt`。
114
+
115
+ ### 导出类型
116
+
117
+ 另可从 `@apexhub/apex-ui-react` 导入:`DropdownClassNames`、`DropdownOpenChangeInfo`、`DropdownPlacement`、`DropdownProps`、`DropdownSemanticDOM`、`DropdownStyles`、`DropdownTriggerAction`(与上文子类型配合使用)。
118
+
119
+ ## 代码演示
120
+
121
+ ### 触发方式
122
+
123
+ `trigger` 支持 `click`、`hover`、`contextMenu`;触屏上 `hover` 会降级为 `click`。
124
+
125
+ ```tsx
126
+ import type { MenuItemType } from '@apexhub/apex-ui-react'
127
+
128
+ import { Button, Dropdown } from '@apexhub/apex-ui-react'
129
+
130
+ const items: MenuItemType[] = [
131
+ { key: '1', label: '1st item' },
132
+ { key: '2', label: '2nd item' },
133
+ { key: '3', label: '3rd item' },
134
+ { key: '4', label: 'disabled', disabled: true },
135
+ { key: '5', label: 'loading', loading: true },
136
+ ]
137
+
138
+ export default () => (
139
+ <div style={{ display: 'flex', gap: 24, flexWrap: 'wrap' }}>
140
+ <Dropdown trigger={['hover']} menu={{ items }}>
141
+ <Button>Hover</Button>
142
+ </Dropdown>
143
+ <Dropdown trigger={['contextMenu']} menu={{ items }}>
144
+ <Button>ContextMenu</Button>
145
+ </Dropdown>
146
+ </div>
147
+ )
148
+ ```
149
+
150
+ ### 受控用法
151
+
152
+ 传入 `open` 与 展开变化事件 后由外部控制展开状态。
153
+
154
+ ```tsx
155
+ import { Button, Dropdown } from '@apexhub/apex-ui-react'
156
+
157
+ import { useState } from 'react'
158
+
159
+ const items = [
160
+ { key: 'profile', label: '个人资料' },
161
+ { key: 'settings', label: '设置' },
162
+ { key: 'logout', label: '退出' },
163
+ ]
164
+
165
+ export default () => {
166
+ const [open, setOpen] = useState(false)
167
+
168
+ return (
169
+ <div style={{ display: 'flex', gap: 12, alignItems: 'center' }}>
170
+ <Dropdown
171
+ open={open}
172
+ trigger={['click']}
173
+ menu={{ items }}
174
+ onOpenChange={(next) => setOpen(next)}
175
+ >
176
+ <Button>{open ? '收起菜单' : '展开菜单'}</Button>
177
+ </Dropdown>
178
+ <span>{open ? '当前:展开' : '当前:收起'}</span>
179
+ </div>
180
+ )
181
+ }
182
+ ```
183
+
184
+ ### 禁用
185
+
186
+ 可禁用整个 Dropdown,或在 `items` 中禁用单项。
187
+
188
+ ```tsx
189
+ import type { MenuItemType } from '@apexhub/apex-ui-react'
190
+
191
+ import { Button, Dropdown } from '@apexhub/apex-ui-react'
192
+
193
+ const items: MenuItemType[] = [
194
+ { key: '1', label: '1st item' },
195
+ { key: '2', label: '2nd item' },
196
+ { key: '3', label: '3rd item' },
197
+ { key: '4', label: 'disabled', disabled: true },
198
+ { key: '5', label: 'loading', loading: true },
199
+ ]
200
+
201
+ export default () => (
202
+ <div style={{ display: 'flex', gap: 12, flexWrap: 'wrap' }}>
203
+ <Dropdown trigger={['click']} menu={{ items }} disabled>
204
+ <Button disabled>Disabled trigger</Button>
205
+ </Dropdown>
206
+ <Dropdown
207
+ trigger={['click']}
208
+ menu={{
209
+ items: [
210
+ { key: 'd', label: 'Disabled item', disabled: true },
211
+ { key: 'ok', label: 'OK' },
212
+ ],
213
+ }}
214
+ >
215
+ <Button>With disabled item</Button>
216
+ </Dropdown>
217
+ </div>
218
+ )
219
+ ```
220
+
221
+ ### 可选中
222
+
223
+ `menu.selectable` 为 true 时支持选中态;配合 `selectedKeys` / `defaultSelectedKeys` 使用。
224
+
225
+ ```tsx
226
+ import { Button, Dropdown } from '@apexhub/apex-ui-react'
227
+
228
+ export default () => (
229
+ <Dropdown
230
+ trigger={['click']}
231
+ menu={{
232
+ selectable: true,
233
+ defaultSelectedKeys: ['2'],
234
+ items: [
235
+ { key: '1', label: 'Item 1' },
236
+ { key: '2', label: 'Item 2' },
237
+ { key: '3', label: 'Item 3' },
238
+ ],
239
+ }}
240
+ >
241
+ <Button>Selectable</Button>
242
+ </Dropdown>
243
+ )
244
+ ```
245
+
246
+ ### 图标与子菜单
247
+
248
+ `menu.items` 支持 `icon` 与嵌套 子内容 子菜单。
249
+
250
+ ```tsx
251
+ import type { MenuItemType } from '@apexhub/apex-ui-react'
252
+
253
+ import { Button, Dropdown } from '@apexhub/apex-ui-react'
254
+
255
+ const items: MenuItemType[] = [
256
+ { key: 'profile', label: '查看资料' },
257
+ { key: 'settings', label: '账号设置' },
258
+ { type: 'divider', key: 'div-1' },
259
+ {
260
+ key: 'workspace',
261
+ label: '切换工作区',
262
+ children: [
263
+ { key: 'ws-a', label: '团队 A' },
264
+ { key: 'ws-b', label: '团队 B' },
265
+ { key: 'ws-personal', label: '个人空间' },
266
+ ],
267
+ },
268
+ { type: 'divider', key: 'div-2' },
269
+ {
270
+ key: 'export',
271
+ label: '导出',
272
+ children: [
273
+ { key: 'export-pdf', label: '导出 PDF' },
274
+ { key: 'export-csv', label: '导出 CSV' },
275
+ ],
276
+ },
277
+ { key: 'sign-out', label: '退出登录' },
278
+ ]
279
+
280
+ export default () => (
281
+ <Dropdown trigger={['click']} menu={{ items }}>
282
+ <Button type="primary">账号菜单</Button>
283
+ </Dropdown>
284
+ )
285
+ ```
286
+
287
+ ### 分组与分割线
288
+
289
+ 通过 `items` 中 `type: 'group'` 或 `type: 'divider'` 组织分组标题与分割线。
290
+
291
+ ```tsx
292
+ import type { MenuItemType } from '@apexhub/apex-ui-react'
293
+
294
+ import { Button, Dropdown } from '@apexhub/apex-ui-react'
295
+
296
+ const items: MenuItemType[] = [
297
+ {
298
+ type: 'group',
299
+ key: 'group-account',
300
+ label: '账号',
301
+ children: [
302
+ { key: 'profile', label: '个人资料' },
303
+ { key: 'settings', label: '设置' },
304
+ ],
305
+ },
306
+ {
307
+ type: 'group',
308
+ key: 'group-workspace',
309
+ label: '工作区',
310
+ children: [
311
+ { key: 'members', label: '成员管理' },
312
+ { key: 'billing', label: '账单' },
313
+ ],
314
+ },
315
+ ]
316
+
317
+ export default () => (
318
+ <Dropdown trigger={['click']} menu={{ items }}>
319
+ <Button type="primary">操作菜单</Button>
320
+ </Dropdown>
321
+ )
322
+ ```
323
+
324
+ ### 弹出位置
325
+
326
+ `placement` 控制菜单相对触发器的弹出方位,贴边时可配合 `autoAdjustOverflow` 自动调整。
327
+
328
+ ```tsx
329
+ import type { DropdownPlacement, MenuItemType } from '@apexhub/apex-ui-react'
330
+
331
+ import { Button, Dropdown } from '@apexhub/apex-ui-react'
332
+
333
+ const items: MenuItemType[] = [
334
+ { key: '1', label: '1st item' },
335
+ { key: '2', label: '2nd item' },
336
+ { key: '3', label: '3rd item' },
337
+ { key: '4', label: 'disabled', disabled: true },
338
+ { key: '5', label: 'loading', loading: true },
339
+ ]
340
+
341
+ const placements: DropdownPlacement[] = [
342
+ 'bottomLeft',
343
+ 'bottom',
344
+ 'bottomRight',
345
+ 'topLeft',
346
+ 'top',
347
+ 'topRight',
348
+ ]
349
+
350
+ export default () => (
351
+ <div style={{ display: 'flex', flexWrap: 'wrap', gap: 16, padding: 80 }}>
352
+ {placements.map((placement) => (
353
+ <Dropdown key={placement} placement={placement} trigger={['click']} menu={{ items }}>
354
+ <Button>{placement}</Button>
355
+ </Dropdown>
356
+ ))}
357
+ </div>
358
+ )
359
+ ```
360
+
361
+ ### 自定义弹出内容
362
+
363
+ 通过 `popupRender`、`classNames` 和 `styles` 定制弹出层内容与局部样式。
364
+
365
+ ```tsx
366
+ import { Button, Dropdown } from '@apexhub/apex-ui-react'
367
+
368
+ const items = [
369
+ { key: 'new', label: '新建项目' },
370
+ { key: 'copy', label: '复制链接' },
371
+ { key: 'archive', label: '归档' },
372
+ ]
373
+
374
+ export default () => (
375
+ <Dropdown
376
+ trigger={['click']}
377
+ destroyOnHidden
378
+ autoAdjustOverflow={false}
379
+ menu={{ items }}
380
+ classNames={{
381
+ popup: 'custom-dropdown-popup',
382
+ item: 'custom-dropdown-item',
383
+ }}
384
+ styles={{
385
+ popup: { minWidth: 180 },
386
+ }}
387
+ popupRender={(menus) => (
388
+ <div>
389
+ <div style={{ padding: '4px 8px', color: 'var(--apex-text-neutral-secondary)' }}>
390
+ 快捷操作
391
+ </div>
392
+ {menus}
393
+ </div>
394
+ )}
395
+ >
396
+ <Button>自定义菜单</Button>
397
+ </Dropdown>
398
+ )
399
+ ```
400
+
401
+ ## DOM 结构
402
+
403
+ 源码声明的静态 `data-slot`:`dropdown-popup-scroll`、`dropdown-item-icon`、`dropdown-item-label`、`dropdown-item-check`、`dropdown-item`、`dropdown-popup`、`dropdown-menu`、`dropdown-root`、`dropdown-trigger-wrap`。具体节点随模式和状态出现,不表示固定嵌套顺序。
404
+
405
+ ## 样式定制
406
+
407
+ 优先使用本组件公开的尺寸、类型和状态属性。换肤与变量覆盖方式见 [主题指南](../../llms-theme.txt)。
408
+
409
+ 需要定制具体样式时再读取 [Token 明细](./tokens.txt),其中包含用途、定义值及适用作用域。常规组件使用无需加载该文件。
410
+
411
+ ## FAQ
412
+
413
+ ### 点击菜单项关闭后,为什么没触发 `onOpenChange`?
414
+
415
+ 这是预期行为。用户选择菜单项导致关闭时,不会触发 `onOpenChange`;仅通过触发器或蒙层等方式开关时才会回调,并附带 `info.source` 区分来源。
416
+
417
+
418
+ ### 为什么没有 `getPopupContainer`?
419
+
420
+ v1 不提供该 prop;下拉菜单通过 Radix Portal 挂载到 `document.body`。若需限制在滚动容器内,请改用 Popover 或 Select 等支持 `getPopupContainer` 的组件。
@@ -0,0 +1,59 @@
1
+ # Dropdown Token 明细
2
+
3
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
4
+
5
+ 按需读取:[组件用法](./llm.txt) · [主题与覆盖规则](../../llms-theme.txt)。
6
+
7
+ 以下组件变量在设计 Token 源中已定义,并被组件或其共享样式使用;不包含仅在实现中声明的临时变量。用途来自实际 CSS 属性,不是对外新增的 Props。
8
+
9
+ 定义值依赖所列尺寸、变体、状态和媒体作用域;Alias 引用还会随 light/dark 主题改变。它们不是统一默认值或最终计算值。作用域用于解释定义位置,不代表内部选择器是稳定的定制 API。
10
+
11
+ | Token | 用途(CSS 属性) | 定义值 | 定义作用域 |
12
+ | --- | --- | --- | --- |
13
+ | `--dropdown-fill-active` | `background-color` | `var(--apex-fill-neutral-quaternary)` | `.apex-dropdown.apex-default-dropdown` |
14
+ | `--dropdown-fill-container-default` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-dropdown.apex-default-dropdown` |
15
+ | `--dropdown-fill-default` | `background-color` | `var(--apex-fill-neutral-transparent)` | `.apex-dropdown.apex-default-dropdown` |
16
+ | `--dropdown-fill-disabled` | `background-color` | `var(--apex-fill-neutral-transparent)` | `.apex-dropdown.apex-default-dropdown` |
17
+ | `--dropdown-fill-hover` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-dropdown.apex-default-dropdown` |
18
+ | `--dropdown-fill-loading` | `background-color` | `var(--apex-fill-neutral-quaternary)` | `.apex-dropdown.apex-default-dropdown` |
19
+ | `--dropdown-fill-selected` | `background-color` | `var(--apex-fill-neutral-transparent)` | `.apex-dropdown.apex-default-dropdown` |
20
+ | `--dropdown-icon-active` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-dropdown.apex-default-dropdown` |
21
+ | `--dropdown-icon-default` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-dropdown.apex-default-dropdown` |
22
+ | `--dropdown-icon-disabled` | `color` | `var(--apex-icon-neutral-disabled)` | `.apex-dropdown.apex-default-dropdown` |
23
+ | `--dropdown-icon-hover` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-dropdown.apex-default-dropdown` |
24
+ | `--dropdown-icon-item` | `height`、`width` | `var(--apex-icon-16)` | `.apex-dropdown.apex-lg-dropdown` |
25
+ | `--dropdown-icon-item` | `height`、`width` | `var(--apex-icon-16)` | `.apex-dropdown.apex-sm-dropdown` |
26
+ | `--dropdown-icon-loading` | `color` | `var(--apex-icon-neutral-disabled)` | `.apex-dropdown.apex-default-dropdown` |
27
+ | `--dropdown-icon-selected` | `color` | `var(--apex-icon-brand-primary)` | `.apex-dropdown.apex-default-dropdown` |
28
+ | `--dropdown-radius-container` | `border-radius` | `var(--apex-radius-8)` | `.apex-dropdown.apex-lg-dropdown` |
29
+ | `--dropdown-radius-container` | `border-radius` | `var(--apex-radius-8)` | `.apex-dropdown.apex-sm-dropdown` |
30
+ | `--dropdown-radius-item` | `border-radius` | `var(--apex-radius-8)` | `.apex-dropdown.apex-lg-dropdown` |
31
+ | `--dropdown-radius-item` | `border-radius` | `var(--apex-radius-8)` | `.apex-dropdown.apex-sm-dropdown` |
32
+ | `--dropdown-size-container-gap` | `gap` | `var(--apex-spacing-2)` | `.apex-dropdown.apex-lg-dropdown` |
33
+ | `--dropdown-size-container-gap` | `gap` | `var(--apex-spacing-2)` | `.apex-dropdown.apex-sm-dropdown` |
34
+ | `--dropdown-size-container-height-max` | `max-height` | `var(--apex-size-320)` | `.apex-dropdown.apex-lg-dropdown` |
35
+ | `--dropdown-size-container-height-max` | `max-height` | `var(--apex-size-320)` | `.apex-dropdown.apex-sm-dropdown` |
36
+ | `--dropdown-size-item-gap-check-min-item` | `padding-left` | `var(--apex-spacing-12)` | `.apex-dropdown.apex-lg-dropdown` |
37
+ | `--dropdown-size-item-gap-check-min-item` | `padding-left` | `var(--apex-spacing-8)` | `.apex-dropdown.apex-sm-dropdown` |
38
+ | `--dropdown-size-item-gap-item` | `gap` | `var(--apex-spacing-4)` | `.apex-dropdown.apex-lg-dropdown` |
39
+ | `--dropdown-size-item-gap-item` | `gap` | `var(--apex-spacing-4)` | `.apex-dropdown.apex-sm-dropdown` |
40
+ | `--dropdown-size-item-height-item` | `min-height` | `var(--apex-size-32)` | `.apex-dropdown.apex-lg-dropdown` |
41
+ | `--dropdown-size-item-height-item` | `min-height` | `var(--apex-size-24)` | `.apex-dropdown.apex-sm-dropdown` |
42
+ | `--dropdown-size-item-width-min-item` | `min-width` | `var(--apex-size-80)` | `.apex-dropdown.apex-lg-dropdown` |
43
+ | `--dropdown-size-item-width-min-item` | `min-width` | `var(--apex-size-80)` | `.apex-dropdown.apex-sm-dropdown` |
44
+ | `--dropdown-spacing-container-padding-x` | `padding` | `var(--apex-spacing-6)` | `.apex-dropdown.apex-lg-dropdown` |
45
+ | `--dropdown-spacing-container-padding-x` | `padding` | `var(--apex-spacing-6)` | `.apex-dropdown.apex-sm-dropdown` |
46
+ | `--dropdown-spacing-container-padding-y` | `padding` | `var(--apex-spacing-6)` | `.apex-dropdown.apex-lg-dropdown` |
47
+ | `--dropdown-spacing-container-padding-y` | `padding` | `var(--apex-spacing-6)` | `.apex-dropdown.apex-sm-dropdown` |
48
+ | `--dropdown-spacing-item-padding-x-item` | `padding`、`padding-inline` | `var(--apex-spacing-12)` | `.apex-dropdown.apex-lg-dropdown` |
49
+ | `--dropdown-spacing-item-padding-x-item` | `padding`、`padding-inline` | `var(--apex-spacing-12)` | `.apex-dropdown.apex-sm-dropdown` |
50
+ | `--dropdown-stroke` | `border-width` | `var(--apex-border-1)` | `.apex-dropdown.apex-lg-dropdown` |
51
+ | `--dropdown-stroke` | `border-width` | `var(--apex-border-1)` | `.apex-dropdown.apex-sm-dropdown` |
52
+ | `--dropdown-stroke-container-default` | `border-color` | `var(--apex-stroke-neutral-quinary)` | `.apex-dropdown.apex-default-dropdown` |
53
+ | `--dropdown-text-active` | `color` | `var(--apex-text-neutral-primary)` | `.apex-dropdown.apex-default-dropdown` |
54
+ | `--dropdown-text-default` | `color` | `var(--apex-text-neutral-primary)` | `.apex-dropdown.apex-default-dropdown` |
55
+ | `--dropdown-text-disabled` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-dropdown.apex-default-dropdown` |
56
+ | `--dropdown-text-hover` | `color` | `var(--apex-text-neutral-primary)` | `.apex-dropdown.apex-default-dropdown` |
57
+ | `--dropdown-text-loading` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-dropdown.apex-default-dropdown` |
58
+ | `--dropdown-text-selected` | `color` | `var(--apex-text-brand-primary)` | `.apex-dropdown.apex-default-dropdown` |
59
+ | `--dropdown-text-subtitle-default` | `color` | `var(--apex-text-neutral-alpha-primary)` | `.apex-dropdown.apex-default-dropdown` |