element-ui菜单el-menu的使用

效果演示

先给大家看一下效果吧

el-menu详解

官方属性

Menu Attributes#

属性名	说明	类型	可选值	默认值
mode	菜单展示模式	string	horizontal / vertical	vertical
collapse	是否水平折叠收起菜单（仅在 mode 为 vertical 时可用）	boolean	—	false
ellipsis	是否省略多余的子项（仅在横向模式生效）	boolean	—	true
background-color	菜单的背景颜色（十六进制格式）（已被废弃，使用--bg-color）	string	—	#ffffff
text-color	文字颜色（十六进制格式）（已被废弃，使用--text-color）	string	—	#303133
active-text-color	活动菜单项的文本颜色（十六进制格式）（已被废弃，使用--active-color）	string	—	#409EFF
default-active	页面加载时默认激活菜单的 index	string	—	—
default-openeds	默认打开的 sub-menu 的 index 的数组	Array	—	—
unique-opened	是否只保持一个子菜单的展开	boolean	—	false
menu-trigger	子菜单打开的触发方式，只在 mode 为 horizontal 时有效。	string	hover / click	hover
router	是否启用 vue-router 模式。 启用该模式会在激活导航时以 index 作为 path 进行路由跳转 使用 default-active 来设置加载时的激活项。	boolean	—	false
collapse-transition	是否开启折叠动画	boolean	—	true
popper-effect	Tooltip 主题，内置了 dark / light 两种主题	string	dark / light	dark

Menu Methods#

方法名	说明	参数
open	展开指定的 sub-menu	index: 需要打开的 sub-menu 的 index
close	收起指定的 sub-menu	index: 需要收起的 sub-menu 的 index

Menu Events#

事件名	说明	回调参数
select	菜单激活回调	index: 选中菜单项的 index, indexPath: 选中菜单项的 index path, item: 选中菜单项, routeResult: vue-router 的返回值（如果 router 为 true）
open	sub-menu 展开的回调	index: 打开的 sub-menu 的 index, indexPath: 打开的 sub-menu 的 index path
close	sub-menu 收起的回调	index: 收起的 sub-menu 的 index, indexPath: 收起的 sub-menu 的 index path

Menu Slots#

插槽名	说明	子标签
—	自定义默认内容	SubMenu / Menu-Item / Menu-Item-Group

SubMenu Attributes#

属性名	说明	类型	可选值	默认值
index	唯一标志	string	—	—
popper-class	为 popper 添加类名	string	—	—
show-timeout	展开 sub-menu 的延时	number	—	300
hide-timeout	收起 sub-menu 的延时	number	—	300
disabled	是否禁用	boolean	—	false
popper-append-to-body（已废弃）	是否将弹出菜单插入至 body 元素。 在菜单的定位出现问题时，可尝试修改该属性	boolean	—	一级子菜单：true / 非一级子菜单：false
teleported	是否将 popup 的下拉列表插入至 body 元素	boolean	—	一级子菜单：true / 非一级子菜单：false
popper-offset	弹出窗口偏移	number	—	6
expand-close-icon	父菜单展开且子菜单关闭时的图标， expand-close-icon 和 expand-open-icon 需要一起配置才能生效	string | Component	—	—
expand-open-icon	父菜单展开且子菜单打开时的图标， expand-open-icon 和 expand-close-icon 需要一起配置才能生效	string | Component	—	—
collapse-close-icon	父菜单收起且子菜单关闭时的图标， expand-close-icon 和 expand-open-icon 需要一起配置才能生效	string | Component	—	—
collapse-open-icon	父菜单收起且子菜单打开时的图标， expand-open-icon 和 expand-close-icon 需要一起配置才能生效	string | Component

SubMenu Slots#

插槽名	说明	子标签
—	自定义默认内容	SubMenu / Menu-Item / Menu-Item-Group
title	自定义标题内容	—

Menu-Item Attributes#

属性名	说明	类型	可选值	默认值
index	唯一标志	string/null	—	null
route	Vue Router 路径对象	object	—	—
disabled	是否禁用	boolean	—	false

Menu-Item Events#

事件名	说明	回调参数
click	菜单点击时的回调函数	el-menu-item 实例

Menu-Item Slots#

插槽名	说明
—	自定义默认内容
title	自定义标题内容

Menu-Item-Group Attributes#

属性名	说明	类型	可选值	默认值
title	组标题	string	—	—

Menu-Item-Group Slots#

插槽名	说明	子标签
—	默认插槽内容	Menu-Item
title	自定义组标题内容	—

属性解析

el-menu属性

mode：菜单展示模式【horizontal水平/vertical垂直】【默认vertical】
collapse：是否水平折叠收起菜单（仅在垂直模式生效）【默认false】，可以修改为动态如：:collapse="menuStore.isCollapse"
collapse-transition：是否开启折叠动画（仅在垂直模式生效）【默认true】
ellipsis：是否省略多余的子项（仅在横向模式生效）【默认true】

unique-opened：是否只保持一个子菜单的展开
router:可以把点击高亮里的index的地址变为路由地址，进行路由访问
default-active：点击高亮(与index=""搭配，在script设置默认访问/) 如：:default-active="active" const active = ref("/")

background-color：菜单的背景颜色【默认#ffffff】
text-color：文字颜色【默认#303133】
active-text-color：选中文字颜色【默认#409EFF】

el-sub-menu属性

index：唯一标志
disabled：是否禁用
show-timeout：展开 sub-menu 的延时【默认300】
hide-timeout：收起 sub-menu 的延时【默认300】

