# DropMenu 下拉菜单
## 代码演示
## 基础用法
基础用法需要绑定 `value` 值以及 `options` 属性。
`options` 属性是一个一维对象数组，数组项的数据结构为：label（选项文本），value（选项值），tip（选项说明）。
通过绑定 `bind:change` 事件，获取当前选中项。
因为小程序组件无法监听点击自己以外的地方，为了在点击页面其他地方时，可以自动关闭 dropmenu ，建议引入组件库的 clickoutside 函数（会关闭所有 dropmenu、popover、toast、swipeAction），在页面的根元素上监听点击事件的冒泡。
:::warning
如果存在用户手动点击 dropmenu 以外某个地方如按钮弹出 dropmenu 的场景，则需要在点击的元素（在这里上按钮）加上 catchtap 阻止事件冒泡到根元素上，避免触发 clickoutside 把要手动打开的 dropmenu 关闭了。
:::
```html
```
```JavaScript
import clickoutside from '/wot-design/common/clickoutside'
Page({
data: {
value1: 0,
value2: 0,
option1: [
{ label: '全部商品', value: 0 },
{ label: '新款商品', value: 1 },
{ label: '活动商品', value: 2 }
],
option2: [
{ label: '综合', value: 0 },
{ label: '销量', value: 1 },
{ label: '上架时间', value: 2 }
]
},
handleChange1 (event) {
this.setData({
value1: event.detail.value
})
},
handleChange2 (event) {
this.setData({
value1: event.detail.value
})
},
clickoutside: clickoutside
})
```
## 自定义菜单内容
通过插槽 `default` 可以自定义 `DropMenuItem` 的内容，此时需要使用实例上的 `close` 方法手动控制菜单的关闭。
可以通过 `title` 设置菜单标题。
> 这时候不要传入 options 和 value
```html
```
```JavaScript
Page({
data: {
value: 0,
option: [
{ label: '全部商品', value: 0 },
{ label: '新款商品', value: 1 },
{ label: '活动商品', value: 2 }
]
},
handleChange (event) {
this.setData({
value: event.detail.value
})
},
confirm () {
// 关闭下拉框
const drop = this.selectComponent('#drop-menu1')
drop.close()
}
})
```
## 自定义菜单选项
自己通过 flex 布局做自定义筛选展示。
```html
```
## 向上展开
将 `direction` 属性值设置为 `up`，菜单即可向上展开
```html
```
## 禁用菜单
```html
```
## DropMenu Attributes
| 参数 | 说明 | 类型 | 可选值 | 默认值 | 最低版本 |
|-----|------|-----|-------|-------|--------|
| direction | 菜单展开方向，可选值为`up` 或 `down` | string | up / down | down | - |
| modal | 是否展示蒙层 | boolean | - | true | - |
| close-on-click-modal | 是否点击蒙层时关闭 | boolean | - | true | - |
| duration | 菜单展开收起动画时间，单位 ms | number | - | 200 | - |
## DropMenuItem Attributes
| 参数 | 说明 | 类型 | 可选值 | 默认值 | 最低版本 |
|-----|------|-----|-------|-------|--------|
| value | 当前选中项对应选中的 value | string / number | - | - | - |
| disabled | 禁用菜单 | boolean | - | false | - |
| options | 列表数据，对应数据结构 `[{text: '标题', value: '0', tip: '提示文字'}]` | array | - | - | - |
| icon-name | 选中的图标名称(可选名称在wd-icon组件中) | string | - | check | - |
| title | 菜单标题 | string | - | - | - |
| value-key | 选项对象中，value对应的 key | string | - | value | - |
| label-key | 选项对象中，展示的文本对应的 key | string | - | label | - |
| tip-key | 选项对象中，选项说明对应的 key | string | - | tip | - |
## DropdownItem Events
| 方法名 | 说明 | 参数 | 最低版本 |
|------|------|------|------|---------|
| bind:change | 绑定值变化时触发 | event.detail = { value, selectedItem }, value 为选中值，selectedItem 为选中项 | - |
| bind:close | 关闭菜单 | - | - |
| bind:open | 展开菜单 | - | - |
## DropdownItem Methods
通过 `this.selectComponent('#selector')` 可以获取到 DropdownItem 实例并调用实例方法
| 方法名 | 说明 | 参数 | 返回值 | 最低版本 |
|------|------|------|------|---------|
| close | 关闭菜单 | - | - | - |
| open | 展开菜单 | - | - | - |
## DropMenu Slot
| name | 说明 | 最低版本 |
|------|-----|---------|
| default | 菜单内容 | - |
## DropMenuItem Slot
| name | 说明 | 最低版本 |
|------|-----|---------|
| default | 菜单自定义内部内容 | - |
## DropMenu 外部样式类
| 类名 | 说明 | 最低版本 |
|-----|------|--------|
| custom-class | DropMenu 根结点样式 | - |
## DropMenuItem 外部样式类
| 类名 | 说明 | 最低版本 |
|-----|------|--------|
| custom-class | DropMenuItem 根结点样式 | - |
| custom-title | DropMenuItem 左侧文字样式 | - |
| custom-icon | DropMenuItem 右侧icon样式 | - |