# v-selectmenu

**Repository Path**: TerryZ/v-selectmenu

## Basic Information

- **Project Name**: v-selectmenu
- **Description**: 基于 Vue2 的简洁、易用、高定制化的菜单解决方案
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://terryz.gitee.io/vue/#/selectmenu
- **GVP Project**: No

## Statistics

- **Stars**: 65
- **Forks**: 7
- **Created**: 2018-07-11
- **Last Updated**: 2025-03-06

## Categories & Tags

**Categories**: vue-extensions

**Tags**: None

## README

<br><br>

<h3 align="center">v-selectmenu</h3>

<br>

<p align="center"><img src="https://terryz.gitee.io/image/v-selectmenu/v-selectmenu-advance.png" alt="v-selectmenu" ></p>

<p align="center">
  <a href="https://www.npmjs.com/package/v-selectmenu"><img src="https://img.shields.io/npm/v/v-selectmenu.svg"></a>
  <a href="https://mit-license.org/"><img src="https://img.shields.io/badge/license-MIT-brightgreen.svg"></a>
  <a href="https://www.npmjs.com/package/v-selectmenu"><img src="https://img.shields.io/npm/dy/v-selectmenu.svg"></a>
</p>

<p align="center">
  基于 <strong>Vue2</strong> 的简洁、易用、高定制化的菜单解决方案
</p>

<p align="center">
  <a href="https://nodei.co/npm/v-selectmenu/"><img src="https://nodei.co/npm/v-selectmenu.png"></a>
</p>

<br><br><br><br><br>

## 文档、Demo
请浏览

- [English site](https://terryz.github.io/vue/#/selectmenu)
- [国内站点](https://terryz.gitee.io/vue/#/selectmenu)

jQuery 版本: [SelectMenu](https://gitee.com/TerryZ/SelectMenu)

<br><br>


## 功能特性

- i18n 支持，提供了中文、英文、日文三种语言
- 常规模式菜单支持多级菜单
- 多分组模式支持
- 高级菜单模式下支持快速搜索
- 高级菜单模式下支持使用键盘进行快速导航
- 自定义渲染行内容
- 嵌入页面模式
- 鼠标右键或鼠标移动呼出菜单

<br><br>

## Vue plugin series

| Plugin | Status | Description |
| :---------------- | :-- | :-- |
| [v-page](https://github.com/TerryZ/v-page) | [![npm version](https://img.shields.io/npm/v/v-page.svg)](https://www.npmjs.com/package/v-page) | A simple pagination bar, including length Menu, i18n support |
| [v-dialogs](https://github.com/TerryZ/v-dialogs) | [![npm version](https://img.shields.io/npm/v/v-dialogs.svg)](https://www.npmjs.com/package/v-dialogs) | A simple and powerful dialog, including Modal, Alert, Mask and Toast modes |
| [v-tablegrid](https://github.com/TerryZ/v-tablegrid) | [![npm version](https://img.shields.io/npm/v/v-tablegrid.svg)](https://www.npmjs.com/package/v-tablegrid) | A simpler to use and practical datatable |
| [v-uploader](https://github.com/TerryZ/v-uploader) | [![npm version](https://img.shields.io/npm/v/v-uploader.svg)](https://www.npmjs.com/package/v-uploader) | A Vue2 plugin to make files upload simple and easier, <br>you can drag files or select file in dialog to upload |
| [v-ztree](https://github.com/TerryZ/v-ztree) | [![npm version](https://img.shields.io/npm/v/v-ztree.svg)](https://www.npmjs.com/package/v-ztree) | A simple tree for Vue2, support single or multiple(check) select tree, <br>and support server side data |
| [v-gallery](https://github.com/TerryZ/v-gallery) | [![npm version](https://img.shields.io/npm/v/v-gallery.svg)](https://www.npmjs.com/package/v-gallery) | A Vue2 plugin make browsing images in gallery |
| [v-region](https://github.com/TerryZ/v-region) | [![npm version](https://img.shields.io/npm/v/v-region.svg)](https://www.npmjs.com/package/v-region) | A simple region selector, provide Chinese administrative division data |
| [v-selectpage](https://github.com/TerryZ/v-selectpage) | [![npm version](https://img.shields.io/npm/v/v-selectpage.svg)](https://www.npmjs.com/package/v-selectpage) | A powerful selector for Vue2, list or table view of pagination, <br>use tags for multiple selection, i18n and server side resources supports |
| [v-suggest](https://github.com/TerryZ/v-suggest) | [![npm version](https://img.shields.io/npm/v/v-suggest.svg)](https://www.npmjs.com/package/v-suggest) | A Vue2 plugin for input suggestions by autocomplete |
| [v-playback](https://github.com/TerryZ/v-playback) | [![npm version](https://img.shields.io/npm/v/v-playback.svg)](https://www.npmjs.com/package/v-playback) | A Vue2 plugin to make video play easier |
| [v-selectmenu](https://github.com/TerryZ/v-selectmenu) | [![npm version](https://img.shields.io/npm/v/v-selectmenu.svg)](https://www.npmjs.com/package/v-selectmenu) | A simple, easier and highly customized menu solution |

<br><br>

## 插件预览

*常规模式菜单*

![regular](https://terryz.gitee.io/image/v-selectmenu/v-selectmenu-regular.png)

*常规模式菜单分组类型*

![regular-group](https://terryz.gitee.io/image/v-selectmenu/v-selectmenu-regular-group.png)

*高级模式菜单分组类型*

![advance](https://terryz.gitee.io/image/v-selectmenu/v-selectmenu-advance.png)

<br><br>

## 安装

``` bash
npm install v-selectmenu --save
```

在项目入口文件 `main.js` 中导入插件

```js
import Vue from 'vue'
import vSelectMenu from 'v-selectmenu';
Vue.use(vSelectMenu);
```

## 在页面中使用 (默认为高级菜单模式)

template

```html
<template>
    <v-selectmenu :data="list" class="form-control" v-model="value">
    </v-selectmenu>
</template>
```

script

```js
export default {
    data(){
        return {
            value: '',
            list: [
                {id:1 ,name:'Chicago Bulls',desc:'芝加哥公牛'},
                {id:2 ,name:'Cleveland Cavaliers',desc:'克里夫兰骑士'},
                {...}
            ]
        };
    }
};
```
<br><br>