绝配前端组件库

# Dropdown 下拉菜单

将动作或菜单折叠到下拉菜单中。

# 基础用法

移动到下拉菜单上，展开更多操作。

通过组件slot来设置下拉触发的元素以及需要通过具名slot为dropdown 来设置下拉菜单。默认情况下，下拉按钮只要hover即可，无需点击也会显示下拉菜单。

<template>
  <jp-dropdown>
    <span class="jp-dropdown-link">
      下拉菜单
      <i class="jp-icon-arrow-down jp-icon--right"></i>
    </span>
    <jp-dropdown-menu slot="dropdown">
      <jp-dropdown-item>黄金糕</jp-dropdown-item>
      <jp-dropdown-item>狮子头</jp-dropdown-item>
      <jp-dropdown-item>螺蛳粉</jp-dropdown-item>
      <jp-dropdown-item disabled>双皮奶</jp-dropdown-item>
      <jp-dropdown-item divided>蚵仔煎</jp-dropdown-item>
    </jp-dropdown-menu>
  </jp-dropdown>
</template>

<style>
.jp-dropdown-link {
  cursor: pointer;
  color: #409eff;
}
.jp-icon-arrow-down {
  font-size: 12px;
}
</style>
显示代码

# 触发对象

可使用按钮触发下拉菜单。

设置split-button属性来让触发下拉元素呈现为按钮组，左边是功能按钮，右边是触发下拉菜单的按钮，设置为 true 即可。

<template>
  <div>
    <jp-dropdown>
      <jp-button type="primary">
        更多菜单
        <i class="jp-icon-arrow-down jp-icon--right"></i>
      </jp-button>
      <jp-dropdown-menu slot="dropdown">
        <jp-dropdown-item>黄金糕</jp-dropdown-item>
        <jp-dropdown-item>狮子头</jp-dropdown-item>
        <jp-dropdown-item>螺蛳粉</jp-dropdown-item>
        <jp-dropdown-item>双皮奶</jp-dropdown-item>
        <jp-dropdown-item>蚵仔煎</jp-dropdown-item>
      </jp-dropdown-menu>
    </jp-dropdown>
    <jp-dropdown split-button type="primary" @click="handleClick">
      更多菜单
      <jp-dropdown-menu slot="dropdown">
        <jp-dropdown-item>黄金糕</jp-dropdown-item>
        <jp-dropdown-item>狮子头</jp-dropdown-item>
        <jp-dropdown-item>螺蛳粉</jp-dropdown-item>
        <jp-dropdown-item>双皮奶</jp-dropdown-item>
        <jp-dropdown-item>蚵仔煎</jp-dropdown-item>
      </jp-dropdown-menu>
    </jp-dropdown>
  </div>
</template>

<style>
.jp-dropdown {
  vertical-align: top;
}
.jp-dropdown + .jp-dropdown {
  margin-left: 15px;
}
.jp-icon-arrow-down {
  font-size: 12px;
}
</style>

<script>
export default {
  methods: {
    handleClick() {
      alert('button click')
    }
  }
}
</script>
显示代码

# 触发方式

可以配置 click 激活或者 hover 激活。

在trigger属性设置为click即可。

