Vue3项目—页面布局与侧栏Menu 菜单

该Vue3项目采用Element-plus的Container 布局容器完成。

用于布局的容器组件，页面的基本结构如下：

<el-container>：外层容器。 当子元素中包含 <el-header> 或 <el-footer> 时，全部子元素会垂直上下排列， 否则会水平左右排列。

<el-header>：顶栏容器。

<el-aside>：侧边栏容器。

<el-main>：主要区域容器。

<el-footer>：底栏容器

页面Container 布局示例

<template>
  <div class="common-layout">
    <el-container>
      <el-header>Header</el-header>
      <el-container>
        <el-aside width="200px">Aside</el-aside>
        <el-main>Main</el-main>
      </el-container>
    </el-container>
  </div>
</template>

效果：

项目Container 布局实例

父组件：

<!-- layout/index.vue -->
<template>
<!-- 外层容器 -->
  <el-container class="pm-layout">
    <!-- 顶栏容器 -->
    <el-header class="pm-layout__header">
      <Header />
    </el-header>
    <el-container>
    <!-- 侧边栏容器 -->
      <el-aside
        :width="siderWidth"
        class="pm-layout__aside overflow-y-scroll"
      >
        <Sider />
      </el-aside>
      <el-container>
        <!-- 主要区域容器 -->
        <el-main>
          <BreadCrumb />
          <el-card class="pm-layout-main overflow-scroll">
            <div
              v-if="getEnv().MODE === 'pre' && !route.meta.prePrdVisible"
              class="overflow-scroll"
            >
              当前环境为pre-prd环境,基于数据隔离考虑,不开放该页面的编辑权限
            </div>
            <div
              v-else
              class="overflow-scroll"
            >
              <router-view />
            </div>
          </el-card>
        </el-main>
      </el-container>
    </el-container>
  </el-container>
</template>

<script setup lang='ts'>

import { ref, watch } from 'vue';
import Sider from './sider/index.vue';
import Header from './header/index.vue';
import BreadCrumb from './header/BreadCrumb.vue';
import { useMenuStore } from '~/store';
import { storeToRefs } from 'pinia';
import { useRoute } from 'vue-router';
import { getEnv } from '~/core/utils';
const store = useMenuStore();
const route = useRoute();
const { isCollapse, userAgent } = storeToRefs(store);

const siderWidth = ref('200px');

watch(isCollapse, (cur) => {
  if (!cur) {
    siderWidth.value = '200px';
    return;
  }
  siderWidth.value = userAgent.value === 'PC' ? '60px' : '0px';
}, { immediate: true });

</script>

<style lang="scss">
.pm-layout {
  &__header {
    background-color: #0A0F25;
  }

  &-main {
    height: calc(100vh - 140px);
    >.ep-card__body{
      padding-bottom: 0;
    }
  }
  &__aside{
    overflow: hidden;
  }
}
</style>

页面侧边菜单示例

侧边导航栏是垂直菜单，里面可内嵌子菜单，同时该项目的垂直导航菜单可以被折叠

<template>
  <el-radio-group v-model="isCollapse" style="margin-bottom: 20px">
    <el-radio-button :label="false">expand</el-radio-button>
    <el-radio-button :label="true">collapse</el-radio-button>
  </el-radio-group>
  <el-menu
    default-active="2"
    class="el-menu-vertical-demo"
    :collapse="isCollapse"
    @open="handleOpen"
    @close="handleClose"
  >
    <!-- 一级菜单 -->
    <el-sub-menu index="1">
      <template #title>
        <el-icon><location /></el-icon>
        <span>Navigator One</span>
      </template>
      <!-- 子菜单 -->
      <el-menu-item-group>
        <template #title><span>Group One</span></template>
        <el-menu-item index="1-1">item one</el-menu-item>
        <el-menu-item index="1-2">item two</el-menu-item>
      </el-menu-item-group>
      <el-menu-item-group title="Group Two">
        <el-menu-item index="1-3">item three</el-menu-item>
      </el-menu-item-group>
      <el-sub-menu index="1-4">
        <template #title><span>item four</span></template>
        <el-menu-item index="1-4-1">item one</el-menu-item>
      </el-sub-menu>
    </el-sub-menu>
    <!-- 二级菜单 -->
    <el-menu-item index="2">
      <el-icon><icon-menu /></el-icon>
      <template #title>Navigator Two</template>
    </el-menu-item>
    <!-- 三级菜单 -->
    <el-menu-item index="3" disabled>
      <el-icon><document /></el-icon>
      <template #title>Navigator Three</template>
    </el-menu-item>
    <!-- 四级菜单 -->
    <el-menu-item index="4">
      <el-icon><setting /></el-icon>
      <template #title>Navigator Four</template>
    </el-menu-item>
  </el-menu>
