Skip to content

Dropdown 下拉菜单

向下弹出的菜单面板。由 see-dropdown 容器 + see-dropdown-item 菜单项 + see-dropdown-panel 面板三部分组成,按 name 关联菜单项与面板。

用法说明:#panels 插槽中必须使用 see-dropdown-panel 包裹每个面板,并通过 name 与对应的 see-dropdown-item 关联。组件根据当前激活的 item 自动切换显示对应的 panel。

基础用法

vue
<template>
  <see-dropdown>
    <template #menu>
      <see-dropdown-item name="sort" title="排序" />
      <see-dropdown-item name="filter" title="筛选" />
    </template>
    <template #panels>
      <see-dropdown-panel name="sort">
        <view>排序面板内容</view>
      </see-dropdown-panel>
      <see-dropdown-panel name="filter">
        <view>筛选面板内容</view>
      </see-dropdown-panel>
    </template>
  </see-dropdown>
</template>

禁用项

vue
<template>
  <see-dropdown>
    <template #menu>
      <see-dropdown-item name="enabled" title="可选" />
      <see-dropdown-item name="disabled" title="禁用" :is-disabled="true" />
    </template>
    <template #panels>
      <see-dropdown-panel name="enabled">
        <view>可选面板内容</view>
      </see-dropdown-panel>
    </template>
  </see-dropdown>
</template>

无遮罩

vue
<template>
  <see-dropdown :is-overlay="false">
    <template #menu>
      <see-dropdown-item name="sort" title="排序" />
    </template>
    <template #panels>
      <see-dropdown-panel name="sort">
        <view>排序面板内容</view>
      </see-dropdown-panel>
    </template>
  </see-dropdown>
</template>

Props (Dropdown)

属性类型默认值说明
modelValueRecord<string, any>{}当前选中值
zIndexnumber100层级
durationnumber200动画时长(ms)
isOverlaybooleantrue是否显示遮罩
closeOnClickOverlaybooleantrue点击遮罩是否关闭

Props (DropdownItem)

属性类型默认值说明
namestring-唯一标识(必填),与 see-dropdown-panel 的 name 对应
titlestring''显示标题
menuType'single' | 'multiple' | 'cascade' | 'date' | 'custom''single'菜单类型
optionsDropdownOption[][]选项列表
isDisabledbooleanfalse是否禁用
placeholderstring'请选择'占位文字

Props (DropdownPanel)

属性类型默认值说明
namestring-唯一标识(必填),与 see-dropdown-item 的 name 对应

Events (Dropdown)

事件名参数说明
onChangevalue, name选项变更
onOpenname面板打开
onClosename面板关闭

Expose (Dropdown)

方法名参数说明
openname打开指定面板
closename关闭指定面板
closeAll-关闭所有面板
reset-重置所有选项

Slots

组件插槽名说明
see-dropdownmenu菜单栏(放置 see-dropdown-item
see-dropdownpanels面板容器(放置 see-dropdown-panel
see-dropdown-paneldefault单个面板的内容

辽 ICP 备 2025070134 号