ZHSW/zhsw_wechat: 智慧水务小程序 @ cb6ddd3787e1f0fe4cb15e2dff8c2143ac25facc

title: DropdownMenu 下拉菜单 description: 菜单呈现数个并列的选项类目，用于整个页面的内容筛选，由菜单面板和菜单选项组成。 spline: message

isComponent: true

该组件于 0.8.0 版本上线，请留意版本。

引入

引入组件

在 app.json 或 page.json 中引入组件：

"usingComponents": {
  "t-dropdown-menu": "tdesign-miniprogram/dropdown-menu/dropdown-menu",
  "t-dropdown-item": "tdesign-miniprogram/dropdown-item/dropdown-item"
}

代码演示

在开发者工具中预览效果

Tips: 请确保开发者工具为打开状态。导入开发者工具后，依次执行：npm i > 构建npm包 > 勾选 "将JS编译成ES5"

单选下拉菜单

多列下拉菜单

树形下拉菜单

API

DropdownMenu Props

DropdownMenu Events

名称 | 参数 | 描述 -- | -- | -- close | - | 菜单关闭时触发 open | - | 菜单展开时触发

DropdownMenu External Classes

DropdownItem Props

名称 | 类型 | 默认值 | 描述 | 必传 -- | -- | -- | -- | -- style | Object | - | 样式 | N custom-style | Object | - | 样式，一般用于开启虚拟化组件节点场景 | N disabled | Boolean | false | 是否禁用操作项 | N footer | Slot | - | 底部。通用类型定义 | N keys | Object | - | 用来定义 value / label 在 options 中对应的字段别名。TS 类型：KeysType。通用类型定义 | N label | String | - | 标题 | N multiple | Boolean | false | 是否多选 | N options | Array | [] | 选项数据。TS 类型：Array<DropdownOption> interface DropdownOption { label: string; disabled: boolean; value: DropdownValue; }。详细类型定义 | N options-columns | String / Number | 1 | 选项分栏（1-3） | N options-layout | String | columns | 已废弃。选项排列；不再支持 tree 布局，可与 treeSelect 配合使用 | N placement | String | left | 复选框和内容相对位置，仅单选菜单栏有效。可选项：left/right | N value | String / Number / Array | undefined | 选中值。TS 类型：DropdownValue type DropdownValue = string \| number \| Array<DropdownValue>;。详细类型定义 | N default-value | String / Number / Array | undefined | 选中值。非受控属性。TS 类型：DropdownValue type DropdownValue = string \| number \| Array<DropdownValue>;。详细类型定义 | N

DropdownItem Events

名称 | 参数 | 描述 -- | -- | -- change | (value: DropdownValue) | 值改变时触发 close | - | 关闭时触发 confirm | (value: DropdownValue) | 点击确认时触发 reset | - | 点击重置时触发

DropdownItem External Classes

CSS Variables

README.md 6.0 KB 履歴 Raw