</template>

<script lang="ts" setup>
import { ref } from 'vue'
import {
  Document,
  Menu as IconMenu,
  Location,
  Setting,
} from '@element-plus/icons-vue'

const isCollapse = ref(true)
const handleOpen = (key: string, keyPath: string[]) => {
  console.log(key, keyPath)
}
const handleClose = (key: string, keyPath: string[]) => {
  console.log(key, keyPath)
}
</script>

<style>
.el-menu-vertical-demo:not(.el-menu--collapse) {
  width: 200px;
  min-height: 400px;
}
</style>

效果：

Menu属性：

属性名	说明	类型	默认值
default-active	页面加载时默认激活菜单的 index	string	——
router	是否启用 vue-router 模式。 启用该模式会在激活导航时以 index 作为 path 进行路由跳转 使用 default-active 来设置加载时的激活项。	boolean	false
active-text-color	页面加载时默认激活菜单的 index	string	——
collapse	是否水平折叠收起菜单（仅在 mode 为 vertical 时可用）	boolean	false
background-color	菜单的背景颜色	string	——
text-color	文字颜色	string	——
collapse-transition	是否开启折叠动画	boolean	true

项目侧边菜单实例

子组件：

<!-- layout/sider/index.vue -->
<template>
  <el-menu
    :default-active="$route.path"
    router
    active-text-color="#ffd04b"
    :collapse="isCollapse"
    background-color="#0A0F25"
    text-color="#ffffff"
    class="pm-sider h-full"
    :collapse-transition="false"
  >
    <!-- 折叠条 -->
    <div
      v-if="userAgent==='PC'"
      :class="['cursor-pointer flex items-center p-20px', 'justify-start',]"
      @click="toggleCollapse"
    >
      <el-image
        class="pm-sider__icon"
        src="/img/program/operation-sider-collapse-icon.png"
      />
    </div>
    <el-sub-menu index="1">
      <template #title>
        <el-image
          class="pm-sider__icon"
          src="/img/program/operation-avatar-clothes-icon.png"
        />
        <span>首页</span>
      </template>
      <el-menu-item index="/welcome">
        首页
      </el-menu-item>
    </el-sub-menu>

    <el-sub-menu index="2">
      <template #title>
        <el-image
          class="pm-sider__icon"
          src="/img/program/operation-expert-icon.png"
        />
        <span>专家系统</span>
      </template>
      <el-menu-item index="/expert/qa-list">
        问答列表
      </el-menu-item>
      <el-menu-item index="/expert/collections">
        专家库
      </el-menu-item>
    </el-sub-menu>
    <el-sub-menu index="3">
      <template #title>
        <el-image
          class="pm-sider__icon"
          src="/img/program/operation-pgc-icon.png"
          style=""
        />
        <span>PGC场景</span>
      </template>
      <el-menu-item index="/pgc/scene">
        场景管理（已废弃）
      </el-menu-item>
      <el-menu-item index="/pgc/configuration">
        场景配置
      </el-menu-item>
      <el-menu-item index="/pgc/task">
        场景任务
      </el-menu-item>
      <el-sub-menu index="3-2">
        <template #title>
          <span>用户管理</span>
        </template>
        <el-menu-item index="/pgc/user/management">
          用户列表
        </el-menu-item>
        <el-menu-item index="/pgc/user/ban-list">
          禁言封禁列表
        </el-menu-item>
      </el-sub-menu>
    </el-sub-menu>
    <el-sub-menu index="4">
      <template #title>
        <el-image
          class="pm-sider__icon"
          src="/img/program/operation-aams-icon.png"
        />
        <span>素材管理</span>
      </template>
      <el-menu-item index="/aams/audit">
        素材审核
      </el-menu-item>
      <el-menu-item index="/aams/clothes">
        商品发布
      </el-menu-item>
    </el-sub-menu>
  </el-menu>
</template>

<script setup lang='ts'>
import {
  Menu as IconMenu,
  ChatDotSquare,
  Expand,
  Fold
} from '@element-plus/icons-vue';
import { ref, watch } from 'vue';
import { useMenuStore, useAccountStore } from '~/store';
import { storeToRefs } from 'pinia';
import { checkPermisson } from '~/core/utils';
const { userInfo: { id } } = useAccountStore();
const store = useMenuStore();
const { toggleCollapse } = store;
const { isCollapse, userAgent } = storeToRefs(store);
// prd: 6551-wangjin 8297-jimmyxia 6107-jimmyxia 6125-jichen 6118-linqiang
// stg: 197-yokinzhu3
const permissionList = ['6551', '8297', '6107', '6125', '6118', '197'];
</script>
<style lang="scss">
.pm-sider {
  &__icon {
    width: 16px;
    height: 16px;
    margin-right: 10px;
  }
}
</style>

效果: