@apexhub/apex-ui-react 0.0.0-stage → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +37 -2
- package/dist/en_US.d.ts +191 -0
- package/dist/index.cjs +40692 -0
- package/dist/index.d.ts +6869 -0
- package/dist/index.mjs +40676 -0
- package/dist/llm/alert.tokens.txt +44 -0
- package/dist/llm/alert.txt +167 -0
- package/dist/llm/apex-provider.txt +368 -0
- package/dist/llm/auto-complete.tokens.txt +77 -0
- package/dist/llm/auto-complete.txt +373 -0
- package/dist/llm/avatar.tokens.txt +38 -0
- package/dist/llm/avatar.txt +199 -0
- package/dist/llm/breadcrumb.tokens.txt +193 -0
- package/dist/llm/breadcrumb.txt +251 -0
- package/dist/llm/button.tokens.txt +470 -0
- package/dist/llm/button.txt +262 -0
- package/dist/llm/card.tokens.txt +27 -0
- package/dist/llm/card.txt +95 -0
- package/dist/llm/cascader.tokens.txt +253 -0
- package/dist/llm/cascader.txt +898 -0
- package/dist/llm/checkbox.tokens.txt +28 -0
- package/dist/llm/checkbox.txt +332 -0
- package/dist/llm/collapse.tokens.txt +84 -0
- package/dist/llm/collapse.txt +330 -0
- package/dist/llm/date-picker.tokens.txt +171 -0
- package/dist/llm/date-picker.txt +424 -0
- package/dist/llm/divider.tokens.txt +22 -0
- package/dist/llm/divider.txt +161 -0
- package/dist/llm/drawer.tokens.txt +71 -0
- package/dist/llm/drawer.txt +369 -0
- package/dist/llm/dropdown.tokens.txt +59 -0
- package/dist/llm/dropdown.txt +420 -0
- package/dist/llm/form.tokens.txt +26 -0
- package/dist/llm/form.txt +341 -0
- package/dist/llm/grid.txt +419 -0
- package/dist/llm/image.tokens.txt +28 -0
- package/dist/llm/image.txt +428 -0
- package/dist/llm/input-number.tokens.txt +159 -0
- package/dist/llm/input-number.txt +486 -0
- package/dist/llm/input.tokens.txt +136 -0
- package/dist/llm/input.txt +422 -0
- package/dist/llm/layout.tokens.txt +29 -0
- package/dist/llm/layout.txt +298 -0
- package/dist/llm/menu.tokens.txt +87 -0
- package/dist/llm/menu.txt +680 -0
- package/dist/llm/message.tokens.txt +25 -0
- package/dist/llm/message.txt +301 -0
- package/dist/llm/modal.tokens.txt +96 -0
- package/dist/llm/modal.txt +584 -0
- package/dist/llm/notification.tokens.txt +79 -0
- package/dist/llm/notification.txt +383 -0
- package/dist/llm/pagination.tokens.txt +33 -0
- package/dist/llm/pagination.txt +208 -0
- package/dist/llm/popover.tokens.txt +28 -0
- package/dist/llm/popover.txt +233 -0
- package/dist/llm/progress.tokens.txt +83 -0
- package/dist/llm/progress.txt +279 -0
- package/dist/llm/radio.tokens.txt +21 -0
- package/dist/llm/radio.txt +348 -0
- package/dist/llm/rate.tokens.txt +20 -0
- package/dist/llm/rate.txt +241 -0
- package/dist/llm/select.tokens.txt +160 -0
- package/dist/llm/select.txt +830 -0
- package/dist/llm/skeleton.tokens.txt +15 -0
- package/dist/llm/skeleton.txt +275 -0
- package/dist/llm/spin.tokens.txt +21 -0
- package/dist/llm/spin.txt +294 -0
- package/dist/llm/steps.tokens.txt +30 -0
- package/dist/llm/steps.txt +300 -0
- package/dist/llm/switch.tokens.txt +38 -0
- package/dist/llm/switch.txt +216 -0
- package/dist/llm/table.tokens.txt +94 -0
- package/dist/llm/table.txt +1046 -0
- package/dist/llm/tabs.tokens.txt +78 -0
- package/dist/llm/tabs.txt +306 -0
- package/dist/llm/tag.tokens.txt +76 -0
- package/dist/llm/tag.txt +305 -0
- package/dist/llm/tooltip.tokens.txt +22 -0
- package/dist/llm/tooltip.txt +304 -0
- package/dist/llm/tree-select.tokens.txt +174 -0
- package/dist/llm/tree-select.txt +762 -0
- package/dist/llm/tree.tokens.txt +36 -0
- package/dist/llm/tree.txt +505 -0
- package/dist/llm/typography.tokens.txt +60 -0
- package/dist/llm/typography.txt +413 -0
- package/dist/llm/upload.tokens.txt +201 -0
- package/dist/llm/upload.txt +706 -0
- package/dist/llms-full.txt +16689 -0
- package/dist/llms-theme.txt +32 -0
- package/dist/llms.txt +59 -0
- package/dist/locale/en_US.cjs +160 -0
- package/dist/locale/en_US.d.ts +4 -0
- package/dist/locale/en_US.mjs +161 -0
- package/dist/locale/zh_CN.cjs +160 -0
- package/dist/locale/zh_CN.d.ts +4 -0
- package/dist/locale/zh_CN.mjs +161 -0
- package/dist/style.css +19619 -0
- package/dist/zh_CN.d.ts +191 -0
- package/llms-full.txt +16689 -0
- package/llms-theme.txt +32 -0
- package/llms.txt +59 -0
- package/package.json +118 -3
- package/src/alert/llm.txt +167 -0
- package/src/alert/tokens.txt +44 -0
- package/src/apex-provider/llm.txt +368 -0
- package/src/auto-complete/llm.txt +373 -0
- package/src/auto-complete/tokens.txt +77 -0
- package/src/avatar/llm.txt +199 -0
- package/src/avatar/tokens.txt +38 -0
- package/src/breadcrumb/llm.txt +251 -0
- package/src/breadcrumb/tokens.txt +193 -0
- package/src/button/llm.txt +262 -0
- package/src/button/tokens.txt +470 -0
- package/src/card/llm.txt +95 -0
- package/src/card/tokens.txt +27 -0
- package/src/cascader/llm.txt +898 -0
- package/src/cascader/tokens.txt +253 -0
- package/src/checkbox/llm.txt +332 -0
- package/src/checkbox/tokens.txt +28 -0
- package/src/collapse/llm.txt +330 -0
- package/src/collapse/tokens.txt +84 -0
- package/src/date-picker/llm.txt +424 -0
- package/src/date-picker/tokens.txt +171 -0
- package/src/divider/llm.txt +161 -0
- package/src/divider/tokens.txt +22 -0
- package/src/drawer/llm.txt +369 -0
- package/src/drawer/tokens.txt +71 -0
- package/src/dropdown/llm.txt +420 -0
- package/src/dropdown/tokens.txt +59 -0
- package/src/form/llm.txt +341 -0
- package/src/form/tokens.txt +26 -0
- package/src/grid/llm.txt +419 -0
- package/src/image/llm.txt +428 -0
- package/src/image/tokens.txt +28 -0
- package/src/input/llm.txt +422 -0
- package/src/input/tokens.txt +136 -0
- package/src/input-number/llm.txt +486 -0
- package/src/input-number/tokens.txt +159 -0
- package/src/layout/llm.txt +298 -0
- package/src/layout/tokens.txt +29 -0
- package/src/menu/llm.txt +680 -0
- package/src/menu/tokens.txt +87 -0
- package/src/message/llm.txt +301 -0
- package/src/message/tokens.txt +25 -0
- package/src/modal/llm.txt +584 -0
- package/src/modal/tokens.txt +96 -0
- package/src/notification/llm.txt +383 -0
- package/src/notification/tokens.txt +79 -0
- package/src/pagination/llm.txt +208 -0
- package/src/pagination/tokens.txt +33 -0
- package/src/popover/llm.txt +233 -0
- package/src/popover/tokens.txt +28 -0
- package/src/progress/llm.txt +279 -0
- package/src/progress/tokens.txt +83 -0
- package/src/radio/llm.txt +348 -0
- package/src/radio/tokens.txt +21 -0
- package/src/rate/llm.txt +241 -0
- package/src/rate/tokens.txt +20 -0
- package/src/select/llm.txt +830 -0
- package/src/select/tokens.txt +160 -0
- package/src/skeleton/llm.txt +275 -0
- package/src/skeleton/tokens.txt +15 -0
- package/src/spin/llm.txt +294 -0
- package/src/spin/tokens.txt +21 -0
- package/src/steps/llm.txt +300 -0
- package/src/steps/tokens.txt +30 -0
- package/src/switch/llm.txt +216 -0
- package/src/switch/tokens.txt +38 -0
- package/src/table/llm.txt +1046 -0
- package/src/table/tokens.txt +94 -0
- package/src/tabs/llm.txt +306 -0
- package/src/tabs/tokens.txt +78 -0
- package/src/tag/llm.txt +305 -0
- package/src/tag/tokens.txt +76 -0
- package/src/tooltip/llm.txt +304 -0
- package/src/tooltip/tokens.txt +22 -0
- package/src/tree/llm.txt +505 -0
- package/src/tree/tokens.txt +36 -0
- package/src/tree-select/llm.txt +762 -0
- package/src/tree-select/tokens.txt +174 -0
- package/src/typography/llm.txt +413 -0
- package/src/typography/tokens.txt +60 -0
- package/src/upload/llm.txt +706 -0
- package/src/upload/tokens.txt +201 -0
|
@@ -0,0 +1,420 @@
|
|
|
1
|
+
# Dropdown
|
|
2
|
+
|
|
3
|
+
> Dropdown:在触发器附近展示一组快捷操作或菜单项时。
|
|
4
|
+
|
|
5
|
+
包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
|
|
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.0`(当前源码快照)。
|
|
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` |
|