<template>
  <jp-row class="block-col-2">
    <jp-col :span="12">
      <span class="demonstration">hover 激活</span>
      <jp-dropdown>
        <span class="jp-dropdown-link">
          下拉菜单
          <i class="jp-icon-arrow-down jp-icon--right"></i>
        </span>
        <jp-dropdown-menu slot="dropdown">
          <jp-dropdown-item icon="jp-icon-plus">黄金糕</jp-dropdown-item>
          <jp-dropdown-item icon="jp-icon-circle-plus">狮子头</jp-dropdown-item>
          <jp-dropdown-item icon="jp-icon-bowl">螺蛳粉</jp-dropdown-item>
          <jp-dropdown-item icon="jp-icon-check">双皮奶</jp-dropdown-item>
          <jp-dropdown-item icon="jp-icon-circle-check">蚵仔煎</jp-dropdown-item>
        </jp-dropdown-menu>
      </jp-dropdown>
    </jp-col>
    <jp-col :span="12">
      <span class="demonstration">click 激活</span>
      <jp-dropdown trigger="click">
        <span class="jp-dropdown-link">
          下拉菜单
          <i class="jp-icon-arrow-down jp-icon--right"></i>
        </span>
        <jp-dropdown-menu slot="dropdown">
          <jp-dropdown-item icon="jp-icon-plus">黄金糕</jp-dropdown-item>
          <jp-dropdown-item icon="jp-icon-circle-plus">狮子头</jp-dropdown-item>
          <jp-dropdown-item icon="jp-icon-bowl">螺蛳粉</jp-dropdown-item>
          <jp-dropdown-item icon="jp-icon-check">双皮奶</jp-dropdown-item>
          <jp-dropdown-item icon="jp-icon-circle-check">蚵仔煎</jp-dropdown-item>
        </jp-dropdown-menu>
      </jp-dropdown>
    </jp-col>
  </jp-row>
</template>

<style>
.jp-dropdown-link {
  cursor: pointer;
  color: #409eff;
}
.jp-icon-arrow-down {
  font-size: 12px;
}
.demonstration {
  display: block;
  color: #8492a6;
  font-size: 14px;
  margin-bottom: 20px;
}
</style>
显示代码

# 菜单隐藏方式

可以hide-on-click属性来配置。

下拉菜单默认在点击菜单项后会被隐藏，将hide-on-click属性默认为 false 可以关闭此功能。

<template>
  <jp-dropdown :hide-on-click="false">
    <span class="jp-dropdown-link">
      下拉菜单
      <i class="jp-icon-arrow-down jp-icon--right"></i>
    </span>
    <jp-dropdown-menu slot="dropdown">
      <jp-dropdown-item>黄金糕</jp-dropdown-item>
      <jp-dropdown-item>狮子头</jp-dropdown-item>
      <jp-dropdown-item>螺蛳粉</jp-dropdown-item>
      <jp-dropdown-item disabled>双皮奶</jp-dropdown-item>
      <jp-dropdown-item divided>蚵仔煎</jp-dropdown-item>
    </jp-dropdown-menu>
  </jp-dropdown>
</template>

<style>
.jp-dropdown-link {
  cursor: pointer;
  color: #409eff;
}
.jp-icon-arrow-down {
  font-size: 12px;
}
</style>
显示代码

# 指令事件

点击菜单项后会触发事件，用户可以通过相应的菜单项 key 进行不同的操作

<template>
  <jp-dropdown @command="handleCommand">
    <span class="jp-dropdown-link">
      下拉菜单
      <i class="jp-icon-arrow-down jp-icon--right"></i>
    </span>
    <jp-dropdown-menu slot="dropdown">
      <jp-dropdown-item command="a">黄金糕</jp-dropdown-item>
      <jp-dropdown-item command="b">狮子头</jp-dropdown-item>
      <jp-dropdown-item command="c">螺蛳粉</jp-dropdown-item>
      <jp-dropdown-item command="d" disabled>双皮奶</jp-dropdown-item>
      <jp-dropdown-item command="e" divided>蚵仔煎</jp-dropdown-item>
    </jp-dropdown-menu>
  </jp-dropdown>
</template>

<style>
.jp-dropdown-link {
  cursor: pointer;
  color: #409eff;
}
.jp-icon-arrow-down {
  font-size: 12px;
}
</style>

<script>
export default {
  methods: {
    handleCommand(command) {
      this.$message('click on item ' + command)
    }
  }
}
</script>
显示代码

# 不同尺寸

Dropdown 组件提供除了默认值以外的三种尺寸，可以在不同场景下选择合适的尺寸。

