Dropdown 下拉菜单

按下弹出列表组件。

何时使用

当页面上的操作命令过多时,用此组件可以收纳操作元素。点击或移入触点,会出现一个下拉菜单。可在列表中进行选择,并执行相应的命令。

基本用法

组件默认插槽中定义触发元素,menu插槽中定义菜单。默认通过点击触发元素展开菜单。
<template>
  <d-dropdown style="width: 100px;" :position="position">
    <d-button>Click Me</d-button>
    <template #menu>
      <ul class="list-menu">
        <li class="menu-item">Item 1</li>
        <li class="menu-item">Item 2</li>
        <li class="menu-item">Item 3</li>
        <li class="menu-item">Item 4</li>
      </ul>
    </template>
  </d-dropdown>
</template>

<script>
import { defineComponent, ref } from 'vue';

export default defineComponent({
  setup() {
    return {
      position: ref(['bottom-start', 'right','top-end']),
    };
  },
});
</script>

<style>
.list-menu {
  padding: 0;
  margin: 0;
  width: 100px;
}
.menu-item {
  display: flex;
  justify-content: space-between;
  align-items: center;
  width: 100px;
  padding: 4px;
  cursor: pointer;
}
.menu-item:hover {
  background-color: var(--devui-list-item-hover-bg, #f2f5fc);
  color: var(--devui-list-item-hover-text, #526ecc);
}
</style>

触发方式

触发方式:
组件默认通过click方式展开;hover方式为鼠标移上触发元素展开菜单;manually方式为手动控制,通过设置visible来控制组件是否展开。
<template>
  <div class="space-y-s">
    <div class="flex items-center">
      触发方式:
      <d-radio-group direction="row" v-model="trigger">
        <d-radio v-for="item in triggerList" :key="item" :value="item">{{ item }}</d-radio>
      </d-radio-group>
    </div>
  </div>
  <d-dropdown :visible="isOpen" :trigger="trigger" :position="position" @toggle="handleToggle">
    <d-button class="mt-1">More</d-button>
    <template #menu>
      <ul class="list-menu">
        <li class="menu-item">Item 1</li>
        <li class="menu-item">Item 2</li>
        <li class="menu-item">Item 3</li>
        <li class="menu-item">Item 4</li>
      </ul>
    </template>
  </d-dropdown>
  <d-button v-show="trigger === 'manually'" @click="isOpen = !isOpen" style="margin-left: 8px;">
    {{ !isOpen ? 'show dropdown' : 'close dropdown' }}
  </d-button>
</template>

<script>
import { defineComponent, ref } from 'vue';

export default defineComponent({
  setup() {
    return {
      isOpen: ref(false),
      trigger: ref('click'),
      triggerList: ['click', 'hover', 'manually'],
      position: ref(['bottom-start']),
      handleToggle: (val) => {
        console.log(val);
      },
    };
  },
});
</script>

可关闭区域

关闭区域:
通过close-scope参数设置点击关闭区域,默认值为all表示点击菜单内外都关闭,blank点击非菜单空白才关闭,none菜单内外均不关闭仅下拉按键可以关闭。
<template>
  <div class="space-y-s">
    <div class="flex items-center">
      关闭区域:
      <d-radio-group direction="row" v-model="closeScope">
        <d-radio v-for="item in closeScopeAreas" :key="item" :value="item">{{ item }}</d-radio>
      </d-radio-group>
    </div>
  </div>
  <d-dropdown :close-scope="closeScope" :position="position" style="width: 100px;">
    <d-button class="mt-1">More</d-button>
    <template #menu>
      <ul class="list-menu">
        <li class="menu-item">Item 1</li>
        <li class="menu-item">Item 2</li>
        <li class="menu-item">Item 3</li>
        <li class="menu-item">Item 4</li>
      </ul>
    </template>
  </d-dropdown>
</template>

<script>
import { defineComponent, ref } from 'vue';

export default defineComponent({
  setup() {
    return {
      closeScope: ref('all'),
      closeScopeAreas: ['all', 'blank', 'none'],
      position: ref(['bottom-start']),
    };
  },
});
</script>

多级菜单

<template>
  <d-dropdown>
    <d-button>Click Me</d-button>
    <template #menu>
      <ul class="list-menu">
        <d-dropdown :position="position" :offset="0">
          <li class="menu-item">
            Item 1
            <i class="icon icon-chevron-right"></i>
          </li>
          <template #menu>
            <ul class="list-menu">
              <d-dropdown :position="position" :offset="0" >
                <li class="menu-item">
                  Item 1-1
                  <i class="icon icon-chevron-right"></i>
                </li>
                <template #menu>
                  <ul class="list-menu">
                    <li class="menu-item">Item 1-1-1</li>
                    <li class="menu-item">Item 1-1-2</li>
                    <li class="menu-item">Item 1-1-3</li>
                  </ul>
                </template>
              </d-dropdown>
              <li class="menu-item">Item 1-2</li>
            </ul>
          </template>
        </d-dropdown>
        <li class="menu-item">Item 2</li>
      </ul>
    </template>
  </d-dropdown>
</template>

<script>
import { defineComponent, ref } from 'vue';

export default defineComponent({
  setup() {
    return {
      position: ref(['right-start', 'right-end']),
    };
  },
});
</script>

单独使用 DropdownMenu

<template>
  <d-button ref="origin" @click="isOpen = !isOpen">More</d-button>
  <d-dropdown-menu v-model="isOpen" :origin="origin?.$el">
    <d-list style="width: 100px;">
      <d-list-item v-for="item of data" :key="item.value" @click="change(item.value)">{{ item.label }}</d-list-item>
    </d-list>
  </d-dropdown-menu>
</template>

<script>
import { defineComponent, ref } from 'vue';

export default defineComponent({
  setup() {
    const isOpen = ref(false);
    const origin = ref(null);
    const data = [
      { value: 'item 1', label: 'Item 1' },
      { value: 'item 2', label: 'Item 2' },
      { value: 'item 3', label: 'Item 3' },
    ];
    const change = (value) => {
      console.log('value', value);
      isOpen.value = false;
    };

    return {
      isOpen,
      origin,
      data,
      change,
    };
  },
});
</script>
参数名类型默认值说明跳转 Demo
visiblebooleanfalse可选,可以显式指定 dropdown 是否打开触发方式
triggerTriggerTypeclick可选,dropdown 触发方式, click 为点、hover 为悬停、manually 为完全手动控制触发方式
close-scopeCloseScopeAreaall可选,点击关闭区域,blank 点击非菜单空白关闭, all 点击菜单内外关闭,none 仅触发元素关闭可关闭区域
positionPlacement[]['bottom']可选,展开位置,按照顺序自动选择位置基本用法
offsetnumber | OffsetOptions4可选,指定与触发元素的间距多级菜单
shift-offsetnumber--可选,当设置该参数时,表示启用贴边功能,当指定的 position 放不下时,选择最近的视图边界对齐,此参数可设置相对视图边界的偏移量
close-on-mouse-leave-menubooleanfalse可选,是否进入菜单后离开菜单的时候关闭菜单
show-animationbooleantrue可选,控制是否显示动画
overlay-classstring--可选,自定义 overlay 的样式
destroy-on-hidebooleantrue可选,是否在关闭 dropdown 时将其销毁
teleportstring | HTMLElement'body'可选,挂载节点,等同于 Teleport 组件的to 属性
事件名回调参数说明跳转 Demo
toggleFunction(status: boolean)组件收起和展开的布尔值,true 表示将要展开,false 表示将要关闭触发方式
方法名类型说明
updatePosition() => void更新 dropdown 的位置,使其跟随在触发元素旁边
插槽名说明
default菜单打开时的触发元素
menu下拉菜单的内容
参数名类型默认值说明
originHTMLElement--必选,必须指定 DropdownMenu 的关联元素
v-modelbooleanfalse必选,指定 DropdownMenu 是否打开
positionPlacement[]['bottom']可选,展开位置,若位置包含startend,需通过align参数设置对齐方式
alignstart | end | nullnull可选,对齐方式,默认居中对齐。若指定start对齐,当start位置放不下时,会自动调整为end对齐
offsetnumber | OffsetOptions4可选,指定与触发元素的间距
close-outside() => boolean() => true可选,点击外部区域的回调函数,默认返回 true,点击外部区域会关闭 DropdownMenu
show-animationbooleantrue可选,控制是否显示动画
overlay-classstring--可选,自定义 overlay 的样式

TriggerType

type TriggerType = 'click' | 'hover' | 'manually';

CloseScopeArea

type CloseScopeArea = 'all' | 'blank' | 'none';

Placement

type Placement =
  | 'top'
  | 'right'
  | 'bottom'
  | 'left'
  | 'top-start'
  | 'top-end'
  | 'right-start'
  | 'right-end'
  | 'bottom-start'
  | 'bottom-end'
  | 'left-start'
  | 'left-end';

OffsetOptions

type OffsetOptions = { mainAxis?: number; crossAxis?: number };
Contributors