Dropdown 下拉菜单
uni-appH5微信小程序App
uni-app 跨端下拉菜单。点击触发元素弹出操作菜单,支持图标、禁用、危险项与分隔线;选中即关闭,点遮罩关闭;支持 v-model:visible 受控可见性。
何时使用
一组平级操作(3 个以上)需要收纳到触发元素下:列表项操作、更多菜单、账户菜单。
何时不使用
只有两个确认/取消操作用 Popconfirm;值选择场景用 Select。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
items | DropdownItem[] | "[]" | 菜单项:{ name, label, icon?, disabled?, danger?, divided? };icon 为内置图标名(见 Icon);divided 表示该项上方加分隔线 |
visible | boolean | "undefined" | 菜单是否可见,配合 v-model:visible 受控;不传时内部自管理 |
trigger | string:'click' | "click" | 触发方式;移动端无 hover,仅支持 click |
placement | string:'bottom' | 'top' | "bottom" | 菜单弹出方位 |
disabled | boolean | false | 禁用触发器,点击不弹菜单 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:visible | boolean | 菜单可见性变化时触发(v-model:visible) |
select | DropdownItem | 点击菜单项时触发并回传该项;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>