Vue DevUI
主题

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']可选，展开位置，若位置包含start或end，需通过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
粤A2-20044005号