Skip to content

TIP

🚧 组件库更新通知 🚧:我们正在努力完善我们的组件库。

Dropdown 下拉菜单

将动作或菜单折叠到下拉菜单中。

基础用法

通过组件 slot 来设置下拉触发的元素以及需要通过具名 slot 为 dropdown 来设置下拉菜单。

TIP

🔨 施工中:我们的团队正在全力以赴,以确保为您提供最高质量的组件。请稍后再来查看这些组件的最新进展。

触发方式

通过设置 trigger 属性来改变触发方式。

TIP

🔨 施工中:我们的团队正在全力以赴,以确保为您提供最高质量的组件。请稍后再来查看这些组件的最新进展。

点击菜单隐藏

可以通过 hide-on-click 属性来配置。 下拉菜单默认在点击菜单项后会被隐藏,将 hide-on-click 属性设置为 false 可以关闭此功能。

TIP

🔨 施工中:我们的团队正在全力以赴,以确保为您提供最高质量的组件。请稍后再来查看这些组件的最新进展。

指令事件

点击菜单项后会触发事件,用户可以通过相应的菜单项 command 进行不同的操作。

TIP

🔨 施工中:我们的团队正在全力以赴,以确保为您提供最高质量的组件。请稍后再来查看这些组件的最新进展。

下拉方法

可以手动使用 DropdownInstance.openDropdownInstance.close 以打开或关闭下拉菜单

TIP

🔨 施工中:我们的团队正在全力以赴,以确保为您提供最高质量的组件。请稍后再来查看这些组件的最新进展。

禁用状态

通过设置 disabled 属性来禁用下拉菜单。

TIP

🔨 施工中:我们的团队正在全力以赴,以确保为您提供最高质量的组件。请稍后再来查看这些组件的最新进展。

触发对象

设置 split-button 属性来让触发下拉元素呈现为按钮组,左边是功能按钮,右边是触发下拉菜单的按钮。

TIP

🔨 施工中:我们的团队正在全力以赴,以确保为您提供最高质量的组件。请稍后再来查看这些组件的最新进展。

尺寸

通过设置 size 属性来改变下拉菜单和按钮的尺寸。

TIP

🔨 施工中:我们的团队正在全力以赴,以确保为您提供最高质量的组件。请稍后再来查看这些组件的最新进展。

Props

NameDescriptionTypeDefault
type菜单按钮类型同 Button 组件 的 type--
size菜单尺寸同 Button 组件 的 size--
split-button下拉触发元素呈现为按钮booleanfalse
disabled是否禁用booleanfalse
trigger触发方式'hover' | 'click' | 'contextmenu'hover
placement弹出位置'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' |...bottom
hideOnClick点击菜单项时是否隐藏下拉菜单booleantrue
show-timeout展开下拉菜单的延时,仅在 trigger 为 hover 时有效number150
hide-timeout收起下拉菜单的延时,仅在 trigger 为 hover 时有效number150

TIP

ps: 触发方式为 hover 时,如果出现弹出层不稳定的情况,可能是 hide-timeout 值过小,请增大该值。(默认值 150 经过验证较为稳定)

Events

NameDescriptionType
clicksplit-buttton 为 true 时,点击左侧按钮触发(event: MouseEvent) => void
visible-change下拉菜单显示或隐藏时触发(visible: boolean) => void
command点击菜单项时触发(command: string| number) => void

Slots

NameDescriptionSub Component
default默认插槽-
dropdown下拉菜单DropdownItem

Expose

NameDescriptionType
open打开下拉菜单() => void
close关闭下拉菜单() => void

Props

NameDescriptionTypeDefault
command菜单项指令string | number-
label菜单项文本string-
disabled禁用状态booleanfalse
divider添加分割线booleanfalse

Slots

NameDescription
default默认插槽, 优先级高于 props.label