额外的尺寸：medium、small、mini，通过设置 size 属性来配置它们。

<template>
  <div>
    <jp-dropdown split-button type="primary">
      默认尺寸
      <jp-dropdown-menu slot="dropdown">
        <jp-dropdown-item>黄金糕</jp-dropdown-item>
        <jp-dropdown-item>狮子头</jp-dropdown-item>
        <jp-dropdown-item>螺蛳粉</jp-dropdown-item>
        <jp-dropdown-item>双皮奶</jp-dropdown-item>
        <jp-dropdown-item>蚵仔煎</jp-dropdown-item>
      </jp-dropdown-menu>
    </jp-dropdown>

    <jp-dropdown size="medium" split-button type="primary">
      中等尺寸
      <jp-dropdown-menu slot="dropdown">
        <jp-dropdown-item>黄金糕</jp-dropdown-item>
        <jp-dropdown-item>狮子头</jp-dropdown-item>
        <jp-dropdown-item>螺蛳粉</jp-dropdown-item>
        <jp-dropdown-item>双皮奶</jp-dropdown-item>
        <jp-dropdown-item>蚵仔煎</jp-dropdown-item>
      </jp-dropdown-menu>
    </jp-dropdown>

    <jp-dropdown size="small" split-button type="primary">
      小型尺寸
      <jp-dropdown-menu slot="dropdown">
        <jp-dropdown-item>黄金糕</jp-dropdown-item>
        <jp-dropdown-item>狮子头</jp-dropdown-item>
        <jp-dropdown-item>螺蛳粉</jp-dropdown-item>
        <jp-dropdown-item>双皮奶</jp-dropdown-item>
        <jp-dropdown-item>蚵仔煎</jp-dropdown-item>
      </jp-dropdown-menu>
    </jp-dropdown>

    <jp-dropdown size="mini" split-button type="primary">
      超小尺寸
      <jp-dropdown-menu slot="dropdown">
        <jp-dropdown-item>黄金糕</jp-dropdown-item>
        <jp-dropdown-item>狮子头</jp-dropdown-item>
        <jp-dropdown-item>螺蛳粉</jp-dropdown-item>
        <jp-dropdown-item>双皮奶</jp-dropdown-item>
        <jp-dropdown-item>蚵仔煎</jp-dropdown-item>
      </jp-dropdown-menu>
    </jp-dropdown>
  </div>
</template>
显示代码
参数 说明 类型 可选值 默认值
type 菜单按钮类型，同 Button 组件(只在split-button为 true 的情况下有效) string — —
size 菜单尺寸，在split-button为 true 的情况下也对触发按钮生效 string medium / small / mini —
split-button 下拉触发元素呈现为按钮组 boolean — false
placement 菜单弹出位置 string top/top-start/top-end/bottom/bottom-start/bottom-end bottom-end
trigger 触发下拉的行为 string hover, click hover
hide-on-click 是否在点击菜单项后隐藏菜单 boolean — true
show-timeout 展开下拉菜单的延时（仅在 trigger 为 hover 时有效） number — 250
hide-timeout 收起下拉菜单的延时（仅在 trigger 为 hover 时有效） number — 150
tabindex Dropdown 组件的 tabindex (opens new window) number — 0
disabled 是否禁用 boolean — false
Name 说明
— 触发下拉列表显示的元素。 注意： 必须是一个元素或者或者组件
dropdown 下拉列表，通常是 <jp-dropdown-menu> 组件
事件名称 说明 回调参数
click split-button 为 true 时，点击左侧按钮的回调 —
command 点击菜单项触发的事件回调 dropdown-item 的指令
visible-change 下拉框出现/隐藏时触发 出现则为 true，隐藏则为 false
参数 说明 类型 可选值 默认值
command 指令 string/number/object — —
disabled 禁用 boolean — false
divided 显示分割线 boolean — false
icon 图标类名 string — —

← Steps 步骤条 →