TIP
🚧 组件库更新通知 🚧:我们正在努力完善我们的组件库。
Dropdown 下拉菜单
将动作或菜单折叠到下拉菜单中。
基础用法
通过组件 slot 来设置下拉触发的元素以及需要通过具名 slot 为 dropdown 来设置下拉菜单。
TIP
🔨 施工中:我们的团队正在全力以赴,以确保为您提供最高质量的组件。请稍后再来查看这些组件的最新进展。
触发方式
通过设置 trigger 属性来改变触发方式。
TIP
🔨 施工中:我们的团队正在全力以赴,以确保为您提供最高质量的组件。请稍后再来查看这些组件的最新进展。
点击菜单隐藏
可以通过 hide-on-click 属性来配置。 下拉菜单默认在点击菜单项后会被隐藏,将 hide-on-click 属性设置为 false 可以关闭此功能。
TIP
🔨 施工中:我们的团队正在全力以赴,以确保为您提供最高质量的组件。请稍后再来查看这些组件的最新进展。
指令事件
点击菜单项后会触发事件,用户可以通过相应的菜单项 command 进行不同的操作。
TIP
🔨 施工中:我们的团队正在全力以赴,以确保为您提供最高质量的组件。请稍后再来查看这些组件的最新进展。
下拉方法
可以手动使用 DropdownInstance.open 或 DropdownInstance.close 以打开或关闭下拉菜单
TIP
🔨 施工中:我们的团队正在全力以赴,以确保为您提供最高质量的组件。请稍后再来查看这些组件的最新进展。
禁用状态
通过设置 disabled 属性来禁用下拉菜单。
TIP
🔨 施工中:我们的团队正在全力以赴,以确保为您提供最高质量的组件。请稍后再来查看这些组件的最新进展。
触发对象
设置 split-button 属性来让触发下拉元素呈现为按钮组,左边是功能按钮,右边是触发下拉菜单的按钮。
TIP
🔨 施工中:我们的团队正在全力以赴,以确保为您提供最高质量的组件。请稍后再来查看这些组件的最新进展。
尺寸
通过设置 size 属性来改变下拉菜单和按钮的尺寸。
TIP
🔨 施工中:我们的团队正在全力以赴,以确保为您提供最高质量的组件。请稍后再来查看这些组件的最新进展。
Dropdown API
Props
| Name | Description | Type | Default |
|---|---|---|---|
| type | 菜单按钮类型 | 同 Button 组件 的 type | -- |
| size | 菜单尺寸 | 同 Button 组件 的 size | -- |
| split-button | 下拉触发元素呈现为按钮 | boolean | false |
| disabled | 是否禁用 | boolean | false |
| trigger | 触发方式 | 'hover' | 'click' | 'contextmenu' | hover |
| placement | 弹出位置 | 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' |... | bottom |
| hideOnClick | 点击菜单项时是否隐藏下拉菜单 | boolean | true |
| show-timeout | 展开下拉菜单的延时,仅在 trigger 为 hover 时有效 | number | 150 |
| hide-timeout | 收起下拉菜单的延时,仅在 trigger 为 hover 时有效 | number | 150 |
TIP
ps: 触发方式为 hover 时,如果出现弹出层不稳定的情况,可能是 hide-timeout 值过小,请增大该值。(默认值 150 经过验证较为稳定)
Events
| Name | Description | Type |
|---|---|---|
| click | split-buttton 为 true 时,点击左侧按钮触发 | (event: MouseEvent) => void |
| visible-change | 下拉菜单显示或隐藏时触发 | (visible: boolean) => void |
| command | 点击菜单项时触发 | (command: string| number) => void |
Slots
| Name | Description | Sub Component |
|---|---|---|
| default | 默认插槽 | - |
| dropdown | 下拉菜单 | DropdownItem |
Expose
| Name | Description | Type |
|---|---|---|
| open | 打开下拉菜单 | () => void |
| close | 关闭下拉菜单 | () => void |
DropdownItem API
Props
| Name | Description | Type | Default |
|---|---|---|---|
| command | 菜单项指令 | string | number | - |
| label | 菜单项文本 | string | - |
| disabled | 禁用状态 | boolean | false |
| divider | 添加分割线 | boolean | false |
Slots
| Name | Description |
|---|---|
| default | 默认插槽, 优先级高于 props.label |