el-menu-item属性

index：唯一标志
route：Router路径对象
disabled：是否禁用

修改默认样式

/**el-menu默认样式 */
                .el-menu{
                  border-right: 0 !important;/*去掉element menu的右侧边框 */
                  border-radius: 5px!important;
                  background-image: linear-gradient(135deg, #EE9AE5 10%, #5961F9 100%) !important;
                }
                .el-menu-item{
                  border-radius: 15px!important;
                }
                .el-menu-item.is-active {
                  font-weight: 900!important;
                  font-size: 20px!important;
                  color: #c1ecef!important;
                }
 
                注意：垂直模式水平折叠收起菜单后里面item的背景色要在App.vue中设置
                .el-menu {
                    background-image: linear-gradient(135deg, #EE9AE5 10%, #5961F9 100%) !important;
                }

代码

直接上代码

  <!--添加动画效果：设置内部样式-->
    <div class="slider-navs" :style="{ width: menuStore.isCollapse ? '64px' : '210px' }">
        <div v-if="menuStore.toggleStore" class="logo">{{ menuStore.isCollapse ? 'J' : "JKW" }}</div>
        <!--background-color:背景颜色(只有菜单这块，菜单占多少背景占多少) 
            text-color：文本颜色 
            active-text-color：选中后文本颜色
            :default-active="active":点击高亮(与index=""搭配，在script设置默认访问/)
            router:可以把点击高亮里的index的地址变为路由地址，进行路由访问
            :collapse：是否开启折叠面板
            unique-opened 是否只保持一个子菜单的展开
            点击的是el-sub-menu,所以el-sub-menu 的唯一性是必须的,设置index属性来保持唯一性
        -->
        <el-menu background-color="rgba(255,255,255,.1)" text-color="rgb(214, 205, 251)" active-text-color="orange"
            :default-active="active" router class="el-menu-vertical-demo" :collapse="menuStore.isCollapse" unique-opened>
            <el-menu-item index="/home/index">
                <el-icon>
                    <HomeFilled />
                </el-icon>
                <span>首页</span>
            </el-menu-item>
 
            <el-sub-menu index="99">
                <template #title>
                    <el-icon>
                        <Tickets />
                    </el-icon>
                    <span>页面</span>
                </template>
                <el-menu-item index="/:pathMath(.*)*">
                    <el-icon>
                        <Warning />
                    </el-icon>
                    <span>404</span>
                </el-menu-item>
 
            </el-sub-menu>
 
            <el-sub-menu index="1">
                <template #title>
                    <el-icon>
                        <Management />
                    </el-icon>
                    <span>分析</span>
                </template>
                <el-menu-item index="/annlysis/Analysis1">
                    <el-icon>
                        <Operation />
                    </el-icon>
                    <span>样例1</span>
 
                </el-menu-item>
 
            </el-sub-menu>
 
            <el-sub-menu index="2">
                <template #title>
                    <el-icon>
                        <Tools />
                    </el-icon>
                    <span>系统</span>
                </template>
                <el-menu-item index="/sys/admin">
                    <el-icon>
                        <User />
                    </el-icon>
                    <span>用户</span>
                </el-menu-item>
                <el-menu-item index="/sys/role">
                    <el-icon>
                        <CopyDocument />
                    </el-icon>
                    <span>角色</span>
                </el-menu-item>
                <el-menu-item index="/sys/permission">
                    <el-icon>
                        <Lock />
                    </el-icon>
                    <span>权限</span>
                </el-menu-item>
            </el-sub-menu>
 
 
        </el-menu>
    </div>

<script setup>
import { ref } from 'vue';
import { useMenuStore } from "@/stores/menuStore.js";//stores
//解决页面刷新后 菜单高亮与面包屑不匹配
const menuStore = useMenuStore()
const active = ref("/")
if (localStorage.getItem("active")) {
    active.value = localStorage.getItem("active")
}
</script>

<style scoped>
.slider-navs {
    background-image: linear-gradient(135deg, #EE9AE5 10%, #5961F9 100%) !important;
    /*固定在左侧(position: fixed生成绝对定位的元素， 相对于浏览器窗口进行定位) */
    position: fixed;
    left: 0;
    top: 0;
    bottom: 0;
    /*width: 210px;*/
 
    /*设置动画过渡 和<el-menu>内部的一样 */
    transition: 0.3s ease-in;
}
 
.el-menu-vertical-demo {
    background-image: linear-gradient(to bottom right, rgb(114, 135, 254), rgb(130, 88, 186));
 
}
 
.logo {
    background-image: linear-gradient(120deg, #00e4d0, #5983e8) !important;
    /*需要在App.vue设置公共样式，把element menu的右边框去掉，否则对不齐 */
    width: 100%;
    height: 60px;
    background-color: #364e6d;
    font-size: 45px;
    font-weight: 900;
    color: rgb(124, 101, 215);
    text-align: center;
    /*左右居中 */
    line-height: 60px;
    /*上下居中：和高度保持一致 */
}
 
.icon {
    width: 16px;
    height: 16px;
    margin-right: 5px;
    /*让图标和文字有空隙 */
}
</style>

app.vue全局样式的设计

/**侧边栏样式修改 */
.el-menu{
  border-radius: 5px!important;
  background-image: linear-gradient(135deg, #EE9AE5 10%, #5961F9 100%) !important;
 
}
.el-menu-item{
  border-radius: 15px!important;
}
.el-menu-item.is-active {
 
  font-weight: 900!important;
  font-size: 20px!important;
  color: #c1ecef!important;
}