向下彈出的菜單列表。
import Vue from 'vue';
import { DropdownMenu, DropdownItem } from 'vant';
Vue.use(DropdownMenu);
Vue.use(DropdownItem);
<van-dropdown-menu>
<van-dropdown-item v-model="value1" :options="option1" />
<van-dropdown-item v-model="value2" :options="option2" />
</van-dropdown-menu>
export default {
data() {
return {
value1: 0,
value2: 'a',
option1: [
{ text: '全部商品', value: 0 },
{ text: '新款商品', value: 1 },
{ text: '活動商品', value: 2 },
],
option2: [
{ text: '默認(rèn)排序', value: 'a' },
{ text: '好評排序', value: 'b' },
{ text: '銷量排序', value: 'c' },
],
};
},
};
通過插槽可以自定義 DropdownItem
的內(nèi)容,此時需要使用實例上的 toggle
方法手動控制菜單的顯示。
<van-dropdown-menu>
<van-dropdown-item v-model="value" :options="option" />
<van-dropdown-item title="篩選" ref="item">
<van-cell center title="包郵">
<template #right-icon>
<van-switch v-model="switch1" size="24" active-color="#ee0a24" />
</template>
</van-cell>
<van-cell center title="團購">
<template #right-icon>
<van-switch v-model="switch2" size="24" active-color="#ee0a24" />
</template>
</van-cell>
<div style="padding: 5px 16px;">
<van-button type="danger" block round @click="onConfirm">
確認(rèn)
</van-button>
</div>
</van-dropdown-item>
</van-dropdown-menu>
export default {
data() {
return {
value: 0,
switch1: false,
switch2: false,
option: [
{ text: '全部商品', value: 0 },
{ text: '新款商品', value: 1 },
{ text: '活動商品', value: 2 },
],
};
},
methods: {
onConfirm() {
this.$refs.item.toggle();
},
},
};
通過 active-color
屬性可以自定義菜單標(biāo)題和選項的選中態(tài)顏色。
<van-dropdown-menu active-color="#1989fa">
<van-dropdown-item v-model="value1" :options="option1" />
<van-dropdown-item v-model="value2" :options="option2" />
</van-dropdown-menu>
將 direction
屬性值設(shè)置為 up
,菜單即可向上展開。
<van-dropdown-menu direction="up">
<van-dropdown-item v-model="value1" :options="option1" />
<van-dropdown-item v-model="value2" :options="option2" />
</van-dropdown-menu>
<van-dropdown-menu>
<van-dropdown-item v-model="value1" disabled :options="option1" />
<van-dropdown-item v-model="value2" disabled :options="option2" />
</van-dropdown-menu>
參數(shù) | 說明 | 類型 | 默認(rèn)值 |
---|---|---|---|
active-color | 菜單標(biāo)題和選項的選中態(tài)顏色 | string | #ee0a24
|
direction | 菜單展開方向,可選值為up
|
string | down
|
z-index | 菜單欄 z-index 層級 | number | string | 10
|
duration | 動畫時長,單位秒 | number | string | 0.2
|
overlay | 是否顯示遮罩層 | boolean | true
|
close-on-click-overlay | 是否在點擊遮罩層后關(guān)閉菜單 | boolean | true
|
close-on-click-outside | 是否在點擊外部元素后關(guān)閉菜單 | boolean | true
|
參數(shù) | 說明 | 類型 | 默認(rèn)值 |
---|---|---|---|
value | 當(dāng)前選中項對應(yīng)的 value,可以通過v-model 雙向綁定 |
number | string | - |
title | 菜單項標(biāo)題 | string | 當(dāng)前選中項文字 |
options | 選項數(shù)組 | Option[] | []
|
disabled | 是否禁用菜單 | boolean | false
|
lazy-render v2.8.5
|
是否在首次展開時才渲染菜單內(nèi)容 | boolean | true
|
title-class | 標(biāo)題額外類名 | string | - |
get-container | 指定掛載的節(jié)點,用法示例 | string | () => Element | - |
事件名 | 說明 | 回調(diào)參數(shù) |
---|---|---|
change | 點擊選項導(dǎo)致 value 變化時觸發(fā) | value |
open | 打開菜單欄時觸發(fā) | - |
close | 關(guān)閉菜單欄時觸發(fā) | - |
opened | 打開菜單欄且動畫結(jié)束后觸發(fā) | - |
closed | 關(guān)閉菜單欄且動畫結(jié)束后觸發(fā) | - |
名稱 | 說明 |
---|---|
default | 菜單內(nèi)容 |
title | 自定義菜單項標(biāo)題 |
通過 ref 可以獲取到 DropdownItem 實例并調(diào)用實例方法,詳見組件實例方法。
方法名 | 說明 | 參數(shù) | 返回值 |
---|---|---|---|
toggle | 切換菜單展示狀態(tài),傳 true 為顯示,false 為隱藏,不傳參為取反 |
show?: boolean | - |
鍵名 | 說明 | 類型 |
---|---|---|
text | 文字 | string |
value | 標(biāo)識符 | number | string |
icon | 左側(cè)圖標(biāo)名稱或圖片鏈接 | string |
組件提供了下列 Less 變量,可用于自定義樣式,使用方法請參考主題定制。
名稱 | 默認(rèn)值 | 描述 |
---|---|---|
@dropdown-menu-height | 48px
|
- |
@dropdown-menu-background-color | @white
|
- |
@dropdown-menu-box-shadow | 0 2px 12px fade(@gray-7, 12)
|
- |
@dropdown-menu-title-font-size | 15px
|
- |
@dropdown-menu-title-text-color | @text-color
|
- |
@dropdown-menu-title-active-text-color | @red
|
- |
@dropdown-menu-title-disabled-text-color | @gray-6
|
- |
@dropdown-menu-title-padding | 0 @padding-xs
|
- |
@dropdown-menu-title-line-height | @line-height-lg
|
- |
@dropdown-menu-option-active-color | @red
|
- |
@dropdown-menu-content-max-height | 80%
|
- |
@dropdown-item-z-index | 10
|
- |
把 DropdownMenu
嵌套在 Tabs
等組件內(nèi)部使用時,可能會遇到下拉菜單位置錯誤的問題。這是因為在 Chrome 瀏覽器中,transform 元素內(nèi)部的 fixed 布局會降級成 absolute 布局,導(dǎo)致下拉菜單的布局異常。
將 DropdownItem
的 get-container
屬性設(shè)置為 body
即可避免此問題:
<van-dropdown-menu>
<van-dropdown-item get-container="body" />
<van-dropdown-item get-container="body" />
</van-dropdown-menu>
更多建議: