跳到主要内容

Dropdown 下拉菜单 ​

uni-appH5微信小程序App

uni-app 跨端下拉菜单。点击触发元素弹出操作菜单,支持图标、禁用、危险项与分隔线;选中即关闭,点遮罩关闭;支持 v-model:visible 受控可见性。

何时使用 ​

一组平级操作(3 个以上)需要收纳到触发元素下:列表项操作、更多菜单、账户菜单。

何时不使用 ​

只有两个确认/取消操作用 Popconfirm;值选择场景用 Select。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Dropdown 下拉菜单 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
itemsDropdownItem[]"[]"菜单项:{ name, label, icon?, disabled?, danger?, divided? };icon 为内置图标名(见 Icon);divided 表示该项上方加分隔线
visibleboolean"undefined"菜单是否可见,配合 v-model:visible 受控;不传时内部自管理
triggerstring:'click'"click"触发方式;移动端无 hover,仅支持 click
placementstring:'bottom' | 'top'"bottom"菜单弹出方位
disabledbooleanfalse禁用触发器,点击不弹菜单

Events ​

名称载荷说明
update:visibleboolean菜单可见性变化时触发(v-model:visible)
selectDropdownItem点击菜单项时触发并回传该项;disabled 项不触发;触发后自动关闭

Slots ​

名称说明
default触发元素

示例 ​

基础用法 ​

vue
<Dropdown :items="dropdownItems">
  <Button variant="secondary">排序 <Icon name="chevron-down" :size="14" /></Button>
</Dropdown>

禁用 ​

vue
<Dropdown :items="dropdownItems" disabled>
  <Button variant="ghost" disabled>不可用</Button>
</Dropdown>

向上弹出 ​

vue
<Dropdown :items="dropdownItems" placement="top">
  <Button variant="secondary">向上展开</Button>
</Dropdown>