Skip to content

DropdownMenu 下拉菜单 ​

为触发区域显示可定位的下拉选项,可自定义选项内容。

支持平台 ​

以下为官网文档所列的平台支持情况,具体功能及版本限制请参见本页的平台说明。

App-vueApp-nvue微信小程序支付宝小程序百度小程序字节小程序QQ小程序H5PC快手小程序钉钉小程序
✓✓(V1.5.0+)✓✓✓✓✓✓✓✓✓

基础用法 ​

vue
<!-- 点击时显示菜单 -->
<fui-dropdown-menu ref="menuRef" :options="options" @click="handleOption">
  <button @click="showMenu">打开菜单</button>
</fui-dropdown-menu>

页面的 showMenu 可调用 this.$refs.menuRef.show();options 项使用 text、src、checked 等字段。

属性 ​

属性类型说明官网默认值
optionsArray选项数据[]
textKey / srcKey / checkedKeyString文字、图片、选中状态字段text / src / checked
maxHeightNumber / String最大高度,单位 rpx;nvue 为实际高度400
minWidthNumber / String最小宽度,单位 rpx0
leftNumber / String左偏移,单位 rpx0
rightNumber / String右偏移,非负时优先于 left,单位 rpx-1
backgroundString菜单背景色#fff
radiusNumber / String圆角,单位 rpx0
paddingString选项内边距32rpx
isCheckboxBoolean是否显示选择框true
checkboxColorString选中颜色#465CFF
borderColorString未选中边框颜色#ccc
isCheckMarkBoolean是否只显示对勾false
checkmarkColorString对勾颜色#fff
isReverseBoolean是否颠倒选择框与内容位置false
splitLineBoolean是否显示项间分隔线false
lineColorString分隔线颜色#eee
iconWidthNumber / String图片图标宽高,单位 rpx48
sizeNumber / String文字大小,单位 rpx32
colorString文字颜色#181818
selectedColorString选中文字颜色-
isMaskBoolean是否显示遮罩true
maskBackgroundString遮罩背景色transparent
directionString展开方向:down、updown

事件 ​

事件说明回调参数
click点击下拉选项包含 index 和当前选项字段的对象
close点击遮罩{}

实例的 show() 用于显示菜单;非 nvue 默认主色和边框颜色由主题变量控制。

插槽 ​

插槽说明
default用于触发下拉菜单的内容
item自定义项目内容