Vue3 入门笔记 ---- 利用Element Plus对页面进行布局划分以及实现左侧公共菜单

这个系列的笔记重点会放在怎么样利用Vue3把项目架设起来并跟后端API互动，不会介绍Vue的基础特性，关于Vue的基础特性可以参考这个视频四个小时带你快速入门Vue，我是看这个入门的，觉得还不错。

代码地址： https://github.com/yexia553/vue_study/tree/%E9%85%8D%E7%BD%AEvue-router/vue3-notes

同步发表于个人站点：http://www.panzhixiang.cn/article/2022/10/22/57.html

页面布局说明以及效果展示

一个网站总有自己的布局的，所谓布局就是在什么区域展示什么信息，下面的图片就是我们设计的布局效果，分为三个部分。

页面的左侧是一个整体，用于展示菜单栏，也就是显示了网站有哪些模块；右侧分为上下两部分，上面是用于显示用户的头像，点击头像可以进行登出等操作；右侧的下半部分是网站的主体区域，展示我们希望像用户传递的信息。

由于左侧的菜单栏和右侧上半部分不论再那个页面都需要，所以我们就可以把这两个部分做成公共组件，可以为左侧菜单栏起个名字叫做CommonAside，右侧的上半部分叫做CommonHeader。

Element Plus简介

会Vue的人基本知道Element UI（和Vue2搭配使用）或者Element Plus, 他们的作用就是封装好了很多UI库，方便我们直接使用，比如我们想实现一个表格，就可以使用el-table 标签帮助我们实现。

实现布局

安装

要使用Element Plus，首先要安装，在项目的根目录下执行下面的命令就可以了

npm install element-plus --save

由于我们后面还要使用Element Plus里面的icon，这里也一并安装

npm install @element-plus/icons-vue

引入

安装好之后还要在Vue3中引入Element Plus才能在Vue3中使用，我们采用全局引入的方式，但是其实引入的方法有好几种，可以点击这里查看具体有哪些引入方法。
引入的方法是在main.js中进行配置，配置之后main.js如下所示，我在代码中备注了哪些代码是引入所需要的。

import { createApp } from 'vue'
import App from './App.vue'
import ElementPlus from 'element-plus'  // 引入Element Plus 所需
import 'element-plus/dist/index.css'  // 引入Element Plus 所需
import router from './router/index.js'
import * as ElementPlusIconsVue from '@element-plus/icons-vue'  // 引入Element Plus icon 所需
import './assets/main.css'

const app = createApp(App)

// 引入Element Plus icon 所需
for (const [key, component] of Object.entries(ElementPlusIconsVue)) {
    app.component(key, component)
}

app.use(router)
app.use(ElementPlus)  // 引入Element Plus 所需
app.mount('#app')

修改Vue3初始样式

Vue3在创建项目的项目的时候默认有一些样式，也就是css，在 项目根目录/src/assets/路径下，有base.css 和main.css这两个样式文件，我们修改main.css就可以了。

主要是修改main.css 中两个 #app 部分，修改后如下：

#app {
    /* max-width: 1280px; */
    margin: 0;
    padding: 0;
    font-weight: normal;
    height: 100vh;
    width: 100%;
}

    #app {
        /* display: grid; */
        /* grid-template-columns: 1fr 1fr; */
        padding: 0;
    }

css的部分不详细解释了，主要的目的就是为了vue能够正常在浏览器中显示我们的页面，看不懂的话需要去简单学一下css的部分。

实现布局

上一篇笔记讲路由的时候，我们在Main.vue中写入了

<template>
Home    
template>

我们现在将里面的内容替换为下面的部分

<template>
    <div class="common-layout">
        <el-container>
            <el-aside width="180px">
                Aside
            el-aside>
            <el-container>
                <el-header>Headerel-header>
                <el-main>Mainel-main>
            el-container>
        el-container>
    div>
template>

替换之后，大家在项目根目录下执行 npm run dev 运行项目,应该可以看到如下的页面

可以看到，虽然很简单，但是页面整体的框架已经出来了。

CommonAside组件

上面提到过，我们可以把左侧菜单栏抽成一个组件，称之为CommonAside。我们现在来实现它。

创建CommonAside.vue文件

首先先删除src/components在项目初始化的时候自动创建的内容。
在src/components路径下创建CommonAside.vue这个文件，文件内容如下，

<template>
    <el-menu class="el-menu-vertical-demo" background-color="#545c64" text-color="#fff" :collapse-transition="false"
        active-text-color="#ffd04b">
        <h3>后台管理h3>
        <el-menu-item :index="item.path+''" v-for="item in list" :key="item.label">
            <component class="icons" :is="item.icon">component>
            <span>{{item.label}}span>
        el-menu-item>
    el-menu>
template>


<script>
export default {
    setup() {
        const list = [
            {
                path: '/user',
                name: 'user',
                label: '用户管理',
                icon: 'user',
                url: '/user'
            },
            {
                label: '其它',
                name: 'other',
                icon: 'location',
                path: '/other',
                url: 'other'
            },
        ];
        return {
            list,
        }
    }
}
script>

<style lang="less" scoped>
.icons {
    width: 18px;
    height: 18px;
    margin-right: 4px;
}
.el-menu-vertical-demo {
    width: 100%;
    border-right: none;
    h3 {
        color: #fff;
        text-align: center;
        margin-top: 10px;
    }
}
style>

代码中分为template、script和style三个部分，我们分别来说明一下。

template

template里面引用el-menu标签实现我们需要的样式，我们这里其实只使用了很简单的部门，还有很多方法和属性我们都没有使用，大家可以多看看element plus的官网。

script

script里面是js代码，Vue3支持选项式API和组合式API，我使用的是组合式API，关于这两者的区别以及应该怎么选择可以看这里

我在script里面其实就定义并返回了一个包含左侧菜单内容的list。

style

style里面是样式，也就是css，但是我使用的是less，关于less的部分可以看这里， 其实不会less的也没关系，看看上面的代码，跟着模仿就行了，我其实也不会less，只会模仿而已。

使用CommonAside.vue 组件

之前分析过，CommonAside这个组件会在所有的页面中都出现，所以我们可以在Main.vue中引入这个组件，引入之后Main.vue的内容如下，

<template>
    <div class="common-layout">
        <el-container>
            <el-aside width="180px">
                
                <common-aside>common-aside>
            el-aside>
            <el-container>
                <el-header>Headerel-header>
                <el-main>Mainel-main>
            el-container>
        el-container>
    div>
template>

<script>
import CommonAside from "../components/CommonAside.vue";
export default {
    components: {
        CommonAside,
    }
}
script>

<style lang="less" scoped>
.common-layout {
    height: 100%;
    &>.el-container {
        height: 100%;
        &>.el-aside {
            height: 100%;
            background: #545c64;
        }
        &>.el-container {
            &>.el-header {
                padding: 0%;
            }
        }
    }
}
style>

代码的内容很简单，只解释一下style里面的一个小知识点。

.common-layout 表示 其后所跟的花括号的样式会作用在class="common-layout"的范围内，
我们会看到 .common-layout下面会有 &>.el-container，这会关联到common-layout里面的el-container，如果在.common-layout之外也有el-container的话是不会起效的。

---

到这里CommonAside组件也完成了，启动项目之后页面应该如下所示，

欢迎关注我的公众号